跳转到主要内容

概览

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 功能
Gemini Files 和 Cache: 原生 Gemini 路径支持 /upload/v1beta/files/v1beta/files/v1beta/files:register/v1beta/cachedContents。Files 使用兼容 Gemini File API 的上游渠道;显式 Cache 资源也可以走 Vertex AI 渠道。通过 TokenLab 创建的资源会绑定到同一个上游渠道/key,后续 generateContent 会沿用该绑定。

工具兼容边界

当目标路径支持时,函数工具可以在不同格式之间转换。提供商原生工具必须保留在对应的原生路径上:
  • OpenAI Responses 托管和原生工具,例如 tool_searchweb_searchfile_searchcode_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 内置工具,例如 googleSearchcodeExecutionurlContextcomputerUse 以及类似的 tools 字段,需要 /v1beta
如果 TokenLab 无法把带原生工具的请求路由到支持原生格式的提供商路径,会返回明确的 unsupported-field 错误,而不是静默丢弃工具或伪装成 Chat Completions 函数。用户自定义函数工具仍然是最可移植的工具路径。

选择合适的格式

迁移指南

来自 OpenAI 官方 API

来自 Anthropic 官方 API

来自 Google AI Studio

跨模型兼容性

TokenLab 的魔力:使用 任意 SDK 访问 任意模型。网关会自动处理格式转换。

任意 SDK → 任意模型

OpenAI SDK → 所有模型

行业比较

虽然跨格式在大多数功能上可行,但格式特定的功能(例如 Anthropic 的延展思维)仍然需要使用原生格式。