通用 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 systemuserassistant
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