Kling 3.0 API

Intégrez l’API vidéo de BetterToken dans l’application de l’utilisateur.
Lisez BETTERTOKEN_API_KEY uniquement dans l’environnement ; ne l’intégrez jamais au code, aux journaux ou aux données analytiques.
Base : https://bettertoken.ai/v1
Modèle : kling-3.0.
Prompt : A rainy city street at night, slow forward camera move
Utilisez exactement le JSON de requête ci-dessous et respectez les champs et limites du modèle choisi.
POST /videos/quote avec la même requête fournit une estimation sans réservation de solde. L’authentification est obligatoire ; ce n’est pas le point d’accès public aux tarifs.
AVANT POST /videos, enregistrez hors du processus un nouvel Idempotency-Key et le corps exact. Après un redémarrage, rechargez cet état ou reprenez la tâche acceptée avec son ID enregistré. Réutilisez les deux si la réponse est incertaine ; un délai dépassé ne justifie pas une nouvelle tâche payante.
Après l’acceptation 202 sur /videos (200 sur la route de compatibilité), enregistrez id et interrogez GET /videos/{id} toutes les 5 secondes. Gérez queued, in_progress, completed, failed et canceled. Un envoi incertain reste in_progress avec stage=reconciliation ; ne créez pas de tâche de remplacement. En cas de 429, respectez Retry-After. Effectuez au maximum 360 interrogations espacées de 5 secondes ; les délais réseau et les attentes liées aux limites peuvent prolonger la durée totale. Conservez l’ID à l’arrêt ; arrêter les interrogations n’annule ni ne recrée la tâche.
Après completed, appelez GET /videos/{id}/content avec une clé API autorisée du propriétaire. Un fichier expiré renvoie 410 video_artifact_expired. Le contenu est privé ; traitez l’expiration et les problèmes de téléchargement séparément des échecs de génération.
Vérifiez le débit final dans la facturation. Un échec ou une annulation confirmé libère ou rembourse les fonds d’origine via le traitement financier ; le statut de la tâche seul ne prouve pas que le remboursement est terminé. Un envoi incertain et un problème de livraison après génération nécessitent un traitement distinct.
Les erreurs relay figurent dans error : 402 video_insufficient_balance, 409 video_idempotency_conflict/video_acceptance_pending, 422 pour les paramètres invalides et 503 pour une acceptation incertaine ou un service indisponible. Conservez la clé et le corps d’origine si la réponse est incertaine. N’ajoutez ni abonnement web ni génération dans la page.

{
  "model": "kling-3.0",
  "operation": "text_to_video",
  "prompt": "A rainy city street at night, slow forward camera move",
  "duration": {
    "mode": "fixed",
    "seconds": 5
  },
  "output": {
    "format": "mp4",
    "aspect_ratio": "16:9"
  },
  "provider_options": {
    "kling": {
      "mode": "std"
    }
  },
  "audio": {
    "mode": "off"
  }
}