img_uuid devuelto o reciba devoluciones de llamada de estado.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
Obtener clave de API
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.
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.
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 <code>model</code> en <code>viduq3_reference</code> y proporcione el prompt de texto obligatorio que describe el video deseado.
Imágenes de referencia
Envíe de 1 a 7 URL en <code>image_urls</code>. 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 <code>image_urls</code>, no <code>image_url</code> o <code>image_end_url</code>. Utilice <code>viduq3_pro</code> 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 <code>540p</code>, <code>720p</code> o <code>1080p</code>. El valor predeterminado documentado es <code>720p</code>.
Relación de salida
Establezca <code>ratio</code> en <code>16:9</code>, <code>9:16</code> o <code>1:1</code>; el valor predeterminado documentado es <code>16:9</code>. <code>aspect_ratio</code> 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.
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.