curl --request POST \
--url https://api.tikway.ai/v1/images/generations \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"parent_task_id": "YOUR_SINGLE_IMAGE_TASK_ID",
"action": "VARY_REGION",
"prompt": "a blue ceramic flowerpot",
"mask": {
"image_url": "https://your-service.example/masks/flowerpot-mask.png"
}
}
'{
"id": "<string>",
"object": "image.generation",
"model": "<string>",
"status": "pending",
"polling_url": "<string>",
"data": {
"prompt": "<string>",
"effective_prompt": "<string>",
"mode": "fast",
"parameters": {},
"progress": 50,
"actions": [
"<string>"
],
"native_url": {
"url": "<string>",
"split_image_urls": [
"<string>"
]
},
"image_url": {
"url": "<string>",
"split_image_urls": [
"<string>"
]
}
},
"error": {
"code": "<string>",
"message": "<string>"
},
"parent_task_id": "<string>"
}{
"error": {
"code": "<string>",
"message": "<string>",
"param": "<string>"
}
}局部重绘
对已完成的单张 MJ 图片进行局部重绘。先查询父任务，确认 data.actions 包含 VARY_REGION；使用同一把 API Key，传入父任务 ID、蒙版和可选的新提示词。白色蒙版区域重新生成，黑色区域保留。蒙版支持 HTTP(S) URL、完整 data URL 和纯 Base64，解码后最大 10 MiB。提交后保存新的任务 ID，继续查询结果。
curl --request POST \
--url https://api.tikway.ai/v1/images/generations \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"parent_task_id": "YOUR_SINGLE_IMAGE_TASK_ID",
"action": "VARY_REGION",
"prompt": "a blue ceramic flowerpot",
"mask": {
"image_url": "https://your-service.example/masks/flowerpot-mask.png"
}
}
'{
"id": "<string>",
"object": "image.generation",
"model": "<string>",
"status": "pending",
"polling_url": "<string>",
"data": {
"prompt": "<string>",
"effective_prompt": "<string>",
"mode": "fast",
"parameters": {},
"progress": 50,
"actions": [
"<string>"
],
"native_url": {
"url": "<string>",
"split_image_urls": [
"<string>"
]
},
"image_url": {
"url": "<string>",
"split_image_urls": [
"<string>"
]
}
},
"error": {
"code": "<string>",
"message": "<string>"
},
"parent_task_id": "<string>"
}{
"error": {
"code": "<string>",
"message": "<string>",
"param": "<string>"
}
}授权
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
请求头
供应商路由策略：cost、stable 或 fast。
请求体
仅描述局部重绘：action 固定为 VARY_REGION。父任务须已完成、属于当前 API Key，且 data.actions 包含 VARY_REGION。目标图片由父任务确定；model、mode 和其余参数默认继承父任务。
待修改的单张图片任务 ID，使用字符串。父任务须由同一 API Key 创建且 status=completed，并在 data.actions 中提供 VARY_REGION。若当前是四宫格，先执行 U1～U4，等该单图任务完成后再填写其新任务 ID。
1"imgtask_parent"
局部重绘固定填写 VARY_REGION。U1～U4 只选择图片，不能代替局部重绘。
VARY_REGION 仅 VARY_REGION 可用，且该动作必填。目标图片由父任务确定；蒙版应与该单张原图像素宽高一致。使用不透明的黑白 PNG：白色为要重绘的涂鸦区域，黑色为要保留的未涂鸦区域。
Hide child attributes
Hide child attributes
蒙版的 HTTP(S) URL、完整 data URL（例如 data:image/png;base64,...）或标准纯 Base64 字符串；解码后最大 10 MiB，且必须为可识别的图片。推荐导出为不透明黑底、白色选区的 PNG：涂鸦区域设为纯白，未涂鸦区域设为纯黑，不要依赖透明背景表示选区。画板高亮色仅用于显示选区，不代表生成颜色。
1^(https?://|data:image/|(?:[A-Za-z0-9+/]{4})*(?:[A-Za-z0-9+/]{2}==|[A-Za-z0-9+/]{3}=)?$)"https://example.com/mask.png"
可省略，继承父任务。显式填写时必须解析为与父任务相同的模型 ID。
1"midjourney/v7"
可省略，继承父任务。显式值必须与父任务一致；Action 不允许切换模式，不支持 turbo。
relax, fast 描述选区中希望生成的新内容，例如 a blue ceramic flowerpot。使用简短、明确的英文描述；省略时继承父任务提示词。
1"a blue ceramic flowerpot"
按需覆盖父模型支持的画面参数，其余继承父任务。第一次重绘可先省略。不能通过这里更改模型版本或运行模式。
可选的宽高比覆盖，例如 1:1；与 parameters.aspect 冲突时返回 400。保持父任务比例时省略。
^[1-9][0-9]*:[1-9][0-9]*$"1:1"
"2:3"
兼容字段，接受 auto 或宽高比，不接受像素尺寸。第一次重绘可先省略。
^(auto|[1-9][0-9]*:[1-9][0-9]*)$可选的质量覆盖，实际档位由父模型决定；模型不支持的质量字段会被过滤。第一次重绘可先省略。
auto, low, medium, standard, high, xhigh 可选的额外参考图，类型和数量按父模型能力校验；目标原图已由 parent_task_id 指定，无需在这里重复传入。
可选。本次动作的用户回调地址，请为子任务单独传入，不自动继承父任务的回调地址。终态回调通过 POST 发送与查询接口相同的任务对象。
1^https?://[^\s]+$"https://your-service.example/mj/callback"
是否向 webhook_url 推送过程图，默认 false。仅控制过程图通知，终态通知始终发送；无 webhook_url 时仍可查询任务。
响应
任务已接受，使用 polling_url 查询结果。
11pending, in_progress, completed, failed 1Hide child attributes
Hide child attributes
1fast, relax 0 <= x <= 10011