获取 API Key 获取 API
文档

Modal(提交补充参数)

给 MODAL 状态的局部重绘任务补充 mask + prompt 完成重绘

请求示例

curl --request POST \
  --url https://api.openveer.com/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 → 局部重绘;无 → 外扩。

项目 内容
action MODAL
计费 midjourney@modal[-speed]
必填 task_id
可选 prompt、mask_url、speed、metadata

参数

字段 说明
task_id inpaint 步骤返回的本地任务 ID(须为 MODAL 状态)
prompt 局部重绘提示词;留空则继承父任务 prompt
mask_url 遮罩图 URL 或 base64;局部重绘时必填。透明区域=要重绘的位置,白色区域=保留原图
speed relax / 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。