Utilisez Kling 3.0 Turbo via Rivya Public API v1 avec le model id kling-3-turbo, les entrées prises en charge, les paramètres, les règles Files API, les crédits et des exemples de réponse.

Disponible via APITexte ou URL prêt ; les modes de référence utilisent Files APIVidéo

ID de modèle API

kling-3-turbo

Entrées

text, file

Files API

Requis pour les modes avec référence

Crédits de base

Tarif en crédits: 18–22,5 / seconde générée Le coût final de la tâche est arrondi au crédit entier supérieur.

Capacité

Vidéo

Facturation

METERED

Limite de prompt

2500 caractères

Contrat de requête

Envoyez l'ID du modèle au niveau supérieur. Les contrôles propres au modèle vont dans params.

Clé	Type	Obligatoire	Par défaut	Description
model	string	Oui	kling-3-turbo	Utilisez kling-3-turbo comme ID de modèle API.
prompt	string	Oui	-	Maximum 2500 caractères pour ce modèle.
params	object	Non	-	Objet de paramètres propre au modèle. Consultez les lignes ci-dessous pour les clés autorisées.
client_request_id	string	Non	-	ID côté client facultatif pour tracer les requêtes dans votre système.

Paramètres du modèle

Clé	Type	Obligatoire	Par défaut	Plage	Options	Description
resolution	select	Non	720p	-	720p, 1080p	La résolution choisie détermine également le taux de crédits par seconde de sortie.
duration	number	Non	5	min 3 / max 15 / step 1	-	Choisissez une durée de sortie en secondes entières, de 3 à 15.
aspect_ratio	select	Non	16:9	-	1:1, 9:16, 16:9	Disponible uniquement en mode texte-vers-vidéo ; ce réglage est masqué lorsqu’une image est utilisée.

Règle d'importation

Importez d'abord les fichiers de référence, puis placez l'URL renvoyée et le durationToken dans params.referenceMediaItems.

Règle de référence

Image de départ facultative: Pour le mode image-vers-vidéo, importez exactement une image JPEG ou PNG de 10 MB maximum. Le mode texte-vers-vidéo n’utilise aucun média importé.

Nombre max. de fichiers

Types de fichier acceptés

image

Duration token

Les références vidéo et audio doivent inclure durationToken depuis /api/v1/files lorsqu'une vérification de durée est requise.

kind	Taille max.	Types MIME
image	10 MB	image/jpeg, image/png

Requête minimale

{
  "model": "kling-3-turbo",
  "prompt": "Une caméra tourne lentement autour d’un flacon de produit posé sur une table de studio.",
  "params": {
    "resolution": "720p",
    "duration": 5,
    "aspect_ratio": "16:9"
  }
}

Requête avec fichier de référence

{
  "model": "kling-3-turbo",
  "prompt": "Une caméra tourne lentement autour d’un flacon de produit posé sur une table de studio.",
  "params": {
    "resolution": "720p",
    "duration": 5,
    "aspect_ratio": "16:9",
    "referenceMediaItems": [
      {
        "url": "https://cdn.example.com/reference-image.png",
        "kind": "image",
        "name": "reference-image.png",
        "mimeType": "image/png",
        "width": 1024,
        "height": 1024,
        "sizeBytes": 1048576,
        "imageDimensionsToken": "image_dimensions_token_from_original_files_api_upload_response"
      }
    ]
  }
}

Réponse de création

L'endpoint de création renvoie un ID de tâche public. Interrogez l'endpoint de statut jusqu'à ce que la tâche réussisse ou échoue.

{
  "id": "task_kling_3_turbo_example",
  "status": "queued",
  "model": "kling-3-turbo",
  "reserved_credits": 90,
  "final_credits": 0,
  "settlement_status": "RESERVED",
  "created_at": "2026-05-11T00:00:00.000Z",
  "updated_at": "2026-05-11T00:00:00.000Z",
  "result": null,
  "error": null
}

Erreurs courantes

validation_failed, insufficient_credits, idempotency_conflict, rate_limited, not_found

Certains modes exigent des importations de référence via Files API.

Intégration API Kling 3.0 Turbo