XXToken API 文档

统一 AI API 接入说明、计费规则和调用示例。

Base URL https://www.xxtoken.cc/v1

充值与计费

余额换算:客户充值 1 元人民币,平台增加 $1 可用额度。平台页面中的 $ 是余额单位,可按 1$ = 1¥ 理解。

文本计费公式

文本模型按 tokens 计费:

费用 = 输入 tokens / 1,000,000 × 输入价格
     + 输出 tokens / 1,000,000 × 输出价格

图片计费公式

图片模型按生成次数计费:

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

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

模型价格

文本模型

模型输入价格输出价格单位折扣/倍率
gpt-5.5$1.00$6.00每 1M tokens官方 0.20x
gpt-5.4$0.50$3.00每 1M tokens官方 0.20x
gpt-5.4-mini$0.15$0.90每 1M tokens官方 0.20x
qwen3.7-max$8.40$25.20每 1M tokens官方 0.70x
qwen3.7-max 缓存读取$1.68-每 1M tokens官方 0.70x
qwen3.7-max 缓存创建$10.50-每 1M tokens官方 0.70x

图片模型

模型价格单位计费说明
gpt-image-2$0.10每张图片固定按次计费

鉴权方式

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

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

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

Responses API

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

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

常用参数

参数说明
model模型名,例如 gpt-5.5gpt-5.4-mini
input用户输入,可以是字符串或兼容数组结构
stream是否流式输出,truefalse

Chat Completions API

适合 OpenAI Chat 兼容客户端。

curl https://www.xxtoken.cc/v1/chat/completions \
  -H "Authorization: Bearer sk-你的平台Key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "qwen3.7-max",
    "messages": [
      {"role": "user", "content": "只回复 ok"}
    ],
    "stream": false
  }'

Python 示例

from openai import OpenAI

client = OpenAI(
    api_key="sk-你的平台Key",
    base_url="https://www.xxtoken.cc/v1"
)

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

图片生成 API

图片模型当前按张计费。

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

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

常见错误

错误原因与处理
Invalid tokenAPI Key 错误、未启用或没有带 Bearer
model not found模型名未开放、拼写错误或令牌限制了模型
insufficient quota余额不足,需要充值
model_price_error模型未配置价格,请联系管理员
429请求过快或上游限流,请降低并发后重试