Kling V4 Flash

Contrat APIMaster de kling-v4-flash, vérifié le 2026-11-07. Canal 317 : texte, première image, références, édition et prolongation. Sortie 720p, 24 images/s, 3–20 secondes ; modèle distinct de Kling V4.

Kling V4 Flash

Points d’accès et authentification

• POST https://apimaster.ai/v1/videos
• POST https://apimaster.ai/v1/videos/generations
• GET https://apimaster.ai/v1/videos/{task_id}
• GET https://apimaster.ai/v1/videos/{task_id}/content
• GET https://apimaster.ai/v1/video-submissions/by-key

Paramètres

Utilisez JSON et Authorization: Bearer YOUR_API_KEY. model vaut kling-v4-flash. prompt obligatoire sauf avec une seule première image. duration/seconds : entiers JSON 3–20, défaut 5 ; null équivaut à absent, 0 est refusé. Les deux alias doivent être valides et égaux. Sans durée, l’édition arrondit vers le haut la durée du flux vidéo. resolution : 720p uniquement. aspect_ratio ou size : 16:9, 9:16, 1:1, 21:9 ; auto uniquement en référence. Défauts : texte 16:9, référence auto, édition selon la source. Image initiale et prolongation refusent aspect_ratio/size non vides. audio uniquement true, watermark uniquement false.

Paramètre	Type JSON	Obligatoire	Par défaut	Rôle et contraintes
model	string	Oui	kling-v4-flash	Toujours kling-v4-flash pour les cinq opérations ; kling-v4 est un autre modèle.
prompt	string	Selon le mode	—	Décrire la scène, le mouvement ou la modification. Facultatif uniquement avec une image initiale. @Image1 et @Video1 sont numérotés séparément dès 1 dans chaque tableau ; la vidéo éditée est @Video1.
duration	integer / null	Non	5	Entier JSON de 3 à 20 secondes, généralement 5. Sans les deux champs de durée, le montage arrondit à l’entier supérieur la durée du flux vidéo source ; l’extension définit le NOUVEAU segment. null signifie omis ; 0, valeurs non entières et chaînes numériques sont refusés.
seconds	integer / null	Non	—	Alias de duration, mêmes limites. Privilégier un seul champ ; si les deux sont présents, ils doivent être valides et égaux, sinon 400.
resolution	string	Non	720p	720p uniquement : niveau de qualité, sans garantir un petit côté de 720px. 1080p et le choix de qualité via mode ne sont pas pris en charge.
aspect_ratio	string	Non	Selon le mode	Texte/références/montage : 16:9, 9:16, 1:1, 21:9 ; auto uniquement en référence. Valeurs par défaut : texte 16:9, référence auto, montage selon la source. Image initiale/extension refusent les valeurs non vides ; chaîne vide = omis.
size	string	Non	—	Alias de aspect_ratio, ni résolution ni dimensions en pixels. Les deux champs doivent correspondre. Les omettre tous deux pour l’image initiale et l’extension.
image_urls	string[]	Selon le mode	—	Tableau d’URL publiques d’images. Auto accepte une image initiale ; des références uniquement visuelles exigent reference explicite. Référence/montage : ≤10 images avec les rôles reference_image. Ne pas mélanger les représentations de l’image initiale ; aucune image pour l’extension.
first_frame_image	string	Selon le mode	—	URL publique de l’unique image initiale, alternative à un élément image_urls ou au rôle first_frame. Largeur et hauteur ≥300px, ratio 2:5–5:2 ; recadrer au préalable si nécessaire.
image_with_roles	{url, role}[]	Selon le mode	—	Chaque objet exige url publique et role. first_frame pour l’unique image initiale, reference_image pour référence/montage. Pas d’image finale/intermédiaire/clé. ≤10 images de référence et ≤15 références image/vidéo au total.
video_url	string	Selon le mode	—	URL publique d’une source, avec edit/extend explicite, exclusive de video_urls. Montage : MP4/MOV, flux vidéo 3–20s, chaque dimension 700–4553px. Extension depuis la dernière image, renvoyant seulement le nouveau segment ; pas d’ID de tâche/conversation.
video_urls	string[]	Selon le mode	—	Jusqu’à 5 MP4/MOV de référence, chaque flux ≥3s, chaque dimension 700–4553px, somme ≤20s. Avec edit/extend explicite, un seul élément peut remplacer video_url. Les dépassements sont refusés, jamais tronqués ; ce tableau sélectionne automatiquement la référence.
omni_reference_task_type	string	Non	auto	auto déduit texte/image initiale/référence ; reference exige des médias de référence ; edit/extend exigent une vidéo. video_url sans mode explicite et deux images ordinaires en auto sont invalides.
audio_setting	string	Non	auto	Uniquement en référence AVEC VIDÉO. auto génère le son ; origin conserve celui de la PREMIÈRE vidéo, et l’absence de piste source produit une sortie sans piste. Omettre pour montage, extension, texte et référence d’images seules.
audio	boolean	Non	true	Booléen de compatibilité : omis ou true, false refusé. La conservation du son passe par audio_setting. Pas de fichiers audio de référence séparés.
watermark	boolean	Non	false	Booléen de compatibilité : omis ou false, true refusé. Ce n’est pas un service de suppression de filigrane sur la source.

