curl --request POST \
  --url https://api.evolink.ai/v1/images/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "mj-v8.2",
  "prompt": "A cinematic shot of a Maine Coon cat on a neon-lit balcony --ar 16:9 --s 500",
  "quality": "standard",
  "model_params": {
    "speed": "fast"
  }
}
'

{
  "created": 1757165031,
  "id": "task-unified-1757165031-mjv82",
  "model": "mj-v8.2",
  "object": "image.generation.task",
  "progress": 0,
  "status": "pending",
  "task_info": {
    "estimated_time": 45
  },
  "type": "image",
  "usage": {
    "billing_rule": "per_call",
    "credits_reserved": 1.8,
    "user_group": "default"
  }
}

{
  "error": {
    "code": "invalid_request",
    "message": "Invalid request parameters",
    "type": "invalid_request_error"
  }
}

{
  "error": {
    "code": "unauthorized",
    "message": "Invalid or expired token",
    "type": "authentication_error"
  }
}

{
  "error": {
    "code": "insufficient_quota",
    "message": "Insufficient quota. Please top up your account.",
    "type": "insufficient_quota"
  }
}

{
  "error": {
    "code": "model_access_denied",
    "message": "Token does not have access to model: mj-v8.2",
    "type": "invalid_request_error"
  }
}

{
  "error": {
    "code": "rate_limit_exceeded",
    "message": "Too many requests, please try again later",
    "type": "rate_limit_error"
  }
}

{
  "error": {
    "code": "internal_error",
    "message": "Internal server error",
    "type": "api_error"
  }
}

Midjourney V8.2

Midjourney V8.2 Generación de imágenes

El modelo Midjourney V8.2 admite la generación de imágenes de alta calidad mediante prompts en lenguaje natural. El modo Fast devuelve 4 imágenes por generación; el modo Draft devuelve 24 imágenes de boceto ligeras de 512 px en una sola ejecución
Soporta generación texto-a-imagen e imagen-a-imagen (referenciando URLs de imágenes en el prompt)
Las URLs de imágenes de entrada deben ser accesibles públicamente y descargables en unos 10 segundos; el proveedor descarga las imágenes de forma síncrona al crear la tarea y devuelve 400 si no puede. Los alojamientos de imágenes fuera de China continental (imgur, ibb, raw.githubusercontent, pinimg, picsum) fallan en la práctica. Aloje las imágenes en un CDN rápido o use la carga de archivos de la plataforma
Aspectos destacados de V8.2: mejora estética y de calidad de imagen respecto a V8.1, nivel de detalle configurado con el parámetro nativo --quality / --q (1–4, 4 = modo de alta calidad) en el prompt sin costo adicional y salida 2K nativa (quality=hd). Turbo no está disponible en V8.2 (el proveedor documenta que V8 no admite turbo)
Se admite la Referencia de estilo (--sref); --oref / --cref no se admiten en V8.2 y son rechazados por el proveedor, consulte la guía de parámetros de prompt
Los parámetros de prompt que el proveedor no admite se transmiten tal cual: la tarea falla con un error de parámetro (invalid_parameters) y los créditos reservados se reembolsan (ya no se descartan silenciosamente)
Modo de procesamiento asíncrono, use el ID de la tarea devuelto para consultar el estado
Los enlaces de imágenes generadas son válidos por 30 días, guárdelos lo antes posible
Tiempo de espera: aproximadamente 20 minutos
Notas de parámetros: esta ruta se ejecuta en V8.2 y no admite niji; configure el modo de velocidad mediante model_params.speed y la calidad de salida mediante el parámetro quality de nivel superior; el nivel de detalle se escribe en el prompt como --quality / --q (1–4) y se transmite sin cambios
mj-v8.2-edit / mj-v8.2-upload-paint son ediciones de lienzo (img_pos + máscara). El endpoint de edición basada en instrucciones del proveedor (--edit, hasta 4 imágenes de referencia) todavía no está expuesto en esta ruta y su incorporación está programada

POST

images

generations

curl --request POST \
  --url https://api.evolink.ai/v1/images/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "mj-v8.2",
  "prompt": "A cinematic shot of a Maine Coon cat on a neon-lit balcony --ar 16:9 --s 500",
  "quality": "standard",
  "model_params": {
    "speed": "fast"
  }
}
'

{
  "created": 1757165031,
  "id": "task-unified-1757165031-mjv82",
  "model": "mj-v8.2",
  "object": "image.generation.task",
  "progress": 0,
  "status": "pending",
  "task_info": {
    "estimated_time": 45
  },
  "type": "image",
  "usage": {
    "billing_rule": "per_call",
    "credits_reserved": 1.8,
    "user_group": "default"
  }
}

{
  "error": {
    "code": "invalid_request",
    "message": "Invalid request parameters",
    "type": "invalid_request_error"
  }
}

{
  "error": {
    "code": "unauthorized",
    "message": "Invalid or expired token",
    "type": "authentication_error"
  }
}

{
  "error": {
    "code": "insufficient_quota",
    "message": "Insufficient quota. Please top up your account.",
    "type": "insufficient_quota"
  }
}

