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.
