Start / Dokumentation

ThunderPeak-API-Dokumentation

Ein Gateway, alle Protokolle. Von null zum ersten Modellaufruf in zwei Minuten.

Schnellstart

1. Registrieren Sie sich bei console.thunder-peak.com und erstellen Sie einen API-Schlüssel (sk-tp-…).
2. Richten Sie Ihr Tool auf die untenstehende Base-URL.
3. Senden Sie Ihre erste Anfrage.

Ihr Tool spricht…Base-URLBeispielaufruf
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

Mit curl testen (OpenAI-kompatibler Chat):

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"}]}'

Tipp: Modellliste jederzeit abfragen mit GET /v1/models mit demselben Schlüssel — der Katalog ist immer aktuell und schlüsselbezogen.

Protokolle & Endpunkte

Alle drei Formate teilen einen Schlüssel und ein Guthaben. Anfragen und Antworten sind bytekompatibel mit den Upstream-APIs — richten Sie jedes offizielle SDK auf die passende Base-URL.

  • Chat Completions — Nachrichten im OpenAI-Format, Funktionsaufrufe, Streaming per SSE. Nutzbar mit OpenAI-SDKs, Cherry Studio und den meisten Tools.
  • Anthropic Messages — x-api-key -Header + anthropic-version. Nutzbar mit Claude Code und dem Anthropic-SDK.
  • Responses — das moderne OpenAI-Agent-Protokoll für Codex CLI und Erweiterung.

Hängt ein Drittanbieter-Client Pfade seltsam an, fügen Sie hinzu oder entfernen Sie /v1 in der Base-URL — das Gateway akzeptiert beide Schreibweisen und normalisiert intern.

Videogenerierung

HappyHorse 1.1 erzeugt Video aus Text, einem Bild oder einem Referenzclip. Es nutzt denselben API-Schlüssel und dasselbe Guthaben wie Ihre Chat-Modelle.

  • Web-UI: öffnen Sie /video, Schlüssel einfügen, Szene beschreiben und generieren.
  • API: POST /api/video/generate mit {key, model, prompt, size, duration} → liefert eine task_id; abfragen mit POST /api/video/status bis state = SUCCEEDED und lesen Sie die url.
  • Modelle: happyhorse-1.1-t2v (Text), happyhorse-1.1-i2v (Bild), happyhorse-1.1-r2v (Referenz).
  • Preise: 720P $0.38 pro 5-Sekunden-Clip · 1080P $0.68 pro 5-Sekunden-Clip (10s = ×2). Berechnung bei Annahme des Jobs; fehlgeschlagene Jobs werden automatisch erstattet.
  • Hinweise: die Generierung dauert meist 1–3 Minuten; Ausgabelinks sind temporär, bitte zeitnah herunterladen.

Tool-Konfiguration

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
Einstellungen → Modelle → OpenAI-kompatibel: Base-URL https://thunder-peak.com/v1, Schlüssel sk-tp-…, Modellpräfix aus.
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
Coding-Agent fürs Terminal, offene Modelle zuerst — eigene Gateways unterstützt.
Python OpenAI SDK
client = OpenAI(base_url="https://thunder-peak.com/v1", api_key="sk-tp-…")
VS-Code-Erweiterungen
Nutzen Sie die OpenAI-kompatible Anbieteroption, fügen Sie Base-URL und Schlüssel ein; viele Erweiterungen finden Modelle automatisch.

Abrechnung & Token

  • Guthaben verfällt nie. Aufladen mit USDT auf TRC-20 / BSC / Solana (min. $10): Adresse kopieren auf der Tarife Seite, Überweisung senden, dann einfügen: TXID auf derselben Seite — das Guthaben wird automatisch gutgeschrieben, meist innerhalb einer Minute.
  • Neue Konten erhalten nach der E-Mail-Verifizierung $2.50 Testguthaben gratis — testen Sie das Gateway vor dem Kauf.
  • Die Messung pro Anfrage umfasst Eingabe-, Ausgabe-, Cache-Schreib-, Cache-Lese- und Thinking-Token. Streaming kostet wie ohne Streaming.
  • Listenpreise: Claude und GPT zu 66% der offiziellen Preise; DeepSeek und Kimi K3 zu 88%; GLM-5.3 zu 80%, GLM-5.2 zu 70%; Qwen zum offiziellen Preis. Rabatte sind Grundsatz, keine Aktion.
  • Guthaben und Nutzung pro Schlüssel sind in der Konsole sichtbar; serverseitig abfragen mit GET /v1/balance.

Vision

qwen3-vl-plus versteht Bilder: Screenshots beschreiben, Dokumente lesen, OCR oder Fotos analysieren. Nutzt denselben API-Schlüssel und dasselbe Guthaben wie Ihre Chat-Modelle.

  • Aufrufformat (OpenAI-kompatibel):
    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"}}
        ]
      }]
    }
  • Preise: $0.32 / $1.28 pro 1 Mio. Token (offizielle Preise). Bilder werden als Bild-Token abgerechnet (rund 100–1200 Token pro Bild je nach Größe).
  • Bildquellen: nutzen Sie eine öffentlich erreichbare URL oder betten Sie das Bild als Base64-Data-URL ein (data:image/png;base64,...).
  • Bildproxy (empfohlen für im Ausland gehostete Bilder): unsere Inferenzregion liegt in Festlandchina, daher können ausländische Bildhosts in Timeouts laufen. Verpacken Sie jede externe URL mit unserem Proxy — dann funktioniert sie überall:
    https://thunder-peak.com/img-proxy?u=<URL-encoded image url>
    Beispiel: https://thunder-peak.com/img-proxy?u=https%3A%2F%2Fpicsum.photos%2F400%2F300
    Der Proxy holt das Bild einmal, cached es und liefert es über unsere Domain — bei Wiederholungen unter einer Sekunde.

Fehler & Ratenlimits

StatusBedeutungAktion
400Fehlerhafte Anfrage / unbekanntes Modell für Ihren SchlüsselModell-ID prüfen unter GET /v1/models
401Schlüssel fehlt oder ist ungültigSchlüssel-Header prüfen
402Guthaben unzureichendAufladen (USDT)
404Falscher Endpunkt für die ModellfamilieKorrekte Base-URL laut Protokolltabelle verwenden
429Ratenlimit pro Schlüssel erreichtZurückhalten oder Schlüssellimit in der Konsole erhöhen
5xxProblem beim Upstream-AnbieterWarten und erneut versuchen; prüfen Sie /healthz

Schlüssel haben standardmäßig ein konservatives Limit pro Minute; in der Konsole pro Schlüssel anpassbar. Bei Upstream-Ausfällen liefert das Gateway 5xx, während GET /v1/models and /healthz grün bleiben — diese Unterscheidung bedeutet: das Problem liegt upstream, nicht bei Ihrem Schlüssel.

Fragen? Telegram @thunderpeak_support — wir antworten in Ihrer Sprache.