vidu/q4-preview/reference-to-videoDesde 34 créditos por un clip de 5 segundos· Referencias a video

Vidu Q4 Preview reference-to-video construye una escena a partir de 1 a 15 imágenes de referencia y hasta 3 clips de voz, en 16:9, 9:16, 1:1, 3:4 o 4:3. Los clips duran de 3 a 16 segundos, de 540p a 4k, con sonido generado.

Llámalo con el nombre de modelo vidu/q4-preview/reference-to-video en POST /jobs/createTask, desde 34 créditos por un clip de 5 segundos (0,34 US$). Las cuentas nuevas reciben 30 créditos gratis para que lo pruebes primero en el Playground.

  • Imagen a video
  • Referencias a video
  • Extender video
  • Hasta 4K
  • Clips de 3 a 16 s
  • Con sonido
  • Hasta 15 imágenes de referencia
  • 5 relaciones de aspecto

Por ahora esta guía solo está en inglés. →

Parámetros de la petición

ParámetroObligatorioDescripción
aspect_ratioNoLa forma del encuadre: horizontal, cuadrado o vertical. 16:9 · 9:16 · 1:1 · 3:4 · 4:3 · Por defecto: 16:9
duration_secondsNoCuánto dura el clip. Se cobra por segundo. ≥ 3 · ≤ 16 · Por defecto: 5
generate_audioNoAñade sonido acorde a la imagen: voces, ambiente y efectos. Por defecto: true
promptSíDescribe the scene and refer to each reference by its position: "the woman from the first image", "the robe from the second image".
reference_audio_urlsNoAudio que imitar: una voz, una música o un ritmo.
reference_image_urlsSíImágenes de las personas, prendas o lugares que el resultado debe mantener.
resolutionNoTamaño de salida. Más grande es más nítido y cuesta más. 540p · 720p · 1080p · 2k · 4k · Por defecto: 720p
seedNoRepite el mismo número para obtener un resultado reproducible. ≥ 0 · ≤ 2147483647

Precios

Los precios están en créditos, los mismos que usas en la web (1 crédito = 0,01 $). El importe se retiene cuando se acepta la tarea y se liquida al coste real cuando termina; las tareas fallidas se reembolsan.

OpciónCréditos por segundo≈ USD
resolution 540p6,750,068 US$
resolution 720p14,250,14 US$
resolution 1080p180,18 US$
resolution 2K28,50,29 US$
resolution 4K58,50,59 US$

Cada tarea se redondea al alza a créditos enteros, así que una ejecución en el nivel más bajo cuesta 34 créditos por un clip de 5 segundos (0,34 US$).

Para saber la cifra exacta antes de ejecutar, envía el mismo cuerpo a POST /jobs/quote.

Inicio rápido de la API

Llama a la API de Vidu Q4 Preview en tres pasos

  1. Crea una clave de API. Inicia sesión en PopNow y crea una clave en la consola de la API. Las claves empiezan por sk-popnow- y usan los mismos créditos que el sitio web.
  2. Envía la solicitud. Haz POST /jobs/createTask con model vidu/q4-preview/reference-to-video y un objeto input según la tabla de parámetros. La respuesta devuelve un ID de tarea al instante.
  3. Obtén el resultado. Consulta GET /jobs/recordInfo con el ID de tarea, o pasa una callBackUrl y te enviamos el resultado ahí. Descarga los enlaces de salida cuando la tarea termine bien.
# 1. Create the task. Keep the Idempotency-Key if you retry after a network error.
export IDEMPOTENCY_KEY="$(uuidgen)"
curl -X POST https://api.popnow.ai/api/v1/jobs/createTask \
  -H "Authorization: Bearer $POPNOW_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $IDEMPOTENCY_KEY" \
  -d '{
  "model": "vidu/q4-preview/reference-to-video",
  "input": {
    "prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
    "reference_image_urls": [
      "https://media.popnow.ai/influencer/examples/ava.webp"
    ],
    "aspect_ratio": "16:9",
    "resolution": "720p",
    "duration_seconds": 5
  }
}'

