Que fait Génération de Vidéos Kling ?
Générez des vidéos IA via l'API Kuaishou Kling d'AceDataCloud.
Configuration : Voir authentification pour la configuration du jeton.
Démarrage Rapide
curl -X POST https://api.acedata.cloud/kling/videos \
-H "Authorization: Bearer $ACEDATACLOUD_API_TOKEN" \
-H "Content-Type: application/json" \
-d '{"action": "text2video", "prompt": "un chat jouant du piano sur un toit au coucher du soleil", "model": "kling-v3", "mode": "std", "duration": 5}'
Asynchrone : Voir interrogation des tâches asynchrones. Interrogez via
POST /kling/tasksavec{"id": "..."}.
Modèles
| Modèle | Qualité | Utilisation Optimale |
|---|---|---|
kling-v3 | Dernier | Meilleure qualité, durée flexible 3–15s, génération audio optionnelle |
kling-v3-omni | Dernier | Modèle Omni avec support audio, durée flexible 3–15s |
kling-v2-6 | Élevée | Sortie de haute qualité avec audio optionnel (mode pro) |
kling-v2-5-turbo | Élevée + Rapide | Meilleur rapport vitesse/qualité |
kling-v2-master | Élevée | Sortie de haute qualité |
kling-v2-1-master | Élevée | v2 amélioré |
kling-v1-6 | Améliorée | Qualité meilleure que v1 |
kling-v1 | Standard | Génération de base, coût le plus bas |
kling-video-o1 | Premium | Plus haute qualité (modèle de réflexion) |
Modes de Qualité
| Mode | Vitesse | Coût | Utilisation |
|---|---|---|---|
std (Standard) | Plus lent | Inférieur | Brouillon/aperçu |
pro (Professionnel) | Plus rapide | Supérieur | Sortie finale |
4k (4K Natif) | — | Premium | Sortie 4K native — seulement kling-v3 et kling-v3-omni ; incompatible avec camera_control |
Flux de Travail
1. Texte-vers-Vidéo
POST /kling/videos
{
"action": "text2video",
"prompt": "une ville futuriste avec des voitures volantes",
"model": "kling-v3",
"mode": "std",
"duration": 5,
"aspect_ratio": "16:9"
}
2. Image-vers-Vidéo
Animer une image fixe. Optionnellement, spécifier une image de fin.
POST /kling/videos
{
"action": "image2video",
"prompt": "la scène prend vie lentement avec du mouvement",
"start_image_url": "https://example.com/scene.jpg",
"end_image_url": "https://example.com/end-scene.jpg",
"model": "kling-v3",
"mode": "pro"
}
3. Extension de Vidéo
Continuer une vidéo existante avec des secondes supplémentaires.
POST /kling/videos
{
"action": "extend",
"video_id": "id-video-existante",
"prompt": "la caméra recule pour révéler le paysage complet",
"model": "kling-v2-5-turbo"
}
4. Contrôle de Mouvement
Appliquer un contrôle précis de la caméra/du mouvement à partir d'une image + d'une vidéo de référence.
POST /kling/motion
{
"image_url": "https://example.com/sujet.jpg",
"video_url": "https://example.com/reference-mouvement.mp4"
}
5. Synchronisation Labiale (Lip Sync)
Créer une vidéo synchronisée labialement à partir d'une vidéo source plus une piste audio ou un texte saisi.
POST /kling/lip-sync
{
"video_url": "https://example.com/source.mp4",
"mode": "audio2video",
"audio_url": "https://example.com/voix-off.mp3"
}
Paramètres
| Paramètre | Valeurs | Description |
|---|---|---|
action | "text2video", "image2video", "extend" | Mode de génération |
model | Voir tableau des modèles | Modèle à utiliser |
mode | "std", "pro", "4k" | Mode de qualité (4k seulement pour kling-v3 / kling-v3-omni, incompatible avec camera_control) |
duration | 5, 10 (v3/v3-omni : 3–15) | Durée en secondes |
generate_audio | true, false | Générer l'audio avec la vidéo (v3, v3-omni, v2-6 pro uniquement) |
aspect_ratio | "16:9", "9:16", "1:1" | Format d'écran de la vidéo |
cfg_scale | 0–1 | Force de pertinence de la consigne |
negative_prompt | chaîne | Ce qu'il faut éviter dans la vidéo |
camera_control | objet | Paramètres de mouvement de la caméra |
element_list | tableau | Sujets de référence de la bibliothèque d'éléments (chaque élément a element_id). Combiné avec video_list, le total des images de référence + sujets ≤ 7 (ou ≤ 4 si une vidéo de référence est incluse) |
video_list | tableau | Vidéo(s) de référence via video_url (MP4/MOV, 3–10s, ≤200 Mo, max 1 vidéo). Chaque élément a video_url, refer_type ("feature" ou "base"), et keep_original_sound optionnel |
callback_url | chaîne | URL de rappel asynchrone |
mode (/kling/lip-sync) | "audio2video", "text2video" | Mode de synchronisation labiale |
video_url (/kling/lip-sync) | URL | URL de la vidéo source pour la synchronisation labiale |
video_id (/kling/lip-sync) | chaîne | ID de vidéo Kling existante pour la synchronisation labiale |
audio_url (/kling/lip-sync) | URL | URL de la source audio (pour audio2video) |
audio_type (/kling/lip-sync) | "url", "file" | Type d'entrée audio (défaut url) |
audio_file (/kling/lip-sync) | chaîne | Charge utile du fichier audio lorsque audio_type=file |
text (/kling/lip-sync) | chaîne | Texte à synthétiser en parole (pour text2video) |
voice_id (/kling/lip-sync) | chaîne | Identifiant de la voix prédéfinie utilisée dans text2video |
voice_language (/kling/lip-sync) | "zh", "en" | Langue TTS pour text2video (défaut zh) |
voice_speed (/kling/lip-sync) | nombre | Vitesse de parole TTS (défaut 1.0) |
Points d'Attention
durationprend en charge5ou10secondes pour la plupart des modèles ;kling-v3etkling-v3-omniprennent en charge une durée flexible3–15secondesmode=4kest disponible uniquement pourkling-v3etkling-v3-omniet est incompatible aveccamera_controlgenerate_audioactive la génération audio synchronisée (prise en charge parkling-v3,kling-v3-omnietkling-v2-6en mode pro)end_image_urlest uniquement pour l'actionimage2video— elle définit la dernière image- Le contrôle de mouvement (
/kling/motion) est un endpoint séparé de la génération vidéo - La synchronisation labiale est un endpoint séparé (
/kling/lip-sync) et nécessitemode; utilisezaudio_urlpouraudio2videooutext+ champs vocaux pourtext2video - Le mode
procoûte environ 2x le modestdmais génère plus rapidement avec une meilleure qualité - Les états des tâches utilisent
"succeed"(pas "succeeded") — vérifiez cette valeur lors de l'interrogation negative_promptaide à éviter les éléments indésirables (ex : "flou, basse qualité, texte")