Kling 4.0 Flash

Kling 4.0 Flash est le modèle plus léger de la famille Kling 4.0 de Kuaishou. Sur SeedRouter, il couvre le texte vers vidéo et la génération à partir de références : jusqu'à 10 images de référence, 5 vidéos de référence et 7 éléments (sujets nommés créés à partir de 2–4 images ou d'une courte vidéo), chacun mentionné dans le prompt. Chaque clip dure 3–20 secondes en 720p avec son. 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-flash",
    "prompt": "A paper boat drifts down a rain-filled city gutter at dusk, the camera skimming the water beside it past glowing shop windows, raindrops ticking on the surface. No text, no logos.",
    "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 du son ; il n'y a pas de commutateur de son. Il n'y a pas de champs pour la première image, les images intermédiaires ou la dernière image, ni de champs negative_prompt, watermark ou voices autonome : associez une voix à un élément avec voice_url. 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.

Mentions

Chaque fichier multimédia ou élément que vous envoyez est facultatif ; sans aucun, la requête génère une vidéo à partir du texte seul. Dès que vous en envoyez, désignez-les dans le prompt :

Chaque @ suivi d'une lettre, d'un chiffre, d'un trait de soulignement ou d'un caractère chinois doit désigner un fichier multimédia ou un élément de cette requête ; sinon, la requête est rejetée avant toute facturation. La correspondance des noms commence par les plus longs, sans tenir compte de la casse. Un nom se terminant par une lettre, un chiffre ou un trait de soulignement ne peut pas être directement suivi d'un autre de ces caractères : @image_12 avec une seule image est rejeté ; écrivez @image_1 2 ou @image_1,.

Les vidéos de référence et les éléments vidéo sont limités à 5 au total, et les images, vidéos et éléments à 15 au total.

{
  "model": "kling-4-0-flash",
  "prompt": "The dancer from @image_1 performs the routine of @video_1 on a rooftop at dusk",
  "image_urls": ["https://example.com/dancer.png"],
  "video_urls": ["https://example.com/routine.mp4"],
  "keep_original_sound": false,
  "duration": 8
}

Éléments

Un élément est un sujet nommé que vous pouvez réutiliser dans le prompt. Il en existe deux types :

Les noms comportent 1–20 lettres, chiffres, traits de soulignement ou caractères chinois et sont uniques sans tenir compte de la casse. image_N, video_N, keyframe_N, object_N, audio_N, first_frame et last_frame sont réservés.

{
  "model": "kling-4-0-flash",
  "prompt": "@Mira opens the shop door and greets the morning crowd",
  "elements": [
    {
      "name": "Mira",
      "image_urls": ["https://example.com/mira-front.png", "https://example.com/mira-side.png"],
      "tag": "character",
      "description": "baker in a flour-dusted apron"
    }
  ],
  "aspect_ratio": "9:16",
  "duration": 6
}

Entrées multimédias

Les images, vidéos et fichiers 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 transmettez leurs URL. Les vidéos de référence et les éléments vidéo doivent totaliser 2–20 secondes ; leur durée est lue lors de l’acceptation de la requête, et une vidéo dont la durée ne peut pas être lue est rejetée avant toute facturation.

Dimensions de facturation

Consultez la section tarification du modèle pour les tarifs actuels. Kling 4.0 Flash est facturé à la seconde de vidéo en 720p :

text, reference images, image elements:   cost = duration × standard rate
reference videos or video elements:       cost = (output + max(output, input)) × video-input rate

input est la somme des durées des vidéos de référence et des éléments vidéo, arrondie à la seconde supérieure. Elle est mesurée lors de l’acceptation de la requête : le montant réservé est donc le montant facturé. Exemple : un clip de 5 secondes guidé par une vidéo de référence de 7,2 secondes est facturé 5 + 8 = 13 secondes ; avec une vidéo de référence de 3 secondes, il est facturé 5 + 5 = 10 secondes. Les tâches échouées ne sont pas facturées.

Schéma de sortie

La soumission retourne la tâche :

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

Récupère la tâche

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

Interrogez 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 reprenez la vérification. Ne créez pas une autre tâche pour vérifier la progression.

Tâche complétée

{
  "id": "task_...",
  "model": "kling-4-0-flash",
  "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 5 secondes sont revenus en MP4 (H.264) à 1280 × 720 avec une piste AAC stéréo, 91–103 secondes après la soumission ; le fichier dure environ une image de plus que duration (5,04 secondes pour 5).

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.

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

{
  "id": "task_...",
  "model": "kling-4-0-flash",
  "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écrivez le sujet, le lieu, le mouvement de caméra, la lumière et le son ; l'audio du clip suit le prompt.
• Utilisez Flash pour essayer à moindre coût des prompts, formats d’image et références, puis passez le plan qui fonctionne à Kling 4.0 si vous avez besoin de 1080p, d’images clés, de modification ou de prolongement.
• Donnez à un personnage récurrent un élément avec deux ou trois vues nettes plutôt qu’une seule image de référence.
• Ajoutez no text, no logos pour éviter les marques inventées.

Voir aussi

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