API de Midjourney v8.2 en HopBase: 4 imágenes por trabajo

Midjourney v8.2 (ID de modelo midjourney-v8-2) ya está disponible en HopBase. Se envía a través del endpoint compatible con OpenAI POST /v1/images/generations, que devuelve 202 con un ID de tarea, y se consulta con GET /v1/video/tasks/{task_id} hasta que la tarea esté completed o failed. La mayor diferencia respecto a la mayoría de los modelos de imagen es que cada trabajo devuelve un conjunto fijo de 4 imágenes candidatas, y la relación de aspecto y la calidad se escriben en el prompt (--ar define la relación y --hd renderiza en 2K nativo) en lugar de pasarse como campos de la solicitud. Se requiere un prompt de texto, con un máximo de 1 imagen de referencia en el campo images. La facturación sigue el número de imágenes realmente devueltas: $0.0067 por imagen en 1K y $0.0108 por imagen en 2K, es decir, $0.0267 y $0.0433 por trabajo. Los 4 enlaces de resultado son válidos durante 24 horas después de la finalización, las tareas sin terminar tras 2 horas se marcan como fallidas y no se facturan, y usage.cost_usd muestra el cargo real. Confirme que su clave tiene acceso con GET /v1/models.

Cómo invocarlo

• Asíncrono en dos pasos: POST /v1/images/generations devuelve 202 con un ID de tarea y después se consulta GET /v1/video/tasks/{task_id}. El estado avanza por queued → processing → completed, y solo completed y failed son estados finales.
• Use el ID de modelo completo: midjourney-v8-2. El ID de referencia es el que devuelve GET /v1/models.
• El prompt es obligatorio: enviar una imagen de referencia sin descripción de texto se rechaza. Máximo 1 imagen de referencia, en el campo images.
• Vigencia de los resultados: al completarse, outputs contiene 4 enlaces firmados, válidos durante 24 horas desde el momento en que se completa la tarea. Volver a consultar devuelve los mismos enlaces sin prolongarlos, y los enlaces caducados devuelven 410, así que descargue dentro de ese plazo.
• Los tiempos de espera agotados no tienen costo: una tarea que siga sin terminar 2 horas después de su creación se marca como fallida y no se factura.
• Cargo real por tarea: cuando la tarea llega a un estado final, la consulta incluye usage.cost_usd, el importe realmente descontado, para que pueda conciliar el costo por trabajo en su código.

Precios: la tarifa oficial convertida a precio por imagen

Nivel	Cómo activarlo	Por imagen	Por trabajo (4 imágenes)
Estándar	Predeterminado	$0.0067	$0.0267
2K	Añada --hd al prompt	$0.0108	$0.0433

Midjourney fija sus precios oficiales por tiempo de GPU (0.8 minutos de GPU para un trabajo estándar, 1.3 minutos con --hd), y nosotros convertimos esa tarifa oficial en un precio por imagen. La facturación sigue el número de imágenes realmente devueltas, así que una sola llamada cuesta lo equivalente a cuatro imágenes; inclúyalo en su modelo de presupuesto en lugar de estimar a partir del precio de una imagen. Como referencia, los modelos del catálogo que devuelven una sola imagen se sitúan en su mayoría entre $0.029 y $0.067 por llamada, y cuatro imágenes de Midjourney juntas siguen costando menos que la mayoría de ellos. Su precio unitario efectivo depende del grupo de su plan, y la consola detalla el costo de cada solicitud.

Relación de aspecto y tamaño

El tamaño no es un campo de la solicitud; proviene de --ar en el prompt, y añadir --hd renderiza en 2K nativo. Valores medidos:

--ar	Estándar	Con --hd
1:1 (predeterminado)	1024 × 1024	2048 × 2048
16:9	1456 × 816	2944 × 1648
9:16	816 × 1456	1648 × 2944
4:3	1232 × 928	2544 × 1904
21:9	1680 × 720	3376 × 1440

--ar solo acepta relaciones enteras, por lo que --ar 1.5:1 se rechaza. El máximo es 14:1, que se reduce a 4:1 cuando --hd está activado.

Parámetros admitidos

• Admitidos: --ar, --hd, --s (0-1000), --c (0-100), --weird (0-3000), --iw (0-3), --sref con --sw, --no, --seed, --tile, --exp.
• No admitidos en v8.2, rechazados con 400 al enviar: --q/--quality, --niji, --repeat, --oref, --cref, --stealth, --stop, --draft y la ponderación multiprompt con ::.

Rechazamos este conjunto al enviar en lugar de reenviarlo: el modelo ignora algunos de ellos en silencio (usted paga y no obtiene nada a cambio), y el resto solo falla después de que el trabajo se haya ejecutado durante decenas de segundos. El mensaje de error indica el parámetro y por qué no se admite.

Integración en tres minutos

# 1. Submit; returns 202 plus a task ID
curl https://api.hop-base.com/v1/images/generations \
  -H "Authorization: Bearer sk-your-key" \
  -H "Content-Type: application/json" \
  -d '{"model":"midjourney-v8-2","prompt":"a red apple on a wooden table, studio light --ar 16:9"}'

# 2. Poll with the id from the previous step; once completed, take the 4 links from outputs (valid 24 hours)
curl https://api.hop-base.com/v1/video/tasks/YOUR_TASK_ID \
  -H "Authorization: Bearer sk-your-key"

Preguntas frecuentes

¿Puedo generar una sola imagen?

No. Todos los modos de generación de Midjourney devuelven una cuadrícula fija de 2×2 con cuatro imágenes candidatas. Así funciona el propio modelo; no es una restricción añadida por nuestra parte. Ni el campo de número de imágenes de la solicitud ni --repeat cambian el resultado, por eso no aceptamos ningún valor de n distinto de 4: es mejor indicarlo al enviar que cobrarle cuatro sin avisar.

¿Cómo controlo el tamaño?

En el prompt: --ar define la relación y --hd renderiza en 2K nativo. El campo quality del cuerpo de la solicitud no tiene efecto en este modelo y se rechaza si lo envía. La tabla completa de tamaños está más arriba.

¿Admite imágenes de referencia?

Sí, como máximo 1, en el campo images, con --iw (0-3) para ajustar con qué fuerza se sigue; para referencias de estilo, use --sref junto con --sw. Tenga en cuenta que v8.2 no admite --oref ni --cref; Midjourney los ha sustituido por sus nuevos modelos de edición.

¿Se facturan los trabajos fallidos?

No. Solo se facturan los trabajos que realmente producen imágenes; los trabajos fallidos no tienen costo. Si la moderación de contenido detiene un prompt, la respuesta indica un motivo de fallo explícito, para que pueda reescribirlo y volver a intentarlo.