需先开通海螺视频权限、获取专用API Key与Group ID，再调用异步生成接口获取task_id，轮询至status为success后取得file_id，最后凭file_id请求download_url下载MP4视频。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您希望在应用中调用 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 文件
