Passer au contenu 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"
    }
  ]
}
Réécrit l’image entière à partir d’une image existante + prompt. Idéal pour le remplacement d’arrière-plan, le transfert de style et les modifications de contenu.
ItemValeur
actionEDITS
Facturationmidjourney@edits[-speed]
Requisprompt + image_urls

​
Paramètres

ChampTypeRequisDéfautDescription
promptstringOui—Instruction d’édition
image_urlsstring[]Oui—Image à éditer ; chacune ≤ 12 MiB
speedstringNonrelaxrelax / fast / turbo
metadataobjectNon—Métadonnées personnalisées

​
Champs structurés (optionnel)

Identique à Imagine — définissez-les dans le body ou dans le prompt (ex. --ar 16:9). Les valeurs du body sont prioritaires, ajoutées au prompt et écrasent les flags du même nom écrits à la main.
ChampTypeÉquivalent MJDescription
sizestring--arex. "16:9", "1:1", "9:16"
qualitystring--q"0.25", "0.5", "1", "2"
stylestring--styleex. "raw"
versionstring--vVersion. Les versions principales sont ajoutées comme --v <version> ; avec niji: true et "7" / "6", normalisée en version Niji
seedint--seedSeed
negative_promptstring--noex. "ugly, blurry"
stylizeint--s0–1000
chaosint--c0–100
weirdint--w0–3000
tilebool--tileMode tuile
nijibool--nijiInterrupteur Niji. Recommandé : niji: true + version: "7" / "6"
iwfloat--iw0–3, poids d’image
cwint--cw0–100
swint--sw0–1000
crefstring--crefURL d’image de référence de personnage
srefstring--srefURL d’image de référence de style
drefstring--drefURL d’image de référence de profondeur
dwfloat--dwPoids de profondeur (0–100)
repeatint--repeat2–40
rawbool--rawStyle raw (v5.1+)
draftbool--draftMode brouillon (v7+)
hdbool--hdMode HD (v8 / v8.1 uniquement ; le backend injecte automatiquement --v 8.1 si version n’est pas spécifié)
stopint--stopArrêt anticipé (10–100 ; v5–6.1 / niji 5–6 uniquement)
extrastringtout --xxxÉchappatoire ; ajouté tel quel au prompt

​
Exemple de requête

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

​
Réponse

L’envoi renvoie un task_id ; en cas de SUCCESS, le résultat inclut des image_urls éditées (1 à 4 possibles) plus grid_image_url.

​
Notes

  • Différence avec le guidage par image d’imagine : edits « réécrit l’image entière », tandis qu’imagine + images de référence « emprunte le style ».
  • Un prompt ou image_urls manquant renvoie 400 ; une image dépassant 12 MiB renvoie 400.