Tokios API 端点：OpenAI 与 Anthropic 参考指南

所有 Tokios API 请求均需发送至 https://api.tokios.com，并将您的 sk-tok-... 令牌作为 Bearer 令牌使用。Tokios 提供了 OpenAI 聊天补全、OpenAI 响应处理以及 Anthropic 消息处理功能，还支持模型列表查询与令牌计数操作。

Base URL

https://api.tokios.com

立即体验 — 无需编写任何代码即可在 console Playground 上测试任意已注册的模型。该操作基于您的登录会话执行，因此即便没有 API 密钥也能轻松试验。

身份验证机制

所有请求都必须包含以下请求头信息：

Authorization: Bearer sk-tok-YOUR_KEY
Content-Type: application/json

每个请求中的 model 字段代表您所注册的公开部署名称（例如 gemma-tunnel），而非本地模型 ID。

使用示例说明

POST/v1/chat/completionsOpenAI dialect

针对 /v1/chat/completions 的常见请求格式示例。请将 sk-tok-YOUR_KEY 与 gemma-tunnel 替换为实际值。流式传输与工具调用功能是否可用取决于底层模型是否支持。

基础用法
流式传输操作
工具调用功能
Windows 操作系统

curl https://api.tokios.com/v1/chat/completions \
  -H "Authorization: Bearer sk-tok-YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gemma-tunnel",
    "messages": [{"role": "user", "content": "What is 2 + 2?"}]
  }'

from openai import OpenAI

client = OpenAI(api_key="sk-tok-YOUR_KEY", base_url="https://api.tokios.com/v1")

resp = client.chat.completions.create(
    model="gemma-tunnel",
    messages=[{"role": "user", "content": "What is 2 + 2?"}],
)
print(resp.choices[0].message.content)

curl https://api.tokios.com/v1/chat/completions \
  -H "Authorization: Bearer sk-tok-YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gemma-tunnel",
    "messages": [{"role": "user", "content": "Write a haiku about tunnels."}],
    "stream": true
  }'

from openai import OpenAI

client = OpenAI(api_key="sk-tok-YOUR_KEY", base_url="https://api.tokios.com/v1")

stream = client.chat.completions.create(
    model="gemma-tunnel",
    messages=[{"role": "user", "content": "Write a haiku about tunnels."}],
    stream=True,
)
for chunk in stream:
    print(chunk.choices[0].delta.content or "", end="")

curl https://api.tokios.com/v1/chat/completions \
  -H "Authorization: Bearer sk-tok-YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gemma-tunnel",
    "messages": [{"role": "user", "content": "What is the weather in Paris?"}],
    "tools": [{
      "type": "function",
      "function": {
        "name": "get_weather",
        "description": "Get the current weather for a city",
        "parameters": {
          "type": "object",
          "properties": {"city": {"type": "string"}},
          "required": ["city"]
        }
      }
    }]
  }'

from openai import OpenAI

client = OpenAI(api_key="sk-tok-YOUR_KEY", base_url="https://api.tokios.com/v1")

tools = [{
    "type": "function",
    "function": {
        "name": "get_weather",
        "description": "Get the current weather for a city",
        "parameters": {
            "type": "object",
            "properties": {"city": {"type": "string"}},
            "required": ["city"],
        },
    },
}]

resp = client.chat.completions.create(
    model="gemma-tunnel",
    messages=[{"role": "user", "content": "What is the weather in Paris?"}],
    tools=tools,
)
print(resp.choices[0].message.tool_calls)

PowerShell 会从文件中读取 -d @body.json 以避免处理引号转义时的麻烦：

PowerShell

$body = '{"model":"gemma-tunnel","messages":[{"role":"user","content":"What is 2 + 2?"}]}'
Set-Content -Path body.json -Value $body -Encoding ascii
curl.exe https://api.tokios.com/v1/chat/completions `
  -H "Authorization: Bearer sk-tok-YOUR_KEY" `
  -H "Content-Type: application/json" `
  -d "@body.json"

POST/v1/chat/completionsOpenAI dialect

POST /v1/chat/completions

该接口兼容各类受支持的 OpenAI SDK。发送消息列表后即可获得由您所注册模型生成的回复内容。

请求体格式说明

string

必填

公开部署名称（例如 "gemma-tunnel"）。

array

必填

消息对象构成的数组。每个对象均包含 role（取值可为 "system"、"user" 或 "assistant"）以及 content。消息内容既可为纯文本字符串，也可由多个内容块（文本、工具调用指令、图片等）组成——Tokios 会原样传递该结构。

boolean

默认值:"false"

通过服务器推送事件机制实现响应流传输。

number

采样温度参数。数值越高则生成结果越具随机性。

integer

允许生成的最大令牌数量上限。

Example request

curl https://api.tokios.com/v1/chat/completions \
  -H "Authorization: Bearer sk-tok-YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gemma-tunnel",
    "messages": [
      {"role": "system", "content": "You are a helpful assistant."},
      {"role": "user", "content": "What is 2 + 2?"}
    ]
  }'

