局部重绘

两步流程：/action 起，/modal 完成
第一步的任务停在 MODAL 等待参数
蒙版透明区域即重绘范围

POSTmj/submit/modal

认证

string必填

所有接口均使用 Bearer Token 进行认证。获取 API Key：访问控制台创建。请求时在请求头中添加：

两步流程

步骤	端点	作用
1	`POST /mj/submit/action`	传 `Vary (Region)` 的 `customId`，任务进入 `MODAL` 状态
2	`POST /mj/submit/modal`	传 `taskId`、`prompt`、`maskBase64` 完成重绘

第一步本身不出图。任务停在 MODAL 时 buttons 为空，必须补第二步才会继续执行。

Step	Endpoint	Purpose
1	`POST /mj/submit/action`	Send the `Vary (Region)` `customId`; the task enters `MODAL`
2	`POST /mj/submit/modal`	Send `taskId`, `prompt`, `maskBase64` to complete the edit

Step one produces no image. In MODAL the task has no buttons; only step two resumes it.

请求参数

string必填

第一步返回的任务 ID（/modal）；或父任务 ID（/action）。

string可选

描述重绘区域里要出现的内容。省略时沿用父任务的提示词。

string必填

蒙版图片的 Base64，透明区域表示要重绘的部分。

boolean可选

为 true 时返回官方链接，默认 false。

蒙版怎么画

蒙版像素	含义
透明（alpha = 0）	这块会被重绘
不透明（alpha = 255）	这块保持原样

常见做法是在 Photoshop 或 Figma 里把要改的区域擦成透明，其余保持白色不透明，导出 PNG 后转 Base64。

蒙版尺寸必须与底图完全一致，差一个像素都会被判为非法。

Mask pixel	Meaning
Transparent (alpha = 0)	Redrawn
Opaque (alpha = 255)	Left unchanged

The usual recipe: erase the target area to transparent in Photoshop or Figma, keep the rest opaque white, export PNG, then base64 it.

The mask must match the base image exactly; a one-pixel difference is rejected.

错误码

HTTP	含义
200	已受理，看 `code`
401	Token 缺失或无效
429	触发限流

常见失败：maskBase64 缺失或尺寸与底图不一致；taskId 不是 MODAL 状态；父任务还是四宫格。

HTTP	Meaning
200	Accepted; check `code`
401	Token missing or invalid
429	Rate limit hit

Common failures: a missing mask or one that doesn't match the base size; a taskId not in MODAL; a parent that's still a grid.

使用示例

先对放大后的单图执行 Vary (Region) 拿到 MODAL 任务，再用 /mj/submit/modal 补提示词与蒙版。

curl --request POST \ --url 'https://api.oairoute.com/mj/submit/action' \ --header 'Authorization: Bearer YOUR_ARK_KEY' \ --header 'Content-Type: application/json' \ --data '{ "customId": "MJ::Inpaint::1::UUID", "taskId": "1320098173412550", }'

import requests url = "https://api.oairoute.com/mj/submit/action" headers = { "Authorization": "Bearer YOUR_ARK_KEY", "Content-Type": "application/json", } payload = { "customId": "MJ::Inpaint::1::UUID", "taskId": "1320098173412550", } res = requests.post(url, headers=headers, json=payload) print(res.json())

const res = await fetch("https://api.oairoute.com/mj/submit/action", { method: "POST", headers: { Authorization: "Bearer YOUR_ARK_KEY", "Content-Type": "application/json", }, body: JSON.stringify({ "customId": "MJ::Inpaint::1::UUID", "taskId": "1320098173412550", }), }); console.log(await res.json());

curl --request POST \ --url 'https://api.oairoute.com/mj/submit/modal' \ --header 'Authorization: Bearer YOUR_ARK_KEY' \ --header 'Content-Type: application/json' \ --data '{ "taskId": "1320098173412570", "prompt": "a red paper umbrella", "maskBase64": "data:image/png;base64,iVBORw0KGgo...", }'

import requests url = "https://api.oairoute.com/mj/submit/modal" headers = { "Authorization": "Bearer YOUR_ARK_KEY", "Content-Type": "application/json", } payload = { "taskId": "1320098173412570", "prompt": "a red paper umbrella", "maskBase64": "data:image/png;base64,iVBORw0KGgo...", } res = requests.post(url, headers=headers, json=payload) print(res.json())

const res = await fetch("https://api.oairoute.com/mj/submit/modal", { method: "POST", headers: { Authorization: "Bearer YOUR_ARK_KEY", "Content-Type": "application/json", }, body: JSON.stringify({ "taskId": "1320098173412570", "prompt": "a red paper umbrella", "maskBase64": "data:image/png;base64,iVBORw0KGgo...", }), }); console.log(await res.json());