模型 API - 模型 API-TokenCube

本文介绍如何选择 AI 网关的接入模式、配置请求地址和 API 令牌，并发送模型调用请求。

接入前的准备

发送请求前，请准备以下信息：

API 令牌（API Key）：在控制台的令牌管理中创建并获取完整密钥。令牌需处于启用状态且未过期。
模型 ID：从模型广场获取目标模型的 ID，并确认该模型已加入令牌关联的模型配置。
接入模式和接口：在目标模型的 API 示例 中确认支持的协议和接口。不同模型支持的协议、接口和参数可能不同。

配置请求地址与鉴权

网关基础地址

完整请求 URL 由网关基础地址、协议路径前缀和接口路径组成：

完整请求地址 = 网关基础地址 + 协议路径前缀 + 接口路径

网关基础地址：固定为 https://api.tokencube.net/v2/llm。
协议路径前缀：用于指定网关底层的转发协议（如 /openai、/anthropic、/gemini）。若使用 OpenAI 兼容模式，则无需填写该前缀。
接口路径：用于指定操作，例如 /chat/completions。

选择接入模式与调用协议

在实际调用时，您可以根据业务需求选择以下两种接入模式之一：

原生透传协议（OpenAI / Anthropic / Gemini，推荐）：网关会将请求直接透传至对应的大模型厂商。此模式最大化保留了各厂商原生的参数与工具能力。当目标模型同时支持以上 2 种接入方式时，推荐优先使用此模式。
OpenAI 兼容模式（统一 API）：采用标准的 OpenAI 接口格式，即可无缝调用平台接入的绝大多数主流模型（含 Claude、DeepSeek 等）。网关会在底层自动完成协议转换，大幅降低多模型的接入与切换成本。

协议与接口路径对照

下表列出常见的对话或内容生成接口，请求方法均为 POST。请先确认目标模型支持对应协议与接口。

接入模式 / 协议	协议路径前缀	接口路径
OpenAI 兼容模式	无	`/chat/completions`
OpenAI 协议	`/openai`	`/chat/completions`
Anthropic 协议	`/anthropic`	`/v1/messages`
Gemini 协议：非流式生成	`/gemini`	`/v1beta/models/{model}:generateContent`
Gemini 协议：流式生成	`/gemini`	`/v1beta/models/{model}:streamGenerateContent`

例如，OpenAI 兼容模式的对话生成接口使用以下完整 URL：

https://api.tokencube.net/v2/llm/chat/completions

接口鉴权（API Key）

网关采用标准的 Bearer Token 方式进行鉴权。在发起 HTTP 请求时，请在请求头（Header）中添加 Authorization 参数，并传入您的 API 令牌：

Authorization: Bearer <YOUR_API_KEY>

提示：若您使用 Anthropic 或 Gemini 官方 SDK 接入原生透传协议，网关同样兼容各厂商原生的鉴权请求头（如 Anthropic 的 x-api-key、Gemini 的 x-goog-api-key）。

调用示例

使用 OpenAI 兼容模式 调用 claude-sonnet-4-6 模型的完整请求示例如下（请将 <YOUR_API_KEY> 替换为您的实际密钥）：

curl https://api.tokencube.net/v2/llm/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer <YOUR_API_KEY>" \
  -d '{
    "model": "claude-sonnet-4-6",
    "messages": [
      {
        "role": "user",
        "content": "你好，请介绍一下你自己。"
      }
    ]
  }'

API接入与鉴权