Skip to main content
POST

Autorisierung

string
erforderlich
Alle API-Endpunkte erfordern eine Authentifizierung per Bearer TokenAPI-Schlüssel abrufen:Besuchen Sie die Seite zur API-Schlüsselverwaltung, um Ihren API-Schlüssel zu erhaltenFügen Sie ihn dem Anfrage-Header hinzu:

Anfrageparameter

string
erforderlich
Name des VideogenerierungsmodellsUnterstützte Modelle:
  • kling-video-o1 — Kling Video O1 (Reasoning-erweitert, höchste Qualität)
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
Positiver TextpromptDer Prompt darf maximal 2.500 Zeichen enthalten.Unterstützt das Referenzieren von Bildern aus image_urls mit der Syntax <<<image_N>>>, wobei N bei 1 beginnt.Beispiel: "Make the person in <<<image_1>>> wave at the camera"
Wenn Bilder bereitgestellt werden, der Prompt aber keine <<<image_N>>>-Referenz enthält, fügt das System automatisch <<<image_1>>> an den Anfang des Prompts an.
string
Standard:"std"
GenerierungsmodusOptionen:
  • std — Standardmodus (720P)
  • pro — Profimodus (1080P)
Standard: std
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
array<url>
Array mit Bild-URLs für BildreferenzenReferenzieren Sie die entsprechenden Bilder im Prompt mit der Syntax <<<image_N>>> (N beginnt bei 1)Beispiel: ["https://example.png"]
  • Bild-URLs müssen öffentlich zugänglich sein, ohne Hotlink-Schutz
  • Im Image-to-Video-Modus kann aspect_ratio durch das tatsächliche Seitenverhältnis des Bildes überschrieben werden
  • Bis zu zwei Bilder. Das erste Element im Array ist das Startbild, das zweite das Endbild
array<object>
Rollenbasiertes Bild-Array, empfohlen für Image-to-Video.Format jedes Elements: { "url": "...", "role": "..." }
  • first_frame: erstes Bild
  • last_frame: letztes Bild
  • reference: Referenzbild
  • image_urls und image_with_roles schließen sich gegenseitig aus, übergeben Sie nicht beide gleichzeitig.
  • Bei mehr als 2 Bildern wird das Festlegen von Start- und Endbild nicht unterstützt.
array
Liste der Referenzvideos (URL-basiert), bis zu 1 Video.Verwenden Sie refer_type, um Typen zu unterscheiden:
  • base: zu bearbeitendes Video (Standard)
  • feature: Feature-Referenzvideo
Verwenden Sie keep_original_sound, um zu steuern, ob der Originalton beibehalten wird:
  • no: nicht behalten (Standard)
  • yes: Originalton behalten
Anfrageformat:
  • video_url darf nicht leer sein, und die Video-URL muss zugänglich sein
  • Bei refer_type=base:
    • Erste/letzte Bilder können nicht definiert werden
    • Das Referenzvideo muss 3–10 Sekunden lang sein
    • Die Dauer des erzeugten Videos richtet sich nach dem hochgeladenen Video
  • Bei refer_type=feature und nicht leerer video_url:
    • image_urls darf nur ein Bild für das erste Bild enthalten
  • Video-Anforderungen: Nur MP4/MOV; mindestens 3 Sekunden Dauer; Auflösung 720–2160 px; Bildrate 24–60 fps (Ausgabe ist 24 fps); maximal 200 MB Größe

Bildreferenz-Syntax

Das Video-O1-Modell verwendet die Syntax <<<image_N>>>, um Bilder in Prompts zu referenzieren, und bietet so ein einheitliches Text-to-Video- / Image-to-Video-Erlebnis:
Automatische Referenz: Wenn image_urls bereitgestellt wird, der Prompt aber keine <<<image_N>>>-Referenz enthält, fügt das System automatisch <<<image_1>>> an den Anfang des Prompts an.

Antwort

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

Anwendungsfälle

Fall 1: Text-zu-Video (höchste Qualität)

Fall 2: Bildreferenz (einzelnes Bild)

Fall 3: Mehrere Bildreferenzen

Fall 4: Bild ohne explizite Referenz bereitgestellt (automatisch hinzugefügt)

Das System fügt <<<image_1>>> automatisch am Anfang des Prompts hinzu, was "<<<image_1>>>The person slowly turns and smiles" entspricht.
Aufgabenergebnisse abfragenDie Videogenerierung ist eine asynchrone Aufgabe, die bei der Einreichung eine task_id zurückgibt. Verwenden Sie den Endpunkt Aufgabenstatus abrufen, um Fortschritt und Ergebnis abzufragen.