Por ahora esta guía solo está en inglés. →
Parámetros de la petición
| Parámetro | Obligatorio | Descripción |
|---|---|---|
duration_seconds | No | Cuánto dura el clip. Se cobra por segundo. ≥ 3 · ≤ 16 · Por defecto: 5 |
enable_prompt_expansion | No | Deja que el modelo añada detalles a un prompt corto. Por defecto: false |
generate_audio | No | Añade sonido acorde a la imagen: voces, ambiente y efectos. Por defecto: true |
image_url | Sí | La imagen de partida. |
prompt | Sí | Describe what happens after the opening frame: the action, the dialogue in quotes, the camera and the sound. |
resolution | No | Tamaño de salida. Más grande es más nítido y cuesta más. 540p · 720p · 1080p · 2k · 4k · Por defecto: 720p |
seed | No | Repite 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ón | Créditos por segundo | ≈ USD |
|---|---|---|
| resolution 540p | 6,75 | 0,068 US$ |
| resolution 720p | 14,25 | 0,14 US$ |
| resolution 1080p | 18 | 0,18 US$ |
| resolution 2K | 28,5 | 0,29 US$ |
| resolution 4K | 58,5 | 0,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
- 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.
- Envía la solicitud. Haz POST /jobs/createTask con model vidu/q4-preview/image-to-video y un objeto input según la tabla de parámetros. La respuesta devuelve un ID de tarea al instante.
- 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/image-to-video",
"input": {
"prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
"image_url": "https://media.popnow.ai/influencer/examples/marco.webp",
"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 Imagen 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; Longitud del prompt (caracteres): 20,000. 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.
- API de Vidu Q4 PreviewClips hasta 4K con sonido y diálogos habladosDesde 34 créditos por un clip de 5 segundos
- API de Vidu Q3 TurboAnimación rápida de imágenes con sonido, hasta 16 segundosDesde 32 créditos por un clip de 5 segundos
- API de Vidu Q3Anima una imagen hasta 16 segundos en 1080pDesde 53 créditos por un clip de 5 segundos
- API de Vidu Q3 ProAnima una imagen con sonido activado de serie, hasta 16 segundosDesde 41 créditos por un clip de 5 segundos

