Vidu Q3 Referenz-API für konsistente Videos

Greifen Sie über die unabhängige GoEnhance Open API auf Vidu Q3 Reference zu. Stellen Sie 1–7 Referenzbilder mit einem Prompt bereit, übermitteln Sie einen asynchronen Video-Task und fragen Sie dann mit der zurückgegebenen img_uuid den Status ab oder erhalten Sie Status-Callbacks.
API-Schlüssel abrufen
Filmische Szene am See zur Darstellung der Konsistenz von Referenz zu Video

Erstellen Sie eine Vidu Q3 Reference API-Anfrage

Referenzbild-Eingabe für Konsistenz entwickelt

POST an https://api.goenhance.ai/api/v1/videos/generations mit model: viduq3_reference, einem erforderlichen Prompt und image_urls, die 1–7 öffentliche Referenzbilder enthalten.
Ungebrandete Charakter-Maquetten, die für visuelle Referenz zusammengestellt wurden

Validierte Anfragen und asynchrone Ergebnisse

Validieren Sie Bildformat, Abmessungen, Seitenverhältnis, Dauer, Auflösung und Ausgabeformat vor der Übermittlung. Speichern Sie die img_uuid und fragen Sie dann GET /api/v1/jobs/detail ab oder verwenden Sie einen öffentlichen HTTPS-Callback.
Film-Kamera-Rig zur Darstellung eines asynchronen Produktions-Workflows
Stimmen Sie das Anfrageschema für Referenz-zu-Video mit der Dokumentation ab, bevor Sie einen Task übermitteln.

Funktionen und Limits der Vidu Q3 Reference API

Modell und Prompt

Setzen Sie model auf viduq3_reference und geben Sie den erforderlichen Text-Prompt an, der das beabsichtigte Video beschreibt.

Referenzbilder

Senden Sie 1–7 URLs in image_urls. Jedes Bild muss im PNG-, JPEG-, JPG- oder WebP-Format vorliegen, mindestens 128×128 Pixel groß sein, maximal 50 MB wiegen und ein Seitenverhältnis zwischen 1:4 und 4:1 aufweisen.

Dedizierter Eingabemodus

Diese Route akzeptiert image_urls, nicht image_url oder image_end_url. Verwenden Sie viduq3_pro für reine Text-, Erstbild- oder Start-End-Bild-Generierung.

Dauer

Wählen Sie eine Ganzzahl zwischen 3 und 16 Sekunden. Der dokumentierte Standardwert beträgt 5 Sekunden.

Auflösung

Wählen Sie 540p, 720p oder 1080p. Der dokumentierte Standardwert ist 720p.

Ausgabeformat

Setzen Sie ratio auf 16:9, 9:16 oder 1:1; der dokumentierte Standardwert ist 16:9. aspect_ratio wird als kompatibler Alias akzeptiert.
Schätzen Sie die Kosten, indem Sie den gewählten Preis pro Sekunde mit der angeforderten Dauer multiplizieren.

Vidu Q3 Reference API-Preisgestaltung

540p

1,75 Token pro generierter Sekunde, entspricht $0.035 pro Sekunde bei der dokumentierten Rate von $0.02 pro Token.

720p

3 Token pro generierter Sekunde, entspricht $0.06 pro Sekunde bei der dokumentierten Rate von $0.02 pro Token.

1080p

3,75 Token pro generierter Sekunde, entspricht $0.075 pro Sekunde bei der dokumentierten Rate von $0.02 pro Token.

Vidu Q3 Reference in sechs Schritten integrieren

1

1. Erstellen Sie einen API-Schlüssel

Erstellen Sie einen GoEnhance-Schlüssel und senden Sie ihn als Bearer-Token im Authorization-Header.
2

2. Referenzen vorbereiten

Hosten Sie 1–7 konforme Referenzbilder unter öffentlichen URLs und entscheiden Sie, welche visuellen Details der Prompt beibehalten soll.
3

3. Anfrage validieren

Legen Sie viduq3_reference, eine Dauer von 3–16 Sekunden, eine unterstützte Auflösung und ein unterstütztes Seitenverhältnis fest.
4

4. Aufgabe übermitteln

Senden Sie einen POST-Request an /api/v1/videos/generations und speichern Sie die zurückgegebene img_uuid.
5

5. Status verfolgen

Fragen Sie GET /api/v1/jobs/detail ab oder konfigurieren Sie eine öffentliche HTTPS custom_callback_url.
6

