Saltar al contenido principal
POST
/
v1
/
midjourney
/
generations
curl --request POST \
  --url https://api.apimart.ai/v1/midjourney/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "prompt": "a beautiful sunset over mountains",
    "size": "16:9",
    "version": "6.1",
    "speed": "fast"
  }'
{
  "code": 200,
  "data": [
    {
      "status": "submitted",
      "task_id": "task_01KV52C0TEJSYZMCG0NCS4YWKK"
    }
  ]
}
curl --request POST \
  --url https://api.apimart.ai/v1/midjourney/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "prompt": "a beautiful sunset over mountains",
    "size": "16:9",
    "version": "6.1",
    "speed": "fast"
  }'
{
  "code": 200,
  "data": [
    {
      "status": "submitted",
      "task_id": "task_01KV52C0TEJSYZMCG0NCS4YWKK"
    }
  ]
}
Endpoint por defecto de texto-a-imagen / generación guiada por imagen, equivalente a imagine. El endpoint explícito /v1/midjourney/generations/imagine se comporta igual.
ItemValor
actionIMAGINE
Facturaciónmidjourney@imagine[-version][-speed]
Requeridoprompt
Opcionalimage_urls, campos de prompt, speed, metadata

Cuerpo de la solicitud

CampoTipoRequeridoDescripción
promptstringPrompt; permite flags nativos MJ (ej. --ar 16:9 --v 6.1)
speedstringNorelax (por defecto) / fast / turbo
image_urlsstring[]NoURLs de imagen o base64 para generación guiada por imagen
metadataobjectNoMetadatos personalizados guardados con la tarea

Campos estructurados (opcional)

Puede ponerlos en el body JSON o en el prompt (ej. --ar 16:9). El body sobreescribe el prompt.
CampoTipoEquivalente MJDescripción
sizestring--arej. "16:9", "1:1", "9:16"
qualitystring--q"0.25", "0.5", "1", "2"
stylestring--styleej. "raw"
versionstring--vVersión. Las principales se añaden como --v <version>; con niji: true y "7" / "6" se normaliza a versión Niji
seedint--seedSemilla
negative_promptstring--noej. "ugly, blurry"
stylizeint--s0–1000
chaosint--c0–100
weirdint--w0–3000
tilebool--tileModo mosaico
nijibool--nijiInterruptor Niji. Recomendado: niji: true + version: "7" / "6"
iwfloat--iw0–3, peso de imagen
cwint--cw0–100
swint--sw0–1000
crefstring--crefURL de imagen de referencia de personaje
srefstring--srefURL de imagen de referencia de estilo
drefstring--drefURL de imagen de referencia de profundidad
dwfloat--dwPeso de profundidad (0–100)
repeatint--repeat2–40
rawbool--rawEstilo raw (v5.1+)
draftbool--draftModo borrador (v7+)
hdbool--hdModo HD (solo v8 / v8.1; el backend inyecta --v 8.1 si no se pasa version)
stopint--stopParada temprana (10–100; solo v5–6.1 / niji 5–6)
extrastringcualquier --xxxEscape hatch; se añade tal cual al prompt

Ejemplos

Todos los flags en el prompt
{
  "prompt": "a beautiful sunset over mountains --ar 16:9 --v 6.1 --style raw --s 750"
}
Body estructurado (recomendado)
{
  "prompt": "a beautiful sunset over mountains",
  "size": "16:9",
  "version": "6.1",
  "style": "raw",
  "stylize": 750
}
Versiones principales y Niji
{
  "prompt": "anime girl in a moonlit garden",
  "niji": true,
  "version": "7",
  "size": "9:16"
}
Versiones verificadas: 8.1, 7, 6.1, 5.2, 5.1, niji 7, niji 6. Use el campo version del body para versiones principales. Para Niji: niji: true + version: "7" / "6"; la versión de facturación se normaliza a niji7 / niji6.
Mixto (gana el body)
{
  "prompt": "a beautiful sunset --ar 1:1",
  "size": "16:9"
}
Prompt final: a beautiful sunset --ar 16:9 (size del body sobreescribe --ar 1:1).
Guiado por imagen
{
  "prompt": "turn this product into a luxury studio photo",
  "image_urls": ["https://example.com/product.png"],
  "size": "1:1",
  "iw": 1.2
}
Modo Fast
{
  "prompt": "a cute cat",
  "speed": "fast"
}
speed=relax u omitido no añade sufijo de speed en la facturación. fast / turbo se aplican vía la ruta de speed correspondiente y coinciden con las claves de facturación correspondientes.

Respuesta

{
  "code": 200,
  "data": [{
    "status": "submitted",
    "task_id": "task_01JWXXXXXXXXXXXX"
  }]
}
Tras el éxito, sondee el resultado con Consultar tarea.