Comienza con Midjourney API

Comprende el concepto principal

La MidJourney API simula las interacciones con botones de Discord. A diferencia de las API REST habituales, funciona como una máquina de estados en la que cada operación devuelve nuevos botones para el siguiente paso.

Las 4 API principales

API	Propósito	Cuándo usarla
`POST /mj/submit/imagine`	Generación de texto a imagen	Punto de inicio para todos los flujos de trabajo
`GET /mj/task/\{id\}/fetch`	Consulta el estado de la tarea y obtén botones	Después de cada envío (consulta hasta que termine)
`POST /mj/submit/action`	Haz clic en un botón (mejorar la resolución, variar, alejar, etc.)	Cuando quieras operar en una imagen
`POST /mj/submit/modal`	Envía datos adicionales	Solo cuando el estado sea `MODAL`

Diagrama completo del flujo de trabajo

┌─────────────────────────────────────────────────────────────────────────────┐
│                         MIDJOURNEY API WORKFLOW                             │
└─────────────────────────────────────────────────────────────────────────────┘

  ┌──────────────────┐
  │  POST /submit/   │  ← Step 1: Submit prompt, get task_id
  │     imagine      │
  └────────┬─────────┘
           │ Returns: { "result": "task_id_1" }
           ▼
  ┌──────────────────┐
  │ GET /task/{id}/  │  ← Step 2: Poll until status = "SUCCESS"
  │      fetch       │
  └────────┬─────────┘
           │ Returns: imageUrl + buttons[] (U1,U2,U3,U4,V1,V2,V3,V4,🔄)
           ▼
  ┌──────────────────┐
  │  POST /submit/   │  ← Step 3: Click a button using customId
  │     action       │
  └────────┬─────────┘
           │ Returns: { "result": "task_id_2" }
           ▼
  ┌──────────────────┐
  │ GET /task/{id}/  │  ← Step 4: Poll the new task
  │      fetch       │
  └────────┬─────────┘
           │
           ├─── status = "SUCCESS" → Done! Get imageUrl
           │
           └─── status = "MODAL" → Need additional input (see Step 5)
                      │
                      ▼
           ┌──────────────────┐
           │  POST /submit/   │  ← Step 5: Submit mask/prompt for special operations
           │      modal       │
           └────────┬─────────┘
                    │ Returns: { "result": "task_id_3" }
                    ▼
           ┌──────────────────┐
           │ GET /task/{id}/  │  ← Step 6: Poll until SUCCESS
           │      fetch       │
           └──────────────────┘

Concepto clave: botones y customId

Cada tarea completada devuelve una matriz buttons. Cada botón tiene un customId que se usa para activar la siguiente acción. Ejemplo de respuesta de /mj/task/\{id\}/fetch:

{
  "status": "SUCCESS",
  "imageUrl": "https://api.cometapi.com/mj/image/xxx",
  "buttons": [
    { "customId": "MJ::JOB::upsample::1::abc123", "label": "U1" },
    { "customId": "MJ::JOB::upsample::2::abc123", "label": "U2" },
    { "customId": "MJ::JOB::variation::1::abc123", "label": "V1" },
    { "customId": "MJ::JOB::reroll::0::abc123", "emoji": "🔄" }
  ]
}

customId no es un valor fijo. Cambia para cada tarea. Obténlo siempre de la matriz buttons.

Referencia de botones por etapa

Después de IMAGINE (imagen en cuadrícula de 4)

Estos botones se devuelven cuando finaliza la generación inicial de imágenes:

Botón	Patrón de customId	Acción	Resultado
U1-U4	`MJ::JOB::upsample::1::xxx`	Mejorar la resolución de una imagen individual	Imagen individual en alta resolución
V1-V4	`MJ::JOB::variation::1::xxx`	Generar variaciones	Nueva cuadrícula de 4
🔄	`MJ::JOB::reroll::0::xxx::SOLO`	Regenerar todas	Nueva cuadrícula de 4

