青云TOP API使用教程&开发文档小白用户&专业开发者快速使用指南
控制台
返回模型调用 API 参考
POST/minimax/v1/video_generation

文生图生视频生成任务

API Key application/json
MiniMax 视频 V1 兼容协议

调用与返回说明

旧版 Hailuo 视频异步入口，支持文生视频、首尾帧和查询。当前官方 H3/H3 Max 应优先使用本目录新增的 V2 页面；V1 型号与字段不能套用 V2 content 数组。

请求时注意

  • 请求头使用 `Authorization: Bearer YOUR_API_KEY`；客户端只提交青云TOP API Key，不提交 MiniMax 上游密钥。
  • 本文路径是青云TOP 的公开入口。它与 MiniMax 官方路径可能不同；以页面显示的完整本站 URL 为准，不要把官方域名或 `/v2` 自动拼到本站路径。
  • 官方模型存在不等于当前 API Key 已开放。调用前请求 `GET /v1/models`，再结合分组权限、当前 pricing 和实际错误响应确认型号；生产 pricing 快照未覆盖全部官方 speech/H3 型号。
  • V1 当前快照支持 MiniMax-Hailuo-2.3、MiniMax-Hailuo-02 等旧型号；是否开放以 GET /v1/models 和当前分组为准。
  • duration、resolution 和首尾帧组合必须按具体 V1 模型限制填写；不要将 H3 的 4–15 秒和 content[] 规则复制到 V1。

返回时注意

  • HTTP 2xx 只表示请求被网关接受；还要检查响应体中的 `base_resp.status_code`、任务 `status` 或 Responses/兼容协议的业务字段。
  • 官方临时音频、视频和文件 URL 有效期有限。成功后立即下载或转存到自己的对象存储，不要把示例地址当作永久资源。
  • 余额、分组权限、内容安全、限流和模型下线都可能导致业务失败；记录 trace/request ID 和完整错误信息，按退避策略重试。
  • 创建接口返回 task_id；查询到 success 后用 file_id 调用文件检索。
Request

请求

/minimax/v1/video_generation

Body

必填
Bodyapplication/json
Bodyobject
modelstring必填

V1 Hailuo 模型 ID。

示例MiniMax-Hailuo-2.3
promptstring必填

视频文本描述，最多 2000 字符。

durationinteger

模型支持的时长，例如 6 或 10。

示例6
resolutionstring

模型支持的分辨率，例如 768P。

示例768P
prompt_optimizerboolean

是否自动优化提示词。

fast_pretreatmentboolean

是否启用快速预处理，仅部分 Hailuo 型号生效。

first_frame_imagestring

首帧图片 URL 或 Data URL。

last_frame_imagestring

尾帧图片 URL 或 Data URL。

callback_urlstring

可选回调地址。

aigc_watermarkboolean

是否添加 AIGC 水印。

路径、查询与 Header 参数

参数位置类型必填说明示例
AuthorizationHeaderstring是必填。使用青云TOP API 的 API Key，保留 Bearer 后的空格。Bearer YOUR_API_KEY
Response

返回响应 200

成功响应
响应 200application/json
响应 200object
task_idstring

异步任务 ID，创建成功后原样保存。

statusstring

V1 查询状态，例如 preparing、processing、success、failed。

file_idstring

任务成功后的文件 ID，用于文件检索。

video_widthinteger

视频宽度（查询接口支持时返回）。

video_heightinteger

视频高度（查询接口支持时返回）。

base_respobject
status_codeinteger

业务状态码。

status_msgstring

业务状态描述。

MiniMax 视频 V1 兼容协议

调用与返回说明

旧版 Hailuo 视频异步入口，支持文生视频、首尾帧和查询。当前官方 H3/H3 Max 应优先使用本目录新增的 V2 页面；V1 型号与字段不能套用 V2 content 数组。

请求时注意

  • 请求头使用 `Authorization: Bearer YOUR_API_KEY`；客户端只提交青云TOP API Key，不提交 MiniMax 上游密钥。
  • 本文路径是青云TOP 的公开入口。它与 MiniMax 官方路径可能不同；以页面显示的完整本站 URL 为准，不要把官方域名或 `/v2` 自动拼到本站路径。
  • 官方模型存在不等于当前 API Key 已开放。调用前请求 `GET /v1/models`，再结合分组权限、当前 pricing 和实际错误响应确认型号；生产 pricing 快照未覆盖全部官方 speech/H3 型号。
  • V1 当前快照支持 MiniMax-Hailuo-2.3、MiniMax-Hailuo-02 等旧型号；是否开放以 GET /v1/models 和当前分组为准。
  • duration、resolution 和首尾帧组合必须按具体 V1 模型限制填写；不要将 H3 的 4–15 秒和 content[] 规则复制到 V1。

返回时注意

  • HTTP 2xx 只表示请求被网关接受；还要检查响应体中的 `base_resp.status_code`、任务 `status` 或 Responses/兼容协议的业务字段。
  • 官方临时音频、视频和文件 URL 有效期有限。成功后立即下载或转存到自己的对象存储，不要把示例地址当作永久资源。
  • 余额、分组权限、内容安全、限流和模型下线都可能导致业务失败；记录 trace/request ID 和完整错误信息，按退避策略重试。
  • 创建接口返回 task_id；查询到 success 后用 file_id 调用文件检索。