Kling Video-Generierung
Generiere KI-Videos über die Kuaishou Kling-API von AceDataCloud.
Einrichtung: Siehe Authentifizierung für die Token-Einrichtung.
Schnellstart
curl -X POST https://api.acedata.cloud/kling/videos \
-H "Authorization: Bearer $ACEDATACLOUD_API_TOKEN" \
-H "Content-Type: application/json" \
-d '{"action": "text2video", "prompt": "a cat playing piano on a rooftop at sunset", "model": "kling-v3", "mode": "std", "duration": 5}'
Asynchron: Siehe async task polling. Abfragen via
POST /kling/tasksmit{"id": "..."}.
Modelle
| Modell | Qualität | Am besten geeignet für |
|---|---|---|
kling-v3 | Neueste | Beste Qualität, flexible 3–15s Dauer, optionale Audio-Generierung |
kling-v3-omni | Neueste | Omni-Modell mit Audio-Unterstützung, flexible 3–15s Dauer |
kling-v2-6 | Hoch | Hochwertige Ausgabe mit optionalem Audio (Pro-Modus) |
kling-v2-5-turbo | Hoch + Schnell | Bester Kompromiss zwischen Geschwindigkeit und Qualität |
kling-v2-master | Hoch | Hochwertige Ausgabe |
kling-v2-1-master | Hoch | Verbessertes v2 |
kling-v1-6 | Verbessert | Bessere Qualität als v1 |
kling-v1 | Standard | Einfache Generierung, niedrigste Kosten |
kling-video-o1 | Premium | Höchste Qualität (Denkmodell) |
Qualitätsmodi
| Modus | Geschwindigkeit | Kosten | Verwenden für |
|---|---|---|---|
std (Standard) | Langsamer | Niedriger | Entwurf/Vorschau |
pro (Professional) | Schneller | Höher | Endausgabe |
4k (Native 4K) | — | Premium | Native 4K-Ausgabe – nur kling-v3 und kling-v3-omni; inkompatibel mit camera_control |
Workflows
1. Text-zu-Video
POST /kling/videos
{
"action": "text2video",
"prompt": "a futuristic city with flying cars",
"model": "kling-v3",
"mode": "std",
"duration": 5,
"aspect_ratio": "16:9"
}
2. Bild-zu-Video
Belebt ein Standbild. Optional kann ein Endbild angegeben werden.
POST /kling/videos
{
"action": "image2video",
"prompt": "the scene slowly comes alive with movement",
"start_image_url": "https://example.com/scene.jpg",
"end_image_url": "https://example.com/end-scene.jpg",
"model": "kling-v3",
"mode": "pro"
}
3. Video verlängern
Führt ein bestehendes Video mit zusätzlichen Sekunden fort.
POST /kling/videos
{
"action": "extend",
"video_id": "existing-video-id",
"prompt": "the camera pulls back to reveal the full landscape",
"model": "kling-v2-5-turbo"
}
4. Bewegungskontrolle
Wendet präzise Kamera-/Bewegungskontrolle aus einem Bild + Referenzvideo an.
POST /kling/motion
{
"image_url": "https://example.com/subject.jpg",
"video_url": "https://example.com/motion-reference.mp4"
}
5. Lippen-Synchronisation
Erstellt ein lippensynchrones Video aus einem Quellvideo sowie entweder einer Audiospur oder einem Eingabetext.
POST /kling/lip-sync
{
"video_url": "https://example.com/source.mp4",
"mode": "audio2video",
"audio_url": "https://example.com/voiceover.mp3"
}
Parameter
| Parameter | Werte | Beschreibung |
|---|---|---|
action | "text2video", "image2video", "extend" | Generierungsmodus |
model | Siehe Modelle-Tabelle | Zu verwendendes Modell |
mode | "std", "pro", "4k" | Qualitätsmodus (4k nur für kling-v3 / kling-v3-omni, inkompatibel mit camera_control) |
duration | 5, 10 (v3/v3-omni: 3–15) | Dauer in Sekunden |
generate_audio | true, false | Audio zusammen mit Video generieren (nur v3, v3-omni, v2-6 pro) |
aspect_ratio | "16:9", "9:16", "1:1" | Video-Seitenverhältnis |
cfg_scale | 0–1 | Stärke der Prompt-Relevanz |
negative_prompt | string | Was im Video vermieden werden soll |
camera_control | object | Kamerabewegungsparameter |
element_list | array | Referenzsubjekte aus der Elementbibliothek (jeder Eintrag hat element_id). Kombiniert mit video_list: Gesamtanzahl Referenzbilder + Subjekte ≤ 7 (oder ≤ 4, wenn ein Referenzvideo enthalten ist) |
video_list | array | Referenzvideo(s) über video_url (MP4/MOV, 3–10s, ≤200MB, max. 1 Video). Jeder Eintrag hat video_url, refer_type ("feature" oder "base") und optional keep_original_sound |
callback_url | string | Async-Callback-URL |
mode (/kling/lip-sync) | "audio2video", "text2video" | Lippen-Synchronisationsmodus |
video_url (/kling/lip-sync) | URL | Quellvideo-URL für Lippen-Synchronisation |
video_id (/kling/lip-sync) | string | Vorhandene Kling-Video-ID für Lippen-Synchronisation |
audio_url (/kling/lip-sync) | URL | Audioquellen-URL (für audio2video) |
audio_type (/kling/lip-sync) | "url", "file" | Audio-Eingabetyp (Standard url) |
audio_file (/kling/lip-sync) | string | Audio-Datei-Payload, wenn audio_type=file |
text (/kling/lip-sync) | string | Eingabetext zur Sprachsynthese (für text2video) |
voice_id (/kling/lip-sync) | string | Stimmen-Preset-ID, die in text2video verwendet wird |
voice_language (/kling/lip-sync) | "zh", "en" | TTS-Sprache für text2video (Standard zh) |
voice_speed (/kling/lip-sync) | number | TTS-Sprechgeschwindigkeit (Standard 1.0) |
Fallstricke
durationunterstützt bei den meisten Modellen5oder10Sekunden;kling-v3undkling-v3-omniunterstützen flexible3–15Sekundenmode=4kist nur fürkling-v3undkling-v3-omniverfügbar und inkompatibel mitcamera_controlgenerate_audioaktiviert synchrone Audio-Generierung (unterstützt vonkling-v3,kling-v3-omniundkling-v2-6im Pro-Modus)end_image_urlist nur für die Aktionimage2videogedacht – sie definiert das letzte Bild- Die Bewegungskontrolle (
/kling/motion) ist ein separater Endpunkt von der Video-Generierung - Die Lippen-Synchronisation ist ein separater Endpunkt (
/kling/lip-sync) und erfordertmode; verwendeaudio_urlfüraudio2videoodertext+ Sprachfelder fürtext2video - Der
pro-Modus kostet etwa das 2-fache desstd-Modus, generiert aber schneller mit besserer Qualität - Aufgabenstatus verwenden
"succeed"(nicht "succeeded") – suche nach diesem Wert beim Abfragen negative_prompthilft, unerwünschte Elemente zu vermeiden (z.B. "blurry, low quality, text")