Skip to content

Omni-Video

POST
/kling/v1/videos/omni-video

Créer une tâche Omni-Video (texte vers vidéo, image vers vidéo, édition vidéo, etc.).

Authorizations

bearer
Type
HTTP (bearer)

Request Body

application/json
object

Nom du modèle. Valeurs : kling-video-o1, kling-v3-omni

Invite textuelle ; peut inclure des descriptions positives et négatives.
Les invites peuvent être modélisées selon le besoin.
Jusqu'à 2500 caractères.
Obligatoire si multi_shot est false.

object[]

Liste d'images de référence (sujet, scène, style, etc.) ou première/dernière image de la vidéo.
Pour la première/dernière image :
type : first_frame (première), end_frame (dernière).
Dernière seule non prise en charge ; si end_frame est défini, first_frame est requis.
Première/dernière image incompatible avec l'édition vidéo.

object[]

Vidéo de référence par URL.
Peut être une vidéo de référence (feature) ou à éditer (base, par défaut) ; audio d'origine optionnel.
refer_type : feature = référence, base = à éditer.
Avec base, pas de première/dernière image.
keep_original_sound : yes = conserver, no = supprimer ; s'applique aussi à feature.

Mode de génération.
Valeurs : std, pro.
std : mode standard, bon rapport qualité/prix.
pro : mode haute qualité.

Format (largeur:hauteur).
Valeurs : 16:9, 9:16, 1:1.
Obligatoire sans première image ni édition vidéo.

Durée en secondes.
Valeurs : 3, 4, 5, 6, 7, 8, 9, 10.
Texte/image première image : seulement 5 et 10.
Édition (refer_type base) : durée = vidéo d'entrée, champ ignoré ; facturation sur durée arrondie.
kling-v3-omni : 3–15 ; mêmes règles en édition.

object[]

Sujets

Vidéo multi-plans.
Si true, prompt ignoré.
Si false, shot_type et multi_prompt ignorés.

Mode de découpage.
Valeur : customize.
Obligatoire si multi_shot est true.

object[]

Détails par plan (invite, durée).
index, prompt, duration :
jusqu'à 6 plans, minimum 1 ;
contenu par plan ≤ 512 caractères ;
durée du plan entre 1 et la durée totale ;
somme des durées = durée totale de la tâche.

object

Générer aussi une version filigranée.
Via enabled, ex. :
"watermark_info": { "enabled": true }
true = oui, false = non.

Générer l'audio avec la vidéo.
Valeurs : on, off.

Responses

OK

application/json
object

ID de tâche

Statut de la tâche

Playground

Authorization
Body

Samples