Recursos de EssevinAPI de imágenes de Midjourney
Midjourney v8.2 en Essevin — tareas fijas de cuatro imágenes, parámetros del prompt, relaciones de aspecto y el ciclo de vida de la tarea.
Midjourney en Essevin es una API asíncrona: envíe una tarea y luego consulte el ID de tarea de Essevin. Use una clave del grupo de plan de Midjourney y confirme el ID exacto de modelo con GET /v1/models antes de enviar trabajo de pago.
Endpoints
| Método | Ruta | Propósito |
|---|---|---|
| POST | /v1/images/generations | Enviar una tarea de imagen de Midjourney |
Todas las solicitudes usan Authorization: Bearer sk-tu-clave y Content-Type: application/json. El ID de modelo es midjourney-v8-2.
Cada tarea devuelve exactamente cuatro imágenes
Este modelo siempre genera un conjunto de cuatro imágenes por tarea, y todas las imágenes devueltas se facturan. El conteo es fijo en el modelo: n solo acepta 4 o nada en absoluto, y no hay forma de pedir una sola imagen. Presupueste cuatro imágenes por envío.
Contrato de solicitud
| Campo | Obligatorio | Notas |
|---|---|---|
model | Sí | midjourney-v8-2 |
prompt | Sí | Descripción más parámetros opcionales. Una solicitud con solo imágenes y sin descripción se rechaza |
images | No | Como máximo una imagen de referencia, como {"url": "https://…"} o {"file_id": "…"} |
n | No | Solo 4, u omítalo. Cualquier otro valor se rechaza |
quality | No | Este modelo no lo usa. Pida 2K con --hd en el prompt en su lugar |
curl https://api.essevin.com/v1/images/generations \
-H "Authorization: Bearer sk-tu-clave" \
-H "Content-Type: application/json" \
-d '{"model":"midjourney-v8-2","prompt":"a red apple on a wooden table, studio light --ar 16:9"}'Tamaño y relación de aspecto
El tamaño de la imagen no es un campo de la solicitud. Viene de --ar en el prompt, y --hd genera de forma nativa aproximadamente al doble de longitud de lado. Los tamaños de abajo están medidos, no derivados: --hd no es una duplicación exacta.
--ar | Predeterminado | 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 |
14:1 | 4096 × 288 | Rechazado — vea más abajo |
--ar solo acepta números enteros; --ar 1.5:1 se rechaza. La relación no puede superar 14:1 en ninguna de las dos direcciones, y --hd baja ese techo a 4:1, por lo que --hd --ar 14:1 se rechaza mientras que --hd --ar 4:1 se genera a 4096 × 1184.
Parámetros del prompt
Estos se aceptan y se transmiten:
| Parámetro | Rango | Propósito |
|---|---|---|
--ar | relación entera | Relación de aspecto |
--hd | indicador | Render nativo en 2K |
--s / --stylize | 0-1000 | Intensidad de la estilización |
--c / --chaos | 0-100 | Variación entre las cuatro imágenes |
--weird / --w | 0-3000 | Estética poco convencional |
--iw | 0-3 | Peso de la imagen de referencia |
--sref + --sw | --sw 0-1000 | Referencia de estilo y su intensidad |
--no | texto | Excluir elementos |
--seed | entero | Reproducibilidad |
--tile, --exp | indicador / 0-100 | Mosaico sin costuras; rango dinámico |
Parámetros que esta versión del modelo no acepta
Estos se rechazan con 400 en el envío, con el motivo en el mensaje de error. Se rechazan en lugar de reenviarse porque el servicio o los ignora en silencio — y usted termina pagando por un efecto que nunca obtuvo — o hace fallar la tarea minutos después.
| Parámetro | Por qué |
|---|---|
--q / --quality | No tiene efecto en esta versión del modelo |
--niji | Niji es una versión de modelo aparte, no un parámetro aquí |
--repeat / --r | No tiene efecto; el número de imágenes por tarea es fijo |
--oref, --cref | La referencia omni y la de personaje no están disponibles en v8.x |
--stealth, --stop | No se admiten en esta versión del modelo |
--draft | Devuelve 24 imágenes de baja resolución por tarea; no se ofrece |
--profile | Los perfiles de personalización no se admiten a través de esta API |
:: | La ponderación multi-prompt no se admite en esta versión del modelo |
Enviar y consultar
Un envío exitoso devuelve 202 con el ID de tarea en id, más images_per_task. Consúltela de la misma manera que cualquier otra tarea de medios asíncrona, sin un encabezado de facturación:
-H "Authorization: Bearer sk-tu-clave"status pasa por queued → processing → completed o failed; solo estos dos últimos son terminales, así que trate cualquier otro valor como en curso. Una tarea completada incluye cuatro URL de salida en outputs, servidas desde el dominio console.essevin.com — enlaces firmados válidos por 6 horas desde el momento en que la tarea se completa. Consultar de nuevo devuelve la misma URL sin extenderla, y un enlace vencido devuelve 410, así que descargue los resultados dentro de esa ventana. Solo se factura una tarea que se completa correctamente; una tarea fallida nunca se factura.
Fallos
| Lo que ve | Qué significa |
|---|---|
400 en el envío | Un campo o un parámetro del prompt no es válido. El mensaje lo indica; corríjalo y vuelva a enviar |
| La tarea falla, contenido rechazado | La moderación de contenido rechazó el prompt. Reformúlelo y envíelo de nuevo |
| La tarea falla, servicio ocupado | El grupo de plan está en su techo de concurrencia para este modelo. Reintente en breve; no se factura nada |
La concurrencia es limitada en este modelo
Midjourney permite generar solo un número reducido de prompts a la vez, muchos menos que los modelos de imagen síncronos. Enviar un lote grande en paralelo hará que la mayoría fallen en lugar de ponerlos en cola. Envíe unos pocos a la vez y reintente los que vuelvan como ocupados — las tareas fallidas no se facturan.
Tarifas
Midjourney factura por imagen devuelta, así que una tarea cuesta cuatro imágenes a la tarifa de su nivel: el render predeterminado y el render 2K con --hd tienen precios distintos. Los precios de lista oficiales están en la página de precios. Su tarifa es la que aparece en el catálogo de modelos con la sesión iniciada, y el cargo real de cada solicitud está en su registro de uso.