6. Abschluss verarbeiten

Verarbeiten Sie Erfolgs- und Fehlerzustände idempotent und überprüfen Sie das generierte Asset vor der weiteren Verwendung.
API-Schlüssel abrufen
Erstellen Sie wiederholbare Referenz-zu-Video-Workflows basierend auf expliziten Eingaben und terminalen Aufgabenstatus.

Entwickler-Anwendungsfälle für die Vidu Q3 Reference API

Charakterbasierte Kampagnen-Clips

Integrieren Sie genehmigte fiktive Charaktere oder Talent-Referenzen in kurze Kampagnen-Videokonzepte.

Produktidentitäts-Sequenzen

Verwenden Sie mehrere genehmigte Produktansichten als visuelle Referenzen für bewegungsorientierte kreative Erkundungen.

Story-Kontinuität

Referenzieren Sie wiederkehrende Motive bei der Generierung separater Aufnahmen für Storyboard- und Previsualisierungs-Workflows.

Lokalisierte kreative Varianten

Verwenden Sie genehmigte visuelle Referenzen wieder, während Sie Prompts für regionale Kampagnenkonzepte anpassen.

Stilkonsistente Social-Media-Assets

Bauen Sie Kurzvideo-Pipelines um eine kontrollierte Menge an visuellen Referenzen und Ausgabeformaten auf.

Kreatives Prototyping

Testen Sie Referenzkombinationen, Prompts, Dauern und Auflösungen, bevor Sie sich auf einen umfassenderen Produktions-Workflow festlegen.
Antworten auf häufige Fragen zu Preisgestaltung, Referenzeingabe, asynchronen Aufgaben und der ShengShu-API.

Vidu Q3 Referenz-API-FAQ

Was ist der Vidu Q3 Reference API-Endpunkt auf GoEnhance?

Senden Sie einen POST https://api.goenhance.ai/api/v1/videos/generations mit dem auf viduq3_reference gesetzten model. Eine erfolgreiche Übermittlung gibt eine img_uuid für die asynchrone Nachverfolgung zurück.

Wie funktioniert die Preisgestaltung der Vidu Q3 Reference API?

Die Preisgestaltung erfolgt pro generierter Sekunde: 1,75 Token/s ($0.035/s) bei 540p, 3 Token/s ($0.06/s) bei 720p und 3,75 Token/s ($0.075/s) bei 1080p. Multiplizieren Sie die gewählte Rate mit der Dauer.

Wie viele Referenzbilder kann ich senden?

Das dokumentierte image_urls-Array erfordert 1–7 Bilder. Jedes muss die veröffentlichten Grenzwerte für Format, Größe, Abmessungen und Seitenverhältnis erfüllen.

Kann ich image_url oder image_end_url senden?

Nein. Diese dedizierte Referenz-Route akzeptiert image_urls. Verwenden Sie die separat dokumentierte viduq3_pro-Route für Text-zu-Video, Bild-zu-Video (erstes Frame) oder Start-End-Frame-Generierung.

Welche Werte für Dauer, Auflösung und Seitenverhältnis werden unterstützt?

Die Dauer beträgt 3–16 Sekunden. Die Auflösung unterstützt 540p, 720p und 1080p. Das Seitenverhältnis unterstützt 16:9, 9:16 und 1:1.

Woher weiß ich, wann das Video fertig ist?

Speichern Sie die img_uuid und fragen Sie GET /api/v1/jobs/detail ab oder geben Sie eine öffentliche HTTPS custom_callback_url an. Callback-Antworten, die nicht den Status 200 zurückgeben, werden bis zu dreimal mit einem Timeout von drei Sekunden pro Versuch erneut versucht.

Ist dies die offizielle ShengShu-API?

Nein. Vidu wird von ShengShu Technology entwickelt. Diese Seite beschreibt den unabhängigen API-Zugriff durch Dritte über GoEnhance und impliziert keine Zugehörigkeit, Partnerschaft oder Unterstützung.

Wie unterscheidet sich Vidu Q3 Reference von der Turbo-Referenzebene?

Diese Seite behandelt die Standard-Route viduq3_reference. Die separat dokumentierte Route viduq3_turbo_reference ist die schnellere, kostengünstigere Referenzebene; vermischen Sie deren Modellkennung oder Preisgestaltung nicht mit dieser Anfrage.

Beginnen Sie mit der Entwicklung mit der Vidu Q3 Reference API