guide
Cómo usar la API de Midjourney V8.1 con EvoLink: payload, polling y callback
EvoLink Team
Product Team
21 de junio de 2026
5 min de lectura
Si quiere usar Midjourney V8.1 desde código, la pregunta útil no es solo qué endpoint llamar. También necesita saber cómo crear tareas, consultar el estado, controlar el coste y mantener la opción de probar otros modelos de imagen dentro de EvoLink.
En EvoLink, la generación principal usa
POST https://api.evolink.ai/v1/images/generations con model: "mj-v8.1". La respuesta es una tarea asíncrona. Puede consultar GET https://api.evolink.ai/v1/tasks/{task_id} o usar callback_url.Respuesta rápida
curl --request POST \
--url https://api.evolink.ai/v1/images/generations \
--header 'Authorization: Bearer YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
"model": "mj-v8.1",
"prompt": "a premium product photo of a matte black espresso machine on a marble counter --ar 16:9 --s 250",
"quality": "standard",
"model_params": {
"speed": "fast"
},
"callback_url": "https://your-domain.com/webhooks/evolink-image-task"
}'Guarde el
id devuelto. Es el task_id que usará para polling, callback y diagnóstico.curl --request GET \
--url https://api.evolink.ai/v1/tasks/<task_id> \
--header 'Authorization: Bearer YOUR_API_KEY'Datos confirmados en EvoLink
| Tema | Estado actual |
|---|---|
| Endpoint | POST /v1/images/generations |
| Modelo | mj-v8.1 |
| Auth | Authorization: Bearer YOUR_API_KEY |
| Campos requeridos | model, prompt |
| Calidad | Campo superior quality: standard o hd |
| Velocidad | model_params.speed: draft, fast |
| Estado async | GET /v1/tasks/{task_id} |
| Salida | Fast hasta 4 imágenes; Draft hasta 24 bocetos ligeros 0.5K |
| Enlaces | Las URLs generadas son válidas 30 días |
Campos del request
| Campo | Requerido | Ejemplo | Nota |
|---|---|---|---|
model | Sí | mj-v8.1 | Selecciona la ruta Midjourney V8.1 |
prompt | Sí | a product photo... --ar 16:9 | Texto y parámetros MJ compatibles |
quality | No | standard, hd | hd aplica multiplicador 1.5x |
model_params.speed | No | draft, fast | draft y hd son incompatibles |
callback_url | No | https://... | Callback HTTPS para eventos terminales |
No coloque
quality dentro de model_params. En esta ruta de EvoLink, quality es un campo superior.Texto a imagen e imagen a imagen
Ejemplo de texto a imagen:
{
"model": "mj-v8.1",
"prompt": "a cinematic product photo of a titanium travel mug on wet black stone --ar 16:9 --s 250",
"quality": "standard",
"model_params": {
"speed": "fast"
}
}Para imagen a imagen, ponga las URLs de imagen al inicio del
prompt. Los formatos admitidos son PNG, GIF, WebP, JPG y JPEG. Una sola URL sin texto no es válida; use una imagen con texto, varias imágenes, o varias imágenes con texto.{
"model": "mj-v8.1",
"prompt": "https://your-cdn.example.com/reference-sofa.jpg a luxury living room campaign image --ar 4:3 --iw 1.2",
"quality": "standard",
"model_params": {
"speed": "fast"
}
}Callback en producción
callback_url debe usar HTTPS, no superar 2048 caracteres y no apuntar a IPs privadas como 127.0.0.1, 10.x.x.x, 172.16-31.x.x o 192.168.x.x. EvoLink envía el callback cuando la tarea se completa, falla o se cancela. Timeout: 10 segundos, hasta 3 reintentos.Un handler de producción debe responder
2xx rápido, verificar el estado final con GET /v1/tasks/{task_id}, deduplicar callbacks repetidos y copiar los resultados a su propio almacenamiento antes de que caduquen los enlaces.Coste y routing
| Elección | Impacto | Recomendación |
|---|---|---|
fast | Modo estándar | Valor por defecto para producción |
draft | Bocetos ligeros; no combinar con hd | Exploración de composición |
standard | Calidad base | Previews y UI de producto |
hd | Multiplicador 1.5x | Assets finales o campañas |
La ventaja de EvoLink no es solo exponer Midjourney V8.1. Puede usar la misma autenticación, facturación y lógica async para probar rutas alternativas como Midjourney V7, Nano Banana Pro o GPT Image 2.
Checklist de producción
| Área | Comportamiento requerido |
|---|---|
| API Key | Guardarla solo en backend |
| Logging | Registrar modelo, hash del prompt, quality, model_params.speed, usuario y task_id |
| UI | Mostrar pending, processing, completed, failed |
| Polling | Usar backoff tras los primeros intentos |
| Callback | Responder 2xx rápido y procesar en segundo plano |
| Storage | Guardar imágenes antes de los 30 días |
| Coste | Controlar acceso a hd |
FAQ
¿Qué endpoint uso para Midjourney V8.1 en EvoLink?
Use
POST /v1/images/generations para crear la tarea y GET /v1/tasks/{task_id} para consultar el estado.¿Cuál es el modelo correcto?
El modelo de generación principal es
mj-v8.1.¿Dónde va quality?
quality va como campo superior. Los valores válidos son standard y hd.¿Qué valores acepta model_params.speed?
La ruta documenta
draft y fast.¿Puedo combinar quality: "hd" con speed: "draft"?
No. La documentación de EvoLink indica que
quality: "hd" y model_params.speed: "draft" son mutuamente excluyentes.¿Midjourney V8.1 soporta imagen a imagen?
Sí. Coloque la URL de imagen al inicio del prompt y añada texto si usa una sola imagen.
¿Cuánto duran las URLs generadas?
Las URLs generadas son válidas 30 días. Guárdelas en su propio almacenamiento.
¿Polling o callback?
Polling sirve para pruebas y herramientas internas. Para producción, use
callback_url y confirme el estado final con el endpoint de tareas.Fuentes
- Página Midjourney V8.1 en EvoLink
- Docs de generación de imagen Midjourney V8.1
- Precios Midjourney V8.1 en EvoLink
- Catálogo de modelos EvoLink
Empezar con Midjourney V8.1 en EvoLink
Pruebe primero el prompt en el playground de Midjourney V8.1 y luego lleve la misma estructura de payload a su backend.
Abrir Midjourney V8.1 en EvoLink
