API de Vidu Q3 Pro: vídeo 540p con sonido

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

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 · Por defecto: 540p
`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
Estándar	8,1	0,081 US$

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

# 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 Pro

¿Cuánto cuesta la API de Vidu Q3 Pro?

Vidu Q3 Pro cuesta 41 créditos (0,41 US$) por un clip de 5 segundos. 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 Pro en la API?

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

¿Qué hace Vidu Q3 Pro?

Anima un cuadro de apertura que tú entregas. La imagen decide sujeto, look y forma; el prompt describe el movimiento, la cámara y el sonido. Los clips duran de 1 a 16 segundos enteros en 540p.

¿Cómo controlo la forma del clip?

Con la imagen fija. Una imagen vertical vuelve como clip vertical y una cuadrada como clip cuadrado, así que la forma del entregable se decide en la pasada de imagen.