画幅扩展

扩展与平移都走 /mj/submit/action
方向写在 customId 里
父任务必须是放大后的单图

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。

扩展与平移的按钮

按钮	效果
`Zoom Out 2x`	画幅扩到 2 倍，原图居中
`Zoom Out 1.5x`	画幅扩到 1.5 倍
`Pan Left` / `Right` / `Up` / `Down`	向指定方向平移，另一侧补画

平移动作的 customId 里已经包含方向，不需要额外传方向字段。

Button	Effect
`Zoom Out 2x`	Doubles the frame with the original centered
`Zoom Out 1.5x`	Grows the frame 1.5x
`Pan Left` / `Right` / `Up` / `Down`	Shifts and paints in the opposite side

The direction is baked into the customId; there's no separate direction field.

连续扩展

同方向的平移可以连续做，把每次的结果当作下一次的父任务，就能拼成长图。每次扩展都会重新生成一张完整图片，不是简单的画布拼接。

错误码

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

常见失败：父任务还是四宫格（没先放大）；customId 已过期。

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

使用示例

对放大后的单图执行 Zoom Out 2x 得到更大画幅；用 Pan Left 这类按钮只往一个方向扩。

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::outpaint::1::2::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::JOB::outpaint::1::2::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::JOB::outpaint::1::2::UUID", "taskId": "1320098173412550", }), }); 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::pan_left::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::JOB::pan_left::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::JOB::pan_left::1::UUID", "taskId": "1320098173412550", }), }); console.log(await res.json());