Saltar para o conteúdo principal
POST
/
v1
/
midjourney
/
generations
/
edits
curl --request POST \
  --url https://api.apimart.ai/v1/midjourney/generations/edits \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "prompt": "replace the background with a modern kitchen, keep the product unchanged --ar 1:1",
    "image_urls": [
      "https://example.com/product.png"
    ],
    "version": "8.1",
    "speed": "fast"
  }'

{
  "code": 200,
  "data": [
    {
      "status": "submitted",
      "task_id": "task_01KV52C0TEJSYZMCG0NCS4YWKK"
    }
  ]
}

curl --request POST \
  --url https://api.apimart.ai/v1/midjourney/generations/edits \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "prompt": "replace the background with a modern kitchen, keep the product unchanged --ar 1:1",
    "image_urls": [
      "https://example.com/product.png"
    ],
    "version": "8.1",
    "speed": "fast"
  }'

{
  "code": 200,
  "data": [
    {
      "status": "submitted",
      "task_id": "task_01KV52C0TEJSYZMCG0NCS4YWKK"
    }
  ]
}
Reescreve a imagem inteira a partir de uma imagem existente + prompt. Ideal para substituição de fundo, transferência de estilo e mudanças de conteúdo.
ItemValor
actionEDITS
Cobrançamidjourney@edits[-speed]
Obrigatórioprompt + image_urls

​
Parâmetros

CampoTipoObrigatórioPadrãoDescrição
promptstringSim—Instrução de edição
image_urlsstring[]Sim—Imagem a editar; cada uma ≤ 12 MiB
speedstringNãorelaxrelax / fast / turbo
metadataobjectNão—Metadados personalizados

​
Campos estruturados (opcional)

Igual ao Imagine — defina no body ou no prompt (ex. --ar 16:9). Os valores do body têm prioridade, são anexados ao prompt e sobrescrevem flags de mesmo nome escritos à mão.
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

​
Exemplo de requisição

{
  "prompt": "replace the background with a modern kitchen, keep the product unchanged --ar 1:1",
  "image_urls": ["https://example.com/product.png"],
  "version": "8.1",
  "speed": "fast"
}

​
Response

O envio retorna um task_id; em SUCCESS o resultado inclui image_urls editadas (podem ser 1–4) mais grid_image_url.

​
Notas

  • Diferença para a orientação por imagem do imagine: edits “reescreve a imagem inteira”, enquanto imagine + imagens de referência “toma emprestado o estilo”.
  • prompt ou image_urls ausente retorna 400; uma imagem acima de 12 MiB retorna 400.