文本生成
文本能力当前覆盖以下公开入口，推荐优先使用 POST /v1/responses，其余入口用于兼容已有 SDK 和原生 Claude 客户端。
| 协议 | 方法与路径 | 用途 |
|---|---|---|
| OpenAI | POST /v1/responses | 新项目优先使用的统一文本生成接口 |
| OpenAI | POST /v1/chat/completions | 兼容大量现有 OpenAI SDK 的对话补全接口 |
| OpenAI | POST /v1/completions | 旧版文本补全接口，仅用于兼容历史调用链 |
| Anthropic | POST /v1/messages | Claude 原生消息格式接口 |
| OpenAI | GET /v1/models | 查询当前路由可用的逻辑模型清单 |
OpenAI Responses
bash
curl https://api.modelgo.com/v1/responses \
-H "Authorization: Bearer $MODELGO_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model":"<model>",
"input":"用三句话介绍 ModelGo。"
}'适合新接入和统一封装场景。请求体、流式返回和 usage 字段遵循 OpenAI Responses 兼容格式。
OpenAI Chat Completions 兼容入口
bash
curl https://api.modelgo.com/v1/chat/completions \
-H "Authorization: Bearer $MODELGO_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model":"<model>",
"messages":[{"role":"user","content":"hello"}]
}'适合已经绑定 OpenAI SDK 或历史对话补全调用链的客户端。推荐新项目优先迁移到 POST /v1/responses。
OpenAI Completions（旧版补全）
bash
curl https://api.modelgo.com/v1/completions \
-H "Authorization: Bearer $MODELGO_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model":"<model>",
"prompt":"用三句话介绍 ModelGo。",
"max_tokens":256
}'旧版文本补全接口，仅用于兼容仍在使用 prompt 的历史调用链，新项目请使用上面的 Responses / Chat Completions。stream 同样以 SSE 返回。多数当前对话模型未声明此协议：qwen3.6-flash 实测 HTTP 400、model_protocol_not_offered。
Anthropic Messages
bash
curl https://api.modelgo.com/v1/messages \
-H "x-api-key: $MODELGO_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model":"<model>",
"max_tokens":1024,
"messages":[{"role":"user","content":"hello"}]
}'适合直接复用 Claude 原生消息格式的客户端。该入口保持 /v1/messages 的事件流语义，不会在网关侧改造成 OpenAI SSE 帧。
查询模型清单
bash
curl https://api.modelgo.com/v1/models \
-H "Authorization: Bearer $MODELGO_API_KEY"GET /v1/models 返回该 API Key 绑定策略所允许的逻辑模型（结合平台模型目录），不会在请求时实时探测上游能力，可能与控制台展示略有差异；计费、策略以控制台和绑定策略为准。
关键约定
model填写平台逻辑模型名GET /v1/models可用，清单由 API Key 绑定的策略与平台模型目录决定- OpenAI 与 Anthropic 协议都可能返回上游原样
usage - 流式失败时可能不会发送
data: [DONE]，请以数据块中的error判断 - 如果上游或路由不支持当前协议，平台会返回
provider_unsupported或协议不兼容错误