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。原有網頁登入狀態驗證繼續可用。