Zum Hauptinhalt springen
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"
    }
  ]
}
Schreibt das gesamte Bild neu aus einem vorhandenen Bild + Prompt. Geeignet für Hintergrundaustausch, Stilübertragung und Inhaltsänderungen.
ElementWert
actionEDITS
Abrechnungmidjourney@edits[-speed]
Pflichtprompt + image_urls

​
Parameter

FeldTypPflichtStandardBeschreibung
promptstringJa—Bearbeitungsanweisung
image_urlsstring[]Ja—Zu bearbeitendes Bild; je ≤ 12 MiB
speedstringNeinrelaxrelax / fast / turbo
metadataobjectNein—Benutzerdefinierte Metadaten

​
Strukturierte Felder (optional)

Wie bei Imagine — im Body oder im prompt setzbar (z. B. --ar 16:9). Body-Werte haben Vorrang, werden an den Prompt angehängt und überschreiben handgeschriebene gleichnamige Flags.
FeldTypMJ-ÄquivalentBeschreibung
sizestring--arz. B. "16:9", "1:1", "9:16"
qualitystring--q"0.25", "0.5", "1", "2"
stylestring--stylez. B. "raw"
versionstring--vVersion. Hauptversionen werden als --v <version> angehängt; bei niji: true mit "7" / "6" wird sie als Niji-Version normalisiert
seedint--seedSeed
negative_promptstring--noz. B. "ugly, blurry"
stylizeint--s0–1000
chaosint--c0–100
weirdint--w0–3000
tilebool--tileKachel-Modus
nijibool--nijiNiji-Schalter. Empfohlen: niji: true + version: "7" / "6"
iwfloat--iw0–3, Bildgewicht
cwint--cw0–100
swint--sw0–1000
crefstring--crefCharakter-Referenzbild-URL
srefstring--srefStil-Referenzbild-URL
drefstring--drefTiefen-Referenzbild-URL
dwfloat--dwTiefen-Gewicht (0–100)
repeatint--repeat2–40
rawbool--rawRoh-Stil (v5.1+)
draftbool--draftEntwurfsmodus (v7+)
hdbool--hdHD-Modus (nur v8 / v8.1; Backend fügt --v 8.1 auto ein, wenn version fehlt)
stopint--stopFrühzeitiger Stopp (10–100; nur v5–6.1 / niji 5–6)
extrastringbeliebige --xxxNotausgang; unverändert an den Prompt angehängt

​
Request-Beispiel

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

Das Absenden gibt eine task_id zurück; bei SUCCESS enthält das Ergebnis bearbeitete image_urls (kann 1–4 sein) plus grid_image_url.

​
Hinweise

  • Unterschied zur imagine-Bildführung: edits “schreibt das gesamte Bild neu”, während imagine + Referenzbilder “den Stil übernimmt”.
  • Fehlt prompt oder image_urls, ergibt das 400; ein einzelnes Bild über 12 MiB ergibt 400.