协议选择
同一个网关同时收四种接口格式,请求发到哪个路径,就走哪套协议。你的代码原来用什么,就继续用什么——只要那把上游通道支持这种格式。
四种协议
| 协议 | 路径 | base_url | 什么时候用 |
|---|---|---|---|
| OpenAI 对话 | /v1/chat/completions | https://api.tokenflow365.com/v1 | 新项目首选。SDK 生态最全,示例最多。 |
| Claude Messages | /v1/messages | https://api.tokenflow365.com | 已有 Anthropic SDK 代码,不想重写调用层。 |
| OpenAI Responses | /v1/responses | https://api.tokenflow365.com/v1 | 想用较新的对话式接口,或需要服务端托管会话。 |
| Gemini | /v1beta/models/{model}:generateContent | https://api.tokenflow365.com | 已有 Gemini SDK 代码,或团队习惯 Google 那套。 |
怎么选
- 新写的代码:用 OpenAI 对话格式。文档、示例、第三方客户端都最多。
- 已有的代码:别改。把 base_url 指过来就行——SDK 自己会拼路径。
- 同一个项目里混用:可以,但没必要。四套格式底层走的是同一批模型,混用只会增加排查成本。
用之前要确认
网关本身四种都收,但能不能跑通,取决于后面对接的上游通道支持哪种格式。当前接入的通道是 OpenAI 兼容协议,所以对话格式最稳;另外三种在接入对应协议的上游之后才能用。
发过去返回 503(模型不可用)或 400(格式不认),通常就是这类原因,不是你的代码写错了。换回/v1/chat/completions先验证 Key 和余额是否正常。
具体路径与可用状态见接口速查。