Kling 4.0

Kling 4.0 est le modèle vidéo de Kuaishou annoncé en septembre 2026. Un seul ID de modèle couvre cinq modes : texte vers vidéo, image vers vidéo avec jusqu'à 10 images clés, génération par références d'images, vidéos et audio, modification de vidéo et prolongement de vidéo. Chaque clip dure 3 à 30 secondes en 720p ou 1080p avec son stéréo. 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 fichiers multimédias sont transmis sous forme d'URL.

ID de modèle

Consultez la page du modèle pour les tarifs 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-4-0",
    "prompt": "A woman with a red umbrella walks down a neon-lit street on a rainy night, signs shimmering in the puddles, the camera tracking low beside her. 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 le résultat. Conservez les clés API dans le code côté serveur.

Paramètres

Chaque clip est livré avec son stéréo ; il n'y a pas de commutateur de son. Il n'y a pas de champ mode, negative_prompt, watermark ou multi-plan. Le schéma est strict : les champs inconnus sont rejetés plutôt qu'ignorés. callback_url n'est pas disponible ; interrogez la tâche à la place.

Modes

Le mode suit les fichiers multimédias que vous envoyez et omni_reference_task_type :

Les images clés et les références multimédias ne peuvent pas être mélangées dans une seule requête. À côté de vidéos ou d'audio de référence, image_urls ne comptent comme images de référence que avec omni_reference_task_type: "reference" ; utilisez les rôles reference_image autrement. Une video_url sans edit ou extend est rejetée.

Images clés

{
  "model": "kling-4-0",
  "prompt": "A girl walks from the window to the door, then looks back and smiles",
  "image_with_roles": [
    {"url": "https://example.com/1.png", "role": "first_frame"},
    {"url": "https://example.com/2.png", "role": "keyframe"},
    {"url": "https://example.com/3.png", "role": "last_frame"}
  ],
  "duration": 10
}

Références

{
  "model": "kling-4-0",
  "prompt": "The woman from @Image1 walks along the beach with the camera movement of @Video1",
  "image_with_roles": [{"url": "https://example.com/woman.png", "role": "reference_image"}],
  "video_urls": ["https://example.com/camera.mp4"],
  "aspect_ratio": "auto",
  "duration": 5
}

Modification

{
  "model": "kling-4-0",
  "prompt": "Change the scene to a snowy winter evening",
  "omni_reference_task_type": "edit",
  "video_url": "https://example.com/in.mp4"
}

La vidéo d'entrée doit durer au moins 3 secondes ; seules ses 30 premières secondes sont utilisées. Sans duration, la sortie suit la vidéo d'entrée.

Prolongement

{
  "model": "kling-4-0",
  "prompt": "The camera keeps moving forward as the sky grows darker",
  "omni_reference_task_type": "extend",
  "video_url": "https://example.com/in.mp4",
  "duration": 5
}

Le prolongement continue à partir de la dernière image de la vidéo d'entrée et retourne l'original plus la nouvelle partie. ajoutez last_frame_image pour choisir où elle finit.

Entrées multimédias

Les images, vidéos et audio sont des URL HTTP(S) publiques. Les URI de données base64 ne sont pas acceptées : chargez vos fichiers vers votre propre stockage et transmets leurs URL. Les images, vidéos et audio ensemble représentent au maximum 15 fichiers de référence.

Dimensions de facturation

Consulte la section tarification du modèle pour les tarifs actuels. Kling 4.0 est facturé à la seconde de vidéo, à un tarif défini par la résolution :

text, image, reference without videos:  cost = duration × standard rate
extend:                                 cost = new seconds × standard rate
edit, reference with videos:            cost = (output + max(output, input)) × video-input rate

input is the summed length of the input videos, rounded up to whole seconds and capped at 30. It is measured when the request is accepted, so the amount reserved is the amount charged. A video whose length cannot be read is rejected before anything is charged. Example: editing a 5.2-second video into a 3-second result bills 3 + 6 = 9 seconds. Failed tasks are not charged.

Schéma de sortie

La soumission retourne la tâche :

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

Récupère la tâche

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

Interroge toutes les 10 à 20 secondes jusqu'à ce que status soit completed ou failed. Un délai d'attente réseau lors de l'interrogation ne signifie pas que la génération a échoué : conservez l'identifiant de tâche et reprends la vérification. Ne crée pas une autre tâche pour vérifier la progression.

Tâche complétée

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

Lors de nos tests, des clips de 3 secondes en 720p sont revenus en MP4 (H.264) à 1280 × 720 avec une piste AAC stéréo, 2 min 41 s à 4 min 22 s après la soumission. Une vidéo étendue de 5,2 secondes est revenue 8,1 secondes.

Erreurs

Les requêtes rejetées avant la création d'une tâche retournent une erreur HTTP avec un objet error et ne sont pas facturées. Une tâche qui échoue après acceptation retourne HTTP 200 lors de la requête, avec status: "failed" et un objet error.

Consulte le catalogue d'erreurs partagé pour les codes, les statuts HTTP et les conseils de nouvelle tentative.

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

Si la soumission elle-même expire, vérifiez vos tâches avant de soumettre à nouveau : la première requête a peut-être été acceptée.

Conseils

• Décris le sujet, le lieu, le mouvement de caméra, la lumière et le son ; l'audio du clip suit le prompt.
• Brouillon à 720p, puis rend le plan final à 1080p avec la même requête.
• donnez des images clés aux clips plus longs pour que la scène se déplace où vous voulez.
• ajoutez no text, no logos pour éviter les marques inventées.

Voir aussi

• Page Kling 4.0 Playground et tarification
• Référence API Kling 3.0
• Télécharge OpenAPI
• Markdown copiable