地址与协议选择表

文档状态未标注功能状态未标注

页面类型:开始使用 | 读者:确认自己该打哪个地址、用哪种协议格式的开发者 | 预计 2 分钟 本页只负责帮你选对路径,⛔ 当配置说明——选完之后跳到对应能力的 API 参考页看完整参数。

先看你要调什么能力

能力端点协议格式
对话POST /v1/chat/completionsOpenAI Chat
对话POST /v1/responsesOpenAI Responses
对话POST /v1/messagesAnthropic Messages
对话POST /v1/models/{model}:generateContentGemini
图片生成POST /v1/images/generationsOpenAI Images
视频 / 多模态生成(异步)POST /v1/contents/generations/tasks 创建 + GET .../tasks/{id} 查询火山方舟 Ark 兼容
素材库/v1/media/assets平台自有
上下文缓存POST /v1/cachesGemini caches
模型列表GET /v1/modelsOpenAI

⚠ 「支持某种协议格式」不等于「该格式的全部原生能力都透传」——每条协议实际转发/改写了哪些字段,见对应能力的 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 字段该填什么。

<!-- doc_status: 已发布 feature_status: 已上线 updated: 2026-09-19 -->
地址与协议选择表 · TokenPortal