Zum Inhalt springen
Kostenlos registrieren
Kling

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 IDOperationDauer (Sekunden)AusgabestufeSeitenverhältnisAudioMedienrolle
kling-3.0-turbotext_to_video5–10, Schrittweite 5720p, 1080p16:9, 9:16, 1:1onKeine
kling-v3-motion-controlreference_to_videoFolgt dem Referenzvideo von 3–10 Sekunden720p, 1080pNicht angebenoff, onreference_image, reference_video
kling-v3-omnitext_to_video3–15, Schrittweite 1720p, 1080p, 4k16:9, 9:16, 1:1off, onKeine
kling-v3image_to_video3–15, Schrittweite 1std, pro, 4kNicht angebenoff, onfirst_frame, last_frame
kling-v3text_to_video3–15, Schrittweite 1std, pro, 4k16:9, 9:16, 1:1off, onKeine

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.

Referenzbild für die Videogenerierung: blauer Keramikbecher auf einem weißen Tisch

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.

FeldTypErforderlichWerte oder BereichStandardwert
audio.modestringNeinonon
duration.modestringNeinfixedfixed
duration.secondsintegerNein5–10, Schrittweite 5 Sekunden; nur bei fester Dauer5
output.aspect_ratiostringNein16:9, 9:16, 1:116:9
output.formatstringNeinmp4mp4
output.resolutionstringNein720p, 1080p720p
promptstringJaZeichenfolgeKeine
watermarkbooleanNeinfalsefalse

Medienanforderungen

Diese Operation akzeptiert keine Medien.

Kombinationsregeln

  • Bei duration.mode="fixed" ist duration.seconds erforderlich. Gib bei explizitem fixed auch 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-FehlercodeAbhilfe
enum / range / stepWerte und Schrittweite anhand der Feldtabelle dieses Abschnitts anpassen.
unsupported_fieldFelder entfernen, die nicht in der Feldtabelle dieser Operation stehen.
requiresSekunden, 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.

FeldTypErforderlichWerte oder BereichStandardwert
audio.modestringNeinoff, onoff
duration.modestringNeinfixedfixed
duration.secondsintegerNein3–15, Schrittweite 1 Sekunde; nur bei fester Dauer3
output.aspect_ratiostringNein16:9, 9:16, 1:116:9
output.formatstringNeinmp4mp4
output.resolutionstringNein720p, 1080p, 4k720p
promptstringJaZeichenfolgeKeine
watermarkbooleanNeinfalsefalse

Medienanforderungen

Diese Operation akzeptiert keine Medien.

Kombinationsregeln

  • Bei duration.mode="fixed" ist duration.seconds erforderlich. Gib bei explizitem fixed auch die Sekunden an.
  • Setze bei output.resolution="4k" zwingend audio.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-FehlercodeAbhilfe
enum / range / stepWerte und Schrittweite anhand der Feldtabelle dieses Abschnitts anpassen.
unsupported_fieldFelder entfernen, die nicht in der Feldtabelle dieser Operation stehen.
requiresSekunden, 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.

FeldTypErforderlichWerte oder BereichStandardwert
audio.modestringNeinoff, onoff
duration.modestringNeinfixedfixed
duration.secondsintegerNein3–15, Schrittweite 1 Sekunde; nur bei fester Dauer5
output.aspect_ratiostringNein16:9, 9:16, 1:116:9
output.formatstringNeinmp4mp4
promptstringNeinZeichenfolgeKeine
provider_options.kling.camera_axisstringNeinhorizontal, vertical, pan, tilt, roll, zoomKeine
provider_options.kling.camera_typestringNeinsimple, down_back, forward_up, right_turn_forward, left_turn_forwardKeine
provider_options.kling.camera_valueintegerNein-10–10, Schrittweite 1, 0 nicht erlaubtKeine
provider_options.kling.modestringNeinstd, pro, 4kstd
provider_options.kling.negative_promptstringNeinZeichenfolgeKeine
watermarkbooleanNeinfalse, truefalse

Medienanforderungen

Diese Operation akzeptiert keine Medien.

Kombinationsregeln

  • Bei duration.mode="fixed" ist duration.seconds erforderlich. Gib bei explizitem fixed auch 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-FehlercodeAbhilfe
enum / range / stepWerte und Schrittweite anhand der Feldtabelle dieses Abschnitts anpassen.
unsupported_fieldFelder entfernen, die nicht in der Feldtabelle dieser Operation stehen.
requiresSekunden, 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.

FeldTypErforderlichWerte oder BereichStandardwert
audio.modestringNeinoff, onoff
duration.modestringNeinfixedfixed
duration.secondsintegerNein3–15, Schrittweite 1 Sekunde; nur bei fester Dauer5
output.formatstringNeinmp4mp4
promptstringNeinZeichenfolgeKeine
provider_options.kling.camera_axisstringNeinhorizontal, vertical, pan, tilt, roll, zoomKeine
provider_options.kling.camera_typestringNeinsimple, down_back, forward_up, right_turn_forward, left_turn_forwardKeine
provider_options.kling.camera_valueintegerNein-10–10, Schrittweite 1, 0 nicht erlaubtKeine
provider_options.kling.modestringNeinstd, pro, 4kstd
provider_options.kling.negative_promptstringNeinZeichenfolgeKeine
watermarkbooleanNeinfalse, truefalse

Medienanforderungen

MedienrolleTyp und AnzahlFormatGrenzen pro Datei
first_frameimage, optional, höchstens 1jpg, jpeg, pngGröße höchstens 10 MB; Breite 300–100000 px; Höhe 300–100000 px
last_frameimage, optional, höchstens 1jpg, jpeg, pngGröß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" ist duration.seconds erforderlich. Gib bei explizitem fixed auch die Sekunden an.
  • Gib mindestens eine der Rollen first_frame, last_frame an.
  • Setze kein provider_options.kling.camera_type, wenn du ein Endbild last_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-FehlercodeAbhilfe
enum / range / stepWerte und Schrittweite anhand der Feldtabelle dieses Abschnitts anpassen.
unsupported_fieldFelder entfernen, die nicht in der Feldtabelle dieser Operation stehen.
requiresSekunden, Seitenverhältnis, Audioeinstellungen oder Medien gemäß den Kombinationsregeln dieses Abschnitts ergänzen.
excludesFelder entfernen, die mit automatischer Dauer oder Endbild kollidieren.
count / media_roleRollen 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.

FeldTypErforderlichWerte oder BereichStandardwert
audio.modestringNeinoff, onoff
duration.modestringNeinautoauto
duration.secondsintegerNeinNicht angeben; folgt dem Referenzvideo von 3–10 SekundenKeine
output.formatstringNeinmp4mp4
output.resolutionstringNein720p, 1080p720p
promptstringJaZeichenfolgeKeine
watermarkbooleanNeinfalsefalse

Medienanforderungen

MedienrolleTyp und AnzahlFormatGrenzen pro Datei
reference_imageimage, genau 1 (erforderlich)jpg, jpeg, pngGröße höchstens 10 MB; Breite 300–16384 px; Höhe 300–16384 px
reference_videovideo, genau 1 (erforderlich)mp4, movGröß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.seconds an.

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-FehlercodeAbhilfe
enum / range / stepWerte und Schrittweite anhand der Feldtabelle dieses Abschnitts anpassen.
unsupported_fieldFelder entfernen, die nicht in der Feldtabelle dieser Operation stehen.
excludesFelder entfernen, die mit automatischer Dauer oder Endbild kollidieren.
count / media_roleRollen 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.