API de Vidu Q3: vídeo 1080p con sonido

Name: Vidu Q3 API
SKU: vidu/q3/image-to-video
Price: 0.53 USD
Availability: InStock

Acerca de Vidu Q3

Vidu Q3 publica un solo endpoint de video, image-to-video: tú aportas el fotograma inicial y describes lo que pasa después. Los clips duran de 1 a 16 segundos en 540p, 720p o 1080p, y el audio se genera junto con la imagen salvo que lo desactives.

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

Parámetros de la petición

Parámetro	Obligatorio	Descripción
`bgm`	No	Add background music to the clip. Separate from generate_audio, which covers the sound of the scene itself. 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 · 1080p · 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	10,5	0,11 US$
resolution 720p	22,5	0,23 US$
resolution 1080p	24	0,24 US$

Cada tarea se redondea al alza a créditos enteros, así que una ejecución en el nivel más bajo cuesta 53 créditos por un clip de 5 segundos (0,53 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 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/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/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",
    "duration_seconds": 5,
    "resolution": "720p",
    "movement_amplitude": "auto"
  }
}'

# 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

¿Cuánto cuesta la API de Vidu Q3?

Vidu Q3 cuesta 53 créditos (0,53 US$) por un clip de 5 segundos. Precios por opción: 540p 10,5 créditos por segundo, 720p 22,5 créditos por segundo, 1080p 24 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 en la API?

Pon vidu/q3/image-to-video para Imagen a video en el campo model de POST /jobs/createTask.

¿Qué resoluciones admite Vidu Q3?

540p, 720p y 1080p, con 720p por defecto. El flujo fiable es encontrar el movimiento en 540p y luego repetir la toma aprobada en 1080p con el mismo fotograma y la misma seed.

¿Puedo generar solo con texto?

En esta familia no. Vidu Q3 se publica solo como image-to-video, así que cada solicitud necesita image_url. Si partes de una idea escrita, genera primero el fotograma inicial con un modelo de imagen, apruébalo y luego anímalo aquí.

¿Cómo fijo la relación de aspecto?

Con el fotograma que subes. Este endpoint no tiene parámetro de relación de aspecto: una imagen 16:9 da un clip 16:9 y una 9:16 da uno vertical, así que recorta la imagen antes de enviarla.

¿Genera sonido?

Sí. generate_audio vale true por defecto, así que el ambiente y los efectos llegan sincronizados con la imagen. Ponlo en false para un clip sin sonido. Los modelos Q3 no tienen un interruptor aparte para pista musical: describe en el prompt la música que quieras.

¿Cómo se cobra Vidu Q3?

Por duración de salida, con la resolución incluida en el cálculo. La estimación en vivo que ves antes de enviar refleja la duración y la resolución exactas de tu solicitud.