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。