Bild-zu-Video-Aufgabe erstellen
- Offizielle Dokumentation: https://platform.vidu.cn/docs/image-to-video
- Erstellt eine Bild-zu-Video-Aufgabe und gibt task_id oder Aufgabendetails zurück
- Steuerung der Generierung über Anfrageparameter
Authorizations
Request Body
Text-Prompt
Textbeschreibung für die Videogenerierung.
Hinweis: Maximal 2000 Zeichen
Modellname
Zulässige Werte: viduq2, viduq1, viduq3-turbo, viduq3-pro
- viduq3-turbo: Schnellere Generierung als viduq3-pro
- viduq3-pro: Effizientes hochwertiges Audio-Video; lebendigeres, ausdrucksstärkeres Ergebnis
- viduq2: Neuestes Modell
- viduq1: Klares Bild, weiche Übergänge, stabile Kameraführung
Videodauer; Standard je nach Modell:
- viduq3-pro, viduq3-turbo: Standard 5 s, Bereich 1–16
- viduq2: Standard 5 s, Bereich 1–10
- viduq1: Standard 5 s, nur 5
Zufalls-Seed
Wenn weggelassen oder 0, wird ein Zufallswert verwendet
Bei manueller Angabe wird dieser Seed verwendet
Auflösung; Standard je nach Modell und Dauer:
- viduq3-pro, viduq3-turbo (1–16 s): Standard 720p, zulässig 540p, 720p, 1080p
- viduq2 (1–10 s): Standard 720p, zulässig 540p, 720p, 1080p
- viduq1 (5 s): Standard 1080p, zulässig 1080p
Bewegungsamplitude
Standard auto; zulässig: auto, small, medium, large
Hinweis: Bei q2-Modell ohne Wirkung
Durchreichparameter
Wird nicht verarbeitet; nur Datenübertragung
Hinweis: Maximal 1048576 Zeichen
Nebenzeiten-Modus; Standard false; zulässig:
- true: Video im Nebenzeiten-Modus erzeugen
- false: Video sofort erzeugen
Hinweis 1: Nebenzeiten-Modus verbraucht weniger Credits; siehe Preise
Hinweis 2: Nebenzeiten-Aufgaben werden innerhalb von 48 Stunden bearbeitet; unvollständige werden storniert und Credits erstattet
Hinweis 3: Nebenzeiten-Aufgaben können manuell abgebrochen werden
Wasserzeichen hinzufügen
- true: Wasserzeichen hinzufügen
- false: kein Wasserzeichen
Hinweis 1: Wasserzeicheninhalt ist fest (KI-generiert); standardmäßig aus
Hinweis 2: Video mit Wasserzeichen über watermarked_url in der Aufgabenabfrage-API
Wasserzeichenposition auf dem Bild:
1: oben links
2: oben rechts
3: unten rechts
4: unten links
Standard: 3
Bild-URL des Wasserzeichens
Wenn weggelassen, Standardtext: KI-generierter Inhalt
Metadaten-Kennung (JSON-String), Durchreichung; eigenes oder Beispielformat:
{
"Label": "your_label","ContentProducer": "yourcontentproducer","ContentPropagator": "your_content_propagator","ProduceID": "yourproductid", "PropagateID": "your_propagate_id","ReservedCode1": "yourreservedcode1", "ReservedCode2": "your_reserved_code2"
}
Wenn leer, standardmäßig Vidu-generierte Metadaten
Callback-URL (POST). Beim Erstellen der Aufgabe setzen; Vidu sendet Statusaktualisierungen. Body entspricht der Aufgabenabfrage-API.
Callback-status-Werte:
- processing: in Bearbeitung
- success: abgeschlossen (bis zu 3 Wiederholungen bei Zustellfehler)
- failed: fehlgeschlagen (bis zu 3 Wiederholungen bei Zustellfehler)
Vidu nutzt Callback-Signatur-Authentifizierung; siehe Signatur-Dokumentation
Erstes Bild (erstes Frame)
Das Modell verwendet das Bild in diesem Parameter als erstes Frame zur Videogenerierung.
Hinweis 1: Unterstützt Bild-Base64 oder Bild-URL (muss erreichbar sein)
Hinweis 2: Nur 1 Bild
Hinweis 3: Formate: png, jpeg, jpg, webp
Hinweis 4: Seitenverhältnis kleiner als 1:4 oder 4:1
Hinweis 5: Maximale Bildgröße 50 MB
Hinweis 6: HTTP-POST-Body max. 20 MB; passenden Content-Type angeben, z. B.:
data:image/png;base64,{base64_encode}
Direkte Audio-Video-Ausgabe; Standard false; zulässig:
- false: keine direkte Ausgabe (stummes Video)
- true: Video mit Dialog und Hintergrundaudio
Hinweis 1: voice_id gilt nur wenn dieser Parameter true ist
Hinweis 2: Bei model q3-pro oder q3-turbo ist Standard true
Hinweis 3: Nebenzeiten-Modus nicht unterstützt wenn dieser Parameter true ist
Stimm-ID
Bestimmt die Stimmlage im Video; wenn leer, empfiehlt das System. Liste: https://shengshu.feishu.cn/sheets/EgFvs6DShhiEBStmjzccr5gonOg
Empfohlene Prompts verwenden
- true: System empfiehlt Prompts (Anzahl=1) und generiert damit
- false: Generierung nach eingegebenem prompt
Hinweis: Empfohlene Prompts kosten 10 zusätzliche Credits pro Aufgabe
Responses
Erfolg