Skip to main content
POST

Autorisierung

string
erforderlich
Alle API-Endpunkte erfordern eine Bearer-Token-AuthentifizierungAPI-Key abrufen:Besuchen Sie die Seite zur API-Key-Verwaltung, um Ihren API-Key zu erhaltenFügen Sie ihn zum Request-Header hinzu:

Anfrageparameter

string
erforderlich
Name des VideogenerierungsmodellsUnterstützte Modelle:
  • kling-v2-6 – Kling v2.6 (empfohlen)
boolean
Standard:"false"
Legt fest, ob der Inhalt vor dem Absenden des Videoauftrags moderiert wird.
  • true: Prompts und Eingabebilder mit omni-moderation-latest prüfen
  • false oder nicht angegeben: keine Moderationsanfrage und damit keine zusätzlichen Moderationskosten oder Verzögerung (Standard)
string
erforderlich
Text-Prompt, maximal 2500 ZeichenBeschreiben Sie Szenen, Aktionen und Stile detailliert für bessere GenerierungsergebnisseBeispiel: "A golden cat running on a sunlit meadow, slow motion, cinematic quality"
string
Standard:"std"
GenerierungsmodusOptionen:
  • std – Standardmodus (720P, nur stummes Video)
  • pro – Profimodus (1080P, unterstützt automatische Audio-Generierung)
Standard: std
Einschränkung des Standardmodus: Der Modus std unterstützt nur stumme Videos. Der Parameter audio erfordert den Modus pro.
integer
Standard:"5"
Videodauer (Sekunden)Optionen: 5 oder 10Standard: 5
string
Standard:"16:9"
Seitenverhältnis des VideosOptionen:
  • 16:9 – Querformat
  • 9:16 – Hochformat
  • 1:1 – Quadrat
Standard: 16:9
string
Negativer Prompt zum Ausschluss unerwünschter InhalteBeispiel: "blurry, low quality, distorted"
array<url>
Array von Bild-URLs für die Image-to-Video-Generierung
  • 1 Bild übergeben: wird als Erstbild verwendet
  • 2 Bilder übergeben: werden automatisch als Erstbild + letztes Einzelbild zugewiesen (erfordert mode: "pro")
Maximal 2 Bilder unterstütztBeispiel: ["https://example.com/first.jpg"]
  • Maximal 2 Bilder unterstützt
  • Letztes Einzelbild (2 Bilder) erfordert nur den Modus pro; der Modus std unterstützt nur das Erstbild (1 Bild)
  • Letztes Einzelbild und Audio schließen sich gegenseitig aus: Im Modus pro können letztes Einzelbild (2 Bilder) und Audio (audio: true) nicht zusammen verwendet werden
  • Im Image-to-Video-Modus kann aspect_ratio durch das tatsächliche Bildverhältnis überschrieben werden
boolean
Standard:"false"
Soll Audio automatisch generiert werden?Standard: false
  • Nur in mode: "pro" verfügbar
  • Schließt sich gegenseitig mit dem letzten Einzelbild aus: Audio kann nicht zusammen mit dem letzten Einzelbild (2 Bilder) verwendet werden
boolean
Soll ein Wasserzeichen hinzugefügt werden?

Funktionsunterstützungsmatrix

Hinweis: Im Modus pro schließen sich Steuerung des letzten Einzelbildes und Audio gegenseitig aus und können nicht zusammen verwendet werden.

Text-zu-Video (Text-to-Video) vs Bild-zu-Video (Image-to-Video)

Das System ermittelt den Modus automatisch danach, ob image_urls angegeben ist: ohne Bilder bedeutet Text-to-Video, mit Bildern bedeutet Image-to-Video.

Antwort

integer
Statuscode der Antwort, 200 bei Erfolg
array
Datenarray der Antwort

Anwendungsfälle

Fall 1: Text-zu-Video (Standardmodus)

Fall 2: Text-zu-Video (Pro-Modus + negativer Prompt)

Fall 3: Bild-zu-Video (Erstbild)

Fall 4: Bild-zu-Video (Steuerung Erst- + Endbild)

Fall 5: Pro-Modus + Auto-Audio

Aufgabenergebnisse abfragenDie Videogenerierung ist eine asynchrone Aufgabe, die nach der Übermittlung eine task_id zurückgibt. Verwenden Sie den Endpunkt Aufgabenstatus abrufen, um den Generierungsfortschritt und die Ergebnisse abzufragen.