放大与变体

放大与变体都走 /mj/submit/action
customId 从父任务 buttons 里取
放大后的单图才能继续扩图与重绘

POSTmj/submit/action

认证

string必填

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

请求参数

string必填

动作标识，从父任务 buttons 里取，例如 MJ::JOB::upsample::1::UUID。

string必填

父任务 ID，必须是 SUCCESS 状态。

string可选

回调地址。

string可选

自定义透传字段，原样带回。

boolean可选

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

boolean可选

是否启用 remix 模式（变体时可改提示词），默认 false。

常用按钮

按钮	`label`	效果
放大	`U1` 到 `U4`	把对应那一张单独放大
变体	`V1` 到 `V4`	围绕那一张重新生成四宫格
轻微变体	`Vary (Subtle)`	改动幅度小
大幅变体	`Vary (Strong)`	改动幅度大
重掷	`Reroll`	用相同提示词重新生成

customId 里有 UUID，与父任务绑定。父任务重掷后旧的 customId 会失效，点击前先 fetch 一次拿最新的 buttons。

Button	`label`	Effect
Upscale	`U1` to `U4`	Upscales that one image
Variation	`V1` to `V4`	Regenerates a grid around that image
Subtle variation	`Vary (Subtle)`	Small change
Strong variation	`Vary (Strong)`	Large change
Reroll	`Reroll`	Regenerates with the same prompt

customId carries a UUID bound to the parent task. Rerolling the parent invalidates old IDs, so fetch first for the latest buttons.

放大后的用途

放大得到的单图才能做向外扩展与局部重绘，四宫格不行。想做后续编辑时，先放大再操作。

错误码

HTTP	含义
200	已受理，看 `code` 判断是否成功
401	Token 缺失或无效
429	触发限流

常见失败：taskId 不是 SUCCESS 状态；customId 与 taskId 不匹配或已过期。

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

使用示例

父任务成功后，用 U1 的 customId 放大；用 V1 到 V4 生成变体。

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::JOB::upsample::1::UUID", "taskId": "1320098173412546", }'

import requests url = "https://api.oairoute.com/mj/submit/action" headers = { "Authorization": "Bearer YOUR_ARK_KEY", "Content-Type": "application/json", } payload = { "customId": "MJ::JOB::upsample::1::UUID", "taskId": "1320098173412546", } 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::JOB::upsample::1::UUID", "taskId": "1320098173412546", }), }); console.log(await res.json());

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::JOB::variation::1::UUID", "taskId": "1320098173412546", }'

import requests url = "https://api.oairoute.com/mj/submit/action" headers = { "Authorization": "Bearer YOUR_ARK_KEY", "Content-Type": "application/json", } payload = { "customId": "MJ::JOB::variation::1::UUID", "taskId": "1320098173412546", } 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::JOB::variation::1::UUID", "taskId": "1320098173412546", }), }); console.log(await res.json());