API调用方式
更新时间：2026-08-18 19:43:04
TokenHub支持 OpenAI、Google Gemini、Anthropic 多种兼容格式接口。你可以把官方 SDK 的 base URL 指向 TokenHub，无需改动业务代码，即可调用 Deepseek，GLM，Kimi，Seedance，海外模型敬请期待（Claude / Gemini / GPT ）等多家模型。
-
Base URL：https://router\.253\.com/
-
鉴权：API Key（
sk-...） -
协议：同时支持 Anthropic 原生格式（
/v1/messages）、OpenAI 兼容格式（/v1/chat/completions）、OpenAI Responses API（/v1/responses，仅 GPT 系列）、Gemini 原生格式（/v1beta/models/{model}:generateContent）和图像生成（/v1/images）
Base URL 与请求头
不同格式的鉴权 Header 不同，按使用的协议选择：
可用模型
通过 GET /v1/models 实时拉取完整列表：
curl GET 'https://router.253.com/v1/models' \
-H 'Authorization: Bearer sk-xxxxxx'| DeepSeek | GLM | Kimi | MiniMax | Qwen 通义千问 | 火山 |
|---|---|---|---|---|---|
| deepseek-v4-flash | glm-5 | kimi-k2.5 | MiniMax-M2.7 | qwen3.5-plus | doubao-seedance-2.5 |
| deepseek-v4-pro | glm-5-turbo | kimi-k2.6 | MiniMax-M3 | qwen3.6-plus | doubao-seedance-2.0 |
| glm-5.1 | kimi-k2.7-code | qwen3.7-max | doubao-seedance-2.0-fast | ||
| glm-5.2 | kimi-k3 | qwen3.7-plus | doubao-seedance-2.0-mini | ||
| qwen3.8-max |
Anthropic 原生格式
端点：POST /v1/messages
基础请求
curl POST 'https://router.253.com/v1/messages' \
--header 'Authorization: Bearer sk-xxxx' \
--data-raw '{
"model": "glm-5.2",
"messages": [
{
"role": "user",
"content": "你好"
}
]
}'OpenAI 兼容格式
端点：POST /v1/chat/completions（Chat Completions）与 POST /v1/responses（Responses API，仅 GPT 系列）
Chat Completions 基础请求
curl https://router.253.com/v1/chat/completions \
-H "Authorization: Bearer sk-xxxxxx" \
-H "content-type: application/json" \
-d '{
"model": "glm-5.2",
"messages": [{"role": "user", "content": "你好"}]
}'Responses API 基础请求
curl https://router.253.com/v1/responses \
-H "Authorization: Bearer sk-xxxxx" \
-H "content-type: application/json" \
-d '{
"model": "deepseek-v4-flash",
"input": "你好"
}'/v1/responses 仅支持 GPT 系列模型，请求 Claude / Gemini 会直接返回 400。Claude 请走 /v1/messages，Gemini 请走 Gemini 原生格式。
Responses API 流式
加 "stream": true，返回 OpenAI Responses API 的标准流式事件。
curl https://router.253.com/v1/responses \
-H "Authorization: Bearer sk-xxxxx" \
-H "content-type: application/json" \
-d '{
"model": "deepseek-v4-flash",
"stream": true,
"input": "你好"
}'Gemini 原生格式
端点：POST /v1beta/models/{model}:generateContent
基础请求
curl https://router.253.com/v1beta/models/deepseek-v4-flash:generateContent \
-H "Authorization: Bearer sk-xxxxx" \
-H "content-type: application/json" \
-d '{
"contents": [
{"role": "user", "parts": [{"text": "用一句话介绍你自己"}]}
]
}'流式（SSE）
使用 streamGenerateContent，并加上 alt=sse
curl 'https://router.253.com/v1beta/models/deepseek-v4-flash:streamGenerateContent?alt=sse' \
-H "Authorization: Bearer sk-xxxxxx" \
-H "content-type: application/json" \
-d '{
"contents": [
{"role": "user", "parts": [{"text": "用一句话介绍你自己"}]}
]
}'环境变量
如果你的工具或 SDK 支持自定义 Gemini Base URL，可以按下面方式配置
export GOOGLE_GEMINI_BASE_URL="https://router.253.com"
export GEMINI_API_KEY="sk-xxxxxx"
export GEMINI_API_KEY_AUTH_MECHANISM="bearer"
不同 Gemini SDK 对自定义 endpoint 的字段名可能不同，常见名称包括 base_url、baseURL、apiEndpoint 或环境变量。核心原则：Base URL 指向 https://router.253.com, Key 使用你的 API Key。
这篇文档对您有帮助吗？
