Crear tarea de imagen a video
- Documentación oficial: https://platform.vidu.cn/docs/image-to-video
- Crea una tarea de imagen a video y devuelve task_id o detalles de la tarea
- Controla la generación con los parámetros de la solicitud
Authorizations
Request Body
Indicación de texto
Descripción textual para generar el video.
Nota: No debe superar 2000 caracteres
Nombre del modelo
Valores permitidos: viduq2, viduq1, viduq3-turbo, viduq3-pro
- viduq3-turbo: Generación más rápida que viduq3-pro
- viduq3-pro: Audio-video de calidad; resultado más vívido y expresivo
- viduq2: Modelo más reciente
- viduq1: Imagen clara, transiciones suaves, movimiento de cámara estable
Duración del video; el valor predeterminado depende del modelo:
- viduq3-pro, viduq3-turbo: 5 s por defecto, rango 1–16
- viduq2: 5 s por defecto, rango 1–10
- viduq1: 5 s por defecto, solo 5
Semilla aleatoria
Si se omite o es 0, se usa un valor aleatorio
Si se establece manualmente, se usa esa semilla
Resolución; el valor predeterminado depende del modelo y la duración:
- viduq3-pro, viduq3-turbo (1–16 s): 720p por defecto, permitido 540p, 720p, 1080p
- viduq2 (1–10 s): 720p por defecto, permitido 540p, 720p, 1080p
- viduq1 (5 s): 1080p por defecto, permitido 1080p
Amplitud de movimiento
Por defecto auto; permitido: auto, small, medium, large
Nota: No tiene efecto con el modelo q2
Parámetro de tránsito
No se procesa; solo transferencia de datos
Nota: Máximo 1048576 caracteres
Modo fuera de hora punta; por defecto false; permitido:
- true: generar video en modo fuera de hora punta
- false: generar video de inmediato
Nota 1: El modo fuera de hora punta consume menos créditos; ver precios
Nota 2: Las tareas fuera de hora punta se procesan en 48 horas; las no completadas se cancelan con reembolso de créditos
Nota 3: Puede cancelar manualmente una tarea fuera de hora punta
Si añadir marca de agua
- true: añadir marca de agua
- false: no añadir
Nota 1: El contenido de la marca es fijo (generado por IA); desactivado por defecto
Nota 2: Video con marca de agua mediante watermarked_url en la API de consulta de tareas
Posición de la marca de agua en la imagen:
1: superior izquierda
2: superior derecha
3: inferior derecha
4: inferior izquierda
Por defecto: 3
URL de imagen de la marca de agua
Si se omite, texto predeterminado: contenido generado por IA
Identificador de metadatos (cadena JSON), tránsito; formato personalizado o de ejemplo:
{
"Label": "your_label","ContentProducer": "yourcontentproducer","ContentPropagator": "your_content_propagator","ProduceID": "yourproductid", "PropagateID": "your_propagate_id","ReservedCode1": "yourreservedcode1", "ReservedCode2": "your_reserved_code2"
}
Si está vacío, se usan metadatos generados por Vidu por defecto
URL de callback (POST). Configúrela al crear la tarea; Vidu envía actualizaciones de estado. El cuerpo coincide con la API de consulta de tareas.
Valores de status en el callback:
- processing: en proceso
- success: completado (hasta 3 reintentos si falla el envío)
- failed: fallido (hasta 3 reintentos si falla el envío)
Vidu usa autenticación por firma de callback; ver documentación de firma
Imagen del primer fotograma
El modelo usa la imagen de este parámetro como primer fotograma para generar el video.
Nota 1: Admite Base64 de imagen o URL de imagen (debe ser accesible)
Nota 2: Solo 1 imagen
Nota 3: Formatos: png, jpeg, jpg, webp
Nota 4: La relación de aspecto debe ser menor que 1:4 o 4:1
Nota 5: Tamaño máximo de imagen 50 MB
Nota 6: El cuerpo POST HTTP no debe superar 20 MB; incluya Content-Type adecuado, p. ej.:
data:image/png;base64,{base64_encode}
Si usar salida directa de audio-video; por defecto false; permitido:
- false: sin salida directa (video silencioso)
- true: video con diálogo y audio de fondo
Nota 1: voice_id solo aplica cuando este parámetro es true
Nota 2: Cuando model es q3-pro o q3-turbo, el valor predeterminado es true
Nota 3: No se admite modo fuera de hora punta cuando este parámetro es true
ID de voz
Determina el timbre en el video; si está vacío, el sistema recomienda. Lista: https://shengshu.feishu.cn/sheets/EgFvs6DShhiEBStmjzccr5gonOg
Si usar indicaciones recomendadas
- true: el sistema recomienda indicaciones (cantidad=1) y genera con ellas
- false: generar según el prompt de entrada
Nota: Las indicaciones recomendadas añaden 10 créditos por tarea
Responses
Éxito