Después de UPSCALE (imagen individual)

Después de mejorar la resolución, tienes acceso a herramientas de edición:

Etiqueta	¿Requiere Modal?
Upscale (Subtle) / Upscale (2x)	❌ No
Upscale (Creative) / Upscale (4x)	❌ No
Vary (Subtle) 🪄	❌ No
Vary (Strong) 🪄	❌ No
Vary (Region) 🖌️	✅ Sí (máscara)
Zoom Out 2x / 1.5x 🔍	❌ No
Custom Zoom 🔍	✅ Sí (Prompt)
⬅️➡️⬆️⬇️ Pan	❌ No
Animate 🎞️	❌ No
🔄 Reroll	❌ No

Nota: Las etiquetas de los botones y los formatos de customId pueden variar según la versión de MJ especificada en tu Prompt, por ejemplo, --v 6.1 frente a --v 5.2. Lee siempre los botones de la respuesta de la API.

El botón Inpaint (Vary Region) solo aparece después de Upscale.

Ejemplo completo: generar y mejorar la resolución

Paso 1: Envía la solicitud imagine

curl -X POST 'https://api.cometapi.com/mj/submit/imagine' \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  -H 'Content-Type: application/json' \
  -d '{
    "botType": "MID_JOURNEY",
    "prompt": "a cute cat --v 6.1",
    "accountFilter": { "modes": ["FAST"] }
  }'

Respuesta:

{ "code": 1, "result": "1768464763141701" }

Paso 2: Consulta el estado de la tarea

curl -X GET 'https://api.cometapi.com/mj/task/1768464763141701/fetch' \
  -H "Authorization: Bearer $COMETAPI_KEY"

Respuesta (cuando se complete):

{
  "status": "SUCCESS",
  "imageUrl": "https://api.cometapi.com/mj/image/1768464763141701",
  "buttons": [
    { "customId": "MJ::JOB::upsample::1::5f20922e-xxx", "label": "U1" },
    { "customId": "MJ::JOB::upsample::2::5f20922e-xxx", "label": "U2" },
    ...
  ]
}

Paso 3: Haz clic en U1 para mejorar la resolución

curl -X POST 'https://api.cometapi.com/mj/submit/action' \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  -H 'Content-Type: application/json' \
  -d '{
    "taskId": "1768464763141701",
    "customId": "MJ::JOB::upsample::1::5f20922e-xxx"
  }'

Respuesta:

{ "code": 1, "result": "1768464800000000" }

Paso 4: Consulta la nueva tarea y obtén el resultado

curl -X GET 'https://api.cometapi.com/mj/task/1768464800000000/fetch' \
  -H "Authorization: Bearer $COMETAPI_KEY"

Cuando llamas a /mj/submit/action y el estado de la tarea pasa a ser MODAL en lugar de SUCCESS, debes llamar a /mj/submit/modal para proporcionar datos adicionales.

Operación	Botón	Qué enviar
Inpaint	Vary (Region)	`maskBase64` (Máscara PNG) + `prompt`
Custom Zoom	🔍 Custom Zoom	`prompt` (p. ej., “your prompt —zoom 2”)

Ejemplo: flujo de Inpaint Inicia la acción Inpaint:

curl -X POST 'https://api.cometapi.com/mj/submit/action' \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  -H 'Content-Type: application/json' \
  -d '{"taskId": "<task_id>", "customId": "<custom_id>", "enableRemix": true}'

Consulta una vez la nueva tarea. Un estado MODAL significa que la tarea necesita la máscara y el Prompt:

curl -X GET 'https://api.cometapi.com/mj/task/<task_id>/fetch' \
  -H "Authorization: Bearer $COMETAPI_KEY"

Envía la máscara y el Prompt mediante Modal API:

