Kling 3.0

Kling 3.0 est le modèle de génération vidéo de Kuaishou. Une seule requête crée un clip de 3 à 15 secondes à partir d'un prompt, ou d'une première image et d'une dernière image facultative, dans trois modes de qualité (std, pro, 4K), avec son natif quand vous le demandez. Un clip peut aussi être une séquence de cinq plans maximum, chacun avec son propre prompt et sa propre durée. 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",
    "prompt": "A red paper boat drifting on a calm pond at sunrise, soft mist on the water, slow push-in, no text, no logos.",
    "mode": "pro",
    "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

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.

Clips multi-plan

Réglez multi_shots sur true et décrivez chaque plan dans multi_prompt. Les durées des plans doivent totaliser 3 à 15 secondes ; ce total est la durée du clip, et duration n'est pas utilisé. prompt peut être omis ou servir à ce que tous les plans ont en commun.

{
  "model": "kling-3-0",
  "mode": "pro",
  "multi_shots": true,
  "multi_prompt": [
    {"prompt": "A red paper boat on a calm pond at sunrise, wide shot", "duration": 3},
    {"prompt": "The boat drifts under a small wooden bridge, low angle", "duration": 3}
  ]
}

Éléments

Un élément est un sujet que le modèle garde cohérent tout au long du clip : une personne, un produit ou un personnage. Donnez-lui un name, une courte description et 2 à 4 images de lui, puis mentionnez-le par son nom dans le prompt (par exemple @hero).

{
  "model": "kling-3-0",
  "prompt": "@hero slowly turns toward the camera in soft window light",
  "kling_elements": [
    {
      "name": "hero",
      "description": "a young woman with short black hair and a yellow raincoat",
      "element_input_urls": ["https://example.com/hero-front.png", "https://example.com/hero-side.png"]
    }
  ]
}

Entrées média

Chaque 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 des images 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 est facturé à la seconde de vidéo, à un tarif fixé par le mode et par l'activation de sound :

billed seconds = duration                      (single shot)
billed seconds = Σ multi_prompt[].duration     (multi_shots: true)
cost = billed seconds × rate per second

Les secondes facturées sont connues à 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", "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",
  "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, un clip std de 3 secondes est revenu au format MP4 (H.264) en 1280 × 720, et un clip pro de 5 secondes avec sound en 1920 × 1080 avec une piste audio, chacun en deux à trois minutes environ.

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",
  "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 ; Kling suit le langage de caméra comme « slow push-in » et « low angle ».
• Faites un brouillon en std, puis générez le plan final en pro ou en 4K avec la même requête.
• Utilisez une première et une dernière image pour contrôler où un plan commence et se termine.
• Découpez une scène en plans avec multi_prompt au lieu de décrire plusieurs coupes dans un seul prompt.
• Ajoutez no text, no logos pour éviter les marques inventées.

Ressources liées

• Playground et tarifs de Kling 3.0
• Télécharger l'OpenAPI
• Markdown copiable