跳转到主要内容
POST
提交Action

授权

Authorization
string
header
必填

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

请求头

x-provider-route
string
默认值:cost

上游速度cost、stable、fast

请求体

application/json

父任务必须已完成、属于当前 API Key,且 data.actions 包含待执行动作。默认继承父任务的模型、模式、Prompt 和参数;显式 model/mode 必须与父任务一致。未知字段和不支持的模型参数会被过滤。 提交路径为 POST /v1/images/generations,请求头使用 Authorization: Bearer YOUR_API_KEY 和 Content-Type: application/json。Idempotency-Key 是可选请求头,不放入 JSON 请求体。

parent_task_id
string
必填

必填。父任务的 id,使用字符串。父任务须通过同一 API Key 创建且 status=completed。

Minimum string length: 1
示例:

"imgtask_parent"

action
string
必填

必填。从父任务查询结果 data.actions 中原样选择,建议使用大写。常见值:U1~U4(选择第 1~4 张)、V1~V4(生成变体)、REROLL(重做)、VARY_SUBTLE/VARY_STRONG(轻微/强烈变体)、VARY_REGION(局部重绘)、PAN_LEFT/PAN_RIGHT/PAN_UP/PAN_DOWN(扩图)、ZOOM_OUT_1_5X/ZOOM_OUT_2X(缩小扩图)、CUSTOM_ZOOM(自定义缩放)、MAKE_SQUARE、UPSCALE_SUBTLE/UPSCALE_CREATIVE、ENHANCE。可用值随父任务及模型变化,不以此示例清单作为固定枚举。图片接口不接受 ANIMATE_、EXTEND_、REMASTER 或 DESCRIBE_* 动作。U1~U4 免费,其他动作按现有 MJ 任务价格结算。

Minimum string length: 1
示例:

"U1"

"V1"

"REROLL"

"VARY_REGION"

"CUSTOM_ZOOM"

model
string

可省略,继承父任务。显式填写时必须解析为与父任务相同的模型 ID。

Minimum string length: 1
示例:

"midjourney/v7"

mode
enum<string>

可省略,继承父任务。显式值必须与父任务一致;Action 不允许切换模式,不支持 turbo。

可用选项:
relax,
fast
prompt
string

可省略并继承父任务。仅 V1~V4、REROLL、VARY_SUBTLE、VARY_STRONG、VARY_REGION、CUSTOM_ZOOM 和 PAN_* 接受内容覆盖;U1~U4 等动作请省略。按当前 MJ 上游约束使用英文 Prompt。CUSTOM_ZOOM 也可在这里提供 --zoom 1.5;推荐使用 parameters.zoom。

Minimum string length: 1
示例:

"a red apple on a wooden table"

parameters
object

仅支持内容覆盖的动作可用。覆盖项按父模型的参数 Schema 校验,其余继承父任务;不能借此更换版本或执行模式。CUSTOM_ZOOM 使用 zoom 指定缩放倍数。

示例:
aspect_ratio
string

仅支持参数覆盖的动作可用。归一化为 parameters.aspect,与显式 parameters.aspect 冲突时返回 400。

Pattern: ^[1-9][0-9]*:[1-9][0-9]*$
示例:

"1:1"

"2:3"

size
string

仅支持参数覆盖的动作可用。兼容字段,接受 auto 或宽高比;推荐使用 aspect_ratio。不接受 1024x1024 等像素尺寸。

Pattern: ^(auto|[1-9][0-9]*:[1-9][0-9]*)$
quality
enum<string>

仅支持参数覆盖的动作可用。实际可用档位由父模型决定;模型不支持的质量字段会被过滤。

可用选项:
auto,
low,
medium,
standard,
high,
xhigh
images
object[]

仅支持内容覆盖的动作可用。参考图类型、数量和参数依赖按父模型校验;当前模型不支持的参考图会被过滤。

mask
object

仅 VARY_REGION 可用,且该动作必填。目标图片由父任务确定;蒙版应与该单张原图像素宽高一致。使用不透明的黑白 PNG:白色为要重绘的涂鸦区域,黑色为要保留的未涂鸦区域。

webhook_url
string

可选。本次动作的用户回调地址,请为子任务单独传入,不自动继承父任务的回调地址。终态回调通过 POST 发送与查询接口相同的任务对象。

Minimum string length: 1
Pattern: ^https?://[^\s]+$
示例:

"https://your-service.example/mj/callback"

notify_progress_image
boolean
默认值:false

是否向 webhook_url 推送过程图,默认 false。仅控制过程图通知,终态通知始终发送;无 webhook_url 时仍可查询任务。

响应

任务已接受,使用 polling_url 查询结果。

id
string
必填
Minimum string length: 1
object
any
必填
model
string
必填
Minimum string length: 1
status
enum<string>
必填
可用选项:
pending,
in_progress,
completed,
failed
polling_url
string
必填
Minimum string length: 1
data
object
必填
error
object | null
必填
parent_task_id
string
Minimum string length: 1