img_uuid den Status ab oder erhalten Sie Status-Callbacks.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
API-Schlüssel abrufen
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.
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.
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 <code>model</code> auf <code>viduq3_reference</code> und geben Sie den erforderlichen Text-Prompt an, der das beabsichtigte Video beschreibt.
Referenzbilder
Senden Sie 1–7 URLs in <code>image_urls</code>. 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 <code>image_urls</code>, nicht <code>image_url</code> oder <code>image_end_url</code>. Verwenden Sie <code>viduq3_pro</code> 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 <code>540p</code>, <code>720p</code> oder <code>1080p</code>. Der dokumentierte Standardwert ist <code>720p</code>.
Ausgabeformat
Setzen Sie <code>ratio</code> auf <code>16:9</code>, <code>9:16</code> oder <code>1:1</code>; der dokumentierte Standardwert ist <code>16:9</code>. <code>aspect_ratio</code> 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.
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.