地址与协议选择表
按客户端或 API 的协议选择 Base URL。直接发 HTTP 请求时使用下表的完整路径,使用 SDK 时让 SDK 追加对应的路径。
先看你要调什么能力
| 协议 | SDK Base URL | HTTP 请求路径 |
|---|---|---|
| OpenAI Chat | https://intertoken.ai/v1 | POST /v1/chat/completions |
| OpenAI Responses | https://intertoken.ai/v1 | POST /v1/responses |
| Anthropic Messages / Claude Code | https://intertoken.ai | POST /v1/messages |
| Gemini | https://intertoken.ai/v1 | POST /v1/models/{model}:generateContent |
| OpenAI Images | https://intertoken.ai/v1 | POST /v1/images/generations |
| TokenPortal 视频生成 | https://intertoken.ai/v1 | POST /v1/contents/generations/tasks |
| 火山方舟兼容(Seedance) | https://intertoken.ai/api/v3 | POST /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/v1 | POST /v1/caches |
| 模型列表 | https://intertoken.ai/v1 | GET /v1/models |
地址怎么拼
直接发 HTTP 请求时把完整路径接到 https://intertoken.ai。例如查询模型:
终端命令
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 反复轮询查询端点,直到任务到终态(成功/失败)才有产物。不要在创建请求上等结果——它不会等。