Crear tarea de texto a video
- Documentación oficial: https://platform.vidu.cn/docs/text-to-video
- Crear una tarea de texto a video y devolver task_id
- Controlar la generación con model, prompt y otros parámetros
Authorizations
Request Body
Prompt de texto
Descripción de texto para generar el video.
Nota: No debe superar los 2000 caracteres
Nombre del modelo
Valores permitidos: viduq3-turbo, viduq3-pro, viduq2, viduq1
- viduq3-turbo: Generación más rápida que viduq3-pro
- viduq3-pro: Audio y video de alta calidad de forma eficiente; salida más vívida, expresiva y con más profundidad
- viduq2: Modelo más reciente
- viduq1: Imágenes claras, transiciones suaves, movimiento de cámara estable
Estilo
Por defecto general; permitidos: general, anime
general: Estilo general; control mediante el prompt
anime: Estilo anime; aspecto anime destacado; control mediante distintos prompts de estilo anime
Nota: No tiene efecto al usar el modelo q2
Duración del video; el valor por defecto 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 se permite 5
Semilla aleatoria
Si se omite o es 0, se usa un valor aleatorio
Si se establece manualmente, se usa esa semilla
Relación de aspecto
Por defecto 16:9; permitidos: 16:9, 9:16, 3:4, 4:3, 1:1
Nota: 3:4 y 4:3 solo se admiten en el modelo q2
Resolución; el valor por defecto depende del modelo y la duración:
- viduq3-pro, viduq3-turbo (1–16 s): 720p por defecto, permitidos 540p, 720p, 1080p
- viduq2 (1–10 s): 720p por defecto, permitidos 540p, 720p, 1080p
- viduq1 (5 s): 1080p por defecto, permitido 1080p
Amplitud de movimiento
Por defecto auto; permitidos: auto, small, medium, large
Nota: No tiene efecto al usar el modelo q2
Si se añade música de fondo al video generado.
Por defecto false; permitidos true, false
Si es true, el sistema elige música adecuada de la biblioteca BGM predefinida.
- La duración del BGM no está limitada; se adapta a la duración del video
Parámetro de paso directo
No se procesa; solo transferencia de datos
Nota: Máximo 1048576 caracteres
Si se añade marca de agua
- true: añadir marca de agua
- false: sin marca de agua
Nota 1: El contenido de la marca de agua es fijo (generado por IA); desactivado por defecto
Nota 2: Use watermarked_url de la API de consulta de tareas para el video con marca de agua
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 la imagen de marca de agua
Si se omite, texto por defecto: Contenido generado por IA
Identificador de metadatos (cadena JSON), paso directo; 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 por defecto los metadatos generados por Vidu
URL de callback (POST). Configúrela al crear la tarea; Vidu envía actualizaciones de estado a esta URL. El cuerpo coincide con la respuesta de 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; consulte la documentación de firma de callback
Responses
Éxito