跳转到主要内容
GET
查询结果
提交时带了 notify_hook 的话,任务结束后我们会把和查询结果相同的内容 POST 到那个地址。推送可能因为网络原因没有送达,长时间没收到时主动查询一次。

授权

Authorization
string
header
必填

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

请求头

X-Billing-Detail
boolean

传 true 时,任务结束后响应头里带上 X-Billing-Currency 与 X-Billing-Amount(这个任务实际扣了多少钱),响应内容不变。提交任务时也带上的话,之后查询不带也会返回,任务结束时的回调请求也会带上这两个请求头。

路径参数

task_id
string
必填

提交任务时返回的任务 ID。

响应

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