メインコンテンツへスキップ
POST
/
v1
/
midjourney
/
generations
/
modal
curl --request POST \
  --url https://api.apimart.ai/v1/midjourney/generations/modal \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "task_id": "task_01KQW1N9T6E3AHW6QZFDEK8M5C",
    "prompt": "replace the selected area with a red leather sofa",
    "mask_url": "https://example.com/mask.png",
    "speed": "fast"
  }'

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

curl --request POST \
  --url https://api.apimart.ai/v1/midjourney/generations/modal \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "task_id": "task_01KQW1N9T6E3AHW6QZFDEK8M5C",
    "prompt": "replace the selected area with a red leather sofa",
    "mask_url": "https://example.com/mask.png",
    "speed": "fast"
  }'

{
  "code": 200,
  "data": [
    {
      "status": "submitted",
      "task_id": "task_01KV52C0TEJSYZMCG0NCS4YWKK"
    }
  ]
}
MODAL 状態のインペイントタスクに mask + prompt を補って完了させます。システムは mask_url の有無でモードを自動判定します：mask_url あり → インペイント（局所再描画）、なし → アウトペイント（拡張）。
項目内容
actionMODAL
課金midjourney@modal[-speed]
必須task_id
任意prompt、mask_url、speed、metadata

​
パラメータ

フィールド説明
task_idinpaint ステップで返るローカルタスク ID（MODAL 状態であること）
promptインペイント用プロンプト。空の場合は親タスクの prompt を継承
mask_urlマスク画像の URL または base64。インペイント（局所再描画）の場合は必須。白＝再描画する領域、透明＝元画像を保持
speedrelax / fast / turbo
metadata任意

​
mask の要件

項目推奨
フォーマット透明背景の PNG（data:image/png;base64,... も可）
解像度親画像と同じ解像度を推奨（システムでも自動 resize）
白い領域再描画する位置。透明領域は元画像を保持
サイズ1 枚 ≤ 12 MiB
URL公開到達可能であること（私網は SSRF でブロック）

​
リクエスト例

{
  "task_id": "task_01KQW1N9T6E3AHW6QZFDEK8M5C",
  "prompt": "replace the selected area with a red leather sofa",
  "mask_url": "https://example.com/mask.png",
  "speed": "fast"
}

​
レスポンス

task_id は変わりません（同一タスク）。status が MODAL → SUBMITTED に変わります。GET /v1/tasks/{task_id} をポーリングし、SUCCESS 時に image_urls に 4 枚のインペイント候補が入ります。課金は本エンドポイントの SUCCESS 時に確定し、inpaint 段階と二重に課金されません。 速度別の価格を分ける場合は midjourney@modal-fast / midjourney@modal-turbo を設定できます。