API de Vidu Q3 Reference para video consistente

Acceda a Vidu Q3 Reference a través de la API abierta e independiente de GoEnhance. Proporcione de 1 a 7 imágenes de referencia con un prompt, envíe una tarea de video asíncrona y luego realice un sondeo con el img_uuid devuelto o reciba devoluciones de llamada de estado.
Obtener clave de API
Escena cinematográfica junto al lago que representa la consistencia de referencia a video

Crear una solicitud de API de Vidu Q3 Reference

Entrada de imagen de referencia diseñada para la consistencia

Realice un POST a https://api.goenhance.ai/api/v1/videos/generations con model: viduq3_reference, un prompt obligatorio y image_urls que contenga de 1 a 7 imágenes de referencia públicas.
Maquetas de personajes sin marca organizadas juntas para referencia visual

Solicitudes validadas y resultados asíncronos

Valide el formato de imagen, las dimensiones, la relación de aspecto, la duración, la resolución y la relación de salida antes de enviarla. Conserve el img_uuid, luego realice un sondeo a GET /api/v1/jobs/detail o utilice una devolución de llamada HTTPS pública.
Equipo de cámara cinematográfica que representa un flujo de trabajo de producción asíncrono
Haga coincidir el esquema de solicitud de referencia a video documentado antes de enviar una tarea.

Capacidades y límites de la API de Vidu Q3 Reference

Modelo y prompt

Establezca model en viduq3_reference y proporcione el prompt de texto obligatorio que describe el video deseado.

Imágenes de referencia

Envíe de 1 a 7 URL en image_urls. Cada imagen debe ser PNG, JPEG, JPG o WebP; tener al menos 128×128 píxeles; no superar los 50 MB; y tener una relación de aspecto entre 1:4 y 4:1.

Modo de entrada dedicado

Esta ruta acepta image_urls, no image_url o image_end_url. Utilice viduq3_pro para la generación solo de texto, del primer fotograma o del fotograma inicial y final.

Duración

Elija un número entero de 3 a 16 segundos. El valor predeterminado documentado es de 5 segundos.

Resolución

Seleccione 540p, 720p o 1080p. El valor predeterminado documentado es 720p.

Relación de salida

Establezca ratio en 16:9, 9:16 o 1:1; el valor predeterminado documentado es 16:9. aspect_ratio se acepta como un alias compatible.
Estime el costo multiplicando la tarifa seleccionada por segundo por la duración solicitada.

Precios de la API de Vidu Q3 Reference

540p

1.75 tokens por segundo generado, equivalente a $0.035 por segundo a la tarifa documentada de $0.02 por token.

720p

3 tokens por segundo generado, equivalente a $0.06 por segundo a la tarifa documentada de $0.02 por token.

1080p

3.75 tokens por segundo generado, equivalente a $0.075 por segundo a la tarifa documentada de $0.02 por token.

Integre Vidu Q3 Reference 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 compatibles en URLs públicas y decida qué detalles visuales debe preservar el prompt.
3

3. Valide la solicitud

Establezca viduq3_reference, una duración de 3 a 16 segundos, una resolución admitida y una relación de aspecto admitida.
4

4. Envíe la tarea

Realice un POST a /api/v1/videos/generations y guarde el img_uuid devuelto.
5

5. Rastree el estado

Realice un sondeo a GET /api/v1/jobs/detail o configure una custom_callback_url HTTPS pública.
6

6. Gestione la finalización

Procese los estados de éxito y error de forma idempotente, luego verifique el activo generado antes de su uso posterior.
Obtener clave de API
Cree flujos de trabajo repetibles de referencia a video en torno a entradas explícitas y estados finales de tarea.

Casos de uso para desarrolladores de la API de Vidu Q3 Reference

Clips de campaña protagonizados por personajes

Incorpore personajes ficticios aprobados o referencias de talento en conceptos cortos de video para campañas.

Secuencias de identidad de producto

Utilice múltiples vistas de producto aprobadas como referencias visuales para la exploración creativa centrada en el movimiento.

Continuidad de la historia

Haga referencia a sujetos recurrentes al generar tomas separadas para flujos de trabajo de guiones gráficos y previsualización.

Variantes creativas localizadas

Reutilice referencias visuales aprobadas mientras adapta los prompts para conceptos de campañas regionales.

Activos sociales con estilo consistente

Cree flujos de trabajo de video de formato corto en torno a un conjunto controlado de referencias visuales y relaciones de aspecto.

Prototipado creativo

Pruebe combinaciones de referencias, prompts, duraciones y resoluciones antes de comprometerse con un flujo de trabajo de producción más amplio.
Respuestas a preguntas comunes sobre precios, entrada de referencia, tareas asíncronas y la API de ShengShu.

Preguntas frecuentes sobre la API de Vidu Q3 Reference

¿Cuál es el endpoint de la API de Vidu Q3 Reference en GoEnhance?

Envíe un POST https://api.goenhance.ai/api/v1/videos/generations con el model establecido en viduq3_reference. Un envío exitoso devuelve un img_uuid para el seguimiento asíncrono.

¿Cómo funcionan los precios de la API de Vidu Q3 Reference?

El precio es por segundo generado: 1.75 tokens/s ($0.035/s) a 540p, 3 tokens/s ($0.06/s) a 720p y 3.75 tokens/s ($0.075/s) a 1080p. Multiplique la tarifa seleccionada por la duración.

¿Cuántas imágenes de referencia puedo enviar?

La matriz image_urls documentada requiere de 1 a 7 imágenes. Cada una debe cumplir con los límites publicados de formato, tamaño, dimensiones y relación de aspecto.

¿Puedo enviar image_url o image_end_url?

No. Esta ruta de referencia dedicada acepta image_urls. Utilice la ruta viduq3_pro documentada por separado para texto a video, imagen a video desde el primer fotograma o generación de fotograma inicial y final.

¿Qué valores de duración, resolución y relación de aspecto son compatibles?

La duración es de 3 a 16 segundos. La resolución admite 540p, 720p y 1080p. La relación de aspecto admite 16:9, 9:16 y 1:1.

¿Cómo sé cuándo ha terminado el vídeo?

Conserve el img_uuid y realice consultas a GET /api/v1/jobs/detail, o proporcione una custom_callback_url HTTPS pública. Las respuestas de devolución de llamada que no sean 200 se reintentarán hasta tres veces con un tiempo de espera de tres segundos por intento.

¿Es esta la API oficial de ShengShu?

No. Vidu ha sido desarrollado por ShengShu Technology. Esta página describe el acceso a la API de terceros independientes a través de GoEnhance y no implica afiliación, asociación ni respaldo.

¿En qué se diferencia Vidu Q3 Reference del nivel de referencia Turbo?

Esta página cubre la ruta estándar viduq3_reference. La ruta viduq3_turbo_reference, documentada por separado, es el nivel de referencia más rápido y económico; no mezcle su identificador de modelo ni sus precios en esta solicitud.

Empiece a desarrollar con la API de Vidu Q3 Reference