通用 OpenAI 兼容
POST https://ai-api.mandao.com/v1/chat/completions
通用的 OpenAI 兼容接口,支持 OpenAI、Gemini、Claude、Grok、Deepseek 等主流模型。主要用于 Claude code、TRAE、VSCode 等外部工具集成。
请求参数
| 参数名 | 类型 | 必需 | 说明 |
|---|---|---|---|
| model | string | 是 | 任何已开通的模型 ID |
| messages | array[object] | 是 | 对话消息列表 |
| messages[].role | string | 是 | system、user、assistant |
| messages[].content | string | 是 | 消息内容 |
| max_tokens | integer | 否 | 最大返回 token 数 |
| temperature | number | 否 | 采样温度,范围 0~1 |
| stream | boolean | 否 | 流式返回标记 |
请求示例
curl --location 'https://ai-api.mandao.com/v1/chat/completions' \
--header 'Authorization: Bearer <your-api-key>' \
--header 'Content-Type: application/json' \
--data '{
"model": "gemini-2.5-flash-lite",
"messages": [
{
"role": "user",
"content": "帮我写一首诗"
}
],
"max_tokens": 2048,
"temperature": 0.7,
"stream": false
}'限制条件
- 不支持图片附件(多模态内容)。
- GPT-5/5-mini/5-nano 不支持设置
temperature。 - GPT-5.1/5/5-mini/5-nano 中
max_tokens已修改为max_completion_tokens,平台将自动替换。 chat/completions接口中tool_calls部分取决于各家对 OpenAI 协议的兼容性。- 不支持 Response、Codex、Embedding 等特殊类型接口。
/v1/models(通用模型列表)
GET https://ai-api.mandao.com/v1/models
返回当前账号开通的所有模型列表,OpenAI 格式。
curl --location 'https://ai-api.mandao.com/v1/models' \
--header 'Authorization: Bearer <your-api-key>'注意事项
- 通用域名接口适合需要同时切换多种模型的场景。
- 如需使用特定模型的完整功能,推荐使用各模型的原生协议。
作者:李志强 创建时间:2026-06-04 15:15
最后编辑:李志强 更新时间:2026-07-02 13:11
最后编辑:李志强 更新时间:2026-07-02 13:11