TTokenPortal

对话端点（四协议）

文档状态已发布功能状态已上线最后更新：2026-09-19

平台同时支持四种对话协议格式，你可以用任意一种已有的官方 SDK 或 HTTP 客户端直接接入，只需替换 Base URL 和 API Key。

一、四个端点一览

协议端点说明
OpenAI Chat CompletionsPOST /v1/chat/completions可直接用 OpenAI 官方 SDK，只改 base_url
Anthropic MessagesPOST /v1/messages需带 anthropic-version: 2023-06-01 请求头
Gemini generateContentPOST /v1/models/{model}:generateContent模型 ID 拼在路径里，见下方「Gemini 路径写法」
OpenAI ResponsesPOST /v1/responses入站按 Responses 格式解析，平台会路由到任意一种上游协议再把结果翻译回 Responses 形状返回给你

请求体、响应体与各家官方协议逐字段一致，本页不重新复制一遍协议细节——那份复制品会随官方协议演进而过时，反而误导你。请以对应官方文档为准；本页只讲平台特有的接入细节、以及平台适配层做了什么改写。

二、鉴权（对四个端点都适用）

Authorization: Bearer sk-你的密钥     首选
x-api-key: sk-你的密钥                Authorization 为空时的备选

这两种鉴权方式对上面四个端点都生效，不是只有 Anthropic 协议才认 x-api-key。

不支持 Gemini 官方那种 ?key= 查询参数鉴权方式——本平台不认这种写法。如果你用 Gemini 官方 SDK 的默认鉴权方式接入，会收到 401 missing_auth；请改成上面两种请求头之一。

三、Gemini 路径写法

网关按可能含 / 的模型 ID（如 google/gemini-3.1-pro-preview）注册路由，完整路径形如：

POST /v1/models/google/gemini-3.1-pro-preview:generateContent

路径形状不对时返回 400（不是 404）。

Gemini 流式响应通过 ?alt=sse 查询参数请求——这是数据面唯一会读取的查询参数。

四、示例

OpenAI Chat（cURL）：

curl https://intertoken.ai/v1/chat/completions \
  -H "Authorization: Bearer sk-你的密钥" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "openai/gpt-4o",
    "messages": [{"role": "user", "content": "Hello!"}]
  }'

Anthropic Messages（cURL）：

curl https://intertoken.ai/v1/messages \
  -H "x-api-key: sk-你的密钥" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "anthropic/claude-opus-4.8",
    "max_tokens": 1024,
    "messages": [{"role": "user", "content": "Hello!"}]
  }'

Gemini generateContent（cURL）：

curl "https://intertoken.ai/v1/models/google/gemini-3.1-pro-preview:generateContent" \
  -H "Authorization: Bearer sk-你的密钥" \
  -H "Content-Type: application/json" \
  -d '{
    "contents": [{"role": "user", "parts": [{"text": "Hello!"}]}]
  }'

OpenAI Responses（cURL）：

curl https://intertoken.ai/v1/responses \
  -H "Authorization: Bearer sk-你的密钥" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "openai/gpt-4o",
    "input": "Hello!"
  }'

Anthropic 协议的地址不带尾部 /v1（Anthropic 官方 SDK 会自己拼接 /v1/messages），其余三个协议的地址带 /v1。用官方 SDK 接入时只需设置 base_url/baseURL，SDK 会自动处理其余路径拼接。

五、平台适配层做了什么（差异列）

调用任意协议时，平台会先把请求解析成内部统一结构，再按你实际路由到的上游协议重新构造请求——这意味着即使入站协议与上游协议相同，请求也会经过一次解析与重建，而不是逐字节透传。这个过程中，部分字段会被保留、部分会被改写、部分会被静默丢弃。

协议平台适配层的透传/改写/丢弃细节
Anthropic Messages已逐字段核实，见 Anthropic Messages 适配层字段表
OpenAI Chat Completions尚未按字段核实到可发布的程度，暂不提供细节表；请求体按官方协议解析
OpenAI Responses尚未按字段核实到可发布的程度，暂不提供细节表
Gemini generateContent尚未按字段核实到可发布的程度，暂不提供细节表

三个"尚未核实"的协议目前没有已知的重大异常报告，只是还没有像 Anthropic 那样逐字段对照代码写出完整清单——不代表它们完全零改写，只代表这部分文档尚未补齐。补齐后本表会更新。

六、错误

四个端点共用同一套错误码词汇表 → 错误码。

七、Key 是否可调用某个模型

调用前可以先查询这把 Key 现在能不能调用目标模型，避免调用失败 → Key 可调用性查询。

对话端点（四协议） · TokenPortal