Por ahora esta guía solo está en inglés. →
Parámetros de la petición
| Parámetro | Obligatorio | Descripción |
|---|---|---|
bgm | No | Add a background music bed that fits the scene. Por defecto: true |
duration_seconds | No | Cuánto dura el clip. Se cobra por segundo. ≥ 1 · ≤ 16 · Por defecto: 5 |
generate_audio | No | Añade sonido acorde a la imagen: voces, ambiente y efectos. Por defecto: true |
image_url | Sí | La imagen de partida. |
movement_amplitude | No | Cuánto se mueven el sujeto y la cámara. auto · small · medium · large · Por defecto: auto |
prompt | Sí | Describe what happens after the opening frame: the action, the camera, and the mood. |
resolution | No | Tamaño de salida. Más grande es más nítido y cuesta más. 540p · 720p · 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,3 | 0,063 US$ |
| resolution 720p | 9,9 | 0,099 US$ |
Cada tarea se redondea al alza a créditos enteros, así que una ejecución en el nivel más bajo cuesta 32 créditos por un clip de 5 segundos (0,32 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 Q3 Turbo 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/q3-turbo/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/q3-turbo/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",
"movement_amplitude": "auto",
"duration_seconds": 5,
"resolution": "720p"
}
}'
# 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 Q3 Turbo
¿Cuánto cuesta la API de Vidu Q3 Turbo?
Vidu Q3 Turbo cuesta desde 32 créditos (0,32 US$) por un clip de 5 segundos con Imagen a video, su tarea más barata. Precios por opción: 540p 6,3 créditos por segundo, 720p 9,9 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 Q3 Turbo en la API?
Pon vidu/q3-turbo/image-to-video para Imagen a video; vidu/q3-turbo/video-extend para Extender video en el campo model de POST /jobs/createTask.
¿Cómo controlo cuánto se mueve?
Con el prompt y movement_amplitude. Di el movimiento con claridad —un cambio de peso, medio giro, una salida de cuadro—, mantenlo compatible con lo que muestra el fotograma inicial y ajusta movement_amplitude (auto, small, medium, large) para la cantidad de movimiento en general. Lo que cambia es cuánto se desplazan los sujetos dentro del cuadro, no cuánto dura el clip.
¿Qué tan largo puede ser un clip?
De uno a dieciséis segundos completos. De uno a cuatro segundos es el punto dulce cuando estás generando variantes; los dieciséis completos están ahí cuando un momento necesita el espacio.
¿Qué resoluciones admite?
540p y 720p, con 720p por defecto. 540p es la pasada de borrador y 720p la de entrega: entre una y otra solo cambia un valor de la misma solicitud.
¿Genera audio?
Sí. generate_audio viene en true, así que el clip llega con una pista sincronizada. Ponlo en false cuando el corte vaya bajo una mezcla existente.
¿Qué límites tiene la API de Vidu Q3 Turbo?
Duración del clip: 1–16 s; Resoluciones: 540p · 720p. Las peticiones fuera de estos límites se rechazan antes de cobrar nada.
¿Puedo probar Vidu Q3 Turbo sin escribir código?
Sí. El Playground ejecuta Vidu Q3 Turbo 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
- 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

