Saltar al contenido principal
POST
/
v1
/
images
/
generations
Interfaz mj-v8.1-edit
curl --request POST \
  --url https://api.evolink.ai/v1/images/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "mj-v8.1-edit",
  "prompt": "Beautiful mountain scenery background",
  "model_params": {
    "task_id": "task-unified-xxx",
    "image_number": 0,
    "canvas": {
      "width": 1024,
      "height": 1024
    },
    "img_pos": {
      "width": 512,
      "height": 512,
      "x": 256,
      "y": 256
    },
    "speed": "fast"
  }
}
'
{
  "created": 1757165031,
  "id": "task-unified-1757165031-mjv81",
  "model": "<string>",
  "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"
  }
}
Midjourney cuenta con un sistema de moderación de contenido integrado. Si algunas imágenes generadas son filtradas por la moderación, los créditos consumidos en esa solicitud no serán reembolsados. Asegúrese de que sus prompts cumplan con 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.1-edit
requerido

Nombre del modelo

Opciones disponibles:
mj-v8.1-edit
Ejemplo:

"mj-v8.1-edit"

​
prompt
string
requerido

Describir el contenido que se desea rellenar

Ejemplo:

"Beautiful mountain scenery background"

​
model_params
object
requerido

Parámetros de edición de lienzo

​
callback_url
string<uri>

URL de callback HTTPS para la finalización de 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íben los callbacks a direcciones IP privadas (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 después de fallar)
  • El formato del cuerpo de respuesta del callback coincide con el de la interfaz de consulta de tareas
  • Un código de estado 2xx se considera exitoso; otros códigos de estado activan reintentos
Ejemplo:

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

Respuesta

Tarea de generación de imágenes creada exitosamente

​
created
integer

Marca de tiempo de creación de la tarea

Ejemplo:

1757165031

​
id
string

ID de la tarea

Ejemplo:

"task-unified-1757165031-mjv81"

​
model
string

Nombre del modelo realmente utilizado

​
object
enum<string>

Tipo de objeto de la 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
​
type
enum<string>
Opciones disponibles:
text,
image,
audio,
video
Ejemplo:

"image"

​
usage
object