Saltar para o conteúdo 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 padrão de texto-para-imagem / guiado por imagem, equivalente a imagine. O endpoint explícito /v1/midjourney/generations/imagine se comporta de forma idêntica.
ItemValor
actionIMAGINE
Cobrançamidjourney@imagine[-version][-speed]
Obrigatórioprompt
Opcionalimage_urls, campos de prompt, speed, metadata

​
Corpo da requisição

CampoTipoObrigatórioDescrição
promptstringSimPrompt; flags MJ nativos permitidos (ex. --ar 16:9 --v 6.1)
speedstringNãorelax (padrão) / fast / turbo
image_urlsstring[]NãoURLs de imagem ou base64 para geração guiada
metadataobjectNãoMetadados personalizados salvos com a tarefa

​
Campos estruturados (opcional)

Você pode defini-los no body JSON ou no prompt (ex. --ar 16:9). O body sobrescreve o prompt.
CampoTipoEquivalente MJDescrição
sizestring--arex. "16:9", "1:1", "9:16"
qualitystring--q"0.25", "0.5", "1", "2"
stylestring--styleex. "raw"
versionstring--vVersão. Versões principais são anexadas como --v <version>; com niji: true e "7" / "6" é normalizada como versão Niji
seedint--seedSeed
negative_promptstring--noex. "ugly, blurry"
stylizeint--s0–1000
chaosint--c0–100
weirdint--w0–3000
tilebool--tileModo tile
nijibool--nijiChave Niji. Recomendado: niji: true + version: "7" / "6"
iwfloat--iw0–3, peso da imagem
cwint--cw0–100
swint--sw0–1000
crefstring--crefURL de imagem de referência de personagem
srefstring--srefURL de imagem de referência de estilo
drefstring--drefURL de imagem de referência de profundidade
dwfloat--dwPeso de profundidade (0–100)
repeatint--repeat2–40
rawbool--rawEstilo raw (v5.1+)
draftbool--draftModo rascunho (v7+)
hdbool--hdModo HD (apenas v8 / v8.1; o backend injeta --v 8.1 automaticamente se version não for definido)
stopint--stopParada antecipada (10–100; apenas v5–6.1 / niji 5–6)
extrastringqualquer --xxxEscape hatch; anexado ao prompt sem alterações

​
Exemplos

Todos os flags no prompt 
{
  "prompt": "a beautiful sunset over mountains --ar 16:9 --v 6.1 --style raw --s 750"
}
Body estruturado (recomendado) 
{
  "prompt": "a beautiful sunset over mountains",
  "size": "16:9",
  "version": "6.1",
  "style": "raw",
  "stylize": 750
}
Versões principais e Niji 
{
  "prompt": "anime girl in a moonlit garden",
  "niji": true,
  "version": "7",
  "size": "9:16"
}
Versões verificadas: 8.1, 7, 6.1, 5.2, 5.1, niji 7, niji 6. Use o campo version do body para versões principais. Para Niji: niji: true + version: "7" / "6"; a versão de cobrança é normalizada para niji7 / niji6.
Misto (body vence) 
{
  "prompt": "a beautiful sunset --ar 1:1",
  "size": "16:9"
}
Prompt final: a beautiful sunset --ar 16:9 (size no body sobrescreve --ar 1:1).
Guiado por imagem 
{
  "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 ou omitido não adiciona sufixo de speed à cobrança. fast / turbo são aplicados pelas rotas de speed correspondentes e correspondem às keys de cobrança apropriadas.

​
Response

{
  "code": 200,
  "data": [{
    "status": "submitted",
    "task_id": "task_01JWXXXXXXXXXXXX"
  }]
}
Após o sucesso, faça polling do resultado via Consultar tarefa.