APIMaster.ai

Vidu Image Q2 · Referencia de la API

Genera imágenes con Vidu Image Q2 a partir de texto o referencias. Consulta las tareas y descarga sus resultados.

Crear una tarea con POST /v1/wand/vidu-image/generation y consultarla con GET /v1/wand/vidu-image/tasks/{task_id}. Envíe una clave de API APIMaster en el encabezado Authorization: Bearer con ambas peticiones. El cuerpo de la solicitud POST está en formato JSON.

Campo Tipo Descripción
model string Obligatorio. Utilice vidu-image-q2.
prompt string Obligatorio. Hasta 2,000 caracteres. Para generar imágenes solo a partir de texto, omite las referencias (text-to-image).
images string[] Opcional. Hasta siete URL públicas o URI de datos en PNG, JPEG/JPG o WebP. Cada imagen debe tener al menos 128 × 128 píxeles, una relación de aspecto entre 1:4 y 4:1 y un tamaño máximo de 50 MB. El cuerpo de la solicitud admite hasta 20 MB.
aspect_ratio string 16:9 por defecto. Las opciones son 16:9, 9:16, 1:1, 3:4, 4:3, 21:9, 2:3, 3:2 y auto. La configuración auto sigue la primera imagen de referencia.
resolution string 1080p por defecto. También es compatible con 2K y 4K. Los valores distinguen entre mayúsculas y minúsculas.
seed integer Omite el campo o usa 0 para elegir una semilla aleatoria.
curl -X POST "https://apimaster.ai/v1/wand/vidu-image/generation" \
  -H "Authorization: Bearer $APIMASTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"vidu-image-q2","prompt":"A blue circle on a white background","resolution":"1080p"}'

Consulta el estado cada 3–5 segundos con el task_id devuelto y la misma cuenta. Los posibles estados son created, queueing, processing, success y failed. Cuando tenga éxito, descargue los archivos bajo creations[].url dentro de las horas 12. Utilice request_id para rastrear fallos tales como imágenes inválidas, revisión de contenido, crédito insuficiente, límites de solicitudes o tareas faltantes.

Consultar el estado no vuelve a generar el resultado ni genera otro cargo. callback_url no es compatible. Para recuperar una sumisión perdida, enviar un estable Idempotency-Key de 8–128 visible ASCII caracteres y seguir el Guía para recuperar una solicitud. La misma clave con los mismos parámetros devuelve un recibo de recuperación con HTTP 202. La misma clave con otros parámetros devuelve HTTP 409.

tokenhub_usage.total_tokens informa del uso facturable, que depende de la resolución y cuántas referencias se utilizaron. Consulte la tarjeta Vidu Image Q2 modelo para el precio actual de APIMaster.