ThunderPeak API 文档

快速开始

1. 在 console.thunder-peak.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 /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 分钟；成片链接为临时地址，请及时下载。

工具配置

计费与 token

• 额度永不过期。USDT 充值支持 TRC-20 / BSC / Solana 三条链（最低 $10）：到套餐页复制收款地址 → 转账 → 在同一页面粘贴交易号 TXID，系统自动链上核验并到账，通常 1 分钟内。
• 新账号注册（完成邮箱验证）即送 $2.50 测试额度，买额度前先验证网关质量。
• 按请求计量：输入、输出、缓存写入、缓存读取、思考 token 五类。流式与非流式同价。
• 零售价：Claude / GPT 官方价 6.6 折；DeepSeek / Kimi K3 8.8 折；GLM-5.3 八折、GLM-5.2 七折；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://thunder-peak.com/img-proxy?u=<URL编码后的图片地址>
  示例：https://thunder-peak.com/img-proxy?u=https%3A%2F%2Fpicsum.photos%2F400%2F300
  中转会下载并缓存图片，之后重复调用亚秒级返回。

错误码与限流

Key 默认有保守的每分钟请求限制，可在控制台逐 Key 调整。上游中断时网关返回 5xx 而 GET /v1/models 与 /healthz 保持正常——以此判断问题在上游而非你的 Key。