Skip to main content
POST

Authentifizierung

string
erforderlich
Alle Schnittstellen erfordern eine Authentifizierung mittels Bearer TokenAPI-Schlüssel erhalten:Besuchen Sie die Verwaltungsseite für API-Schlüssel, um Ihren API-Schlüssel zu erhaltenFügen Sie ihn bei der Verwendung dem Anfrage-Header hinzu:

Anfrageparameter

string
erforderlich
Name des VideogenerierungsmodellsUnterstützte Modelle:
  • kling-3.0-turbo - Kling 3.0 Turbo
string
erforderlich
Text-PromptDas Upstream-Limit liegt bei höchstens 3072 Zeichen, empfohlen werden höchstens 2500 Zeichen.Beispiel: "Ein Corgi rennt am Strand entlang, filmische Atmosphäre, Dämmerungslicht"
string
Unterstützt Bild-URL oder Base64.
Upstream-Beschränkungen für das erste Bild:
  • Format: .jpg / .jpeg / .png
  • Größe: ≤ 50MB
  • Breite und Höhe: ≥ 300px
  • Seitenverhältnis: 1:2.5 ~ 2.5:1
string
Standard:"16:9"
Seitenverhältnis des VideosMögliche Werte:
  • 16:9 - Querformat
  • 9:16 - Hochformat
  • 1:1 - Quadratisch
Standardwert: 16:9
Gilt nur für Text-zu-Video. Bei Bild-zu-Video ist dieses Feld wirkungslos; das Videoverhältnis wird durch das erste Bild bestimmt.
string
Standard:"720p"
VideoauflösungMögliche Werte:
  • 720p
  • 1080p
Standardwert: 720p
integer
Standard:"5"
Videolänge (Sekunden)Wertebereich: 3-15 (mindestens 3 Sekunden, höchstens 15 Sekunden)Standardwert: 5⚠️ Hinweis: Es muss eine reine Zahl eingegeben werden (z. B. 6), ohne Anführungszeichen, andernfalls tritt ein Fehler auf
boolean
Ob ein Wasserzeichen hinzugefügt werden sollWird nur dann an den Upstream weitergegeben, wenn es explizit übergeben wird; wird es nicht übergeben, wird kein Wasserzeichen hinzugefügt.

Text-zu-Video vs. Bild-zu-Video

Das System erkennt automatisch den Generierungsmodus anhand dessen, ob ein first_frame_image bereitgestellt wird: Mit erstem Bild wird Bild-zu-Video, ohne erstes Bild wird Text-zu-Video verwendet; der Benutzer muss dies nicht explizit angeben.

Antwort

integer
Antwortstatuscode, bei Erfolg 200
array
Zurückgegebenes Datenarray

Anwendungsfälle

Szenario 1: Text-zu-Video (1080P)

Szenario 2: Text-zu-Video (Hochformat 720P)

Szenario 3: Bild-zu-Video (erstes Bild)

Szenario 4: Reine Bild-zu-Video-Generierung (ohne Prompt)

Szenario 5: Multi-Shot-Storyboard (Text-zu-Video)

Task-Ergebnis abfragenDie Videogenerierung ist ein asynchroner Task; nach der Übermittlung wird eine task_id zurückgegeben. Verwenden Sie die Schnittstelle Task-Status abrufen, um den Fortschritt und das Ergebnis der Generierung abzufragen.