URL HTTP(S) publiques directes sans identifiants intégrés ; ni base64, chemin local ou ID de tâche. Formats et plafonds en octets des images non spécifiés séparément. 100MiB est la limite de lecture de chaque vidéo analysée en référence/montage, pas un plafond général de téléversement.

Modes et médias

Opération	Sélection et médias requis	Valeurs par défaut et exclusions
Texte vers vidéo	Aucun média, prompt obligatoire, type auto ou omis.	5s, 16:9 ; sans audio_setting.
Image initiale vers vidéo	Une image via UNE des trois représentations ; prompt facultatif.	5s, ratio de l’image ; sans aspect_ratio/size ni image finale.
Référence vers vidéo	reference + images, rôles reference_image ou video_urls ; prompt obligatoire.	5s, auto ; images≤10, vidéos≤5, total≤15 ; option sonore seulement avec vidéo.
Montage vidéo	edit + une vidéo, prompt obligatoire ; jusqu’à 10 images de référence.	Durée source arrondie au supérieur, ratio source ; sans rôles de cadre/audio_setting.
Extension vidéo	extend + une vidéo, prompt obligatoire.	5 NOUVELLES secondes ; sans images, changement de ratio/audio_setting ; les minima taille/durée du montage/référence ne s’appliquent pas.

omni_reference_task_type : auto, reference, edit, extend. Une image image_urls, first_frame_image ou un rôle first_frame lance l’image-vers-vidéo. Plusieurs références nécessitent reference ou des rôles reference_image ; deux image_urls en auto sont refusées. video_urls sélectionne les références sauf edit/extend explicite. video_url exige edit/extend et exclut video_urls. Édition/prolongation : une vidéo. L’édition accepte des images de référence ; la prolongation refuse images/audio_setting et ne renvoie que le nouveau segment. Fournissez une URL vidéo publique, pas un ID de tâche ou de conversation.

URL HTTP(S) publiques directes sans identifiants intégrés. Maximum 10 images, 15 références image/vidéo au total. Images au moins 300×300, rapport 2:5–5:2. Jusqu’à 5 MP4/MOV, chacun au moins 3 secondes, total au plus 20 ; édition : une vidéo 3–20 secondes. Largeur ET hauteur entre 700 et 4553 pixels. Le gateway lit au plus 100 MiB par vidéo et mesure le flux vidéo, pas le conteneur/audio. Ces contrôles de taille/durée minimale ne s’appliquent pas à l’entrée de prolongation. Le fournisseur contrôle aussi les images. audio_setting=origin conserve le son de la première référence vidéo ou le silence, auto recrée le son ; seulement avec des références vidéo. L’édition recrée le son. Pas d’URL audio, dernière/intermédiaire image, keyframes, negative_prompt, mode, seed, séquences multiples ou listes de personnages/voix.

Pixels de sortie et cadence

Ratio / opération	Pixels documentés	Cadence
16:9	1280×720	24 fps
9:16	720×1280	24 fps
1:1	960×960	24 fps
21:9	1464×628	24 fps
Image initiale vers vidéo	Ratio de l’image, environ 0,92MP ; par ex. 604×1516 pour 2:5.	24 fps

Les dimensions de sortie ne sont pas les contraintes d’entrée. Le 21:9 mesure 628px de haut : il ne satisfait pas les 700px pour référence/montage ; préparer une source conforme. Ce minimum ne concerne pas l’extension. Le fichier peut durer environ une image de plus.

Exemples sans exécution

1. text

{
  "model": "kling-v4-flash",
  "prompt": "A paper boat floats along a quiet stream.",
  "duration": 3,
  "aspect_ratio": "16:9"
}

2. first_frame

{
  "model": "kling-v4-flash",
  "image_urls": [
    "https://example.com/start.png"
  ],
  "duration": 3
}

3. reference_image

{
  "model": "kling-v4-flash",
  "prompt": "Animate the scene from @Image1.",
  "omni_reference_task_type": "reference",
  "image_urls": [
    "https://example.com/style.png"
  ],
  "duration": 3
}

4. mixed_reference

