Kling Video-API: Generierung aus Text, Bildern und Bewegungssteuerung
Binde Kling mit deinem BetterToken API Key ein und wähle Felder, Medien und Generierungsart anhand von Model ID und Operation.
Du kannst Videos aus Text oder Bildern generieren oder Bewegungen mit einem Personenreferenzbild und einem Bewegungsvideo steuern. kling-v3 verwendet provider_options.kling.mode für die Ausgabestufe. Omni, Turbo und Motion Control verwenden jeweils ihre Auflösungsfelder.
Halte deinen BetterToken API Key bereit. Die Base URL ist https://bettertoken.ai/v1; verwende Authorization: Bearer YOUR_API_KEY zur Authentifizierung. Kopiere die Model ID exakt, einschließlich Groß- und Kleinschreibung.
Alle folgenden request.json verwenden denselben Ablauf: Angebot einholen, bestätigen, Aufgabe erstellen, Status abfragen und herunterladen. Ein Angebot startet keine Generierung; die Erstellung übermittelt eine kostenpflichtige Aufgabe. Aktuelle Preise stehen in der model plaza.
Modelle und Operationen
Die folgende Tabelle zeigt die verfügbaren Werte je Operation. Standardwerte, Medienanzahl und Kombinationsregeln stehen im jeweiligen Abschnitt. Die Mediengrößen verwenden 1 MB = 1048576 Bytes.
| Model ID | Operation | Dauer (Sekunden) | Ausgabestufe | Seitenverhältnis | Audio | Medienrolle |
|---|---|---|---|---|---|---|
kling-3.0-turbo | text_to_video | 5–10, Schrittweite 5 | 720p, 1080p | 16:9, 9:16, 1:1 | on | Keine |
kling-v3-motion-control | reference_to_video | Folgt dem Referenzvideo von 3–10 Sekunden | 720p, 1080p | Nicht angeben | off, on | reference_image, reference_video |
kling-v3-omni | text_to_video | 3–15, Schrittweite 1 | 720p, 1080p, 4k | 16:9, 9:16, 1:1 | off, on | Keine |
kling-v3 | image_to_video | 3–15, Schrittweite 1 | std, pro, 4k | Nicht angeben | off, on | first_frame, last_frame |
kling-v3 | text_to_video | 3–15, Schrittweite 1 | std, pro, 4k | 16:9, 9:16, 1:1 | off, on | Keine |
kling-v3 akzeptiert kein output.resolution und bei der Generierung aus Bildern auch kein output.aspect_ratio. kling-v3-motion-control akzeptiert keine provider_options. Turbo generiert nur Videos mit 5 oder 10 Sekunden und festem Audio on.
Beispielmedien
Die Beispiele für Generierung aus Bildern und Bildreferenzen verwenden einen blauen Keramikbecher auf einem weißen Tisch. Du kannst das Beispielbild ausprobieren oder es vorher durch eigene öffentlich erreichbare HTTPS-Medien ersetzen, die du verwenden darfst und die die Anforderungen dieser Seite erfüllen.

