Skip to main content

文本接口

文本接口提供多套常见协议,方便已有业务按最接近的 SDK 或请求结构接入。新项目通常优先选择 OpenAI Responses 或 Chat Completions;已有 Claude、Gemini 原生调用代码时,可以直接保留对应协议。

模型与协议矩阵

按协议、能力和常见模型家族选择接入入口。

Chat Completions

POST /v1/chat/completions,适合聊天、Agent、长文本生成和多模态输入。

OpenAI Responses

POST /v1/responses,适合结构化输出、工具调用和复杂任务编排。

图像输入

文本模型接收图片时的 URL、base64 和图床上传写法。

Claude 原生

POST /v1/messages,保留 Anthropic Messages 协议。

Gemini 原生

POST /v1beta/models/{model}:{action}GET /v1beta/models

认证方式

大多数文字接口使用 Bearer Token:
Claude 原生格式同时兼容:
Gemini 原生格式同时兼容:

接口清单

通用错误码

如果接口页里标记了“可选”参数,不代表所有模型都支持该字段。最终是否透传、是否生效,仍取决于实际分发到的渠道能力。

接入建议

推荐阅读顺序

  1. 文本模型支持矩阵
  2. Chat Completions(非流式)
  3. Chat Completions(流式)
  4. 图像输入与图床上传
  5. OpenAI Responses 接口
  6. Claude 消息接口
  7. Gemini 原生格式
  8. 模型列表
  9. 参数测试用例
  10. Realtime 接口