img_uuid restituito o ricevi callback di stato.API Vidu Q3 Reference per Video Coerenti
Accedi a Vidu Q3 Reference tramite l'Open API indipendente di GoEnhance. Fornisci da 1 a 7 immagini di riferimento con un prompt, invia un'attività video asincrona, quindi esegui il polling con l'
Ottieni Chiave API
Crea una richiesta API Vidu Q3 Reference
Input di immagini di riferimento creato per la coerenza
Invia una richiesta POST a https://api.goenhance.ai/api/v1/videos/generations con model: viduq3_reference, un prompt obbligatorio e image_urls contenente da 1 a 7 immagini di riferimento pubbliche.
Richieste convalidate e risultati asincroni
Convalida formato immagine, dimensioni, proporzioni, durata, risoluzione e rapporto di output prima dell'invio. Salva l'img_uuid, quindi esegui il polling di GET /api/v1/jobs/detail o utilizza un callback HTTPS pubblico.
Rispetta lo schema di richiesta da riferimento a video documentato prima di inviare un'attività.
Funzionalità e limiti dell'API Vidu Q3 Reference
Modello e prompt
Imposta <code>model</code> su <code>viduq3_reference</code> e fornisci il prompt di testo richiesto che descrive il video desiderato.
Immagini di riferimento
Invia da 1 a 7 URL in <code>image_urls</code>. Ogni immagine deve essere PNG, JPEG, JPG o WebP; almeno 128×128 pixel; non superiore a 50 MB; e con proporzioni comprese tra 1:4 e 4:1.
Modalità di input dedicata
Questo percorso accetta <code>image_urls</code>, non <code>image_url</code> o <code>image_end_url</code>. Utilizza <code>viduq3_pro</code> per la generazione basata solo su testo, primo fotogramma o fotogramma iniziale-finale.
Durata
Scegli un numero intero da 3 a 16 secondi. Il valore predefinito documentato è 5 secondi.
Risoluzione
Seleziona <code>540p</code>, <code>720p</code> o <code>1080p</code>. Il valore predefinito documentato è <code>720p</code>.
Rapporto di output
Imposta <code>ratio</code> su <code>16:9</code>, <code>9:16</code> o <code>1:1</code>; il valore predefinito documentato è <code>16:9</code>. <code>aspect_ratio</code> è accettato come alias compatibile.
Stima il costo come tariffa selezionata al secondo moltiplicata per la durata richiesta.
Prezzi dell'API Vidu Q3 Reference
540p
1,75 token per secondo generato, pari a $0,035 al secondo alla tariffa documentata di $0,02 per token.
720p
3 token per secondo generato, pari a $0,06 al secondo alla tariffa documentata di $0,02 per token.
1080p
3,75 token per secondo generato, pari a $0,075 al secondo alla tariffa documentata di $0,02 per token.
Integra Vidu Q3 Reference in sei passaggi
1
1. Crea una chiave API
Crea una chiave GoEnhance e inviala come bearer token nell'intestazione Authorization.
2
2. Prepara i riferimenti
Ospita da 1 a 7 immagini di riferimento conformi su URL pubblici e decidi quali dettagli visivi il prompt debba preservare.
3
3. Convalida la richiesta
Imposta
viduq3_reference, una durata da 3 a 16 secondi, una risoluzione supportata e un rapporto supportato. 4
4. Invia l'attività
Esegui una richiesta POST a
/api/v1/videos/generations e conserva l'img_uuid restituito. 5
5. Monitora lo stato
Esegui il polling di
GET /api/v1/jobs/detail o configura un custom_callback_url HTTPS pubblico. 6
6. Gestisci il completamento
Elabora gli stati di successo e fallimento in modo idempotente, quindi verifica l'asset generato prima dell'utilizzo a valle.
Costruisci flussi di lavoro ripetibili da riferimento a video attorno a input espliciti e stati finali dell'attività.
Casi d'uso per sviluppatori per l'API Vidu Q3 Reference
Clip di campagna basate sui personaggi
Trasporta personaggi di fantasia approvati o riferimenti di talent in brevi concept video per campagne.
Sequenze di identità di prodotto
Utilizza molteplici viste di prodotto approvate come riferimenti visivi per l'esplorazione creativa focalizzata sul movimento.
Continuità narrativa
Fai riferimento a soggetti ricorrenti durante la generazione di riprese separate per storyboard e flussi di lavoro di previsualizzazione.
Varianti creative localizzate
Riutilizza i riferimenti visivi approvati adattando i prompt per i concept di campagne regionali.
Asset social coerenti nello stile
Costruisci pipeline video in formato breve attorno a un set controllato di riferimenti visivi e rapporti di output.
Prototipazione creativa
Testa combinazioni di riferimenti, prompt, durate e risoluzioni prima di impegnarti in un flusso di lavoro di produzione più ampio.
Risposte a domande comuni su prezzi, input di riferimento, attività asincrone e API ShengShu.