XXToken API 文档

工具配置

Codex、cc-switch、Claude Code / CCS 等客户端工具，请查看单独的工具配置文档。

充值与计费

当前计费模式

XXToken 当前采用 官方基准价 + 分组倍率 的计费方式。模型价格页面展示的是模型官方基准价，用户实际扣费会再乘以 API Key 所属分组的倍率。

实际输入费用 = 输入 tokens / 1,000,000 × 模型输入价格 × 分组倍率
实际输出费用 = 输出 tokens / 1,000,000 × 模型输出价格 × 分组倍率
最终费用 = 实际输入费用 + 实际输出费用

例如 claude-sonnet-4-5 官方基准价为输入 $3、输出 $15。如果 Key 属于 claude-kiro 分组，倍率为 0.27，则实际扣费为输入 $0.81 / 1M tokens、输出 $4.05 / 1M tokens。

图片计费公式

图片模型当前按生成次数计费：

费用 = 生成图片张数 × 单张价格

扣费以使用日志中的实际输入、输出、模型价格和分组倍率为准。请妥善保管 API Key，不要在前端网页、公开仓库或截图中泄露。

分组倍率

API Key 创建时会绑定分组。分组决定可用渠道、可用模型和最终扣费倍率。

模型价格

GPT 文本模型

Claude 文本模型

Claude 模型按分组分别开放。倍率列按 官方价格 ÷ 7 × 分组倍率 计算。

claude-kiro 分组

claude-ccmax 分组

claude-sonnet-5 当前按优惠基准价展示；如上游官方价格调整，请以后台模型定价页面为准。

图片模型

鉴权方式

所有请求都需要在请求头中携带平台分配的 API Key：

Authorization: Bearer sk-你的平台Key
Content-Type: application/json

不要使用上游供应商 Key 调用本站接口。客户只应使用 XXToken 平台生成的 Key。

Responses API

适合 GPT 5.x 和兼容 Responses 的模型。

curl https://token.niuwate.com/v1/responses \
  -H "Authorization: Bearer sk-你的平台Key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.4-mini",
    "input": "只回复 ok",
    "stream": false
  }'

Chat Completions API

适合 OpenAI Chat 兼容客户端，也可用于已开放的 Claude 普通 API 分组。

curl https://token.niuwate.com/v1/chat/completions \
  -H "Authorization: Bearer sk-你的平台Key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-sonnet-5",
    "messages": [
      {"role": "user", "content": "只回复 ok"}
    ],
    "stream": false
  }'

Python 示例

from openai import OpenAI

client = OpenAI(
    api_key="sk-你的平台Key",
    base_url="https://token.niuwate.com/v1"
)

res = client.chat.completions.create(
    model="gpt-5.4-mini",
    messages=[{"role": "user", "content": "只回复 ok"}]
)
print(res.choices[0].message.content)

图片生成 API

图片模型当前按张计费。

curl https://token.niuwate.com/v1/images/generations \
  -H "Authorization: Bearer sk-你的平台Key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2",
    "prompt": "生成一张未来科技风格的机器人头像",
    "size": "1024x1024",
    "n": 1
  }'

返回可能是图片 URL 或 base64 数据，取决于上游模型返回格式。

常见错误