img_uuid und fragen Sie den Status ab oder nutzen Sie einen Callback, um das generierte Video zu erhalten.Vidu Q3 Turbo-Referenz-API für konsistente Videosubjekte
Greifen Sie über die unabhängige GoEnhance Open API auf die Vidu Q3 Turbo Reference API zu. Senden Sie 1–7 Referenzbilder mit einem Prompt, speichern Sie die zurückgegebene
API-Schlüssel abrufen
Eine gültige Referenz-zu-Video-Anfrage erstellen
1–7 Referenzbilder bereitstellen
POST an https://api.goenhance.ai/api/v1/videos/generations mit model: viduq3_turbo_reference, einem erforderlichen Prompt und einem image_urls-Array, das 1–7 öffentliche Bild-URLs enthält.
Jede asynchrone Aufgabe nachverfolgen
Wählen Sie eine Dauer von 1–16 Sekunden und eine Auflösung von 540p, 720p oder 1080p. Speichern Sie die zurückgegebene img_uuid und fragen Sie dann GET /api/v1/jobs/detail ab oder konfigurieren Sie eine custom_callback_url.
Validieren Sie den Vertrag für reine Referenzanfragen, bevor Sie eine Produktionsaufgabe übermitteln.
Funktionen und Parameter der Vidu Q3 Turbo-Referenz-API
Genaue Modell-ID
Setzen Sie <code>model</code> auf <code>viduq3_turbo_reference</code>; behalten Sie den Unterstrich genau bei.
Erforderlicher Prompt
Beschreiben Sie die beabsichtigte Aktion, den Schauplatz, das Kameraverhalten und die visuelle Gestaltung im <code>prompt</code>.
Referenz-Array
Stellen Sie 1–7 öffentliche Bild-URLs über <code>image_urls</code> bereit.
Route nur für Referenzen
Senden Sie kein <code>image_url</code> oder <code>image_end_url</code>; verwenden Sie <code>viduq3_turbo</code> für diese Modi.
Dauer
Wählen Sie eine Ganzzahl von 1 bis 16 Sekunden. Der dokumentierte Standardwert beträgt 5 Sekunden.
Auflösung
Verwenden Sie <code>540p</code>, <code>720p</code> oder <code>1080p</code>; der dokumentierte Standardwert ist <code>720p</code>.
Schätzen Sie die Gesamtkosten als das gewählte Preis-pro-Sekunde-Verhältnis multipliziert mit der angeforderten Dauer.
Vidu Q3 Turbo-Referenz-API-Preise
540p
1 Token pro generierter Sekunde, entspricht $0.02 pro Sekunde bei der dokumentierten Rate von $0.02 pro Token.
720p
2,5 Token pro generierter Sekunde, entspricht $0.05 pro Sekunde bei der dokumentierten Rate von $0.02 pro Token.
1080p
3,25 Token pro generierter Sekunde, entspricht $0.065 pro Sekunde bei der dokumentierten Rate von $0.02 pro Token.
Integrieren Sie die Vidu Q3 Turbo-Referenz-API in sechs Schritten
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 genehmigte Referenzbilder unter öffentlichen URLs, die Ihre Anfrage in
image_urls bereitstellen kann. 3
3. Payload validieren
Legen Sie die exakte Modell-ID, den Prompt, die Dauer und eine dokumentierte Auflösung fest; lassen Sie Felder für nur den ersten Frame weg.
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 stellen Sie eine öffentliche HTTPS-Callback-URL bereit. 6
6. Abschluss verarbeiten
Verarbeiten Sie den terminalen Erfolg oder Fehler idempotent und überprüfen Sie das zurückgegebene Video vor der weiteren Verwendung.
Erstellen Sie wiederholbare Pipelines, bei denen genehmigte visuelle Eingaben eine generierte Szene steuern.
Entwickler-Anwendungsfälle für referenzbasiertes Video
Charakterkontinuität
Verwenden Sie mehrere genehmigte Charakteransichten, um wiederkehrende Subjekte über kurze generierte Clips hinweg zu führen.
Produkt-Storytelling
Stellen Sie Produktreferenzen und einen Szenen-Prompt für überprüfbare Kampagnenkonzepte bereit.
Kampagnenvarianten
Verwenden Sie ein genehmigtes visuelles Referenzset wieder, während Sie die Prompts für verschiedene Platzierungen oder Story-Beats ändern.
Previsualisierung
Verwandeln Sie Charakter-, Requisiten- und Umgebungsreferenzen in Bewegungskonzepte vor der vollständigen Produktion.
Lokalisierte Werbemittel
Parametrisieren Sie Szenen-Prompts, während Sie dieselben genehmigten visuellen Referenzen über regionale Varianten hinweg beibehalten.
Serialisierte Inhalte
Führen Sie wiederkehrende Subjekte und die künstlerische Leitung über unabhängig eingereichte asynchrone Aufgaben hinweg.
Antworten auf häufige Fragen zu Eingaben, Preisen, Aufgabenstatus und der ShengShu-API.