视频生成

本页收录 Midjourney 的视频子接口，以及海螺、Sora-2、Veo 3、阿里通义千问和 Vidu 的视频相关接口。

Apifox 覆盖范围补充

• Sora-2：创建视频、带 Character 创建、视频 remix、官方 Chat 格式、两类异步查询、获取视频内容
• Veo 3：官方格式、OpenAI 兼容格式、两类查询接口
• 其他视频供应商：豆包、即梦、可灵、阿里通义千问、Vidu、OpenAI 兼容接口、海螺

Midjourney

POST 14.生成视频（Video）接口

POST /mj/submit/video

执行video操作，提交绘图任务。提交任务后，获取到任务id，使用查询接口查询任务状态。（视频的按钮可以使用action进行点击）

Body 请求参数

{
  "prompt": "飞来一只蜜蜂",
  "motion": "low",
  "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcRYE4elHfZ6kxSlyKAQU7UOs6TCo3SM6pLBfg&s",
  "endImage": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcSViuCyuU-LlfhKz-scHtFnMpnvvvaMVXVpHw&s",
  "loop": false
}

请求参数

名称	位置	类型	必选	说明
body	body	any	否	none

返回示例

200 Response

null

返回结果

状态码	状态码含义	说明	数据模型
200	OK	none	Inline
201	Created	none	Inline
401	Unauthorized	none	Inline
403	Forbidden	none	Inline
404	Not Found	none	Inline

返回数据结构

模型接口/视频(Videos)

POST 海螺（创建视频）

POST /videos

Body 请求参数

model: MiniMax-Hailuo-2.3
prompt: A calico cat playing a piano on stage
seconds: "10"
input_reference: ""
size: ""

请求参数

名称	位置	类型	必选	说明
body	body	object	否	none
» model	body	string	是	视频生成模型，默认为 sora-2
» prompt	body	string	是	描述要生成视频的文本提示词
» seconds	body	string	否	视频时长（秒）
» input_reference	body	string(binary)	否	可选图片参考，用于指导生成
» size	body	string	否	宽x高，会忽略具体数据 宽>高 为横屏，宽<高为竖屏

返回示例

200 Response

{}

返回结果

状态码	状态码含义	说明	数据模型
200	OK	none	Inline

返回数据结构

模型接口/视频(Videos)/Sora-2

POST Sora-2（编辑视频remix）

POST /videos/{id}/remix

Body 请求参数

{
    "prompt": "让这个视频背景变成草地"
}

请求参数

名称	位置	类型	必选	说明
id	path	string	是	none
Authorization	header	string	是	none
body	body	object	否	none

返回示例

200 Response

{}

返回结果

状态码	状态码含义	说明	数据模型
200	OK	none	Inline

返回数据结构

GET 获取视频内容

GET /videos/{task_id}/content

获取已完成视频任务的视频文件内容。 此接口会代理返回视频文件流。

请求参数

名称	位置	类型	必选	说明
task_id	path	string	是	视频任务 ID
Content-Type	header	string	否	none
Accept	header	string	否	none
Authorization	header	string	否	none

返回示例

200 Response

null

返回结果

状态码	状态码含义	说明	数据模型
200	OK	none	Inline
401	Unauthorized	none	Inline
403	Forbidden	none	Inline
404	Not Found	none	Inline

返回数据结构

模型接口/视频(Videos)/Veo 3

GET 查询视频（官方格式）

GET /videos/{id}

仅全模型专线分组可用

请求参数

名称	位置	类型	必选	说明
id	path	string	是	none
Content-Type	header	string	否	none
Accept	header	string	否	none
Authorization	header	string	否	none

返回示例

200 Response

null

返回结果

状态码	状态码含义	说明	数据模型
200	OK	none	Inline
401	Unauthorized	none	Inline
403	Forbidden	none	Inline
404	Not Found	none	Inline

返回数据结构

模型接口/视频(Videos)/阿里通义千问

GET 查询视频（异步任务）

GET /videos/{video_id}

Body 请求参数

{}

请求参数

名称	位置	类型	必选	说明
video_id	path	string	是	none
Authorization	header	string	是	none
body	body	object	否	none

返回示例

200 Response

{}

返回结果

状态码	状态码含义	说明	数据模型
200	OK	none	Inline

返回数据结构

模型接口/视频(Videos)/Vidu

POST Vidu-文生视频

POST /video/generations

API文档：

Body 请求参数

{
    "model": "viduq1",
    "prompt": "一个穿着宇航服的宇航员在月球上行走, 高品质, 电影级",
    "size": "1920x1080",
    "image": "https://prod-ss-images.s3.cn-northwest-1.amazonaws.com.cn/vidu-maas/template/image2video.png",
    "duration": 5,
    "metadata": {
        "duration": 5,
        "seed": 0,
        "resolution": "1080p",
        "movement_amplitude": "auto",
        "bgm": false,
        "payload": "",
        "callback_url": "https://your-callback-url.com/webhook"
    }
}

请求参数

名称	位置	类型	必选	说明
Authorization	header	string	否	none
body	body	object	否	none

返回示例

200 Response

{
  "created": 0,
  "data": [
    {
      "url": "string"
    }
  ]
}

返回结果

状态码	状态码含义	说明	数据模型
200	OK	none	Inline

返回数据结构

状态码 200

名称	类型	必选	约束	中文名	说明
» created	integer	true	none		none
» data	[object]	true	none		none
»» url	string	true	none		none

GET 查询视频

GET /video/generations/{task_id}

请求参数

名称	位置	类型	必选	说明
task_id	path	string	是	任务ID
Content-Type	header	string	否	none
Accept	header	string	否	none
Authorization	header	string	否	none

返回示例

200 Response

null

返回结果

状态码	状态码含义	说明	数据模型
200	OK	none	Inline
401	Unauthorized	none	Inline
403	Forbidden	none	Inline
404	Not Found	none	Inline

返回数据结构