地址与协议选择表
文档状态未标注功能状态未标注
页面类型:开始使用 | 读者:确认自己该打哪个地址、用哪种协议格式的开发者 | 预计 2 分钟 本页只负责帮你选对路径,⛔ 当配置说明——选完之后跳到对应能力的 API 参考页看完整参数。
先看你要调什么能力
| 能力 | 端点 | 协议格式 |
|---|---|---|
| 对话 | POST /v1/chat/completions | OpenAI Chat |
| 对话 | POST /v1/responses | OpenAI Responses |
| 对话 | POST /v1/messages | Anthropic Messages |
| 对话 | POST /v1/models/{model}:generateContent | Gemini |
| 图片生成 | POST /v1/images/generations | OpenAI Images |
| 视频 / 多模态生成(异步) | POST /v1/contents/generations/tasks 创建 + GET .../tasks/{id} 查询 | 火山方舟 Ark 兼容 |
| 素材库 | /v1/media/assets | 平台自有 |
| 上下文缓存 | POST /v1/caches | Gemini caches |
| 模型列表 | GET /v1/models | OpenAI |
⚠ 「支持某种协议格式」不等于「该格式的全部原生能力都透传」——每条协议实际转发/改写了哪些字段,见对应能力的 API 参考页(对话四协议差异表在准备中)。
地址怎么拼
所有能力共用同一个 Base URL(下面用 https://intertoken.ai/v1 表示,实际值以你登录后看到的为准——网页所在域名不等于 API 域名,白标合作方看到的是自己配置的地址):
完整地址 = https://intertoken.ai/v1 + 上表的端点路径
⚠ Anthropic Messages 一个例外:https://intertoken.ai/v1 本身已经带 /v1,而 Anthropic 官方 SDK/环境变量约定的 Base URL 不带 /v1(SDK 自己会拼上去)。如果你用 ANTHROPIC_BASE_URL 环境变量或 Anthropic 官方 SDK 接入(例如 Claude Code),要去掉 https://intertoken.ai/v1 末尾的 /v1 再填,否则会拼成 /v1/v1/messages 拿到 404。其余协议(OpenAI 系 / Gemini / 火山方舟兼容)直接用 https://intertoken.ai/v1 本身,不用改。
异步 vs 同步
对话、图片生成是同步的:请求发出去,响应里直接带结果。
视频 / 多模态生成是异步的:创建请求立刻返回一个任务 id,你要拿这个 id 反复轮询查询端点,直到任务到终态(成功/失败)才有产物。不要在创建请求上等结果——它不会等。
下一篇:模型 ID 规范与查询办法 —— 创建任务时 model 字段该填什么。