API 文档

Gemini 调用说明

Gemini 3.5–3.8 Flash 和 Gemini 4 Argon 通过 /chat/completions 调用。Argon 的模型 ID 为 google/gemini-4-argon。GET /models 展示已公开模型；对于管理员已配置但未公开的模型，请使用管理员提供的准确模型 ID，调用地址相同。

curl "https://tokenhub.store/api/v1/chat/completions" \
  -H "Authorization: Bearer th-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "google/gemini-3.8-flash",
    "messages": [{"role": "user", "content": "Hello"}],
    "reasoning_effort": "low",
    "max_tokens": 1024,
    "stream": true
  }'

支持流式、系统指令、函数调用和 base64 图片 data URL。reasoning_effort 可选 low、medium、high；max_tokens 包含思考 token。

多轮工具调用请保留完整的 assistant 消息，包括 tool_calls.extra_content 或 content_blocks，以保留思考签名。TokenHub 暂不提供对外的 Gemini 原生端点。

Gemini Flash 和 Argon 输出用量包含思考 token；命中缓存的输入按已配置的缓存读取单价计费。公开模型价格以模型目录为准，未公开模型请向账户管理员确认价格。

Responses API 流式响应与计费

POST /v1/responses 的 response.completed 表示响应完成。收到此事件后关闭客户端连接，不会将成功请求改记为取消。

优先采用上游报告的 token 数，包括零值；仅在缺失时估算。完成前取消的请求，仍可能按已处理的 token 计费。

账户管理 API

在「设置 → 账户信息」下生成访问令牌。请求需携带 Authorization: Bearer YOUR_ACCESS_TOKEN 和 TokenHub-User: YOUR_USER_ID。也兼容 New-Api-User；同时传入两个用户 ID 请求头时，值必须一致。 打开设置

访问令牌用于账户管理；调用模型仍使用 th- 开头的 API Key。

export TOKENHUB_ACCESS_TOKEN="YOUR_ACCESS_TOKEN"
export TOKENHUB_USER_ID="YOUR_USER_ID"

curl "https://tokenhub.store/api/balance" \
  -H "Authorization: Bearer $TOKENHUB_ACCESS_TOKEN" \
  -H "TokenHub-User: $TOKENHUB_USER_ID"

curl "https://tokenhub.store/api/keys" \
  -H "Authorization: Bearer $TOKENHUB_ACCESS_TOKEN" \
  -H "TokenHub-User: $TOKENHUB_USER_ID" \
  -H "Content-Type: application/json" \
  -d '{"name":"My application","spendLimit":10}'

curl --get "https://tokenhub.store/api/v1/billing/usage" \
  -H "Authorization: Bearer $TOKENHUB_ACCESS_TOKEN" \
  -H "TokenHub-User: $TOKENHUB_USER_ID" \
  --data-urlencode "apiKeyId=YOUR_API_KEY_ID" \
  --data-urlencode "model=alibaba/qwen-turbo" \
  --data-urlencode "startDate=2026-09-07T00:00:00Z" \
  --data-urlencode "endDate=2026-09-08T00:00:00Z" \
  --data-urlencode "page=1" \
  --data-urlencode "limit=20"

用量参数：apiKeyId 是 /api/keys 返回的 id，不是 th- 密钥原文；model 精确匹配完整模型名。startDate、endDate 必须同时传入带时区的 ISO 时间，包含起止边界。page 默认 1，limit 默认 20、最大 100。summary 汇总全部符合条件的记录。省略 apiKeyId 则查询整个账户；Key 不存在或不属于当前账户时返回 404。原有 API Key 的账户级账单查询方式继续兼容。/api/usage 还兼容 start_date/end_date、单边时间范围，以及 limit（默认 100、最大 1000）和 offset（默认 0）。

创建参数：name=My application, spendLimit=10；省略 spendLimit 则使用共享钱包。PATCH 支持 name、isActive 和 action（set_limit、add_budget、clear_limit、reset_spent）；set_limit/add_budget 还需非负 value。set_limit 会清零已用额度，add_budget 对已有额度上限保留已用额度。GET /api/keys/:id 返回完整模型密钥。删除 Key 会移除它与 UsageLog 的关联；如需保留按 Key 查询历史用量，请使用 isActive:false 停用。

API Key 列表支持按名称或前缀搜索，每页显示 20 条，新建 Key 显示在第一页。若找不到其他窗口或通过 API 创建的 Key，请点击“刷新列表”。 API Keys

每个账户同时保留一个访问令牌，直到重新生成或撤销前持续有效；数据库仅保存哈希。GET/POST/DELETE /api/user/access-token 仅允许网页登录后查询状态、生成/重新生成及撤销。访问令牌不能管理自身，也不能鉴权管理员接口、修改密码、删除账户或调用模型。令牌无效或用户 ID 不匹配返回 401。原有网页登录态鉴权继续可用。