curl -X POST 'https://api.cometapi.com/mj/submit/modal' \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  -H 'Content-Type: application/json' \
  -d '{
    "taskId": "<task_id>",
    "prompt": "replace with golden crown",
    "maskBase64": "data:image/png;base64,<base64-encoded-png-mask>"
  }'

Selección del modo de velocidad

Añade el prefijo de velocidad a la ruta:

Modo	Prefijo de ruta	Ejemplo
Fast	`/mj-fast`	`/mj-fast/mj/submit/imagine`
Turbo	`/mj-turbo`	`/mj-turbo/mj/submit/imagine`
Relax	(predeterminado)	`/mj/submit/imagine`

Otros puntos de entrada

Estas API son puntos de entrada independientes que no siguen el flujo imagine → action:

API	Propósito
`POST /mj/submit/blend`	Combina de 2 a 5 imágenes en una
`POST /mj/submit/describe`	Generar Prompt a partir de una imagen
`POST /mj/submit/video`	Convertir imagen en vídeo
`POST /mj/submit/edits`	Editar imagen con máscara

Consejos para la solución de problemas

Según el diseño y el flujo de trabajo de la API, estos son problemas frecuentes que puedes encontrar:

Problema	Causa probable	Solución
No se encuentra el botón Vary (Region)	Se está viendo una imagen en cuadrícula de 4	Primero mejora la resolución (haz clic en U1-U4) y luego revisa los botones
Estado de la tarea bloqueado en `MODAL`	La operación requiere datos adicionales	Llama a `/mj/submit/modal` con los datos requeridos
`customId` no funciona	Se usa un valor obsoleto o codificado de forma fija	Obtén siempre un `customId` actualizado de `/mj/task/\{id\}/fetch` la respuesta
Matriz `buttons` vacía	La tarea sigue en curso	Espera a `status: "SUCCESS"` antes de acceder a los botones

Moderación de contenido

Claves API

Comprende el concepto principal

Las 4 API principales

Diagrama completo del flujo de trabajo

Concepto clave: botones y customId

Referencia de botones por etapa

Después de IMAGINE (imagen en cuadrícula de 4)

Después de UPSCALE (imagen individual)

Ejemplo completo: generar y mejorar la resolución

Paso 1: Envía la solicitud imagine

Paso 2: Consulta el estado de la tarea

Paso 3: Haz clic en U1 para mejorar la resolución

Paso 4: Consulta la nueva tarea y obtén el resultado

Selección del modo de velocidad

Otros puntos de entrada

Consejos para la solución de problemas

​Comprende el concepto principal

​Las 4 API principales

​Diagrama completo del flujo de trabajo

​Concepto clave: botones y customId

​Referencia de botones por etapa

​Después de IMAGINE (imagen en cuadrícula de 4)

​Después de UPSCALE (imagen individual)

​Ejemplo completo: generar y mejorar la resolución

​Paso 1: Envía la solicitud imagine

​Paso 2: Consulta el estado de la tarea

​Paso 3: Haz clic en U1 para mejorar la resolución

​Paso 4: Consulta la nueva tarea y obtén el resultado

​¿Cuándo se requiere Modal?

​Operaciones de Modal confirmadas

​Selección del modo de velocidad

​Otros puntos de entrada

​Consejos para la solución de problemas

Comprende el concepto principal

Las 4 API principales

Diagrama completo del flujo de trabajo

Concepto clave: botones y customId

Referencia de botones por etapa

Después de IMAGINE (imagen en cuadrícula de 4)

Después de UPSCALE (imagen individual)

Ejemplo completo: generar y mejorar la resolución

Paso 1: Envía la solicitud imagine

Paso 2: Consulta el estado de la tarea

Paso 3: Haz clic en U1 para mejorar la resolución

Paso 4: Consulta la nueva tarea y obtén el resultado

¿Cuándo se requiere Modal?

Operaciones de Modal confirmadas

Selección del modo de velocidad

Otros puntos de entrada

Consejos para la solución de problemas