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'img_uuid restituito o ricevi callback di stato.
Ottieni Chiave API
Scena cinematografica in riva al lago che rappresenta la coerenza da riferimento a video

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.
Maquette di personaggi senza marchio disposte insieme per riferimento visivo

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.
Rig di ripresa cinematografica che rappresenta un flusso di lavoro di produzione asincrono
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 model su viduq3_reference e fornisci il prompt di testo richiesto che descrive il video desiderato.

Immagini di riferimento

Invia da 1 a 7 URL in image_urls. 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 image_urls, non image_url o image_end_url. Utilizza viduq3_pro 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 540p, 720p o 1080p. Il valore predefinito documentato è 720p.

Rapporto di output

Imposta ratio su 16:9, 9:16 o 1:1; il valore predefinito documentato è 16:9. aspect_ratio è 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.
Ottieni chiave API
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.

FAQ sull'API Vidu Q3 Reference

Qual è l'endpoint dell'API Vidu Q3 Reference su GoEnhance?

Invia una POST https://api.goenhance.ai/api/v1/videos/generations con model impostato su viduq3_reference. Un invio riuscito restituisce img_uuid per il monitoraggio asincrono.

Come funziona il prezzo dell'API Vidu Q3 Reference?

Il prezzo è per secondo generato: 1,75 token/s (0,035 $/s) a 540p, 3 token/s (0,06 $/s) a 720p e 3,75 token/s (0,075 $/s) a 1080p. Moltiplica la tariffa selezionata per la durata.

Quante immagini di riferimento posso inviare?

L'array image_urls documentato richiede da 1 a 7 immagini. Ognuna deve soddisfare i limiti pubblicati di formato, dimensione, risoluzione e rapporto d'aspetto.

Posso inviare image_url o image_end_url?

No. Questo percorso di riferimento dedicato accetta image_urls. Utilizza il percorso viduq3_pro documentato separatamente per text-to-video, image-to-video con primo fotogramma o generazione con fotogramma iniziale e finale.

Quali valori di durata, risoluzione e rapporto sono supportati?

La durata è di 3-16 secondi. La risoluzione supporta 540p, 720p e 1080p. Il rapporto d'aspetto supporta 16:9, 9:16 e 1:1.

Come faccio a sapere quando il video è terminato?

Mantieni img_uuid ed effettua il polling di GET /api/v1/jobs/detail, oppure fornisci un custom_callback_url HTTPS pubblico. Le risposte di callback diverse da 200 vengono riprovate fino a tre volte con un timeout di tre secondi per tentativo.

Questa è l'API ufficiale di ShengShu?

No. Vidu è sviluppato da ShengShu Technology. Questa pagina descrive l'accesso API di terze parti indipendente tramite GoEnhance e non implica affiliazione, partnership o approvazione.

In che modo Vidu Q3 Reference differisce dal livello di riferimento Turbo?

Questa pagina copre il percorso standard viduq3_reference. Il percorso viduq3_turbo_reference, documentato separatamente, è il livello di riferimento più veloce ed economico; non mischiare il suo identificatore di modello o i prezzi in questa richiesta.

Inizia a sviluppare con l'API Vidu Q3 Reference