QuantoPort API 文件

快速開始

1. 在 console.quantoport.com 註冊並建立 API Key（sk-tp-…）。
2. 把工具指向下方的 base URL。
3. 傳送你的第一個請求。

curl 試試（OpenAI 相容）：

隨時用 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/擴充套件使用。

影片生成

HappyHorse 1.1 支援文生影片、圖生影片、參考生影片。與對話模型使用同一個 API 金鑰、同一個餘額。

• 網頁版：開啟 /zh/video，貼上金鑰、描述畫面即可生成。
• 介面呼叫： POST /v1/videos，引數 {model, prompt, resolution, seconds, image_url}，標頭 Authorization: Bearer <金鑰>（介面網址 https://console.quantoport.com）→ 回傳 id；輪詢 GET /v1/videos/{id} 直到 status = completed，再從 GET /v1/videos/{id}/content 下載成片。
• 模型：happyhorse-1.1-t2v（文生影片）、happyhorse-1.1-i2v（圖生影片）、happyhorse-1.1-r2v（參考生影片）。
• 價格： 480P/720P $0.35（每 5 秒，10 秒按 2 倍）。任務受理時扣費，生成失敗自動退回。
• 解析度 請務必明確帶上 resolution（480P / 720P / 1080P）。未帶或帶錯時，上游會以 1080P 出片，並依 1080P 計費。
• 注意：生成通常 1–3 分鐘；成片連結為臨時地址，請及時下載。

工具配置

計費與 token

• 額度永不過期。USDT 儲值支援 TRC-20 / BSC / Solana 三條鏈（最低 $10）：到套餐頁複製收款地址 → 轉賬 → 在同一頁面貼上交易號 TXID，系統自動鏈上核驗併到賬，通常 1 分鐘內。
• 新賬號註冊（完成郵箱驗證）即送 測試額度，買額度前先驗證閘道器質量。
• 按請求計量：輸入、輸出、快取寫入、快取讀取、思考 token 五類。流式與非流式同價。
• 零售價：Claude / GPT、DeepSeek、Kimi K3、Qwen 官方價；GLM-5.3 8.5折。折扣是長期政策而非限時促銷。
• 控制台可查餘額與每 Key 用量；服務端用 GET /v1/balance 查詢餘額。

帳戶 API

用自己的程式查餘額——用你現有的 API key 即可，不需要另外申請權杖。唯讀介面，可放心輪詢（例如每 5 分鐘一次）做自己的告警。

• 查餘額：GET /v1/balance，請求標頭帶 Authorization: Bearer sk-tp-…，回傳帳戶餘額（美元）、今日 / 近 7 日 / 近 30 日消耗、該 Key 自身的剩餘額度與到期時間、儲值入口。
• 主要欄位：balance_usd、usage.today_usd、usage.last_7d_usd、usage.last_30d_usd、key.remaining_usd、key.expires_at、is_available。
• Key 缺失 / 被停用 / 已過期會回傳 401 / 403 與錯誤碼，方便接你自己的監控。
• 寫入操作（新建 Key、按模型用量、儲值紀錄）都在控制台裡。
• 餘額快用完時我們會自動寄信提醒（低於你近期日均消耗的約三天用量即觸發），不需要你自己盯著輪詢。

視覺模型

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.2 / $1.6。圖片按 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
  中轉會下載並快取圖片，之後重複呼叫亞秒級返回。

錯誤碼與限流

Key 預設有保守的每分鐘請求限制，可在控制台逐 Key 調整。上游中斷時閘道器返回 5xx 而 GET /v1/models 與 /healthz 保持正常——以此判斷問題在上游而非你的 Key。