img_uuid devuelto y realice sondeos o utilice una devolución de llamada (callback) para recibir el video generado.API Vidu Q3 Turbo Reference para sujetos de video consistentes
Acceda a la API Vidu Q3 Turbo Reference a través de la API abierta e independiente de GoEnhance. Envíe de 1 a 7 imágenes de referencia con un prompt, conserve el
Obtener clave de API
Cree una solicitud válida de referencia a video
Proporcione de 1 a 7 imágenes de referencia
Realice una solicitud POST a https://api.goenhance.ai/api/v1/videos/generations con model: viduq3_turbo_reference, un prompt obligatorio y una matriz image_urls que contenga de 1 a 7 URL de imágenes públicas.
Realice un seguimiento de cada tarea asíncrona
Elija una duración de 1 a 16 segundos y una resolución de 540p, 720p o 1080p. Guarde el img_uuid devuelto, luego realice un sondeo a GET /api/v1/jobs/detail o configure una custom_callback_url.
Valide el contrato exclusivo de referencia antes de enviar una tarea de producción.
Capacidades y parámetros de la API Vidu Q3 Turbo Reference
ID de modelo exacto
Establezca <code>model</code> en <code>viduq3_turbo_reference</code>; conserve el guion bajo exactamente.
Prompt obligatorio
Describa la acción prevista, el entorno, el comportamiento de la cámara y el tratamiento visual en el <code>prompt</code>.
Matriz de referencia
Proporcione de 1 a 7 URL de imágenes públicas a través de <code>image_urls</code>.
Ruta exclusiva de referencia
No envíe <code>image_url</code> ni <code>image_end_url</code>; utilice <code>viduq3_turbo</code> para esos modos.
Duración
Elija un número entero de 1 a 16 segundos. El valor predeterminado documentado es de 5 segundos.
Resolución
Utilice <code>540p</code>, <code>720p</code> o <code>1080p</code>; el valor predeterminado documentado es <code>720p</code>.
Estime el costo total como la tarifa seleccionada por segundo multiplicada por la duración solicitada.
Precios de la API de referencia de Vidu Q3 Turbo
540p
1 token por segundo generado, equivalente a $0.02 por segundo a la tarifa documentada de $0.02 por token.
720p
2.5 tokens por segundo generado, equivalente a $0.05 por segundo a la tarifa documentada de $0.02 por token.
1080p
3.25 tokens por segundo generado, equivalente a $0.065 por segundo a la tarifa documentada de $0.02 por token.
Integre la API de referencia de Vidu Q3 Turbo en seis pasos
1
1. Cree una clave de API
Cree una clave de GoEnhance y envíela como un token de portador (bearer token) en el encabezado de autorización.
2
2. Prepare las referencias
Aloje de 1 a 7 imágenes de referencia aprobadas en URLs públicas que su solicitud pueda proporcionar en
image_urls. 3
3. Valide la carga útil
Establezca el ID de modelo exacto, el prompt, la duración y una resolución documentada; omita los campos exclusivos del primer fotograma.
4
4. Envíe la tarea
Realice un POST a
/api/v1/videos/generations y conserve el img_uuid devuelto. 5
5. Rastree el estado
Consulte
GET /api/v1/jobs/detail o proporcione una URL de devolución de llamada HTTPS pública. 6
6. Gestione la finalización
Procese el éxito o el fallo terminal de forma idempotente y verifique el video devuelto antes de su uso posterior.
Cree pipelines repetibles donde las entradas visuales aprobadas guíen una escena generada.
Casos de uso para desarrolladores de video basado en referencias
Continuidad de personajes
Utilice varias vistas de personajes aprobadas para guiar a los sujetos recurrentes a través de clips generados cortos.
Narrativa de producto
Proporcione referencias de producto y un prompt de escena para conceptos de campaña revisables.
Variantes de campaña
Reutilice un conjunto de referencias visuales aprobado mientras cambia los prompts para diferentes ubicaciones o ritmos narrativos.
Previsualización
Convierta referencias de personajes, accesorios y entornos en conceptos de movimiento antes de la producción completa.
Creatividad localizada
Parametrice los prompts de escena manteniendo las mismas referencias visuales aprobadas en las variantes regionales.
Contenido serializado
Guíe a los sujetos recurrentes y la dirección artística a través de tareas asíncronas enviadas de forma independiente.
Respuestas a preguntas comunes sobre entradas, precios, estado de tareas y la API de ShengShu.