Generación de imágenes de Midjourney v8.2 / Niji 7

Usa la API de imágenes asíncrona en https://apimaster.ai/v1 con midjourney-v8.2 o midjourney-niji-7. El ID del modelo selecciona la versión; no añadas campos de anulación de versión.

Crear una tarea

POST https://apimaster.ai/v1/midjourney/generations

curl -s "https://apimaster.ai/v1/midjourney/generations" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "midjourney-v8.2",
    "prompt": "a quiet Japanese garden at dawn, cinematic composition",
    "size": "16:9",
    "speed": "relax"
  }'

Para Niji 7, establece model en midjourney-niji-7:

{"model":"midjourney-niji-7","prompt":"anime character under cherry blossoms","size":"9:16","speed":"fast"}

Campo	Tipo	Obligatorio	Descripción
model	string	Sí	midjourney-v8.2 o midjourney-niji-7
prompt	string	Sí	Descripción de la imagen, incluidos los parámetros de Midjourney admitidos
size	string	No	Relación de aspecto, como 1:1 o 16:9; por defecto es 1:1
speed	string	No	relax, fast o turbo; por defecto es relax
image_urls	string[]	No	De 1 a 20 URL de imágenes de referencia; también se aceptan Data URL de imágenes admitidas
iw	number	No	Peso de la imagen de referencia 0–3; requiere image_urls
quality	string	No	0.25, 0.5, 1 o 2; no es compatible con Niji 7
stylize / chaos / weird	integer	No	Rangos: 0–1000, 0–100 y 0–3000, respectivamente
seed	integer	No	Semilla aleatoria 0–4294967295
negative_prompt	string	No	Contenido que se debe excluir
sref / sw	string / integer	No	URL pública de referencia de estilo y peso 0–1000; sw requiere sref
dref / dw	string o string[] / number	No	URL de referencia (hasta 20) y peso 0–100; dw requiere dref
raw / tile / hd	boolean	No	Estilo raw, mosaico y HD; tile y hd son solo para v8.2
extra	string	No	Cadena de parámetros admitidos, como --ar 16:9 --s 750; los campos estructurados tienen prioridad
metadata	object	No	Metadatos de negocio personalizados
repeat	integer	No	2–40 para crear varias tareas

Niji 7 no admite quality, tile=true ni hd=true. Ambos modelos rechazan draft=true, cref, cw, stop y los campos de solicitud version y niji. style=raw se normaliza a raw=true. No uses --v ni --niji en prompt o extra para anular la versión del modelo.

La respuesta contiene un ID de lote y los ID de tarea:

{
  "id": "imagine_batch_xxxxxxxx",
  "request_id": "req_xxxxxxxx",
  "model": "midjourney-v8.2",
  "status": "queued",
  "data": [{"id": "imagine_xxxxxxxx", "task_id": "imagine_xxxxxxxx", "status": "submitted"}]
}

Consultar el estado de la tarea

curl -s "https://apimaster.ai/v1/tasks/imagine_batch_xxxxxxxx" \
  -H "Authorization: Bearer YOUR_API_KEY"

La respuesta completada incluye URL de imágenes en data; tasks contiene cada tarea secundaria:

{
  "id": "imagine_batch_xxxxxxxx",
  "status": "completed",
  "progress": 100,
  "data": [{"url": "https://example.com/generated.png"}],
  "tasks": [{"task_id": "imagine_xxxxxxxx", "status": "completed", "progress": 100, "data": [{"url": "https://example.com/generated.png"}]}]
}

Consulta periódicamente mientras el estado sea queued o processing. Si falla, lee tasks[].error y no reenvíes la misma solicitud. Descarga las URL devueltas cuanto antes, ya que pueden caducar.

Si el envío devuelve 502 con un encabezado X-Task-ID, o una consulta devuelve pending_timeout, guarda el ID y sigue comprobando su estado en lugar de volver a enviarlo automáticamente. Un lote puede contener tanto tareas correctas como fallidas; inspecciona tasks[] individualmente. Se recomienda consultar una vez cada 15 segundos.

Errores y precios

model y un prompt no vacío son obligatorios. Las versiones no admitidas, las relaciones no válidas, las referencias inaccesibles y los parámetros no admitidos devuelven 400. 401 significa clave no válida, 402 significa saldo insuficiente y 429 significa limitación de velocidad. Consulta la tarjeta de Midjourney v8.2 y la tarjeta de Niji 7 para conocer los precios y las rutas actuales.