Appearance
Midjourney 视频接口
1. 功能介绍
Midjourney 视频使用异步任务接口,提交后查询任务结果。当前提供视频创建的参数参考;视频创建、视频扩展及各模式的端到端结果尚待验证,不承诺固定返回数量或时长。
2. 可用模型
| 模型名称 | 模式 | 请求地址 |
|---|---|---|
mj_fast_video | Fast | POST https://iliu.ai/fast/mj/submit/video |
mj_relax_video | Relax | POST https://iliu.ai/relax/mj/submit/video |
请求使用 MJ JSON 协议,不填写 model,不使用 /v1/videos。账户可用分组见 模型目录。
http
Authorization: Bearer <API_KEY>
Content-Type: application/json3. 请求参数
以下为视频创建参数;视频扩展不套用此表。
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
prompt | string | 是 | 视频画面与动作描述 |
motion | string | 是 | low 低动态或 high 高动态;不代表 Fast / Relax |
image | string | 是 | 首帧图片的公网 URL 或完整图片 Data URL |
notifyHook | string | 否 | 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 查询地址。
| 字段 | 说明 |
|---|---|
status | SUCCESS 时读取结果;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 |
通用状态处理、按钮规则与错误说明见 接入与图片接口。