Das Beispiel zur Bewegungssteuerung verwendet ein Referenzbild eines Jungen und ein Bewegungsvideo desselben Jungen. Der Prompt passt zu diesen Personenmedien. Das Video ist etwa 5,04 Sekunden lang, mit 1280 × 720 und 24 fps.
Video aus Text generieren
kling-3.0-turbo
Verwende diese Operation, wenn du ein Video nur aus einer Textbeschreibung generieren möchtest.
Setze model auf die Model ID dieses Abschnitts und operation auf text_to_video. Verwende nur die unten aufgeführten Generierungsfelder und lege Medien im Array media ab.
| Feld | Typ | Erforderlich | Werte oder Bereich | Standardwert |
|---|---|---|---|---|
audio.mode | string | Nein | on | on |
duration.mode | string | Nein | fixed | fixed |
duration.seconds | integer | Nein | 5–10, Schrittweite 5 Sekunden; nur bei fester Dauer | 5 |
output.aspect_ratio | string | Nein | 16:9, 9:16, 1:1 | 16:9 |
output.format | string | Nein | mp4 | mp4 |
output.resolution | string | Nein | 720p, 1080p | 720p |
prompt | string | Ja | Zeichenfolge | Keine |
watermark | boolean | Nein | false | false |
Medienanforderungen
Diese Operation akzeptiert keine Medien.
Kombinationsregeln
- Bei
duration.mode="fixed"istduration.secondserforderlich. Gib bei explizitemfixedauch die Sekunden an.
Beispielanfrage
Speichere das folgende JSON als request.json. Hole nach dem allgemeinen Ablauf zuerst ein Angebot ein und erstelle die Aufgabe nach der Bestätigung.
{ "model": "kling-3.0-turbo", "operation": "text_to_video", "prompt": "A blue ceramic mug on a white table. Slowly move the camera closer in soft daylight.", "duration": { "mode": "fixed", "seconds": 5 }, "output": { "resolution": "720p", "aspect_ratio": "16:9" }}Häufige 422-Fehler
| 422-Fehlercode | Abhilfe |
|---|---|
enum / range / step | Werte und Schrittweite anhand der Feldtabelle dieses Abschnitts anpassen. |
unsupported_field | Felder entfernen, die nicht in der Feldtabelle dieser Operation stehen. |
requires | Sekunden, Seitenverhältnis, Audioeinstellungen oder Medien gemäß den Kombinationsregeln dieses Abschnitts ergänzen. |
kling-v3-omni
Verwende diese Operation, wenn du ein Video nur aus einer Textbeschreibung generieren möchtest.
Setze model auf die Model ID dieses Abschnitts und operation auf text_to_video. Verwende nur die unten aufgeführten Generierungsfelder und lege Medien im Array media ab.
| Feld | Typ | Erforderlich | Werte oder Bereich | Standardwert |
|---|---|---|---|---|
audio.mode | string | Nein | off, on | off |
duration.mode | string | Nein | fixed | fixed |
duration.seconds | integer | Nein | 3–15, Schrittweite 1 Sekunde; nur bei fester Dauer | 3 |
output.aspect_ratio | string | Nein | 16:9, 9:16, 1:1 | 16:9 |
output.format | string | Nein | mp4 | mp4 |
output.resolution | string | Nein | 720p, 1080p, 4k | 720p |
prompt | string | Ja | Zeichenfolge | Keine |
watermark | boolean | Nein | false | false |
Medienanforderungen
Diese Operation akzeptiert keine Medien.
Kombinationsregeln
- Bei
duration.mode="fixed"istduration.secondserforderlich. Gib bei explizitemfixedauch die Sekunden an. - Setze bei
output.resolution="4k"zwingendaudio.mode="off".
Beispielanfrage
Speichere das folgende JSON als request.json. Hole nach dem allgemeinen Ablauf zuerst ein Angebot ein und erstelle die Aufgabe nach der Bestätigung.
{ "model": "kling-v3-omni", "operation": "text_to_video", "prompt": "A blue ceramic mug on a white table. Slowly move the camera closer in soft daylight.", "duration": { "mode": "fixed", "seconds": 5 }, "output": { "resolution": "720p", "aspect_ratio": "16:9" }}Häufige 422-Fehler
| 422-Fehlercode | Abhilfe |
|---|---|
enum / range / step | Werte und Schrittweite anhand der Feldtabelle dieses Abschnitts anpassen. |
unsupported_field | Felder entfernen, die nicht in der Feldtabelle dieser Operation stehen. |
requires | Sekunden, Seitenverhältnis, Audioeinstellungen oder Medien gemäß den Kombinationsregeln dieses Abschnitts ergänzen. |
kling-v3
Verwende diese Operation, wenn du ein Video nur aus einer Textbeschreibung generieren möchtest.
Setze model auf die Model ID dieses Abschnitts und operation auf text_to_video. Verwende nur die unten aufgeführten Generierungsfelder und lege Medien im Array media ab.
| Feld | Typ | Erforderlich | Werte oder Bereich | Standardwert |
|---|---|---|---|---|
audio.mode | string | Nein | off, on | off |
duration.mode | string | Nein | fixed | fixed |
duration.seconds | integer | Nein | 3–15, Schrittweite 1 Sekunde; nur bei fester Dauer | 5 |
output.aspect_ratio | string | Nein | 16:9, 9:16, 1:1 | 16:9 |
output.format | string | Nein | mp4 | mp4 |
prompt | string | Nein | Zeichenfolge | Keine |
provider_options.kling.camera_axis | string | Nein | horizontal, vertical, pan, tilt, roll, zoom | Keine |
provider_options.kling.camera_type | string | Nein | simple, down_back, forward_up, right_turn_forward, left_turn_forward | Keine |
provider_options.kling.camera_value | integer | Nein | -10–10, Schrittweite 1, 0 nicht erlaubt | Keine |
provider_options.kling.mode | string | Nein | std, pro, 4k | std |
provider_options.kling.negative_prompt | string | Nein | Zeichenfolge | Keine |
watermark | boolean | Nein | false, true | false |
Medienanforderungen
Diese Operation akzeptiert keine Medien.
Kombinationsregeln
- Bei
duration.mode="fixed"istduration.secondserforderlich. Gib bei explizitemfixedauch die Sekunden an.
Beispielanfrage
Speichere das folgende JSON als request.json. Hole nach dem allgemeinen Ablauf zuerst ein Angebot ein und erstelle die Aufgabe nach der Bestätigung.
{ "model": "kling-v3", "operation": "text_to_video", "prompt": "A blue ceramic mug on a white table. Slowly move the camera closer in soft daylight.", "duration": { "mode": "fixed", "seconds": 5 }, "output": { "aspect_ratio": "16:9" }, "provider_options": { "kling": { "mode": "std" } }}Häufige 422-Fehler
| 422-Fehlercode | Abhilfe |
|---|---|
enum / range / step | Werte und Schrittweite anhand der Feldtabelle dieses Abschnitts anpassen. |
unsupported_field | Felder entfernen, die nicht in der Feldtabelle dieser Operation stehen. |
requires | Sekunden, Seitenverhältnis, Audioeinstellungen oder Medien gemäß den Kombinationsregeln dieses Abschnitts ergänzen. |
Video aus Bildern generieren
kling-v3
Verwende diese Operation, wenn du das Startbild oder Start- und Endbild durch Bilder festlegen möchtest.
Setze model auf die Model ID dieses Abschnitts und operation auf image_to_video. Verwende nur die unten aufgeführten Generierungsfelder und lege Medien im Array media ab.
| Feld | Typ | Erforderlich | Werte oder Bereich | Standardwert |
|---|---|---|---|---|
audio.mode | string | Nein | off, on | off |
duration.mode | string | Nein | fixed | fixed |
duration.seconds | integer | Nein | 3–15, Schrittweite 1 Sekunde; nur bei fester Dauer | 5 |
output.format | string | Nein | mp4 | mp4 |
prompt | string | Nein | Zeichenfolge | Keine |
provider_options.kling.camera_axis | string | Nein | horizontal, vertical, pan, tilt, roll, zoom | Keine |
provider_options.kling.camera_type | string | Nein | simple, down_back, forward_up, right_turn_forward, left_turn_forward | Keine |
provider_options.kling.camera_value | integer | Nein | -10–10, Schrittweite 1, 0 nicht erlaubt | Keine |
provider_options.kling.mode | string | Nein | std, pro, 4k | std |
provider_options.kling.negative_prompt | string | Nein | Zeichenfolge | Keine |
watermark | boolean | Nein | false, true | false |
Medienanforderungen
| Medienrolle | Typ und Anzahl | Format | Grenzen pro Datei |
|---|---|---|---|
first_frame | image, optional, höchstens 1 | jpg, jpeg, png | Größe höchstens 10 MB; Breite 300–100000 px; Höhe 300–100000 px |
last_frame | image, optional, höchstens 1 | jpg, jpeg, png | Größe höchstens 10 MB; Breite 300–100000 px; Höhe 300–100000 px |
Ob Medien erforderlich sind, richtet sich zusätzlich nach den folgenden Kombinationsregeln.
Kombinationsregeln
- Bei
duration.mode="fixed"istduration.secondserforderlich. Gib bei explizitemfixedauch die Sekunden an. - Gib mindestens eine der Rollen
first_frame,last_framean. - Setze kein
provider_options.kling.camera_type, wenn du ein Endbildlast_frameübergibst.
Beispielanfrage
Speichere das folgende JSON als request.json. Hole nach dem allgemeinen Ablauf zuerst ein Angebot ein und erstelle die Aufgabe nach der Bestätigung.
{ "model": "kling-v3", "operation": "image_to_video", "prompt": "Slowly move the camera closer to the blue ceramic mug. Preserve its shape and the white table.", "duration": { "mode": "fixed", "seconds": 5 }, "provider_options": { "kling": { "mode": "std" } }, "media": [ { "id": "first", "type": "image", "role": "first_frame", "source": "https://docs.bettertoken.ai/images/nano-banana-guide/sample-07.png" } ]}Häufige 422-Fehler
| 422-Fehlercode | Abhilfe |
|---|---|
enum / range / step | Werte und Schrittweite anhand der Feldtabelle dieses Abschnitts anpassen. |
unsupported_field | Felder entfernen, die nicht in der Feldtabelle dieser Operation stehen. |
requires | Sekunden, Seitenverhältnis, Audioeinstellungen oder Medien gemäß den Kombinationsregeln dieses Abschnitts ergänzen. |
excludes | Felder entfernen, die mit automatischer Dauer oder Endbild kollidieren. |
count / media_role | Rollen und Anzahl anhand der Medientabelle dieses Abschnitts anpassen. |
video_input_unsupported | Öffentliche HTTPS-URL, Content-Type und Dateiformat prüfen und ein neues Angebot einholen. |
Video aus Referenzen generieren
kling-v3-motion-control
Verwende diese Operation, wenn Referenzmedien die Merkmale eines Motivs oder einer Bewegung erhalten sollen.
Setze model auf die Model ID dieses Abschnitts und operation auf reference_to_video. Verwende nur die unten aufgeführten Generierungsfelder und lege Medien im Array media ab.
| Feld | Typ | Erforderlich | Werte oder Bereich | Standardwert |
|---|---|---|---|---|
audio.mode | string | Nein | off, on | off |
duration.mode | string | Nein | auto | auto |
duration.seconds | integer | Nein | Nicht angeben; folgt dem Referenzvideo von 3–10 Sekunden | Keine |
output.format | string | Nein | mp4 | mp4 |
output.resolution | string | Nein | 720p, 1080p | 720p |
prompt | string | Ja | Zeichenfolge | Keine |
watermark | boolean | Nein | false | false |
Medienanforderungen
| Medienrolle | Typ und Anzahl | Format | Grenzen pro Datei |
|---|---|---|---|
reference_image | image, genau 1 (erforderlich) | jpg, jpeg, png | Größe höchstens 10 MB; Breite 300–16384 px; Höhe 300–16384 px |
reference_video | video, genau 1 (erforderlich) | mp4, mov | Größe höchstens 100 MB; Dauer 3–10 Sekunden; Gesamtdauer dieser Rolle höchstens 10 Sekunden |
Ob Medien erforderlich sind, richtet sich zusätzlich nach den folgenden Kombinationsregeln.
Kombinationsregeln
- Verwende automatische Dauer; die Ausgabedauer folgt dem Referenzvideo. Gib kein
duration.secondsan.
Du musst genau ein reference_image und genau ein reference_video angeben. Setze weder Seitenverhältnis noch zusätzliche provider_options.
Beispielanfrage
Speichere das folgende JSON als request.json. Hole nach dem allgemeinen Ablauf zuerst ein Angebot ein und erstelle die Aufgabe nach der Bestätigung.
{ "model": "kling-v3-motion-control", "operation": "reference_to_video", "prompt": "Animate the boy in the reference image following the motion in the reference video. Preserve his appearance.", "duration": { "mode": "auto" }, "output": { "resolution": "720p" }, "media": [ { "id": "person", "type": "image", "role": "reference_image", "source": "https://bettertoken.ai/video-api/shared/kling-hero-3.0-poster.jpg" }, { "id": "motion", "type": "video", "role": "reference_video", "source": "https://bettertoken.ai/video-api/shared/kling-hero-3.0.mp4" } ]}Häufige 422-Fehler
| 422-Fehlercode | Abhilfe |
|---|---|
enum / range / step | Werte und Schrittweite anhand der Feldtabelle dieses Abschnitts anpassen. |
unsupported_field | Felder entfernen, die nicht in der Feldtabelle dieser Operation stehen. |
excludes | Felder entfernen, die mit automatischer Dauer oder Endbild kollidieren. |
count / media_role | Rollen und Anzahl anhand der Medientabelle dieses Abschnitts anpassen. |
video_input_unsupported | Öffentliche HTTPS-URL, Content-Type und Dateiformat prüfen und ein neues Angebot einholen. |
Offizielle Dokumentation
Verwende beim Aufruf von BetterToken die Felder dieser Seite und die passende Operation im aktuellen Modellkatalog.

