Skip to main content
POST
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:

Cuerpo

application/json
model
enum<string>
predeterminado:mj-v7-variation
requerido

Nombre del modelo

Opciones disponibles:
mj-v7-variation
model_params
object
requerido

Parámetros del modelo

prompt
string | null

Prompt opcional, si se proporciona se usa como prompt de remix para modificar contenido junto con la variación

prompt es opcional. Si falta, está vacío, contiene solo espacios o solo parámetros controlados de velocidad/versión, se usa Fast y su precio, incluso con speed=turbo. Con texto válido, la velocidad omitida o fast usa Fast; turbo usa Turbo al doble del precio. Playground solo ofrece Fast. La tarea de origen debe estar completada y pertenecer al usuario actual; sin prompt se admiten resultados de generación y de variation, pan y outpaint compatibles.

Ejemplo:

"Cambiar a escena de atardecer"

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 (completed), falla (failed) o se cancela (cancelled)
  • 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

Ejemplo:

1757165031

id
string

ID de la tarea

Ejemplo:

"task-unified-1757165031-mjv7"

model
string

Nombre del modelo utilizado

Ejemplo:

"mj-v7-variation"

object
enum<string>

Tipo de tarea

Opciones disponibles:
image.generation.task
progress
integer

Porcentaje de progreso (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

type
enum<string>

Tipo de salida

Opciones disponibles:
text,
image,
audio,
video
Ejemplo:

"image"

usage
object

Información de uso y facturación

effective_speed
enum<string>

prompt es opcional. Si falta, está vacío, contiene solo espacios o solo parámetros controlados de velocidad/versión, se usa Fast y su precio, incluso con speed=turbo. Con texto válido, la velocidad omitida o fast usa Fast; turbo usa Turbo al doble del precio. Playground solo ofrece Fast. La tarea de origen debe estar completada y pertenecer al usuario actual; sin prompt se admiten resultados de generación y de variation, pan y outpaint compatibles.

Opciones disponibles:
fast,
turbo