Text-zu-Video-Aufgabe erstellen
- Offizielle Dokumentation: https://platform.vidu.cn/docs/text-to-video
- Erstellt eine Text-zu-Video-Aufgabe und gibt task_id zurück
- Steuern Sie die Generierung mit model, prompt und weiteren Parametern
Authorizations
Request Body
Text-Prompt
Textbeschreibung für die Videogenerierung.
Hinweis: Darf 2000 Zeichen nicht überschreiten
Modellname
Zulässige Werte: viduq3-turbo, viduq3-pro, viduq2, viduq1
- viduq3-turbo: Schnellere Generierung als viduq3-pro
- viduq3-pro: Effiziente hochwertige Audio-Video-Generierung; lebendigere, ausdrucksstärkere, dimensionreichere Ausgabe
- viduq2: Neuestes Modell
- viduq1: Klare Bilder, weiche Übergänge, stabile Kamerabewegung
Stil
Standard general; zulässig: general, anime
general: Allgemeiner Stil; Steuerung über den Prompt
anime: Anime-Stil; starke Anime-Optik; Steuerung über verschiedene Anime-Stil-Prompts
Hinweis: Bei Verwendung des q2-Modells ohne Wirkung
Videodauer; Standard hängt vom Modell ab:
- viduq3-pro, viduq3-turbo: Standard 5 s, Bereich 1–16
- viduq2: Standard 5 s, Bereich 1–10
- viduq1: Standard 5 s, nur 5 zulässig
Zufalls-Seed
Bei Weglassen oder 0 wird ein Zufallswert verwendet
Bei manueller Angabe wird dieser Seed verwendet
Seitenverhältnis
Standard 16:9; zulässig: 16:9, 9:16, 3:4, 4:3, 1:1
Hinweis: 3:4 und 4:3 nur beim q2-Modell unterstützt
Auflösung; Standard hängt von Modell und Dauer ab:
- 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 Verwendung des q2-Modells ohne Wirkung
Ob dem generierten Video Hintergrundmusik hinzugefügt wird.
Standard false; zulässig true, false
Bei true wählt das System passende Musik aus der vorgegebenen BGM-Bibliothek.
- BGM-Länge nicht begrenzt; Anpassung an die Videodauer
Durchreichparameter
Wird nicht verarbeitet; nur Datenübertragung
Hinweis: Maximal 1048576 Zeichen
Ob ein Wasserzeichen hinzugefügt wird
- true: Wasserzeichen hinzufügen
- false: kein Wasserzeichen
Hinweis 1: Wasserzeicheninhalt ist fest (KI-generiert); standardmäßig aus
Hinweis 2: watermarked_url aus der Aufgabenabfrage-API für Video mit Wasserzeichen verwenden
Wasserzeichenposition auf dem Bild:
1: oben links
2: oben rechts
3: unten rechts
4: unten links
Standard: 3
URL des Wasserzeichenbilds
Bei Weglassen Standardtext: KI-generierter Inhalt
Metadaten-Kennung (JSON-String), Durchreichfeld; 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, werden standardmäßig von Vidu erzeugte Metadaten verwendet
Callback-URL (POST). Beim Erstellen der Aufgabe setzen; Vidu sendet Statusaktualisierungen an diese URL. Body entspricht der Antwort 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 Callback-Signatur-Dokumentation
Responses
Erfolg