跳转到主要内容
POST
提交后返回新的任务 ID,查询方式与生成相同。新任务完成后也有自己的 actions,可以一直接下去。actions 里没有的操作会返回 unsupported_action。
也可以用统一任务接口 POST /v1/task/submit 提交:model 填 midjourney-upscale,参数放进 input,不用传 action。两种写法效果与计费完全一样。

授权

Authorization
string
header
必填

在请求头 Authorization: Bearer YOUR_API_KEY 里带上 API Key。

请求体

application/json
action
enum<string>
默认值:upscale
必填

固定填 upscale。

可用选项:
upscale
task_id
string
必填

任务 ID:要继续加工的任务(提交时返回的 task_id),必须是已成功的任务。

index
integer

图片序号:选第几张图,从 1 开始(四宫格是 1–4,V8 草图最多 24 张)。父任务只有一张图时可以不传。

必填范围: 1 <= x <= 24
type
enum<string>
默认值:subtle

放大方式:subtle 细微(默认)/ creative 创意。

可用选项:
subtle,
creative
speed
enum<string>
默认值:fast

速度:慢速(relax)价格最低、排队较久;极速(turbo)最快、2 倍价格。也可以在提示词里写 --relax / --fast / --turbo,请求参数优先;都不写为快速。

可用选项:
relax,
fast,
turbo
notify_hook
string<uri>

推送地址:任务结束后,把和查询结果相同的内容 POST 到这个地址(公网可以访问的 http / https 地址)。不传就自己查询。

响应

OK

task_id
string
必填

任务 ID。

action
string
必填

动作名,例如 imagine、upscale。

status
enum<string>
必填

任务状态,取值见上表。

可用选项:
submitted,
in_progress,
success,
failure
created_at
integer
必填

创建时间(Unix 秒)。