快速開始
1. 在 console.quantoport.com 註冊並建立 API Key(sk-tp-…)。
2. 把工具指向下方的 base URL。
3. 傳送你的第一個請求。
| 你的工具協議 | Base URL | 呼叫示例 |
|---|---|---|
| OpenAI SDK / Chat | https://quantoport.com/v1 | POST /v1/chat/completions |
| Anthropic SDK / Messages | https://quantoport.com | POST /v1/messages |
| Responses(Codex 系) | https://quantoport.com/v1 | POST /v1/responses |
curl 試試(OpenAI 相容):
curl https://quantoport.com/v1/chat/completions \
-H "Authorization: Bearer $QUANTOPORT_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"claude-sonnet-5","messages":[{"role":"user","content":"Say hello in one line"}]}'
隨時用 GET /v1/models 查詢你的 Key 實時模型列表——目錄始終最新且按 Key 生效。
協議與端點
三種線上格式共用同一 Key 與同一餘額。請求體與響應與上游 API 位元組級相容——把官方 SDK 指向對應 base URL 即可。
- Chat Completions — OpenAI 格式訊息、函式呼叫、SSE 流式。適合 OpenAI SDK、Cherry Studio 及多數工具。
- Anthropic Messages — x-api-key 頭 + anthropic-version。Claude Code 與 Anthropic SDK 使用。
- Responses — 現代 OpenAI Agent 協議,Codex CLI/擴充套件使用。
第三方客戶端路徑拼寫不對時,在 base URL 增刪 /v1 即可——閘道器兩種寫法都接受並內部歸一化。
影片生成
HappyHorse 1.1 支援文生影片、圖生影片、參考生影片。與對話模型使用同一個 API 金鑰、同一個餘額。
- 網頁版:開啟 /zh/video,貼上金鑰、描述畫面即可生成。
- 介面呼叫:POST /api/video/generate,引數 {key, model, prompt, size, duration} → 返回 task_id;輪詢 POST /api/video/status 直到 state = SUCCEEDED,取 url 即為成片。
- 模型:happyhorse-1.1-t2v(文生影片)、happyhorse-1.1-i2v(圖生影片)、happyhorse-1.1-r2v(參考生影片)。
- 價格:720P 每 5 秒 $0.38 · 1080P 每 5 秒 $0.68(10 秒按 2 倍)。任務受理時扣費,生成失敗自動退回。
- 注意:生成通常 1–3 分鐘;成片連結為臨時地址,請及時下載。
工具配置
export ANTHROPIC_AUTH_TOKEN=$QUANTOPORT_KEY
claude
codex --config set model gpt-6-astra
# base_url https://quantoport.com/v1 · responses
provider = "openai"
base_url = "https://quantoport.com/v1"
api_key = "sk-tp-…"
model = "glm-5.3" # 任意本平臺模型
計費與 token
- 額度永不過期。USDT 充值支援 TRC-20 / BSC / Solana 三條鏈(最低 $10):到套餐頁複製收款地址 → 轉賬 → 在同一頁面貼上交易號 TXID,系統自動鏈上核驗併到賬,通常 1 分鐘內。
- 新賬號註冊(完成郵箱驗證)即送 $2.50 測試額度,買額度前先驗證閘道器質量。
- 按請求計量:輸入、輸出、快取寫入、快取讀取、思考 token 五類。流式與非流式同價。
- 零售價:Claude / GPT 6.6折;DeepSeek / Kimi K3;GLM-5.3 8折、GLM-5.2 7折;Qwen。折扣是長期政策而非限時促銷。
- 控制台可查餘額與每 Key 用量;服務端用 GET /v1/balance 查詢餘額。
視覺模型
qwen3-vl-plus 支援圖片理解:識別截圖、讀文件、OCR、分析照片。與對話模型共用同一個 API 金鑰和餘額。
- 呼叫格式(OpenAI 相容):
POST /v1/chat/completions { "model": "qwen3-vl-plus", "messages": [{ "role": "user", "content": [ {"type": "text", "text": "描述這張圖"}, {"type": "image_url", "image_url": {"url": "https://example.com/pic.jpg"}} ] }] } - 價格:每百萬 tokens $0.32 / $1.28(官方價)。圖片按 image tokens 計費(視尺寸約 100–1200 tokens 一張)。
- 圖片來源:可公開訪問的 URL,或 base64 內聯(data:image/png;base64,...)。
- 圖片中轉(國外圖床推薦用這個):推理節點在中國大陸,國外圖床可能超時。把任意外部圖片地址套上我們的中轉即可全球可用:
https://quantoport.com/img-proxy?u=<URL編碼後的圖片地址>
示例:https://quantoport.com/img-proxy?u=https%3A%2F%2Fpicsum.photos%2F400%2F300
中轉會下載並快取圖片,之後重複呼叫亞秒級返回。
錯誤碼與限流
| 狀態碼 | 含義 | 處理 |
|---|---|---|
| 400 | 請求格式錯誤 / 模型不在你的 Key 目錄 | 對照 GET /v1/models 檢查模型 ID |
| 401 | Key 缺失或無效 | 檢查請求頭中的 Key |
| 402 | 餘額不足 | 充值(USDT) |
| 404 | 端點與模型家族不匹配 | 按協議表使用正確 base URL |
| 429 | 觸發該 Key 頻率限制 | 稍候或到控制台調高限額 |
| 5xx | 上游廠商問題 | 等待重試;查 /healthz |
Key 預設有保守的每分鐘請求限制,可在控制台逐 Key 調整。上游中斷時閘道器返回 5xx 而 GET /v1/models 與 /healthz 保持正常——以此判斷問題在上游而非你的 Key。
有疑問?Telegram @thunderpeak_support —— 中英文均可。