APIMaster.ai

Vidu Video Q4 Preview · Referencia de la API

Generar un vídeo a partir de una sola imagen o referencias, luego encuestar la tarea APIMaster.

Utilice POST /v1/wand/vidu/image-to-video para una única imagen de inicio o POST /v1/wand/vidu/reference-to-video para la generación guiada por referencia. Encuesta con GET /v1/wand/vidu/tasks/{task_id}. Utilice JSON para enviar y autenticación Bearer para cada solicitud. Para este modelo no se dispone de generación de sólo texto ni de un punto final de inicio/final.

Campo Tipo Descripción
model string Obligatorio. Utilice vidu-video-q4-preview.
images string[] Image-to-video requiere exactamente una imagen. Reference-to-video acepta hasta imágenes 15 o subjects. Utilice URLs público o URI de datos en PNG, JPEG/JPG, o WebP. La relación de aspecto debe ser 1:4 a 4:1. Cada imagen URL puede ser hasta 50 MB. Las imágenes Base64 se limitan a 15 MB antes de la codificación y 20 MB codificado en total.
subjects object[] Para reference-to-video como alternativa a images. Ajuste el name de cada elemento y de uno a tres images. Consulte un sujeto con @name en el prompt.
prompt string Requerido para reference-to-video. Hasta 2,000 para referencias directas de imágenes o 5,000 para sujetos y image-to-video. Image-to-video ignora este campo cuando is_rec está activado.
auto_subjects boolean Opción de biblioteca de asunto para reference-to-video. Valor predeterminado: false.
audio boolean Por defecto a true para image-to-video y false para reference-to-video. El vídeo de referencia con audio requiere subjects y un valor true explícito.
audio_type string Cuando el audio está activado, utilice all (predeterminado), speech_only, o sound_effect_only.
is_rec boolean Recomendación rápida automática para image-to-video. Habilitando aumenta el uso de tareas.
duration integer De 3 a 16 segundos, con 5 como el predeterminado.
resolution string 540p, 720p (por defecto), 1080p, 2K, o 4K.
aspect_ratio string Sólo Reference-to-video. Utilice 16:9 (predeterminado), 9:16, 3:4, 4:3, o 1:1. Image-to-video sigue la imagen de entrada.
seed integer Omite el campo o usa 0 para elegir una semilla aleatoria.
payload string Datos de aplicación opcionales, hasta caracteres 1,048,576.
watermark boolean Valor predeterminado: false.
wm_url string Marca de agua URL opcional personalizada. La marca de agua predeterminada aparece en la parte superior izquierda. La API no acepta wm_position.
curl -X POST "https://apimaster.ai/v1/wand/vidu/image-to-video" \
  -H "Authorization: Bearer $APIMASTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"vidu-video-q4-preview","images":["https://example.com/reference.jpg"],"prompt":"Slow camera pan","duration":5,"resolution":"720p"}'

Consulta el estado cada 5–10 segundos con el task_id y la misma cuenta. Los estados son created, queueing, processing, success y failed. En el éxito, creations[].url es el vídeo y creations[].cover_url es su cubierta. Descargue enlaces temporales dentro de las horas 12. Mantenga request_id cuando informe de un fallo.

Utilice un Idempotency-Key de 8–128 visible ASCII caracteres para recuperar una presentación. La misma clave con los mismos parámetros devuelve un recibo de recuperación con HTTP 202. La misma clave con otros parámetros devuelve HTTP 409. Véase Guía para recuperar una solicitud. Los tiempos de espera de las consultas pueden ser juzgados de nuevo sin crear un nuevo vídeo.

La puerta de entrada establece la generación una vez. tokenhub_usage.total_tokens informa de uso facturable. Consulte la tarjeta Vidu Video Q4 Preview modelo para el precio actual de APIMaster.