API 文档

TokShop 提供 OpenAI 兼容 API。Base URL: https://tokshop.xyz/v1

1. 获取 API Key

注册并充值后,在控制台创建 Key。Key 形如 sk-tok-...,仅在创建时展示一次。

2. 查询模型列表

curl https://tokshop.xyz/v1/models

公开接口,返回模型 ID、上下文长度和每百万 token 的美元价格。

3. 对话补全

curl https://tokshop.xyz/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-tok-YOUR_KEY" \
  -d '{
    "model": "deepseek-v3.2",
    "messages": [{"role": "user", "content": "Hello!"}]
  }'

使用官方 OpenAI Python SDK:

from openai import OpenAI

client = OpenAI(
    base_url="https://tokshop.xyz/v1",
    api_key="sk-tok-YOUR_KEY",
)

resp = client.chat.completions.create(
    model="deepseek-v3.2",
    messages=[{"role": "user", "content": "Hello!"}],
)
print(resp.choices[0].message.content)

4. 流式输出

设置 stream: true,返回 Server-Sent Events,格式与 OpenAI 完全一致。

resp = client.chat.completions.create(
    model="deepseek-v3.2",
    messages=[{"role": "user", "content": "Hello!"}],
    stream=True,
)
for chunk in resp:
    print(chunk.choices[0].delta.content or "", end="")

5. 计费说明

• 预付美元余额,每次请求从余额中扣除。
• 费用 = 输入 token 数 × 输入单价 / 1M + 输出 token 数 × 输出单价 / 1M。
• 余额耗尽后请求返回 402 insufficient_balance.
• 每次调用均有日志,可在控制台随时审计。

错误码

• 401 - API Key 缺失或无效
• 402 - 余额不足
• 404 - 未知模型

技术支持

使用问题、发票或企业批量采购,请邮件联系,一个工作日内回复: mingxinai@agentmail.to / 13426086861@139.com