Response · 200

{
  "id": "chatcmpl-abc123",
  "object": "chat.completion",
  "created": 1717000000,
  "model": "gemma-tunnel",
  "choices": [
    {
      "index": 0,
      "message": { "role": "assistant", "content": "2 + 2 equals 4." },
      "finish_reason": "stop"
    }
  ],
  "usage": { "prompt_tokens": 24, "completion_tokens": 9, "total_tokens": 33 }
}

POST/v1/messagesAnthropic dialect

POST /v1/messages

该功能兼容各类受支持的 Anthropic SDK。发送消息数组后，即可收到符合 Anthropic 格式的响应。Tokios 会将该响应转换为适用于您所用模型的聊天补全格式，再传回给您。

请求体

string

必填

公共部署名称。

array

必填

消息对象数组，每个对象包含 role（即 "user" 或 "assistant"）以及 content（可为字符串或内容块数组）。

integer

必填

可生成的最大令牌数量。

string

需预先添加至对话中的系统提示内容。

boolean

默认值:"false"

通过服务器推送事件的方式流式传输响应内容。

Example request

curl https://api.tokios.com/v1/messages \
  -H "Authorization: Bearer sk-tok-YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gemma-tunnel",
    "max_tokens": 256,
    "messages": [{"role": "user", "content": "Explain async/await"}]
  }'

Response · 200

{
  "id": "msg_abc123",
  "type": "message",
  "role": "assistant",
  "content": [{ "type": "text", "text": "Async/await is a syntax for handling asynchronous operations..." }],
  "model": "gemma-tunnel",
  "stop_reason": "end_turn",
  "usage": { "input_tokens": 12, "output_tokens": 48 }
}

POST/v1/messages/count_tokensAnthropic dialect

POST /v1/messages/count_tokens

该功能兼容各类受支持的 Anthropic SDK。发送与 /v1/messages 相同的请求体即可，无需执行生成操作便能获取输入令牌的数量。

Example request

curl https://api.tokios.com/v1/messages/count_tokens \
  -H "Authorization: Bearer sk-tok-YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gemma-tunnel",
    "messages": [{"role": "user", "content": "Explain async/await"}]
  }'

Response · 200

{ "input_tokens": 12 }

POST/v1/responsesOpenAI dialect

POST /v1/responses

该功能兼容各类受支持的 OpenAI SDK，尤其适用于较新的 Responses 格式（即 OpenAI Codex 所使用的格式）。Tokios 会将其转换为适用于您所用模型的聊天补全格式。

请求体

string

必填

公共部署名称。

string | array

必填

用于生成响应的输入文本或输入项数组。

boolean

默认值:"false"

通过服务器推送事件来流式传输响应内容。

Example request

curl https://api.tokios.com/v1/responses \
  -H "Authorization: Bearer sk-tok-YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gemma-tunnel",
    "input": "Write a haiku about tunnels."
  }'

GET/v1/modelsOpenAI dialect

GET /v1/models

列出您的 API 密钥可使用的所有模型部署项。该接口与支持 OpenAI 标准的 SDK 兼容，返回格式也符合规范。

Example request

curl https://api.tokios.com/v1/models \
  -H "Authorization: Bearer sk-tok-YOUR_KEY"

Response · 200

{
  "object": "list",
  "data": [
    { "id": "gemma-tunnel", "object": "model", "owned_by": "tokios" },
    { "id": "qwen-coder", "object": "model", "owned_by": "tokios" }
  ]
}

Claude Code 的模型选择器仅显示 claude* 类型的 ID，因此无法呈现您的 Tokios 模型。您需通过 claude --model gemma-tunnel 参数显式指定所需模型，详情请参阅 Claude Code 指南。

错误代码

HTTP 状态码	错误含义
400	请求体格式有误
401	API 密钥缺失或无效
403	该令牌无权使用指定模型，或者对应账户已被暂停使用
404	未找到对应的模型部署
503	连接器处于离线状态或已达容量上限（`connector_unavailable` / `connector_busy`）

出现 503 提示说明该部署所使用的连接器当前并未连接（或已达并发上限）。请启动连接器并确认其在控制台中显示为在线状态后再尝试操作。

入门

模型

概念

参考

Tokios API 端点：OpenAI 与 Anthropic 参考指南

身份验证机制

使用示例说明

POST /v1/chat/completions

请求体格式说明

POST /v1/messages

请求体

POST /v1/messages/count_tokens

POST /v1/responses

请求体

GET /v1/models

错误代码

​身份验证机制

​使用示例说明

​POST /v1/chat/completions

​请求体格式说明

​POST /v1/messages

​请求体

​POST /v1/messages/count_tokens

​POST /v1/responses

​请求体

​GET /v1/models

​错误代码

身份验证机制

使用示例说明

POST /v1/chat/completions

请求体格式说明

POST /v1/messages

请求体

POST /v1/messages/count_tokens

POST /v1/responses

请求体

GET /v1/models

错误代码