接入文档

平台提供 OpenAI 兼容接口，绝大多数 SDK 只需修改 Base URL 与 API Key 即可无缝接入。

1. 基本信息

项目	值
Base URL	`https://api.mdyh.net/v1`
鉴权方式	`Authorization: Bearer sk-xxxx`
接口协议	OpenAI Chat / Completion / Embedding 兼容

2. 支持的接口

接口	方法	说明
`/v1/chat/completions`	POST	对话补全（支持流式 stream）
`/v1/completions`	POST	文本补全
`/v1/embeddings`	POST	向量化
`/v1/models`	GET	查询可用模型列表
`/v1/dashboard/billing/subscription`	GET	查询密钥余额（客户端兼容）
`/v1/dashboard/billing/usage`	GET	查询用量（客户端兼容）

3. 快速开始

使用 curl 发起一次对话请求：

curl https://api.mdyh.net/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-你的密钥" \
  -d '{"model":"gpt-4o-mini","messages":[{"role":"user","content":"你好"}]}'
    

4. 各语言调用示例

Python（OpenAI SDK）

from openai import OpenAI

client = OpenAI(
    api_key='sk-你的密钥',
    base_url='https://api.mdyh.net/v1',
)
resp = client.chat.completions.create(
    model='gpt-4o-mini',
    messages=[{'role': 'user', 'content': '你好'}],
)
print(resp.choices[0].message.content)

Node.js

const OpenAI = require('openai');

const client = new OpenAI({
    apiKey: 'sk-你的密钥',
    baseURL: 'https://api.mdyh.net/v1',
});

const resp = await client.chat.completions.create({
    model: 'gpt-4o-mini',
    messages: [{ role: 'user', content: '你好' }],
});
console.log(resp.choices[0].message.content);

5. 流式输出

请求体中加入 "stream": true 即可开启流式（SSE）输出，响应格式与 OpenAI 一致，并在结束事件 [DONE] 前按需返回 usage。

6. 计费说明

平台按模型单价与实际 Token 用量计费，价格单位：元 / 100 万 Token（输入与输出分别计价）。每次调用后自动扣费并写入使用日志，可在管理后台查看明细。

7. 常见错误

HTTP	说明
401	API Key 无效或未提供
402	余额不足或额度用尽
429	请求过于频繁，超出速率限制
400	参数错误 / 模型不可用