img_uuid restituito e interroga o utilizza un callback per ricevere il video generato.API Vidu Q3 Turbo Reference per soggetti video coerenti
Accedi all'API Vidu Q3 Turbo Reference tramite l'API aperta GoEnhance indipendente. Invia 1–7 immagini di riferimento con un prompt, conserva l'
Ottieni chiave API
Crea una richiesta di riferimento-video valida
Fornisci 1–7 immagini di riferimento
Effettua una richiesta POST a https://api.goenhance.ai/api/v1/videos/generations con model: viduq3_turbo_reference, un prompt obbligatorio e un array image_urls contenente 1–7 URL di immagini pubbliche.
Traccia ogni attività asincrona
Scegli una durata da 1 a 16 secondi e una risoluzione di 540p, 720p o 1080p. Salva l'img_uuid restituito, quindi interroga GET /api/v1/jobs/detail o configura custom_callback_url.
Convalida il contratto solo riferimento prima di inviare un'attività di produzione.
Funzionalità e parametri dell'API Vidu Q3 Turbo Reference
ID modello esatto
Imposta <code>model</code> su <code>viduq3_turbo_reference</code>; mantieni il trattino basso esattamente com'è.
Prompt richiesto
Descrivi l'azione prevista, l'ambientazione, il comportamento della telecamera e il trattamento visivo nel <code>prompt</code>.
Array di riferimento
Fornisci 1–7 URL di immagini pubbliche tramite <code>image_urls</code>.
Percorso solo riferimento
Non inviare <code>image_url</code> o <code>image_end_url</code>; usa <code>viduq3_turbo</code> per quelle modalità.
Durata
Scegli un numero intero da 1 a 16 secondi. L'impostazione predefinita documentata è 5 secondi.
Risoluzione
Utilizza <code>540p</code>, <code>720p</code> o <code>1080p</code>; l'impostazione predefinita documentata è <code>720p</code>.
Stima il costo totale come tariffa al secondo selezionata moltiplicata per la durata richiesta.
Prezzi dell'API Vidu Q3 Turbo Reference
540p
1 token per secondo generato, pari a 0,02 $ al secondo alla tariffa documentata di 0,02 $ per token.
720p
2,5 token per secondo generato, pari a 0,05 $ al secondo alla tariffa documentata di 0,02 $ per token.
1080p
3,25 token per secondo generato, pari a 0,065 $ al secondo alla tariffa documentata di 0,02 $ per token.
Integra l'API Vidu Q3 Turbo 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 approvate su URL pubblici che la tua richiesta può fornire in
image_urls. 3
3. Convalida il payload
Imposta l'ID modello esatto, il prompt, la durata e una risoluzione documentata; ometti i campi relativi solo al primo fotogramma.
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 fornisci un URL di callback HTTPS pubblico. 6
6. Gestisci il completamento
Elabora il successo o il fallimento finale in modo idempotente e verifica il video restituito prima dell'utilizzo a valle.
Crea pipeline ripetibili in cui input visivi approvati guidano una scena generata.
Casi d'uso per sviluppatori per video basati su riferimenti
Continuità del personaggio
Utilizza diverse viste approvate del personaggio per guidare soggetti ricorrenti attraverso brevi clip generate.
Storytelling di prodotto
Fornisci riferimenti di prodotto e un prompt di scena per concetti di campagna revisionabili.
Varianti di campagna
Riutilizza un set di riferimenti visivi approvato modificando i prompt per diverse posizioni o ritmi narrativi.
Previsualizzazione
Trasforma i riferimenti di personaggi, oggetti di scena e ambienti in concetti di movimento prima della produzione completa.
Contenuti creativi localizzati
Parametrizza i prompt di scena mantenendo gli stessi riferimenti visivi approvati tra le varianti regionali.
Contenuti serializzati
Guida soggetti ricorrenti e direzione artistica attraverso attività asincrone inviate in modo indipendente.
Risposte a domande comuni su input, prezzi, stato delle attività e API ShengShu.