地址与协议选择表

The guide below is in Chinese.

按客户端或 API 的协议选择 Base URL。直接发 HTTP 请求时使用下表的完整路径,使用 SDK 时让 SDK 追加对应的路径。

先看你要调什么能力

协议SDK Base URLHTTP 请求路径
OpenAI Chathttps://intertoken.ai/v1POST /v1/chat/completions
OpenAI Responseshttps://intertoken.ai/v1POST /v1/responses
Anthropic Messages / Claude Codehttps://intertoken.aiPOST /v1/messages
Geminihttps://intertoken.ai/v1POST /v1/models/{model}:generateContent
OpenAI Imageshttps://intertoken.ai/v1POST /v1/images/generations
TokenPortal 视频生成https://intertoken.ai/v1POST /v1/contents/generations/tasks
火山方舟兼容(Seedance)https://intertoken.ai/api/v3POST /api/v3/contents/generations/tasks
素材库https://intertoken.ai/v1/v1/media/assets
火山兼容素材库https://intertoken.ai/api/v3/api/v3/media/assets
Gemini 上下文缓存https://intertoken.ai/v1POST /v1/caches
模型列表https://intertoken.ai/v1GET /v1/models

地址怎么拼

直接发 HTTP 请求时把完整路径接到 https://intertoken.ai。例如查询模型:

Shell command
curl "https://intertoken.ai/v1/models" -H "Authorization: Bearer $TP_API_KEY"

使用 Claude Code 或 Anthropic SDK 时,Base URL 填 https://intertoken.ai,SDK 会追加 /v1/messages。若地址带了 /v1,可能拼成 /v1/v1/messages 而报 404。

火山方舟 Seedance 客户端使用 https://intertoken.ai/api/v3。平台 /v1 视频和火山兼容路径的状态字段与产物字段不同,请在同一套路径创建和查询。

所有数据面请求通用

  • 请求体可以 gzip 压缩:带上 Content-Encoding: gzip 即可,长上下文请求能明显省上行带宽。解压后的请求体大小上限与不压缩时相同,压缩不能用来发更大的请求体。
  • 每个响应都带三个计时头(含报错的响应),便于排查慢请求:
响应头含义
req-arrive-time请求到达平台网关的时刻(Unix 毫秒)
resp-start-time平台开始写响应的时刻(Unix 毫秒)
req-cost-time上面两者之差(毫秒)

⚠ req-cost-time 只算到响应开始为止,不是整次请求的总耗时:流式响应在这之后还会继续传输几秒到几分钟。

异步 vs 同步

对话、图片生成是同步的:请求发出去,响应里直接带结果。

视频 / 多模态生成是异步的:创建请求立刻返回一个任务 id,你要拿这个 id 反复轮询查询端点,直到任务到终态(成功/失败)才有产物。不要在创建请求上等结果——它不会等。

下一步

查模型 ID · 四协议对话示例 · 视频生成接入