img_uuid devuelto y luego realice sondeos o reciba devoluciones de llamada hasta que el trabajo se complete o falle.API de Vidu Q3 Pro para generación de video
Acceda a Vidu Q3 Pro a través de la API abierta e independiente de GoEnhance para generación de texto a video, imagen a video y generación de fotograma inicial-final. Envíe una solicitud asíncrona, guarde el
Obtener clave de API
Cree una solicitud clara para la API de Vidu Q3 Pro
Tres modos de entrada en un mismo endpoint
Realice un POST a https://api.goenhance.ai/api/v1/videos/generations con model: viduq3_pro. Utilice solo un prompt para texto a video, añada image_url para un fotograma inicial, o añada image_end_url para la generación de fotograma inicial-final.
Controles explícitos y finalización asíncrona
Valide la duración, resolución y relación de aspecto de texto a video antes del envío. Guarde el ID de tarea devuelto y luego utilice GET /api/v1/jobs/detail o una custom_callback_url HTTPS pública para gestionar los resultados finales.
Ajuste el esquema de solicitud documentado antes de que una tarea entre en su flujo de trabajo de video.
Capacidades y parámetros de la API de Vidu Q3 Pro
Modelo
Establezca <code>model</code> en <code>viduq3_pro</code>.
Prompt
Proporcione el prompt de texto requerido que describe el video deseado.
Fotograma inicial
Añada una <code>image_url</code> pública para la generación de imagen a video; omítala para texto a video.
Fotograma final
Añada <code>image_end_url</code> junto con <code>image_url</code> para el control de fotograma inicial-final.
Duración
Elija un número entero de 1 a 16 segundos. El valor predeterminado documentado es de 5 segundos.
Resolución y relación de aspecto
La resolución acepta 540p, 720p o 1080p, con 720p como valor predeterminado. El campo <code>ratio</code> se aplica a las solicitudes de texto a video.
Estime el costo de generación como la tarifa seleccionada por segundo multiplicada por la duración solicitada.
Precios de la API de Vidu Q3 Pro
540p
2.25 tokens por segundo generado, equivalente a $0.045 por segundo a la tarifa documentada de $0.02 por token.
720p
5 tokens por segundo generado, equivalente a $0.10 por segundo a la tarifa documentada de $0.02 por token.
1080p
6 tokens por segundo generado, equivalente a $0.12 por segundo a la tarifa documentada de $0.02 por token.
Integre Vidu Q3 Pro 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. Seleccione el modo de entrada
Utilice solo un prompt, añada una URL del primer fotograma o añada las URLs tanto del primer como del último fotograma.
3
3. Valide la solicitud
Establezca
viduq3_pro, una duración de 1 a 16 segundos y uno de los valores de resolución documentados. 4
4. Envíe la tarea de video
Realice un POST a
/api/v1/videos/generations y guarde el img_uuid devuelto. 5
5. Realice el seguimiento del estado
Consulte
GET /api/v1/jobs/detail o configure una URL de devolución de llamada HTTPS pública. 6
6. Gestione la finalización
Procese los estados de éxito y error de forma idempotente y verifique el activo devuelto antes de su uso posterior.
Cree flujos de trabajo de generación de video repetibles basados en entradas explícitas y estados de tarea terminales.
Casos de uso para desarrolladores de la API de Vidu Q3 Pro
Variantes de video para campañas
Genere clips conceptuales cortos a partir de prompts estructurados para revisión creativa y ensamblaje posterior.
Movimiento de productos
Anime un fotograma de producto aprobado mientras su aplicación controla los prompts, la validación y la revisión de activos.
Transiciones de guion gráfico
Utilice entradas de primer y último fotograma para explorar el movimiento entre dos puntos visuales aprobados.
Canales creativos localizados
Parametrice los prompts para variantes de campañas regionales sin cambiar el gestor de tareas asíncronas.
Producción de video para redes sociales
Cree activos de movimiento breves con la resolución y duración seleccionadas por su aplicación.
Previsualización
Convierta descripciones concisas de tomas en conceptos de movimiento revisables antes de la producción completa.
Respuestas a preguntas comunes sobre precios, entradas, estado de tareas y la API de video de ShengShu.