Vidu
Vidu Q4 Preview
vidu-q4-preview/reference-to-video
Erste öffentliche Vorschauversion der Vidu-Q4-Serie, mit Fokus auf Charakterdarstellung und native Audio, unterstützt bis zu 15 Bild- und 3 Audioreferenzen zur Steuerung und liefert Videos mit bis zu 4K
vidu-q4-preview/reference-to-video ausprobieren
Eingabe
Galerie
Alle Arbeiten ansehenAusgabe
videoPreise
vidu-q4-preview/reference-to-video per second
| Spezifikationen | Einzelpreis |
|---|---|
| 540P | $0.0515 |
| 720P | $0.109 |
| 1080P | $0.1375 |
| 2K | $0.2175 |
| 4K | $0.446 |
Positionierung und Kurzprofil
Der referenzbasierte Videopfad von Vidu Q4 Preview richtet sich an Entwickler, die Figuren, Szenen und Stimme im fertigen Video konsistent halten müssen. Laden Sie 1 bis 15 Referenzbilder hoch (Personen, Szenen und Requisiten sind alle möglich) sowie bis zu 3 Audioreferenzen und erzeugen Sie zusammen mit einem Text-Prompt ein Video von 3 bis 16 Sekunden. Die Auflösung ist wahlweise von 540p bis 4K verfügbar, und standardmäßig wird nativer, zum Bild synchroner Ton ausgegeben. Geeignet für serielle Kurzinhalte, Charakterdialog-Segmente und Shot-Previsualisierungen, bei denen mehrere Varianten verglichen werden sollen.
Kernhighlights
- Mehrere Referenzbilder halten Figuren und Szenen konsistent – bis zu 15 Referenzbilder pro Durchlauf können Figuren, Szenen und Requisiten festlegen; im Prompt werden sie der Reihenfolge nach referenziert, was Bilddrift über mehrere Shots hinweg reduziert.
- Audioreferenzgestützte Stimmgenerierung – bis zu 3 MP3-Sprachsamples von 3 bis 12 Sekunden können als Stimmreferenz angehängt werden, damit generierte Dialoge der gewünschten Stimmfarbe näherkommen.
- Nativer Ton standardmäßig mitgeliefert – standardmäßig werden synchron zum Video Dialoge und Soundeffekte erzeugt; abschaltbar, um stummes Material zu erhalten und die nachträgliche Audiospurtrennung zu sparen.
- Dauer, Seitenverhältnis und Auflösung anpassbar – Dauer 3 bis 16 Sekunden, fünf Seitenverhältnisse und fünf Auflösungsstufen von 540p bis 4K; derselbe Pfad deckt Quer- und Hochformat sowie unterschiedliche Klarheitsanforderungen ab.
Funktionsbeschreibung
Generierung mit Referenzbild-Bindung: Geben Sie 1 bis 15 Bilder im Format JPG, PNG oder WEBP ein und referenzieren Sie diese im Prompt der Reihenfolge nach, um Aussehen der Figuren, Szenen und zentrale Requisiten zu fixieren – ideal für mehrere Videos, die dieselbe Erscheinung fortführen sollen.
Stimmreferenz für die Vertonung: Hängen Sie bis zu 3 MP3-Sprachreferenzen von 3 bis 12 Sekunden an und legen Sie im Prompt die sprechende Figur fest, damit Charakterdialoge die gewünschten Stimmmerkmale tragen.
Schalter für synchronen Ton: Der audio-Parameter ist standardmäßig aktiv und erzeugt ein fertiges Video mit Dialogen und Soundeffekten; nach dem Abschalten erhält man ein reines Bildvideo, das sich später frei vertonen und mit Musik unterlegen lässt.
Frei festlegbare Ausgabespezifikation: Unterstützt die fünf Seitenverhältnisse 16:9, 9:16, 1:1, 4:3 und 3:4 sowie Auflösungen von 540p bis 4K und liefert direkt fertige Videos für verschiedene Platzierungen.
Lange Prompt-Beschreibungen: Der Prompt kann bis zu 20000 Zeichen lang sein und strukturierte Beschreibungen wie Rollenverteilung mehrerer Figuren, Kamerabewegung und Dialogzeilen aufnehmen.
Anwendungsfälle
- Kreative für serielle Kurzinhalte – mit derselben Gruppe von Figuren- und Szenenreferenzbildern mehrere Kurzfilme in Serie erzeugen, das Figurenbild einheitlich halten und direkt für Social-Media-Updates oder Seriensegmente nutzen.
- Produktion von Handlungssegmenten mit Dialog – Figurenreferenzbilder und Stimmproben bereitstellen, Dialogzeilen ausschreiben und ein Kurzvideo mit synchronem Dialog erzeugen, etwa als Storyboard-Previsualisierung oder als Fertigmaterial.
- Vergleich mehrerer Varianten für Werbe- und Markenfilme – durch Wechsel von Referenzbildern und Prompts schnell Versionen mit unterschiedlichen Kamerapositionen und Einstiegen testen, damit das Team vor dem Dreh die Richtung auswählen kann.
- Materialadaption für Multi-Plattform-Ausspielung – je eine Version mit unterschiedlichen Seitenverhältnissen und Auflösungsparametern erzeugen, um Querformat, Hochformat und HD-Auslieferung abzudecken.
Einschränkungen und Auswahlhinweise
Die maximale Generierungsdauer pro Durchlauf beträgt 16 Sekunden; längere Erzählungen müssen segmentweise erzeugt und anschließend zusammengesetzt werden. Referenzmaterial ist mengenmäßig begrenzt: höchstens 15 Bilder und 3 Audiospuren, wobei Audioreferenzen nur als MP3 und mit je 3 bis 12 Sekunden unterstützt werden. Als Preview-Version können Funktionsumfang und Parameter später angepasst werden; für Produktionsprozesse mit extrem hohen Anforderungen an die Ausgabestabilität ist der Pfad daher weniger geeignet. Wenn nur ein einzelnes Startbild das Bild führen soll, kann der Startbild-Pfad derselben Serie gewählt werden; bei Bedarf an längeren durchgehenden Shots sollten die Postproduktionskosten für das Zusammensetzen von Segmenten abgewogen werden.
Häufige Fragen
Alle Fragen ansehen →-
Kann man bei der Bild-zu-Video-Generierung das Seitenverhältnis selbst festlegen?
Nein. Das Seitenverhältnis des fertigen Videos richtet sich vollständig nach dem ersten Frame: Bei einem Querformat-Bild entsteht ein Querformat-Video, bei einem Hochformat-Bild ein Hochformat-Video. Für ein 9:16-Hochformat-Video also einfach ein hochformatiges erstes Frame vorbereiten. Das Seitenverhältnis des ersten Frames muss zwischen 1:4 und 4:1 liegen; zu schmale oder zu lange Bilder werden beim Einreichen abgelehnt.
-
Wozu dient der audio-Schalter?
Der native Ton ist standardmäßig aktiviert und erzeugt synchron zum Bild Dialoge, Umgebungsgeräusche und Soundeffekte; nach dem Deaktivieren wird ein reines stummes Video ohne Ton ausgegeben, geeignet für Loop-Hintergründe, eigene Nachvertonung oder Untertitel. Der Schalter beeinflusst den Preis nicht.
-
In welchem Verhältnis stehen Dauer und Preis?
Die Abrechnung erfolgt nach der übermittelten ganzzahligen Dauer in Sekunden multipliziert mit dem Sekundenpreis der gewählten Auflösung; die Audiooption und die Anzahl der Bilder fließen nicht in die Preisberechnung ein. Je höher die Auflösung, desto höher der Sekundenpreis; die 4K-Stufe kostet etwa das 8,7-Fache der 540p-Stufe. Der genaue Betrag richtet sich nach der Preisseite.
-
Für welche Szenarien eignet sich welche der fünf Auflösungsstufen?
540p dient zum Ausprobieren von Prompts und Kameraeinstellungen und reicht auch für kleine Loop-Hintergründe; 720p deckt die meisten Social-Media- und Web-Anwendungen ab; 1080p ist für den regulären Einsatz geeignet; 2K eignet sich für Großbildschirme und TV-Präsentationen; 4K für Ausstellungen, kinoqualitative Bilder oder Aufnahmen, die in der Nachbearbeitung beschnitten und neu komponiert werden sollen. Vor der Finalisierung zunächst mit niedriger Stufe testen, erst danach mit hoher Stufe ausgeben.
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: vidu-q4-preview/reference-to-video
routestringOptionalAktueller Festwert: default
inputobjectPflicht
Geschäftsparameter für vidu-q4-preview/reference-to-video und Route default — siehe Parametertabelle unten.
audiobooleanOptionalStandard: trueOb natives Audio (Dialog und Soundeffekte) synchron zum Video generiert werden soll; boolescher Wert, Standard true, bei false wird ein stummes Video ausgegeben.
promptstringPflichtminLength 1maxLength 20000Prompt für den Videoinhalt; Referenzmaterial kann über Nummern referenziert werden (z. B. „Der Mann aus Referenzbild 2 spricht mit Referenzaudio 1“); Zeichenkette, maximal 20000 Zeichen.
durationintegerOptionalStandard: 5min 3max 16Videodauer (Sekunden); ganzzahliger Wert zwischen 3 und 16, Standard 5.
resolutionstringOptionalStandard: "720p"Auflösung des Ausgabevideos; Zeichenkette, Standard 720p.
540p720p1080p2k4kaspect_ratiostringOptionalStandard: "16:9"Seitenverhältnis des Ausgabevideos; Zeichenkette, Standard 16:9.
16:99:161:14:33:4reference_audio_urlsarrayOptionalmaxItems 3Optionales Array von Referenzaudio-URLs, maximal 3 Stück, die als Stimmreferenz dienen; jedes Stück unterstützt nur MP3, maximal 50MB, Dauer 3-12 Sekunden.
Array [ string ]
reference_image_urlsarrayPflichtminItems 1maxItems 15Array von Referenzbild-URLs mit 1-15 Bildern zur Wahrung der Konsistenz von Charakteren, Szenen und Objekten; jedes Bild unterstützt JPG, JPEG, PNG oder WEBP, maximal 50MB, mindestens 128×128 Pixel, Seitenverhältnis zwischen 1:4 und 4:1.
Array [ string ]
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": "vidu-q4-preview/reference-to-video",
"input": {
"audio": true,
"prompt": "…",
"duration": 5,
"resolution": "720p",
"aspect_ratio": "16:9",
"reference_image_urls": "…"
}
}' 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: "vidu-q4-preview/reference-to-video",
input: {
"audio": true,
"prompt": "…",
"duration": 5,
"resolution": "720p",
"aspect_ratio": "16:9",
"reference_image_urls": "…"
}
}),
});
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": "vidu-q4-preview/reference-to-video",
"input": {
"audio": True,
"prompt": "…",
"duration": 5,
"resolution": "720p",
"aspect_ratio": "16:9",
"reference_image_urls": "…"
}
},
)
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 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-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 rufen Sie hailuo-2.3/text-to-video über die HiAPI API auf: curl, Python und lauffähige Anfragebeispiele
-
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
-
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
Ähnliche Modelle
Alle Modelle ansehen →Gleicher Typ
-
Veo 3.1 Google $0.290 /Sekunde -
Veo 3.1 Lite Google $0.060 /Sekunde -
MiniMax H3 MiniMax $0.072 /Sekunde -
Wan 3.0 Video Alibaba $0.040 /Sekunde -
LTX 2.5 Fast Lightricks $0.086 /Sekunde -
HappyHorse 1.0 Alibaba $0.168 /Sekunde -
Vidu Q4 Preview Vidu $0.051 /Sekunde -
Kling 2.5 Kuaishou $0.060 /Sekunde -
Kling 3.0 Turbo Kuaishou $0.130 /Sekunde -
HappyHorse 1.1 Alibaba $0.160 /Sekunde -
Creatify Boreal Creatify $0.015 /Sekunde -
PixVerse V6 PixVerse $0.036 /Sekunde