{
  "model": "kling-v4-flash",
  "prompt": "Animate @Image1 with the camera movement from @Video1.",
  "omni_reference_task_type": "reference",
  "image_with_roles": [
    {
      "url": "https://example.com/subject.png",
      "role": "reference_image"
    }
  ],
  "video_urls": [
    "https://example.com/camera.mp4"
  ],
  "duration": 5,
  "aspect_ratio": "auto",
  "audio_setting": "origin"
}

5. reference_video

{
  "model": "kling-v4-flash",
  "prompt": "Follow the camera movement from @Video1.",
  "video_urls": [
    "https://example.com/input.mp4"
  ],
  "duration": 3,
  "aspect_ratio": "auto"
}

6. reference_video / origin

{
  "model": "kling-v4-flash",
  "prompt": "Follow @Video1 and preserve its original sound.",
  "video_urls": [
    "https://example.com/input.mp4"
  ],
  "audio_setting": "origin",
  "duration": 3
}

7. edit / duration

{
  "model": "kling-v4-flash",
  "prompt": "Change the light in @Video1 to sunset.",
  "omni_reference_task_type": "edit",
  "video_url": "https://example.com/input.mp4",
  "duration": 3
}

8. edit / default

{
  "model": "kling-v4-flash",
  "prompt": "Change @Video1 to a snowy scene.",
  "omni_reference_task_type": "edit",
  "video_url": "https://example.com/input.mp4",
  "image_with_roles": [
    {
      "url": "https://example.com/style.png",
      "role": "reference_image"
    }
  ]
}

9. extend

{
  "model": "kling-v4-flash",
  "prompt": "Continue the camera moving forward.",
  "omni_reference_task_type": "extend",
  "video_url": "https://example.com/input.mp4",
  "duration": 3
}

Facturation

Base officielle nominale : $0.094 par seconde produite (720P), $0.0628 par seconde facturable avec vidéo (720P-input). Texte, image, références sans vidéo et prolongation : sortie/nouveau segment. Références vidéo et édition : sortie + max(entrée, sortie). Additionnez d’abord les durées des flux entrants puis arrondissez la somme au supérieur. Entrée 3.04 s, sortie 3 s : 3+max(4,3)=7 secondes facturables. Une image supplémentaire dans le fichier ne change pas la durée entière demandée. Remises de forfait et coefficients de compte restent séparés ; consultez la carte et le montant final du journal. Un échec confirmé rembourse la réserve. Arrêter le suivi n’annule pas la tâche ; un délai réseau ambigu n’autorise pas une nouvelle génération.

input_seconds = ceil(sum(input_video_stream_seconds))
billable_seconds = output_seconds + max(input_seconds, output_seconds)

Suivi, erreurs et nouvelles tentatives

Première acceptation : HTTP 200, task_id public, queued. GET /v1/videos/{task_id} : queued/in_progress/completed/failed, unknown temporaire possible. url et metadata.url exigent Bearer ; téléchargement aussi via GET /v1/videos/{task_id}/content. Échec : error.code=generation_failed et message filtré ; paramètres invalides : HTTP 400. Idempotency-Key : 8–128 caractères ASCII visibles sans espaces. Même compte/clé/requête : HTTP 202 sans génération/réservation supplémentaire ; modification : 409. GET /v1/video-submissions/by-key lit le reçu. accepted+task_ready=true : consulter task_id ; pending/submitting ou non prêt : patienter. acceptance_unknown : conserver la clé et contacter le support, sans renvoi automatique. Un 404 ne prouve pas la non-acceptation. Conservation minimale 30 jours ; protection du gateway, sans recherche chez le fournisseur. Coût final dans le journal via other.task_id ; le suivi ne garantit pas une facture. /v1/videos/quote non pris en charge. Exemples inertes : remplacez les URL et changez de clé pour toute nouvelle opération.

{
  "id": "task_REDACTED_EXAMPLE",
  "task_id": "task_REDACTED_EXAMPLE",
  "object": "video",
  "model": "kling-v4-flash",
  "status": "queued",
  "created_at": 1794052800
}

{
  "id": "task_REDACTED_EXAMPLE",
  "task_id": "task_REDACTED_EXAMPLE",
  "object": "video",
  "model": "kling-v4-flash",
  "status": "completed",
  "progress": 100,
  "created_at": 1794052800,
  "url": "https://apimaster.ai/v1/videos/task_REDACTED_EXAMPLE/content",
  "metadata": {
    "url": "https://apimaster.ai/v1/videos/task_REDACTED_EXAMPLE/content"
  }
}

{
  "id": "task_REDACTED_EXAMPLE",
  "task_id": "task_REDACTED_EXAMPLE",
  "object": "video",
  "model": "kling-v4-flash",
  "status": "failed",
  "progress": 100,
  "created_at": 1794052800,
  "error": {
    "code": "generation_failed",
    "message": "Generation failed"
  }
}

APIMart · Kling V4 Flash · Kling AI