Documentation de l’API ThunderPeak

Démarrage rapide

1. Inscrivez-vous sur console.thunder-peak.com et créez une clé API (sk-tp-…).
2. Pointez votre outil vers l’URL de base ci-dessous.
3. Envoyez votre première requête.

Essayez avec curl (chat compatible OpenAI) :

Astuce : consultez votre liste de modèles à tout moment avec GET /v1/models avec la même clé — le catalogue est toujours à jour et propre à chaque clé.

Protocoles et endpoints

Les trois formats partagent une clé et un solde. Les corps de requête et les réponses sont compatibles octet pour octet avec les API amont — pointez n’importe quel SDK officiel vers l’URL de base correspondante.

• Chat Completions — messages au format OpenAI, appel de fonctions, streaming via SSE. À utiliser avec les SDK OpenAI, Cherry Studio et la plupart des outils.
• Anthropic Messages — x-api-key en-tête + anthropic-version. À utiliser avec Claude Code et le SDK Anthropic.
• Responses — le protocole d’agent OpenAI moderne utilisé par Codex CLI et son extension.

Génération de vidéo

HappyHorse 1.1 génère de la vidéo à partir d’un texte, d’une image ou d’un clip de référence. Il utilise la même clé API et le même solde que vos modèles de chat.

• Interface web : ouvrez /video, collez votre clé, décrivez le plan et générez.
• API : POST /api/video/generate avec {key, model, prompt, size, duration} → renvoie un task_id ; interrogez POST /api/video/status jusqu’à state = SUCCEEDED et lisez l’ url.
• Modèles : happyhorse-1.1-t2v (texte), happyhorse-1.1-i2v (image), happyhorse-1.1-r2v (référence).
• Tarifs : 720P $0.38 par clip de 5 secondes · 1080P $0.68 par clip de 5 secondes (10s = ×2). Facturé à l’acceptation du job ; les jobs échoués sont remboursés automatiquement.
• Remarques : la génération prend généralement 1 à 3 minutes ; les liens de sortie sont temporaires, téléchargez rapidement.

Configuration des outils

Facturation et tokens

• Les crédits n’expirent jamais. Rechargez en USDT sur TRC-20 / BSC / Solana (min $10) : copiez l’adresse sur la Offres page, envoyez le virement, puis collez votre TXID de retour sur cette page — le solde est crédité automatiquement, généralement en une minute.
• Les nouveaux comptes reçoivent $2.50 de crédit d’essai gratuit après vérification de l’e-mail — testez la passerelle avant d’acheter des crédits.
• La mesure par requête couvre les tokens d’entrée, de sortie, d’écriture de cache, de lecture de cache et de raisonnement. Le streaming coûte comme le non-streaming.
• Tarifs affichés : Claude et GPT à 66 % des tarifs officiels ; DeepSeek et Kimi K3 à 88 % ; GLM-5.3 à 80 %, GLM-5.2 à 70 % ; Qwen au tarif officiel. Les remises sont une politique permanente, pas une promo.
• Votre solde et l’usage par clé sont visibles dans la console ; interrogez le solde côté serveur avec GET /v1/balance.

Vision

qwen3-vl-plus comprend les images : décrire des captures, lire des documents, OCR ou analyser des photos. Il utilise la même clé API et le même solde que vos modèles de chat.

• Format d’appel (compatible 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"}}
      ]
    }]
  }

• Tarifs : $0.32 / $1.28 par million de tokens (tarifs officiels). Les images sont facturées en tokens d’image (environ 100 à 1200 tokens par image selon la taille).
• Sources d’image : utilisez une URL accessible publiquement, ou intégrez l’image en data URL base64 (data:image/png;base64,...).
• Proxy d’images (recommandé pour les images hébergées à l’étranger) : notre région d’inférence se trouve en Chine continentale, les hébergeurs d’images à l’étranger peuvent donc expirer. Encapsulez toute URL externe avec notre proxy et cela fonctionne partout :
  https://thunder-peak.com/img-proxy?u=<URL-encoded image url>
  Exemple : https://thunder-peak.com/img-proxy?u=https%3A%2F%2Fpicsum.photos%2F400%2F300
  Le proxy récupère l’image une fois, la met en cache et la sert depuis notre domaine — moins d’une seconde aux appels répétés.

Erreurs et limites de débit

Les clés ont par défaut une limite prudente de requêtes par minute ; ajustez-la par clé dans la console. En cas de panne amont, la passerelle renvoie 5xx tandis que GET /v1/models and /healthz restent au vert — cette distinction signifie que le problème vient de l’amont, pas de votre clé.