img_uuid und fragen Sie anschließend den Status ab oder empfangen Sie Callbacks, bis der Auftrag erfolgreich abgeschlossen oder fehlgeschlagen ist.Vidu Q3 Pro API zur Videogenerierung
Greifen Sie über die unabhängige offene API von GoEnhance auf Vidu Q3 Pro zu, um Text-zu-Video, Bild-zu-Video sowie Start- und End-Frame-Generierung zu nutzen. Senden Sie eine asynchrone Anfrage, speichern Sie die zurückgegebene
API-Schlüssel abrufen
Erstellen Sie eine klare Vidu Q3 Pro API-Anfrage
Drei Eingabemodi an einem Endpunkt
Senden Sie einen POST-Request an https://api.goenhance.ai/api/v1/videos/generations mit model: viduq3_pro. Verwenden Sie nur einen Prompt für Text-zu-Video, fügen Sie image_url für ein erstes Bild hinzu oder ergänzen Sie image_end_url für die Start-End-Frame-Generierung.
Explizite Steuerung und asynchroner Abschluss
Validieren Sie Dauer, Auflösung und Text-zu-Video-Verhältnis vor dem Absenden. Speichern Sie die zurückgegebene Aufgaben-ID und verwenden Sie dann GET /api/v1/jobs/detail oder eine öffentliche HTTPS custom_callback_url, um die Endergebnisse zu verarbeiten.
Stimmen Sie das dokumentierte Anfrageschema ab, bevor eine Aufgabe in Ihre Videopipeline gelangt.
Vidu Q3 Pro API-Funktionen und Parameter
Modell
Setzen Sie <code>model</code> auf <code>viduq3_pro</code>.
Prompt
Geben Sie den erforderlichen Text-Prompt ein, der das beabsichtigte Video beschreibt.
Erstes Bild
Fügen Sie eine öffentliche <code>image_url</code> für die Bild-zu-Video-Generierung hinzu; lassen Sie diese für Text-zu-Video weg.
Letztes Bild
Fügen Sie <code>image_end_url</code> zusammen mit <code>image_url</code> für die Start-End-Frame-Steuerung hinzu.
Dauer
Wählen Sie eine Ganzzahl von 1 bis 16 Sekunden. Der dokumentierte Standardwert beträgt 5 Sekunden.
Auflösung und Seitenverhältnis
Die Auflösung unterstützt 540p, 720p oder 1080p, mit 720p als Standard. Das Feld <code>ratio</code> gilt für Text-zu-Video-Anfragen.
Schätzen Sie die Generierungskosten, indem Sie den gewählten Preis pro Sekunde mit der angeforderten Dauer multiplizieren.
Vidu Q3 Pro API-Preisgestaltung
540p
2,25 Token pro generierter Sekunde, entspricht $0.045 pro Sekunde bei der dokumentierten Rate von $0.02 pro Token.
720p
5 Token pro generierter Sekunde, entspricht $0.10 pro Sekunde bei der dokumentierten Rate von $0.02 pro Token.
1080p
6 Token pro generierter Sekunde, entspricht $0.12 pro Sekunde bei der dokumentierten Rate von $0.02 pro Token.
Vidu Q3 Pro in sechs Schritten integrieren
1
1. API-Schlüssel erstellen
Erstellen Sie einen GoEnhance-Schlüssel und senden Sie ihn als Bearer-Token im Authorization-Header.
2
2. Eingabemodus auswählen
Verwenden Sie nur einen Prompt, fügen Sie eine URL für den ersten Frame hinzu oder fügen Sie URLs für den ersten und letzten Frame hinzu.
3
3. Anfrage validieren
Legen Sie
viduq3_pro, eine Dauer von 1–16 Sekunden und einen der dokumentierten Auflösungswerte fest. 4
4. Video-Task ü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-Callback-URL. 6
6. Abschluss verarbeiten
Verarbeiten Sie Erfolgs- und Fehlerzustände idempotent und überprüfen Sie das zurückgegebene Asset vor der weiteren Verwendung.
Erstellen Sie wiederholbare Videogenerierungs-Workflows auf Basis expliziter Eingaben und terminaler Task-Zustände.
Entwickler-Anwendungsfälle für die Vidu Q3 Pro API
Kampagnen-Videovarianten
Generieren Sie kurze Konzept-Clips aus strukturierten Prompts für kreative Überprüfungen und nachgelagerte Zusammenstellungen.
Produktbewegung
Animieren Sie einen genehmigten Produkt-Frame, während Ihre Anwendung Prompts, Validierung und Asset-Überprüfung steuert.
Storyboard-Übergänge
Verwenden Sie Eingaben für den ersten und letzten Frame, um Bewegungen zwischen zwei genehmigten visuellen Beats zu erkunden.
Lokalisierte kreative Pipelines
Parametrisieren Sie Prompts für regionale Kampagnenvarianten, ohne den asynchronen Task-Handler zu ändern.
Social-Video-Produktion
Erstellen Sie kurze Bewegtbild-Assets mit einer von Ihrer Anwendung gewählten Auflösung und Dauer.
Previsualisierung
Verwandeln Sie präzise Shot-Beschreibungen in überprüfbare Bewegungskonzepte vor der vollständigen Produktion.
Antworten auf häufige Fragen zu Preisen, Eingaben, Aufgabenstatus und der ShengShu Video-API.