{
"created": 1757165031,
"id": "task-unified-1757165031-mjv81",
"model": "mj-v8.1",
"object": "image.generation.task",
"progress": 0,
"status": "pending",
"task_info": {
"can_cancel": true,
"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.1",
"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.1 Generación de imágenes
- El modelo Midjourney V8.1 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 0.5K en una sola ejecución
- Soporta generación texto-a-imagen e imagen-a-imagen (referenciando URLs de imágenes en el prompt)
- Aspectos destacados de V8.1: salida HD nativa (
quality=hd), generación aproximadamente 5x más rápida que la generación anterior, mejor renderizado de texto (el texto entre comillas se renderiza con mayor precisión) y mayor adherencia al prompt - Compatible con los recursos de V7: se admiten Referencia de estilo (
--sref) y Referencia Omni (--oref), consulte la guía de parámetros de prompt - 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.1 y no admite niji; configure el modo de velocidad mediante
model_params.speedy la calidad de salida mediante el parámetroqualityde nivel superior
{
"created": 1757165031,
"id": "task-unified-1757165031-mjv81",
"model": "mj-v8.1",
"object": "image.generation.task",
"progress": 0,
"status": "pending",
"task_info": {
"can_cancel": true,
"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.1",
"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"
}
}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
Nombre del modelo
mj-v8.1 Prompt, soporta toda la sintaxis nativa de parámetros de Midjourney V8.1 (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
1024"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 Parámetros del modelo
Show child attributes
Show child attributes
Dirección de callback HTTPS después de completar la tarea
Momento del callback:
- Se activa cuando la tarea se completa, falla o se cancela
- 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
Marca de tiempo de creación de la tarea
1757165031
ID de la tarea
"task-unified-1757165031-mjv81"
Nombre del modelo utilizado
"mj-v8.1"
Tipo de objeto de tarea
image.generation.task Porcentaje de progreso de la tarea (0-100)
0 <= x <= 1000
Estado de la tarea
pending, processing, completed, failed "pending"
Información de tarea asíncrona
Show child attributes
Show child attributes
Tipo de salida de la tarea
text, image, audio, video "image"
Información de uso y facturación
Show child attributes
Show child attributes