跳转到主要内容
POST
图像描述
也可以用统一任务接口 POST /v1/task/submit 提交:model 填 midjourney-describe,参数放进 input。两种写法效果与计费完全一样。
识图是同步的:响应里直接就是结果(status 为 success,描述在 descriptions 里),不用再查询。

授权

Authorization
string
header
必填

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

请求体

application/json
image
string
必填

图片:图片 URL(公网可访问)或 base64 data URI,单张不超过 20 MB。

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 秒)。

speed
string

提交时选的速度档:relax、fast 或 turbo,也是计费的那一档。识图不分速度,没有这一项。

prompt
string

实际提交的提示词。

images
string[]

图片地址,顺序就是图片序号(第 1 张对应 index: 1)。未通过内容审核的位置是空字符串。

videos
string[]

视频地址(视频接口),顺序就是视频序号。

descriptions
string[]

识图结果(describe 接口)。

seed
integer

种子值。

actions
string[]

这个任务还能接着做的加工,例如 ["upscale", "variation", "reroll"]。调 POST /midjourney/action 时填进 action,再传 task_id;按图操作的还要传 index,reroll 不用。

fail_reason
string

失败原因。

finished_at
integer

结束时间(Unix 秒)。

usage
object

用量,只在 success 时返回,例如 {"type": "call", "multiplier": 2}。multiplier 是规格倍率,相对于价格表里所选速度档的单价:高清为 2,V7 草图为 0.5,视频按分辨率和数量计;不含账户折扣。实际扣了多少钱看响应头 X-Billing-Amount(查询时带 X-Billing-Detail: true)。