跳转到主要内容
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）
白色区域要重绘的位置；透明区域保留原图
大小单图 ≤ 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。