ホーム / ドキュメント

ThunderPeak API ドキュメント

ひとつのゲートウェイ、すべてのプロトコル。2 分で最初のモデル呼び出しまで到達できます。

クイックスタート

1. 次で登録します: console.thunder-peak.com で API キーを作成(sk-tp-…).
2. 使用するツールを下記のベース URL に向けます。
3. 最初のリクエストを送信します。

使用ツールの形式ベース URL呼び出し例
OpenAI SDK / Chathttps://thunder-peak.com/v1POST /v1/chat/completions
Anthropic SDK / Messageshttps://thunder-peak.comPOST /v1/messages
Responses(Codex)https://thunder-peak.com/v1POST /v1/responses

curl で試す(OpenAI 互換チャット):

curl https://thunder-peak.com/v1/chat/completions \
  -H "Authorization: Bearer $THUNDERPEAK_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"claude-sonnet-5","messages":[{"role":"user","content":"Say hello in one line"}]}'

ヒント:モデル一覧はいつでも次の方法で照会できます: GET /v1/models 同じキーを使用 — カタログは常に最新で、キーごとに表示されます。

プロトコルとエンドポイント

3 つの形式はすべて 1 つのキーと 1 つの残高を共有します。リクエストとレスポンスは上流 API とバイト互換です — 公式 SDK を対応するベース URL に向けるだけです。

  • Chat Completions — OpenAI 形式のメッセージ、関数呼び出し、SSE ストリーミング。OpenAI SDK、Cherry Studio、多くのツールで使用できます。
  • Anthropic Messages — x-api-key ヘッダー + anthropic-version。Claude Code と Anthropic SDK で使用します。
  • Responses — Codex CLI と拡張機能が使う最新の OpenAI エージェントプロトコル。

サードパーティのクライアントがパスを奇妙に付加する場合は、次を追加または削除してください: /v1 (ベース URL 内) — ゲートウェイはどちらの表記も受け付け、内部で正規化します。

動画生成

HappyHorse 1.1 はテキスト、画像、参照クリップから動画を生成します。チャットモデルと同じ API キーと残高を使用します。

  • Web UI: 開く /video、キーを貼り付け、ショットを描写して生成します。
  • API: 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://thunder-peak.com
export ANTHROPIC_AUTH_TOKEN=$THUNDERPEAK_KEY
claude
Codex CLI
codex --config set model_provider thunderpeak
codex --config set model gpt-6-astra
# base_url https://thunder-peak.com/v1 · responses
Cursor
設定 → モデル → OpenAI 互換:ベース URL https://thunder-peak.com/v1、キー sk-tp-…、モデル接頭辞はオフ。
Cherry Studio
添加 OpenAI 兼容提供商 → API 地址 https://thunder-peak.com/v1 → API Key → 模型列表自动拉取。
CodeWhale
# ~/.codewhale/config.toml
provider = "openai"
base_url = "https://thunder-peak.com/v1"
api_key = "sk-tp-…"
model = "glm-5.3" # any model we serve
ターミナル用コーディングエージェント。オープンモデルを優先 — カスタムゲートウェイにも対応。
Python OpenAI SDK
client = OpenAI(base_url="https://thunder-peak.com/v1", api_key="sk-tp-…")
VS Code 拡張
OpenAI 互換プロバイダーのオプションを使い、ベース URL とキーを貼り付けます。多くの拡張はモデルを自動検出します。

課金とトークン

  • クレジットは失効しません。 TRC-20 / BSC / Solana の USDT で入金(最低 $10): 料金プラン ページでアドレスをコピーし、送金してから次を貼り付けます: TXID (そのページに戻って) — 残高は通常 1 分以内に自動で加算されます。
  • 新規アカウントは メール認証後に $2.50 の無料テストクレジットを受け取れます — クレジット購入前にゲートウェイをお試しください。
  • リクエストごとの計量は入力、出力、キャッシュ書き込み、キャッシュ読み取り、思考トークンを対象とします。ストリーミングも非ストリーミングと同じ料金です。
  • 掲載価格:Claude と GPT は公式価格の 66%、DeepSeek と Kimi K3 は 88%、GLM-5.3 は 80%、GLM-5.2 は 70%、Qwen は公式価格。 割引は恒久的な方針です — キャンペーンではありません。
  • 残高とキーごとの使用量はコンソールで確認できます。サーバー側からは次の方法で残高を照会できます: GET /v1/balance.

視覚

qwen3-vl-plus は画像を理解します:スクリーンショットの説明、文書の読み取り、OCR、写真の分析。チャットモデルと同じ API キーと残高を使用します。

  • 呼び出し形式 (OpenAI 互換):
    POST /v1/chat/completions
    {
      "model": "qwen3-vl-plus",
      "messages": [{
        "role": "user",
        "content": [
          {"type": "text", "text": "Describe this image"},
          {"type": "image_url", "image_url": {"url": "https://example.com/photo.jpg"}}
        ]
      }]
    }
  • 料金: 100 万トークンあたり $0.32 / $1.28(公式価格)。画像は画像トークンとして課金されます(サイズにより 1 枚あたり約 100〜1200 トークン)。
  • 画像ソース: 公開アクセス可能な URL を使うか、base64 データ URL として埋め込みます(data:image/png;base64,...).
  • 画像プロキシ(海外ホストの画像に推奨): 推論リージョンは中国本土にあるため、海外の画像ホストはタイムアウトする場合があります。外部 URL を当社プロキシで包めばどこでも動作します:
    https://thunder-peak.com/img-proxy?u=<URL-encoded image url>
    例: https://thunder-peak.com/img-proxy?u=https%3A%2F%2Fpicsum.photos%2F400%2F300
    プロキシは画像を 1 度取得してキャッシュし、当社ドメインから配信します — 2 回目以降は 1 秒未満です。

エラーとレート制限

ステータス意味対処
400不正なリクエスト / キーに対して未知のモデルモデル ID を次で確認: GET /v1/models
401キーが欠落または無効キーヘッダーを再確認
402残高不足入金する(USDT)
404モデル系統に対して誤ったエンドポイントプロトコル表に従って正しいベース URL を使用
429キーごとのレート制限に到達待機するか、コンソールでキー上限を引き上げる
5xx上流プロバイダーの問題待って再試行し、次を確認: /healthz

キーは既定で控えめな毎分リクエスト数上限となっています。コンソールでキーごとに増減できます。上流障害時はゲートウェイが 5xx を返しますが、 GET /v1/models and /healthz は正常のままです — この違いは問題が上流にあり、あなたのキーではないことを意味します。

ご質問は Telegram @thunderpeak_support — お使いの言語で返信します。