首頁 / 文件

QuantoPort API 文件

一個閘道器,全部協議。兩分鐘從零到第一個模型呼叫。

快速開始

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

你的工具協議Base URL呼叫示例
OpenAI SDK / Chathttps://quantoport.com/v1POST /v1/chat/completions
Anthropic SDK / Messageshttps://quantoport.comPOST /v1/messages
Responses(Codex 系)https://quantoport.com/v1POST /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 分鐘;成片連結為臨時地址,請及時下載。

工具配置

Claude Code
export ANTHROPIC_BASE_URL=https://quantoport.com
export ANTHROPIC_AUTH_TOKEN=$QUANTOPORT_KEY
claude
Codex CLI
codex --config set model_provider thunderpeak
codex --config set model gpt-6-astra
# base_url https://quantoport.com/v1 · responses
Cursor
設定 → Models → OpenAI 相容:base URL https://quantoport.com/v1,Key sk-tp-…。
Cherry Studio
新增 OpenAI 相容提供商 → API 地址 https://quantoport.com/v1 → API Key → 自動拉取模型列表。
CodeWhale
# ~/.codewhale/config.toml
provider = "openai"
base_url = "https://quantoport.com/v1"
api_key = "sk-tp-…"
model = "glm-5.3" # 任意本平臺模型
開源模型優先的終端程式設計 agent,支援自定義閘道器。
Python OpenAI SDK
client = OpenAI(base_url="https://quantoport.com/v1", api_key="sk-tp-…")
VS Code 擴充套件
使用 OpenAI 相容提供商選項,貼上 base URL 與 Key;多數擴充套件自動發現模型。

計費與 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
401Key 缺失或無效檢查請求頭中的 Key
402餘額不足充值(USDT)
404端點與模型家族不匹配按協議表使用正確 base URL
429觸發該 Key 頻率限制稍候或到控制台調高限額
5xx上游廠商問題等待重試;查 /healthz

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

有疑問?Telegram @thunderpeak_support —— 中英文均可。