# 2. Copy data.taskId from the response, then poll until state is succeeded, failed, canceled or expired.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
  -H "Authorization: Bearer $POPNOW_API_KEY"

Sustituye el prompt y los enlaces por los tuyos. La pestaña API tiene la referencia de la respuesta, el sondeo y el callback.

Preguntas sobre la API de Vidu Q4 Preview

¿Cuánto cuesta la API de Vidu Q4 Preview?

Vidu Q4 Preview cuesta desde 34 créditos (0,34 US$) por un clip de 5 segundos con Referencias a video, su tarea más barata. Precios por opción: 540p 6,75 créditos por segundo, 720p 14,25 créditos por segundo, 1080p 18 créditos por segundo, 2K 28,5 créditos por segundo. Los créditos son los mismos que en la web (1 crédito = 0,01 $), las cuentas nuevas reciben 30 créditos gratis y las tareas fallidas se reembolsan.

¿Cuál es el nombre de modelo de Vidu Q4 Preview en la API?

Pon vidu/q4-preview/image-to-video para Imagen a video; vidu/q4-preview/reference-to-video para Referencias a video; vidu/q4-preview/video-extend para Extender video en el campo model de POST /jobs/createTask.

¿Qué es Vidu Q4 Preview?

La vista previa pública del modelo de video Q4 de Vidu, lanzada el 7 de octubre de 2026 antes del modelo Q4 completo. Ofrece image-to-video, reference-to-video y video-extend. No hay text-to-video.

¿Cuánto duran los clips y en qué resolución?

De 3 a 16 segundos enteros a 24 fotogramas por segundo, en 540p, 720p (por defecto), 1080p, 2k o 4k. Image-to-video conserva la forma de tu cuadro; reference-to-video acepta 16:9, 9:16, 1:1, 3:4 o 4:3.

¿Genera sonido y puede decir frases?

Sí. Diálogos, efectos y ambiente se generan junto con la imagen, y un interruptor los apaga. Pon las frases habladas entre comillas dobles en el prompt; en nuestras ejecuciones la frase entre comillas se pronunció. Con un clip de voz de referencia, escribe también la frase en el prompt.

¿Cuántas referencias puedo usar?

Reference-to-video acepta de 1 a 15 imágenes de referencia (personas, atuendos, productos o lugares) y hasta 3 clips de audio; Vidu pide MP3 de 3 a 12 segundos cada uno. En nuestras ejecuciones tres referencias volvieron como una sola escena, y dos retratos conservaron ambos rostros.

¿Por qué mi archivo 4k no se reproduce en el navegador?

Los clips de 2k y 4k son archivos HEVC (H.265) de 10 bits, que algunos navegadores no pueden reproducir directamente. Ábrelos en un reproductor o editor de escritorio, o transcodifícalos. 540p, 720p y 1080p son H.264 y se reproducen casi en cualquier parte.

¿Qué límites tiene la API de Vidu Q4 Preview?

Duración del clip: 3–16 s; Resoluciones: 540p · 720p · 1080p · 2K · 4K; Relaciones de aspecto: 16:9 · 9:16 · 1:1 · 3:4 · 4:3; Audio de referencia: 3; Imágenes de referencia: 15. Las peticiones fuera de estos límites se rechazan antes de cobrar nada.

¿Puedo probar Vidu Q4 Preview sin escribir código?

Sí. El Playground ejecuta Vidu Q4 Preview con tus créditos de PopNow, no necesita clave API y te muestra el código de cada generación.

Todos los modelos de Vidu

Vidu Q3 es el modelo consolidado de imagen a vídeo, con tope en 1080p. Q4 Preview añade escenas de referencia, extensión de clips y salida hasta 4K, y arranca con un precio por segundo más bajo.

Más sobre Vidu Q4 Preview