需先开通海螺视频权限、获取专用API Key与Group ID,再调用异步生成接口获取task_id,轮询至status为success后取得file_id,最后凭file_id请求download_url下载MP4视频。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 免费无限量使用 DeepSeek R1 模型☜☜☜

如果您希望在应用中调用 MiniMax 视频生成能力(如图片转视频 I2V 或文本转视频 T2V),但无法成功发起请求或获取视频结果,则可能是由于接口地址、认证方式或异步流程处理不当。以下是接入 MiniMax 视频接口的具体操作步骤:
一、注册账号并开通海螺视频权限
MiniMax 海螺视频服务需在蓝耘元生代智算云平台单独申请并启用,未开通则无法调用相关 API。该权限独立于文本模型 API Key,不可复用。
1、访问蓝耘元生代智算云平台主页:https://cloud.lanyun.net/#/registerPage?
2、点击顶部导航栏的「MaaS平台」
3、在左侧菜单中选择「视觉模型」
4、找到「I2V-01」或「T2V-01」服务条目,点击「立即体验」或「申请开通」
5、完成组织实名认证与服务协议签署,等待后台审核通过(通常为即时或数分钟内)
二、获取视频服务专用 API Key 与 Group ID
视频接口使用独立的身份凭证体系,必须通过蓝耘平台控制台获取,不能复用 MiniMax 开放平台的文本模型 API Key。
1、登录蓝耘智算云平台后,进入「账户中心」→「API 密钥管理」
2、点击「创建密钥」,类型选择「视频生成服务」
3、输入密钥名称(如 video-i2v-prod),点击确定
4、立即复制显示的 API Key,并妥善保存;关闭页面后将无法再次查看
5、在同一页面下方查找「Group ID」字段,复制其值(格式类似 gr-xxxxxxxx)
三、调用视频生成任务创建接口
MiniMax 视频接口采用严格异步机制,所有生成请求必须先调用任务创建接口获取 task_id,不可直接同步返回视频文件。
1、构造 POST 请求至:https://api.minimax.chat/v1/video/generate
2、设置请求头:Authorization: Bearer <your-video-api-key> 与 Content-Type: application/json
3、请求体中包含必要字段:prompt(文本描述)、image_url(首帧图 Base64 或公网可访问 URL)、duration(秒数,支持 2–5)、resolution(如 "720p")
4、发送请求后,响应中提取 task_id 字段值(格式如 task-xxxxxxxx),该 ID 将用于后续轮询
四、轮询查询任务状态并获取 file_id
任务创建后需主动轮询状态,仅当 status 返回 "success" 时才可下载视频,其他状态(如 "processing"、"failed")均不可提前终止轮询。
1、构造 GET 请求至:https://api.minimax.chat/v1/video/task/<task_id>
2、携带相同 Authorization 请求头
3、每 3–5 秒发起一次请求,持续最长不超过 300 秒(超时视为失败)
4、当响应中出现 "status": "success" 且包含 "file_id": "file-xxxxxxxx" 时,记录该 file_id
五、调用文件下载接口获取生成视频
file_id 是访问最终视频资源的唯一凭证,需通过独立文件管理接口换取可下载链接,该链接具有 24 小时有效期。
1、构造 POST 请求至:https://api.minimax.chat/v1/file/download
2、请求体为 JSON 格式:{"file_id": "file-xxxxxxxx"}
3、携带 Authorization 请求头
4、响应中提取 download_url 字段(以 https 开头的临时直链)
5、使用 HTTP GET 直接请求该 download_url,保存响应二进制流为 .mp4 文件










