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": "processing",
"task_info": {
"estimated_time": 60
},
"type": "image",
"usage": {
"billing_rule": "per_call",
"credits_reserved": 5.4,
"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 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 al crear la tarea; si no puede, la tarea falla y los créditos reservados se reembolsan. 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/--crefno 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.speedy la calidad de salida mediante el parámetroqualityde 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-paintson 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
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": "processing",
"task_info": {
"estimated_time": 60
},
"type": "image",
"usage": {
"billing_rule": "per_call",
"credits_reserved": 5.4,
"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"
}
}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
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
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) 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, --bs / --batchsize 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.
2048"A cinematic shot of a Maine Coon cat on a neon-lit balcony --ar 16:9 --s 500"
Calidad de salida
standard: Resolución estándar (predeterminado), multiplicador 1xhd: Salida HD nativa, multiplicador 1.5x. Mutuamente excluyente conspeed: draft
Información de costos: el multiplicador de calidad se combina (multiplica) con el multiplicador de speed.
standard, hd 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
2048caracteres
Mecanismo de callback:
- Tiempo de espera:
10segundos - Máximo
3reintentos después de fallar (a los1s/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
"https://your-domain.com/webhooks/image-task-completed"
Respuesta
Tarea creada exitosamente