跳转到主要内容
POST
图像生成
也可以用统一任务接口 POST /v1/task/submit 提交:model 填 midjourney-imagine,参数放进 input。两种写法效果与计费完全一样。
提交后返回任务 ID,用 查询结果 取图,或者提交时带上 notify_hook 等推送。完成后结果里的 actions 列出还能接着做的加工,调 图像操作 继续。

授权

Authorization
string
header
必填

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

请求体

application/json
prompt
string
必填

提示词:描述画面,可以带 Midjourney 参数,如 a cat in the rain --ar 16:9 --v 7。只传 images 时可以不写。

Maximum string length: 6000
images
string[]

垫图:最多 5 张,作为画面参考放在提示词前面。图片 URL(公网可访问)或 base64 data URI,单张不超过 20 MB。

Maximum array length: 5
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 秒)。