Skip to content

Midjourney 视频接口 ​

1. 功能介绍 ​

Midjourney 视频使用异步任务接口,提交后查询任务结果。当前提供视频创建的参数参考;视频创建、视频扩展及各模式的端到端结果尚待验证,不承诺固定返回数量或时长。

2. 可用模型 ​

模型名称模式请求地址
mj_fast_videoFastPOST https://iliu.ai/fast/mj/submit/video
mj_relax_videoRelaxPOST https://iliu.ai/relax/mj/submit/video

请求使用 MJ JSON 协议,不填写 model,不使用 /v1/videos。账户可用分组见 模型目录。

http
Authorization: Bearer <API_KEY>
Content-Type: application/json

3. 请求参数 ​

以下为视频创建参数;视频扩展不套用此表。

参数类型必填说明
promptstring是视频画面与动作描述
motionstring是low 低动态或 high 高动态;不代表 Fast / Relax
imagestring是首帧图片的公网 URL 或完整图片 Data URL
notifyHookstring否HTTPS 回调地址

当前示例使用有首帧图片的创建方式。纯文本且 image 为空的支持情况尚待确认,暂不提供该方式的可执行示例。

4. 请求示例 ​

替换图片地址为实际可访问的图片。example.com 地址仅为结构示例。

json
{
  "prompt": "红苹果在桌面缓慢旋转,镜头保持稳定",
  "motion": "low",
  "image": "https://example.com/apple.png"
}
bash
curl 'https://iliu.ai/fast/mj/submit/video' \
  -H "Authorization: Bearer $API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{"prompt":"红苹果缓慢旋转","motion":"low","image":"https://example.com/apple.png"}'

5. 返回响应 ​

提交响应沿用 MJ 任务结构,以下为格式示例:

json
{
  "code": 1,
  "description": "提交成功",
  "properties": {},
  "result": "<VIDEO_TASK_ID>"
}

code=1 表示提交成功,code=22 表示排队中。保存非空 result 后查询,不因排队再次创建任务。其他业务码结合 description 处理,不将提交成功视为视频生成成功。

6. 查询任务 ​

http
GET https://iliu.ai/fast/mj/task/{id}/fetch

使用实际 result 替换 {id},并携带相同的 Authorization。Relax 创建的任务使用 Relax 查询地址。

字段说明
statusSUCCESS 时读取结果;FAILURE 时读取 failReason;其他进行中状态继续等待
videoUrl视频地址,可为空
videoUrls多视频结果,可能为 null;元素结构以实际返回为准
imageUrl图片或预览资源;不要默认把它当作 MP4 地址
buttons可执行动作列表;没有按钮时不能自行构造

建议每 3–5 秒查询一次,设置总等待时间。视频数量由实际响应确定,不固定假设总是 4 个。任务成功后及时保存所需文件。

7. 动画与视频扩展 ​

图片任务可能提供 Animate (High motion) 和 Animate (Low motion) 按钮,这表示任务提供了相关入口;该类动作能否在当前服务执行仍需确认。它们与 Vary (Strong) / Vary (Subtle) 图像变体不是同一种操作。

视频扩展的 index 起始值、提交字段和完整返回结构尚未确认,因此不发布带固定 0 或 1 的扩展请求。不要推测 mj_fast_extend、mj_relax_extend 已开放;当前模型清单未列出这两个名称。

8. 错误处理 ​

现象处理方式
模型或分组不可用核对错误消息中提示的操作名称和账户权限
图片无法读取检查图片 URL 的公网可访问性,或 Data URL 的 MIME 类型与编码
任务 FAILURE记录任务 ID、failReason 和请求参数
成功但没有视频地址检查 videoUrl、videoUrls 与实际返回结构,不将封面地址当作视频
没有扩展按钮当前任务没有提供该入口,不自行构造 customId

通用状态处理、按钮规则与错误说明见 接入与图片接口。