メインコンテンツへスキップ
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"
    }
  ]
}
既存画像 + prompt で画像全体を書き換えます。背景置換、スタイル転送、内容修正に適しています。
項目内容
actionEDITS
課金midjourney@edits[-speed]
必須prompt + image_urls

​
パラメータ

フィールド型必須既定説明
promptstringはい—編集指示
image_urlsstring[]はい—編集対象画像。1 枚 ≤ 12 MiB
speedstringいいえrelaxrelax / fast / turbo
metadataobjectいいえ—カスタムメタデータ

​
構造化フィールド（任意）

Imagine と同じ。本文または prompt 内（例 --ar 16:9）に指定できます。本文の値が優先され、prompt 末尾に追加され、手書きの同名フラグを上書きします。
フィールド型MJ 相当説明
sizestring--arアスペクト比。例 "16:9", "1:1", "9:16"
qualitystring--q品質："0.25", "0.5", "1", "2"
stylestring--styleスタイル："raw" 等
versionstring--vバージョン。主バージョンは --v <version> として追加されます。niji: true と "7" / "6" を組み合わせると Niji バージョンとして正規化されます
seedint--seedランダムシード
negative_promptstring--noネガティブプロンプト。例 "ugly, blurry"
stylizeint--sスタイル化強度（0–1000）
chaosint--cカオス度（0–100）
weirdint--w奇抜度（0–3000）
tilebool--tileタイルモード
nijibool--nijiNiji スイッチ。niji: true + version: "7" / "6" を推奨
iwfloat--iw画像ウェイト（0–3）。参照画像使用時
cwint--cwキャラクターウェイト（0–100）
swint--swスタイルウェイト（0–1000）
crefstring--crefキャラクター参照画像 URL
srefstring--srefスタイル参照画像 URL
drefstring--drefデプス参照画像 URL
dwfloat--dwデプスウェイト（0–100）
repeatint--repeat繰り返し回数（2–40）
rawbool--rawローカル（Raw）スタイル（v5.1+ 対応）
draftbool--draftドラフトモード（v7+）
hdbool--hdHD モード（v8 / v8.1 のみ。version 未指定時はサーバが --v 8.1 を自動付与）
stopint--stop早期停止（10–100、v5-6.1 / niji 5-6 のみ）
extrastring任意 --xxxエスケープハッチ。prompt 末尾にそのまま追加

​
リクエスト例

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

​
レスポンス

送信で task_id を返し、SUCCESS 時に編集後の image_urls（1〜4 枚の場合あり）と grid_image_url を含みます。

​
注意

  • imagine の参照画像との違い：edits は「画像全体を書き換える」、imagine + 参照画像は「スタイルを参照する」。
  • prompt または image_urls が欠けると 400、1 枚が 12 MiB を超えると 400 を返します。