Token Wallet API

基础 URL

https://www.walletfortokens.com/api/v1

下方所有接口均相对于此基础 URL。

鉴权

在 API 密钥页面 创建密钥。密钥仅在创建时显示一次，请妥善保存在密钥管理工具中。 将其作为 bearer token 放入 Authorization 请求头中发送。

curl https://www.walletfortokens.com/api/v1/chat/completions \
  -H "Authorization: Bearer tw_xxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "deepseek/deepseek-v4-flash",
    "messages": [{ "role": "user", "content": "Hello" }]
  }'

对话补全（Chat completions）

POST /chat/completions 完全兼容 OpenAI 协议：只需 model 与 messages。调用从你的 全能订阅 额度中扣减；模型 ID 见 GET /models。

{
  "model": "deepseek/deepseek-v4-flash",
  "messages": [
    { "role": "system", "content": "You are concise." },
    { "role": "user", "content": "Summarise Singapore's AI policy in 3 bullets." }
  ],
  "temperature": 0.5,
  "max_tokens": 512,
  "stream": false
}

响应为标准 OpenAI chat.completion 结构：

{
  "id": "chatcmpl-…",
  "object": "chat.completion",
  "created": 1783200000,
  "model": "deepseek/deepseek-v4-flash",
  "choices": [
    {
      "index": 0,
      "message": { "role": "assistant", "content": "…" },
      "finish_reason": "stop"
    }
  ],
  "usage": { "prompt_tokens": 24, "completion_tokens": 86, "total_tokens": 110 }
}

设置 "stream": true 可获得逐 Token 的 SSE 流式输出（标准 chat.completion.chunk 帧，以 data: [DONE] 结束）。最后一帧附带 usage 统计。

列出模型

GET /models 返回当前可用的模型及其每百万（1M）Token 的价格。

curl https://www.walletfortokens.com/api/v1/models -H "Authorization: Bearer tw_xxxxxxxxxxxx"

{
  "object": "list",
  "data": [
    {
      "id": "deepseek/deepseek-v4-flash",
      "object": "model",
      "owned_by": "ppio",
      "input_price_per_1m_tokens": 0.19,
      "output_price_per_1m_tokens": 0.37
    }
  ]
}

代码示例

Python（OpenAI 官方 SDK）：

from openai import OpenAI

client = OpenAI(base_url="https://www.walletfortokens.com/api/v1", api_key="tw_xxxxxxxxxxxx")

r = client.chat.completions.create(
    model="deepseek/deepseek-v4-flash",
    messages=[{"role": "user", "content": "Hello"}],
)
print(r.choices[0].message.content)

Node（OpenAI 官方 SDK）：

import OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://www.walletfortokens.com/api/v1",
  apiKey: "tw_xxxxxxxxxxxx",
});

const r = await client.chat.completions.create({
  model: "deepseek/deepseek-v4-flash",
  messages: [{ role: "user", content: "Hello" }],
});
console.log(r.choices[0].message.content);

图形界面客户端（Cherry Studio、LobeChat 等）：在“OpenAI 兼容”供应商设置中，Base URL 填上方基础 URL，API Key 填你的 tw_ 密钥即可。

错误

错误会返回 { "error": { "message", "type" } } 以及对应的 HTTP 状态码。

• 400输入无效——模型或供应商未知，或请求结构不匹配。
• 401缺少或无效的 API 密钥。
• 402该供应商／模型没有有效套餐，或套餐在调用中途用尽。请前往 /packs 订阅套餐。
• 403账号已被暂停，或该密钥不允许使用此模型。
• 429超出速率限制。请放慢请求并稍后重试。
• 502上游供应商错误。该次调用不会计费。

速率限制

默认：每个密钥可突发 10 次请求，并以约 0.5 次／秒的速率回补。需要更高额度？欢迎与我们联系。

安全

• 密钥在存储前会经过哈希处理——创建之后我们再也无法看到明文。
• 套餐扣减在数据库事务中执行；失败的供应商调用绝不会计费。
• 上游供应商密钥仅保存在服务器端。切勿将其暴露给浏览器。
• 一旦怀疑密钥泄露，请立即在 API 密钥页面将其吊销。