API 端点

TokOne 网关同时暴露 OpenAI、Anthropic、Gemini 三套兼容协议。本页列出实际可用的端点。

通用配置

项	值
Base URL	`https://api.tokone.ai`（以你的部署域名为准）
鉴权头	`Authorization: Bearer <key>` / `x-api-key: <key>` / `x-goog-api-key: <key>`
内容类型	`application/json`
流式	请求体加 `"stream": true`，响应为 `text/event-stream`

大多数端点同时提供 /v1/... 与去掉前缀的根路径别名（如 /chat/completions），推荐统一使用带 /v1 的形式。

OpenAI 兼容端点

方法	路径	说明
POST	`/v1/chat/completions`	Chat Completions 对话补全
POST	`/v1/embeddings`	文本向量（仅当密钥所属分组平台为 OpenAI 时可用）
POST	`/v1/responses`	OpenAI Responses API
GET	`/v1/models`	模型列表
GET	`/v1/usage`	用量查询

请求/响应结构与 OpenAI 官方一致，直接使用官方 SDK 把 base_url 指向 TokOne 即可。

Anthropic 兼容端点

方法	路径	说明
POST	`/v1/messages`	Claude Messages API
GET	`/v1/models`	模型列表

示例：

bash

curl https://api.tokone.ai/v1/messages \
  -H "x-api-key: $TOKONE_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-opus-4-6",
    "max_tokens": 512,
    "messages": [{ "role": "user", "content": "Hello" }]
  }'

Gemini 兼容端点

原生 Gemini 风格，挂在 /v1beta 下，路径中以 模型:动作 表示操作：

方法	路径	说明
GET	`/v1beta/models`	模型列表
GET	`/v1beta/models/:model`	单个模型信息
POST	`/v1beta/models/{model}:generateContent`	生成内容
POST	`/v1beta/models/{model}:streamGenerateContent`	流式生成

示例：

bash

curl "https://api.tokone.ai/v1beta/models/gemini-3.5-flash:generateContent" \
  -H "x-goog-api-key: $TOKONE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "contents": [{ "parts": [{ "text": "Hello" }] }]
  }'

错误码

TokOne 沿用各兼容协议的标准 HTTP 状态码：

状态码	含义	常见原因
400	请求错误	参数缺失/格式错误；通过查询参数传 Key
401	鉴权失败	API Key 缺失、错误或被禁用
402	余额不足	账户余额不够本次调用
404	端点/模型不可用	路径写错，或该端点不适用于当前密钥的平台分组
429	触发限流	请求过于频繁，稍后重试
5xx	上游/网关错误	上游暂时不可用，建议重试

客户端示例

把任意 OpenAI 兼容 SDK 的 base_url 指向 https://api.tokone.ai/v1，把 api_key 设为你的 sk- 密钥即可，详见快速接入。

API 端点 ​

通用配置 ​

OpenAI 兼容端点 ​

Anthropic 兼容端点 ​

Gemini 兼容端点 ​

错误码 ​

客户端示例 ​