クイックスタート
1. 次で登録します: console.thunder-peak.com で API キーを作成(sk-tp-…).
2. 使用するツールを下記のベース URL に向けます。
3. 最初のリクエストを送信します。
| 使用ツールの形式 | ベース URL | 呼び出し例 |
|---|---|---|
| OpenAI SDK / Chat | https://thunder-peak.com/v1 | POST /v1/chat/completions |
| Anthropic SDK / Messages | https://thunder-peak.com | POST /v1/messages |
| Responses(Codex) | https://thunder-peak.com/v1 | POST /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 分かかります。出力リンクは一時的なので速やかにダウンロードしてください。
ツール設定
export ANTHROPIC_AUTH_TOKEN=$THUNDERPEAK_KEY
claude
codex --config set model gpt-6-astra
# base_url https://thunder-peak.com/v1 · responses
provider = "openai"
base_url = "https://thunder-peak.com/v1"
api_key = "sk-tp-…"
model = "glm-5.3" # any model we serve
課金とトークン
- クレジットは失効しません。 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 — お使いの言語で返信します。