Kuaishou
Kling 3.0
kling-3.0-omni/reference-to-video
Einheitliche multimodale Videogenerierungs-Serie mit Unterstützung für Text-zu-Video, Bild-zu-Video, Referenz-zu-Video und Bearbeitung innerhalb von Videos, native Lippensynchronisation und mehrsprachiges Audio
kling-3.0-omni/reference-to-video ausprobieren
Eingabe
Galerie
Alle Arbeiten ansehenAusgabe
videoPreise
kling-3.0-omni/reference-to-video per second
Positionierung im Überblick
kling-3.0-omni/reference-to-video ist der auf referenzbildgestützte Videogenerierung ausgerichtete Pfad der Kling 3.0 Omni-Serie. Er erlaubt es, 1 bis 7 Referenzbilder (oder in Kombination bis zu 7 wiederverwendbare Subjektelemente) als visuelle Anker zu verwenden und zusammen mit einem Text-Prompt ein 3 bis 15 Sekunden langes Video zu erzeugen. Unterstützt werden die Auflösungen 720p, 1080p und 4k sowie die Seitenverhältnisse 16:9, 9:16 und 1:1; natives Audio und intelligente Multi-Shot-Funktion lassen sich aktivieren. Geeignet für Entwickler, die Charakter- oder Objektkonsistenz über mehrere Shots hinweg wahren und Marketing- sowie Social-Media-Videos in Serie produzieren möchten.
Kernhighlights
- Duale Verankerung über mehrere Referenzbilder und Subjektelemente – Es können 1 bis 7 Referenzbilder übergeben oder bis zu 7 Subjektelemente mit je 2 bis 4 Bildern definiert und im Prompt per @name referenziert werden.
- Optionaler zusätzlicher Referenzvideo-Overlay – Ein Referenzvideo von 3 bis 15,5 Sekunden kann ergänzt werden, um Bewegung und Bildkomposition vorzugeben; in diesem Fall ist die Gesamtobergrenze aus Referenzbildern und Subjekten auf 4 begrenzt.
- Auflösung und Seitenverhältnis von Hochformat bis 4K – Ausgabe wahlweise in 720p, 1080p oder 4k; die Seitenverhältnisse umfassen 16:9, 9:16 und 1:1 und eignen sich für Querformat- sowie vertikale Kurzvideo-Ausspielung.
- Natives Audio und Multi-Shot kombinierbar – Standardmäßig deaktiviertes natives Audio und intelligente Multi-Shot-Funktion können gleichzeitig aktiviert werden, um in einem Durchlauf einen Multi-Shot-Clip mit Ton zu erzeugen; bei Verwendung eines Referenzvideos stehen beide nicht zur Verfügung.
Funktionsbeschreibung
Konsistente Generierung mehrerer Subjekte: Über elements werden Subjektname, Beschreibung und 2 bis 4 Bilder desselben Subjekts definiert und im Prompt per @name aufgerufen, sodass dieselbe Figur oder dasselbe Objekt in mehreren Shots einheitlich aussieht.
Referenzvideo als Vorgabe: Ein Referenzvideo im Format MP4/MOV (maximal 200 MB, 3 bis 15,5 Sekunden) gibt Bewegung und Rhythmus vor und eignet sich für stilistische oder neu gedrehte Generierungen auf Basis vorhandenen Materials.
Steuerung von Auflösung und Seitenverhältnis: Je nach Ausspielkanal wird die Ausgabe in 720p, 1080p oder 4k gewählt und ein Seitenverhältnis von 16:9, 9:16 oder 1:1 festgelegt, was nachträgliches Zuschneiden und Transkodieren reduziert.
Natives Audio und intelligente Multi-Shot-Funktion: Mit aktiviertem audio wird synchron Ton erzeugt; mit aktiviertem prefer_multi_shots zerlegt das Modell den Prompt automatisch in mehrere Shots. Beides ist verfügbar, solange kein Referenzvideo verwendet wird.
Anpassbare Dauer und Prompt-Länge: Die Ausgabedauer lässt sich je nach Erzählbedarf auf 3 bis 15 Sekunden festlegen; der Prompt umfasst bis zu 3072 Zeichen, genug für Subjekt, Aktion und Kameraführung.
Anwendungsfälle
- Markenmarketing-Teams: Referenzbilder + Produkt-USP-Prompt – Mehransichtige Produktreferenzbilder fixieren das Aussehen; erzeugt werden Kurzvideos mit definierten Seitenverhältnis- und Auflösungsspezifikationen, die direkt für In-Feed- und Website-Ausspielung genutzt werden können.
- Social-Media-Redaktion: Charakterelemente + Hochformat-Skript – Nach Definition fester Charakterelemente werden 9:16-Kurz videos in Serie generiert, die die Figur konsistent halten und sich für die tägliche Content-Produktion eignen.
- Film- und Animationsvorproduktion: Referenzvideo + Storyboard-Prompt – Ein Referenzvideo gibt den Bewegungsrhythmus vor; ausgegeben werden Multi-Shot-Previsualisierungsclips, anhand derer Regisseure Kameradesign und Schnittpunkte bestätigen.
- E-Commerce-Content-Teams: Produktbildserien zu Video – Produktreferenzbilder werden hochgeladen und ein Seitenverhältnis von 1:1 oder 16:9 festgelegt; erzeugt werden Präsentationsvideos für Detailseiten und Produkthauptbildplätze.
Einschränkungen und Auswahlhinweise
Referenzbilder und Subjektelemente dürfen zusammen 7 nicht überschreiten; bei ergänztem Referenzvideo wird die Grenze auf 4 gesenkt, und natives Audio sowie intelligente Multi-Shot-Funktion stehen dann nicht zur Verfügung. Die Dauer pro Durchlauf ist auf 15 Sekunden begrenzt; lange Erzählungen müssen in Segmenten erzeugt und anschließend zusammengefügt werden. Referenzbilder müssen JPG/PNG sein, pro Bild höchstens 50 MB und an der kürzesten Kante mindestens 300 px; Referenzvideos sind auf MP4/MOV und 3 bis 15,5 Sekunden beschränkt. Wenn nur ein einzelnes Bild als Treiber oder eine reine Textgenerierung benötigt wird, kann der image-to-video- bzw. text-to-video-Pfad derselben Serie gewählt werden; bei speziellen Anforderungen an die Bewegungskontrolle ist motion-control zu prüfen.
Neuigkeiten
Changelog ansehen →- Neues Modell Neues Modell: Kling 3.0 Omni (可灵 O3), aufrufbar über POST /v1/tasks. kling-3.0-omn…
Häufige Fragen
Alle Fragen ansehen →-
Muss ich bei Kling 3.0 Image-to-Video ein Bild hochladen?
Ja. Der aktuelle kling-3.0/image-to-video ist eine Image-to-Video-Route; das Eingabebild bestimmt das Motiv und die Ausgangskomposition, der Prompt steuert Bewegung, Kamera und Umgebungsveränderungen.
-
Welche Dauern und Auflösungen unterstützt Kling 3.0 Image-to-Video?
Der aktuelle HiAPI-Anfragevertrag unterstützt 3–15s, die Ausgabeauflösungen sind 720p, 1080p, 4K. Die verfügbaren Werte richten sich nach dem Parameterfeld der Seite und der API-Dokumentation.
-
Wie wird Kling 3.0 Image-to-Video abgerechnet?
Aufgaben werden nach der Ausgabedauer und der gewählten Stufe abgerechnet. Die Seite zeigt den Live-Preis in der globalen Währungseinheit an; die endgültige Abrechnung richtet sich nach dem Datensatz der erfolgreichen Aufgabe.
-
Wie lässt sich die Stabilität des Hauptmotivs bei der Bild-zu-Video-Generierung verbessern?
Verwenden Sie ein Eingabebild mit klarem Hauptmotiv, wenigen Verdeckungen und vollständiger Komposition; beschreiben Sie im Prompt zuerst die Hauptaktion und die Kameraführung und listen Sie anschließend die beizubehaltenden Merkmale von Aussehen, Material und Hintergrundbeziehungen auf. Für den ersten Test wird eine kürzere Dauer empfohlen.
Generierungsaufgabe erstellen
https://api.hiapi.ai/v1/tasks Header
AuthorizationstringPflichtAccount-API-Schlüssel. Bei jeder Anfrage erforderlich. Beispiel: Bearer YOUR_HIAPI_API_KEY. API-Schlüssel holen
Content-TypestringOptionalDer Anfragekörper wird immer als JSON geparst; beim Senden ist nur application/json (optional mit charset) zulässig — andere Werte liefern 415. Beispiel: application/json.
Idempotency-KeystringOptionalIdempotenz-Schlüssel, bis 255 Bytes. Wiederholungen mit demselben Schlüssel desselben Kontos erstellen die Aufgabe nur einmal; Replays liefern die ursprüngliche taskId.
Bei Netzwerk-Timeouts oder Client-Wiederholungen erstellt derselbe Schlüssel die Aufgabe nur einmal — keine doppelte Abbuchung (Geltungsbereich = das Konto des API-Schlüssels). Empfohlen: geschäftsseitig eindeutige Kennung (z. B. "order-42"); Replays liefern die ursprüngliche taskId, Schlüssel laufen 24 Stunden nach der ersten Anfrage ab. Die vollständige Szenariomatrix steht in der Übersicht der Unified Async API.
Body
modelstringPflichtAktueller Festwert: kling-3.0-omni/reference-to-video
routestringOptionalAktueller Festwert: default
inputobjectPflicht
Geschäftsparameter für kling-3.0-omni/reference-to-video und Route default — siehe Parametertabelle unten.
audiobooleanOptionalStandard: falseOb bei der Videogenerierung gleichzeitig nativer, zum Bild passender Ton erzeugt wird, boolescher Wert, Standard false; nicht verfügbar, wenn ein Referenzvideo (video_urls) bereitgestellt wird.
promptstringPflichtminLength 1maxLength 3072Beschreibt den gewünschten Videoinhalt; sollen Subjekte aus elements verwendet werden, können diese im Prompt über @name mit ihrem Namen referenziert werden.
durationintegerOptionalStandard: 5min 3max 15Dauer des Ausgabevideos in Sekunden, ganze Zahl, Wertebereich 3-15, Standard 5.
elementsarrayOptionalmaxItems 7
Liste wiederverwendbarer Subjekte, maximal 7; jedes Element enthält einen Namen, eine kurze Beschreibung und 2-4 Bilder und kann im Prompt über @name referenziert werden.
Array [ object ]
Array-Elemente
namestringPflichtminLength 1Eindeutiger Name des Subjekts, der im Prompt über @name referenziert wird; der Name darf keine Leerzeichen enthalten.
descriptionstringPflichtminLength 1Kurzer Beschreibungstext zu diesem Subjekt, der dem Modell hilft, das Subjekt zu erkennen und wiederzugeben.
element_input_urlsarrayPflichtminItems 2maxItems 4Array von Referenzbildern desselben Subjekts, 2-4 Bilder erforderlich, JPG/PNG wird unterstützt.
Array [ string ]
image_urlsarrayPflichtminItems 1maxItems 7Array von Referenzbildern, 1-7 Bilder möglich; bei hinzugefügtem Referenzvideo maximal 4, wobei Referenzbilder und Subjekte (elements) zusammen höchstens 7 betragen (mit Referenzvideo zusammen höchstens 4). JPG/PNG wird unterstützt, einzelne Bilder maximal 50MB, Kantenlänge mindestens 300 px.
Array [ string ]
resolutionstringOptionalStandard: "720p"Auflösung des Ausgabevideos, Zeichenkette, Standard 720p.
720p1080p4kvideo_urlsarrayOptionalminItems 1maxItems 1Optionales Array von Referenzvideos, MP4 oder MOV wird unterstützt, einzelne Videos maximal 200MB, Dauer 3-15,5 Sekunden, Breite und Höhe 700-4553 px, Bildrate 24-60 fps; nach dem Hinzufügen eines Referenzvideos werden nativer Ton und intelligente Multishot-Funktion nicht unterstützt.
Array [ string ]
aspect_ratiostringOptionalStandard: "16:9"Seitenverhältnis des Ausgabevideos, Zeichenkette, Standard 16:9.
16:99:161:1prefer_multi_shotsbooleanOptionalStandard: falseOb das Modell anhand des Prompts automatisch mehrere Kameraeinstellungen planen soll, boolescher Wert, Standard false; nach dem Hinzufügen eines Referenzvideos nicht verfügbar.
callbackobjectOptional
Konfiguration der Endzustands-Benachrichtigung. Ohne Angabe wird kein Callback gesendet — selbst abfragen.
Beim Erstellen callback.url angeben, dann POSTet HiAPI im Endzustand an Ihren Service — kein Polling nötig. Der Callback-Body entspricht der Aufgaben-Detailstruktur; Signaturprüfung, Wiederholungen und Idempotenz sind in der Übersicht der Unified Async API beschrieben.
urlstringPflichtPflicht, wenn callback angegeben ist. Nach dem Endzustand wird an diese URL gepostet; muss eine gültige http(s)-URL sein.
whenstringOptionalStandard: "final"Derzeit wird nur final unterstützt — Benachrichtigung bei success und fail.
finalstoragestringOptionalStandard: "temp"Speicherstufe für Artefakte: temp (Standard, ca. 7 Tage) oder persistent (langfristig, nach Größe abgerechnet). Bei unzureichendem Guthaben oder Überschreitung des Speicherlimits erfolgt ein stiller Downgrade auf temp; die wirksame Stufe steht in der Aufgaben-Detailantwort.
temppersistentAnfragebeispiele
# Asynchrone Aufgabe senden; gibt sofort eine taskId zurück (wartet nicht auf die Generierung)
curl -X POST "https://api.hiapi.ai/v1/tasks" \
-H "Authorization: Bearer $HIAPI_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "kling-3.0-omni/reference-to-video",
"input": {
"audio": false,
"prompt": "…",
"duration": 5,
"image_urls": "…",
"resolution": "720p",
"aspect_ratio": "16:9",
"prefer_multi_shots": false
}
}' const res = await fetch("https://api.hiapi.ai/v1/tasks", {
method: "POST",
headers: {
Authorization: `Bearer ${process.env.HIAPI_API_KEY}`,
"Content-Type": "application/json",
},
body: JSON.stringify({
model: "kling-3.0-omni/reference-to-video",
input: {
"audio": false,
"prompt": "…",
"duration": 5,
"image_urls": "…",
"resolution": "720p",
"aspect_ratio": "16:9",
"prefer_multi_shots": false
}
}),
});
const task = await res.json();
// { code: 200, message: "success", data: { taskId } } import os, requests
res = requests.post(
"https://api.hiapi.ai/v1/tasks",
headers={"Authorization": f"Bearer {os.environ['HIAPI_API_KEY']}"},
json={
"model": "kling-3.0-omni/reference-to-video",
"input": {
"audio": False,
"prompt": "…",
"duration": 5,
"image_urls": "…",
"resolution": "720p",
"aspect_ratio": "16:9",
"prefer_multi_shots": False
}
},
)
print(res.json()) # { code, message, data: { taskId } } 200 OK
{
"code": 200,
"message": "success",
"data": {
"taskId": "tk-hiapi-01HZTQ8BX2N3GM3YFK4Z9D7VQR"
}
} 400 Bad Request
{
"code": 400,
"message": "invalid request",
"data": null,
"error_code": "INVALID_REQUEST"
} Aufgabendetails abrufen
https://api.hiapi.ai/v1/tasks/:id Antwortfelder
taskIdstringPflichtAufgaben-ID, stets mit Präfix tk-hiapi-.
modelstringPflichtAufgelöster vollständiger Modellname. Mit route-Parameter eingereichte Aufgaben geben base@route zurück (z. B. gpt-image-2/text-to-image@ext); sonst identisch mit dem übermittelten Namen.
routestringOptionalErscheint nur bei explizitem route-Parameter; gibt den übermittelten Wert zurück.
statusstringPflichtAufgabenstatus.
queued Eingereiht, noch nicht gestartet.
handling In Verarbeitung.
archiving Verarbeitung abgeschlossen, Artefakte werden vorbereitet.
success Endzustand: abgeschlossen, Artefakte verfügbar (output wird zurückgegeben).
fail Endzustand: fehlgeschlagen (error wird zurückgegeben).
Nach dem Senden den status prüfen: success und fail sind Endzustände, alles andere nicht. Alle 1–3 Sekunden bis zum Endzustand pollen. Nach Erfolg Artefakte aus output[].url laden und vor expireAt übertragen; für Langzeitaufbewahrung storage: "persistent" beim Erstellen angeben.
creatednumberPflichtZeitpunkt der Aufgabenerstellung (Unix-Sekunden).
completednumberPflichtUnix-Sekunden des Endzustands; vor Abschluss stets 0.
outputarrayOptional
Nur bei status == success. Artefaktliste — immer ein Array; eine Aufgabe kann mehrere Typen gleichzeitig liefern (z. B. video + first_frame).
Array [ object ]
Array-Elemente
urlstringPflichtArtefakt-URL, direkt herunterladbar.
typestringPflichtAktuell mögliche Werte: video, image, audio, first_frame, last_frame, thumbnail; später können weitere folgen.
expireAtnumberPflichtUnix-Sekunden, bis wann das Artefakt verfügbar ist; vorher herunterladen oder übertragen.
errorobjectOptional
Nur bei status == fail.
codestringPflichtBusiness-Fehlercode.
messagestringPflichtFehlerbeschreibung.
Antwortbeispiele
Erfolg
{
"code": 200,
"message": "success",
"data": {
"taskId": "tk-hiapi-01HZTQ8BX2N3GM3YFK4Z9D7VQR",
"model": "happyhorse-1-0",
"status": "success",
"created": 1777282033,
"completed": 1777282099,
"output": [
{
"url": "https://cdn.hiapi.ai/tasks/.../video.mp4",
"type": "video",
"expireAt": 1777886899
}
]
}
} In Bearbeitung (nicht final)
{
"code": 200,
"message": "success",
"data": {
"taskId": "tk-hiapi-...",
"model": "happyhorse-1-0",
"status": "archiving",
"created": 1777282033,
"completed": 0
}
} Fehlgeschlagen
{
"code": 200,
"message": "success",
"data": {
"taskId": "tk-hiapi-...",
"model": "happyhorse-1-0",
"status": "fail",
"created": 1777282033,
"completed": 1777282099,
"error": {
"code": "TASK_FAILED",
"message": "task failed"
}
}
} Artikel
Alle Artikel ansehen →-
Tutorial
So rufen Sie hailuo-2.3-fast/image-to-video über die HiAPI API auf: curl und Python in der Praxis
Die erste lauffähige Anfrage für die schnelle, kostengünstige Bild-zu-Video-Stufe – von der Modell-ID bis zum heruntergeladenen MP4
-
Tutorial
So nutzt du kling-4.0/text-to-video über die HiAPI-API: curl, Python und ein lauffähiges Anforderungsbeispiel
Ein praxisnaher Leitfaden für Entwickler: filmische Prompts, synchrones Audio, asynchrones Polling und Download der Ausgabe
-
Tutorial
So rufen Sie hailuo-2.3/text-to-video über die HiAPI API auf: curl, Python und lauffähige Anfragebeispiele
-
Tutorial
kandinsky-6.0-pro/image-to-video auf HiAPI: Tutorial mit curl und Python
Eine funktionierende Bild-zu-Video-Anfrage auf HiAPI ausführen: vom Upload des ersten Frames über asynchrones Polling bis zum finalen Download
-
Tutorial
Kandinsky 6.0 Pro Text-zu-Video auf HiAPI: curl- und Python-Tutorial
Eine anfrageorientierte praktische Demonstration: Aufbau des Aufrufs vom Prompt zum Videoclip, Absenden der Anfrage, Abfragen des Fertigstellungsstatus und Herunterladen des Ergebnisses
Ähnliche Modelle
Alle Modelle ansehen →Gleicher Typ
-
Veo 3.1 Lite Google $0.060 /Sekunde -
Vidu Q3 Vidu $0.149 /Sekunde -
HappyHorse 1.0 Alibaba $0.168 /Sekunde -
Gemini Omni 1.1 Flash Google $0.450 /Video -
HeyGen Avatar V HeyGen $0.150 /Sekunde -
Creatify Boreal Creatify $0.015 /Sekunde -
PixVerse V6 PixVerse $0.036 /Sekunde -
FLUX 3 Video Black Forest Labs $0.090 /Sekunde -
Ray 3.2 Luma $0.214 /Video -
Kling 3.0 Kuaishou $0.100 /Sekunde -
Grok Imagine 1.5 Lite xAI $0.029 /Sekunde -
Wan 3.0 Video Alibaba $0.040 /Sekunde






