TokenFlow

协议选择

同一个网关同时收四种接口格式,请求发到哪个路径,就走哪套协议。你的代码原来用什么,就继续用什么——只要那把上游通道支持这种格式。

四种协议

协议路径base_url什么时候用
OpenAI 对话/v1/chat/completionshttps://api.tokenflow365.com/v1新项目首选。SDK 生态最全,示例最多。
Claude Messages/v1/messageshttps://api.tokenflow365.com已有 Anthropic SDK 代码,不想重写调用层。
OpenAI Responses/v1/responseshttps://api.tokenflow365.com/v1想用较新的对话式接口,或需要服务端托管会话。
Gemini/v1beta/models/{model}:generateContenthttps://api.tokenflow365.com已有 Gemini SDK 代码,或团队习惯 Google 那套。

怎么选

  • 新写的代码:用 OpenAI 对话格式。文档、示例、第三方客户端都最多。
  • 已有的代码:别改。把 base_url 指过来就行——SDK 自己会拼路径。
  • 同一个项目里混用:可以,但没必要。四套格式底层走的是同一批模型,混用只会增加排查成本。

用之前要确认

网关本身四种都收,但能不能跑通,取决于后面对接的上游通道支持哪种格式。当前接入的通道是 OpenAI 兼容协议,所以对话格式最稳;另外三种在接入对应协议的上游之后才能用。

发过去返回 503(模型不可用)或 400(格式不认),通常就是这类原因,不是你的代码写错了。换回/v1/chat/completions先验证 Key 和余额是否正常。

具体路径与可用状态见接口速查。