概览
TokenLab 支持使用单个 API 密钥的三种原生 API 格式。选择最适合您用例的格式 — 无需更改配置。OpenAI 格式
/v1/chat/completions
标准格式,兼容性最广Anthropic 格式
/v1/messages
延展思维,原生 Claude 功能Gemini 格式
/v1beta/models/:model:generateContent
Google 生态系统集成为什么使用多格式?
格式比较
OpenAI 格式
这是面向已有 OpenAI SDK 集成、可移植聊天或 embeddings 的兼容路由。需要 Claude 或 Gemini 原生行为时,请使用下面的 Anthropic 或 Gemini 格式。- 通用场景
- 已有 OpenAI SDK 集成
- 最大兼容性
Anthropic 格式
原生 Anthropic Messages API。用于 Claude 特有功能,如延展思维。延展思维(Claude Opus 4.6)
仅在 Anthropic 格式可用:- Claude 特有功能
- 延展思维模式
- 原生 Anthropic SDK 用户
Gemini 格式
原生 Google Gemini API 格式,适用于 Google 生态系统集成。流式传输
- Google Cloud 集成
- 已有 Gemini SDK 代码
- 原生 Gemini 功能
/upload/v1beta/files、/v1beta/files、/v1beta/files:register 和 /v1beta/cachedContents。Files 使用兼容 Gemini File API 的上游渠道;显式 Cache 资源也可以走 Vertex AI 渠道。通过 TokenLab 创建的资源会绑定到同一个上游渠道/key,后续 generateContent 会沿用该绑定。
工具兼容边界
当目标路径支持时,函数工具可以在不同格式之间转换。提供商原生工具必须保留在对应的原生路径上:- OpenAI Responses 托管和原生工具,例如
tool_search、web_search、file_search、code_interpreter、MCP、shell/apply_patch 和 computer-use 工具,需要/v1/responses。 - Anthropic server/native 工具,例如
web_search_*、web_fetch_*、code_execution_*、tool_search_*、bash、computer-use 和 text-editor 工具,需要/v1/messages。 - Gemini 内置工具,例如
googleSearch、codeExecution、urlContext、computerUse以及类似的tools字段,需要/v1beta。
选择合适的格式
迁移指南
来自 OpenAI 官方 API
来自 Anthropic 官方 API
来自 Google AI Studio
跨模型兼容性
TokenLab 的魔力:使用 任意 SDK 访问 任意模型。网关会自动处理格式转换。任意 SDK → 任意模型
OpenAI SDK → 所有模型
行业比较
虽然跨格式在大多数功能上可行,但格式特定的功能(例如 Anthropic 的延展思维)仍然需要使用原生格式。