Kling 3.0 Turbo

Kling 3.0 Turbo est un modèle vidéo de la famille Kling 3.0 de Kuaishou. Une seule requête crée un clip de 3 à 15 secondes avec son à partir d'un prompt, ou d'un prompt et d'une première image, en 720p ou 1080p. Envoyez la requête, conservez l'identifiant de tâche renvoyé et récupérez la vidéo terminée dans la tâche. Les images sont transmises sous forme d'URL.

ID de modèle

Consultez la page du modèle pour les prix actuels.

Exemple rapide

curl https://api.seedrouter.ai/v1/videos/generations \
  -H "Authorization: Bearer $SEEDROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "kling-3-0-turbo",
    "prompt": "A red paper boat drifting on a calm pond at sunrise, soft mist, slow push-in. No text, no logos.",
    "resolution": "720p",
    "duration": 5,
    "aspect_ratio": "16:9"
  }'

Point de terminaison

POST https://api.seedrouter.ai/v1/videos/generations

La réponse est une tâche ({"id": "task_...", "status": "processing"}), pas la vidéo terminée. Interrogez GET /v1/tasks/{task_id} pour obtenir le résultat. Gardez les clés API dans le code côté serveur.

Paramètres

Chaque clip est livré avec du son ; il n'existe aucun réglage du son. Le schéma est strict : les champs inconnus sont rejetés au lieu d'être ignorés. callback_url n'est pas disponible ; interrogez plutôt la tâche.

Image vers vidéo

Passez une première image dans first_frame_image et décrivez ce qui se passe ensuite dans prompt. Le clip s'ouvre sur l'image et en prend le format, si bien que aspect_ratio n'est pas utilisé.

{
  "model": "kling-3-0-turbo",
  "prompt": "The subject slowly turns toward the camera, soft natural light, gentle breeze.",
  "first_frame_image": "https://example.com/frame.png",
  "resolution": "1080p",
  "duration": 5
}

Entrées média

La première image est une URL HTTP(S) publique. Les data URI en base64 ne sont pas acceptées : téléversez le fichier sur votre propre stockage et transmettez son URL. Utilisez une image JPG ou PNG de 10 Mo maximum.

Facteurs de coût

Consultez la section tarifs du modèle pour les tarifs actuels. Kling 3.0 Turbo est facturé à la seconde de vidéo, à un tarif fixé par la résolution :

cost = duration × rate per second for the resolution

La durée est connue à l'acceptation de la requête, si bien que le montant réservé est le montant facturé. Consultez les frais définitifs dans l'historique d'utilisation de votre compte. Les tâches échouées ne sont pas facturées.

Schéma de sortie

L'envoi renvoie la tâche :

{"id": "task_...", "model": "kling-3-0-turbo", "status": "processing", "created_at": 1789689600}

Récupérer la tâche

GET https://api.seedrouter.ai/v1/tasks/{task_id}

Interrogez toutes les 10 à 20 secondes jusqu'à ce que status vaille completed ou failed. Un dépassement de délai réseau pendant l'interrogation ne signifie pas que la génération a échoué : conservez l'identifiant de tâche et reprenez la vérification. Ne créez pas une autre tâche pour vérifier l'avancement.

Tâche terminée

{
  "id": "task_...",
  "model": "kling-3-0-turbo",
  "status": "completed",
  "created_at": 1789689600,
  "finished_at": 1789689710,
  "output": {
    "video_url": "https://static.seedrouter.ai/media/tasks/task_example/0.mp4"
  }
}

Lors de nos tests, des clips 720p de 3 secondes sont revenus au format MP4 (H.264) en 1280 × 720 et des clips 1080p de 5 secondes en 1920 × 1080, tous avec une piste audio stéréo, entre 54 secondes et environ 5 minutes 20 secondes après l'envoi.

Erreurs

Les requêtes rejetées avant la création d'une tâche renvoient une erreur HTTP avec un objet error et ne sont pas facturées. Une tâche qui échoue après acceptation renvoie HTTP 200 lorsqu'on l'interroge, avec status: "failed" et un objet error.

Voir le catalogue d'erreurs commun pour les codes, les statuts HTTP et les conseils de reprise.

{
  "id": "task_...",
  "model": "kling-3-0-turbo",
  "status": "failed",
  "error": {
    "code": 60001,
    "message": "The request was rejected by the content policy. Please revise the prompt or input images."
  }
}

Si l'envoi lui-même dépasse le délai, vérifiez vos tâches avant de renvoyer : la première requête a peut-être été acceptée.

Conseils

• Décrivez le sujet, le lieu, le mouvement de caméra et la lumière en une phrase chacun ; le langage de caméra comme « slow push-in » et « low angle » est suivi.
• Faites un brouillon en 720p, puis générez le plan final en 1080p avec la même requête.
• Avec une première image, ne décrivez que ce qui bouge : l'image pose déjà la scène.
• Ajoutez no text, no logos pour éviter les marques inventées.

Ressources liées

• Playground et tarifs de Kling 3.0 Turbo
• Référence de l'API Kling 3.0
• Télécharger l'OpenAPI
• Markdown copiable