{
  "error": {
    "code": "model_access_denied",
    "message": "Token does not have access to model: mj-v8.2",
    "type": "invalid_request_error"
  }
}

{
  "error": {
    "code": "rate_limit_exceeded",
    "message": "Too many requests, please try again later",
    "type": "rate_limit_error"
  }
}

{
  "error": {
    "code": "internal_error",
    "message": "Internal server error",
    "type": "api_error"
  }
}

Midjourney cuenta con un sistema de moderación de contenido integrado. Cada imagen se modera por separado: las imágenes filtradas no aparecen en los resultados y el resto se entrega con normalidad, por lo que puedes recibir menos imágenes de lo habitual. Si al menos una imagen supera la revisión, la tarea queda en completed y se factura con normalidad; si se filtran todas las imágenes, la tarea termina en failed y los créditos reservados se reembolsan íntegramente. Asegúrate de que tus prompts e imágenes de referencia cumplan las directrices de contenido.

Autorizaciones

Authorization

string

header

requerido

Todas las interfaces requieren autenticación con Bearer Token

Obtener API Key:

Visite la página de gestión de API Key para obtener su API Key

Agregue lo siguiente al encabezado de la solicitud:

Authorization: Bearer YOUR_API_KEY

Cuerpo

application/json

model

enum<string>

predeterminado:mj-v8.2

requerido

Nombre del modelo

Opciones disponibles:

mj-v8.2

prompt

string

requerido

Prompt, soporta toda la sintaxis nativa de parámetros de Midjourney V8.2 (como --ar 16:9 --s 500).

Imagen a imagen: Coloque las URLs de imagen al inicio del prompt. Formatos soportados: .png, .gif, .webp, .jpg, .jpeg

Reglas de imagen a imagen:

1 imagen + sin texto = inválido (devolverá error)
1 imagen + descripción de texto = válido
2+ imágenes + sin texto = válido
2+ imágenes + descripción de texto = válido

Parámetros no admitidos: los parámetros que el proveedor no admite (p. ej. --oref, --cref, --stop, --bs) se transmiten y el proveedor los rechaza explícitamente: la tarea falla con un error de parámetro (invalid_parameters) y los créditos reservados se reembolsan. --v / --version / --niji y los parámetros de velocidad / hd se eliminan y se controlan mediante parámetros de la API; --quality / --q (1–4) se transmite tal cual.

Maximum string length: 2048

Ejemplo:

"A cinematic shot of a Maine Coon cat on a neon-lit balcony --ar 16:9 --s 500"

quality

enum<string>

predeterminado:standard

Calidad de salida

standard: Resolución estándar (predeterminado), multiplicador 1x
hd: Salida HD nativa, multiplicador 1.5x. Mutuamente excluyente con speed: draft

Información de costos: el multiplicador de calidad se combina (multiplica) con el multiplicador de speed.

Opciones disponibles:

standard,

hd

model_params

object

Parámetros del modelo

Show child attributes

callback_url

string<uri>

Dirección de callback HTTPS después de completar la tarea

Momento del callback:

Se activa cuando la tarea se completa o falla
Se envía después de confirmar la facturación

Restricciones de seguridad:

Solo se admite el protocolo HTTPS
Se prohíbe el callback a direcciones IP de red interna (127.0.0.1, 10.x.x.x, 172.16-31.x.x, 192.168.x.x, etc.)
La longitud de la URL no debe exceder 2048 caracteres

Mecanismo de callback:

Tiempo de espera: 10 segundos
Máximo 3 reintentos después de fallar (a los 1s/2s/4s respectivamente)
El formato de respuesta del callback es consistente con el de la interfaz de consulta de tareas
Si la dirección de callback devuelve un código 2xx se considera exitoso, otros códigos activan reintentos

Ejemplo:

"https://your-domain.com/webhooks/image-task-completed"

Respuesta

Tarea creada exitosamente

created

integer

Marca de tiempo de creación de la tarea

Ejemplo:

1757165031

string

ID de la tarea

Ejemplo:

"task-unified-1757165031-mjv82"

model

string

Nombre del modelo utilizado

Ejemplo:

"mj-v8.2"

object

enum<string>

Tipo de objeto de tarea

Opciones disponibles:

image.generation.task

progress

integer

Porcentaje de progreso de la tarea (0-100)

Rango requerido: 0 <= x <= 100

Ejemplo:

0

status

enum<string>

Estado de la tarea

Opciones disponibles:

pending,

processing,

completed,

failed

Ejemplo:

"pending"

task_info

object

Información de tarea asíncrona

Show child attributes

type

enum<string>

Tipo de salida de la tarea

Opciones disponibles:

text,

image,

audio,

video

Ejemplo:

"image"

usage

object

Información de uso y facturación

Show child attributes

Serie de imágenes

Serie de videos

Serie de audio

Serie de texto

Gestión de cuenta

Gestión de tareas

Gestión de archivos

Midjourney V8.2 Generación de imágenes

Autorizaciones

Todas las interfaces requieren autenticación con Bearer Token

Cuerpo

Respuesta