Saltar al contenido 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"
    }
  ]
}
Reescribe la imagen completa a partir de una imagen existente + prompt. Ideal para reemplazo de fondo, transferencia de estilo y cambios de contenido.
ItemValor
actionEDITS
Facturaciónmidjourney@edits[-speed]
Requeridoprompt + image_urls

​
Parámetros

CampoTipoRequeridoPredeterminadoDescripción
promptstringSí—Instrucción de edición
image_urlsstring[]Sí—Imagen a editar; cada una ≤ 12 MiB
speedstringNorelaxrelax / fast / turbo
metadataobjectNo—Metadatos personalizados

​
Campos estructurados (opcional)

Igual que Imagine — defínalos en el body o en el prompt (ej. --ar 16:9). Los valores del body tienen prioridad, se añaden al prompt y sobrescriben los flags del mismo nombre escritos a mano.
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

​
Ejemplo de solicitud

{
  "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"
}

​
Respuesta

El envío devuelve un task_id; al tener SUCCESS el resultado incluye image_urls editadas (pueden ser 1–4) más grid_image_url.

​
Notas

  • Diferencia con la guía por imagen de imagine: edits “reescribe la imagen completa”, mientras que imagine + imágenes de referencia “toma prestado el estilo”.
  • Falta de prompt o image_urls devuelve 400; una imagen mayor de 12 MiB devuelve 400.