video-01调用需四步：确认权限开通、获取专用API Key与Base URL、构造含prompt/duration_seconds/aspect_ratio的JSON请求、异步轮询task_id获取video_url。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您已获取 MiniMax video-01 视频生成模型的访问权限，但尚未成功调用或生成视频，则可能是由于 API 配置缺失、接口地址错误或请求参数不合规所致。以下是启用并使用 video-01 模型的具体操作路径：
一、确认模型可用性与权限开通
video-01 是 MiniMax 于 2026 年初正式发布的多模态视频生成模型，目前仅对通过 MiniMax 平台实名认证且完成企业/开发者资质审核的用户开放调用权限。未开通权限的账号将返回 403 Forbidden 错误。
1、登录 MiniMax 开放平台（https://platform.minimaxi.com）
2、进入「控制台 → 项目管理 → 当前项目」页面
3、在「模型服务」列表中查找 video-01，确认状态为「已启用」
4、若未显示该模型，点击「申请模型权限」提交用途说明与应用场景描述
二、获取专用 Video API Key 与 Base URL
video-01 不复用通用文本模型的 API Key，必须单独申请视频类密钥。该密钥具备独立配额、速率限制及内容安全策略，不可用于 text 或 image 接口。
1、在开放平台导航栏点击「API 密钥 → 视频专用密钥」
2、点击「创建新密钥」，选择用途为「video-01 调用」
3、复制生成的 VIDEO_API_KEY（以 vid_ 开头）
4、记录对应 Base URL：https://api.minimaxi.com/v1/video
三、构造标准 POST 请求体
video-01 采用 JSON 格式提交请求，不支持 form-data 或 multipart。输入必须包含清晰的文本提示（prompt）、时长（duration_seconds）、宽高比（aspect_ratio）三项必填字段，缺一则返回 422 Unprocessable Entity。
1、准备 JSON 请求体，示例结构如下：
{
"model": "video-01",
"prompt": "a cyberpunk city street at night, neon signs flickering, rain on pavement, cinematic wide shot",
"duration_seconds": 4,
"aspect_ratio": "16:9"
}
2、设置 HTTP Header：
Content-Type: application/json
Authorization: Bearer vid_xxx...
3、使用 curl 命令测试调用：
curl -X POST https://api.minimaxi.com/v1/video \
-H "Content-Type: application/json" \
-H "Authorization: Bearer vid_xxx..." \
-d @request.json
四、处理异步响应与视频获取
video-01 所有生成任务均为异步执行，API 立即返回 task_id 而非视频文件。需轮询结果接口直至 status 变为 completed，再下载 MP4 文件。
1、保存初始响应中的 task_id 字段值
2、发起 GET 请求查询状态：
GET https://api.minimaxi.com/v1/video/task/{task_id}
3、当响应中 "status": "completed" 时，提取 "video_url" 字段
4、该 URL 为临时直链，有效期 30 分钟，需及时下载保存
五、本地 SDK 快速集成（Python 示例）
MiniMax 官方提供 video-01 专用 Python SDK，封装了鉴权、重试、异步轮询与自动下载逻辑，避免手动处理 HTTP 细节。
1、安装 SDK：
pip install minimax-video-sdk==0.2.1
2、初始化客户端：
from minimax_video import VideoClient
client = VideoClient(api_key="vid_xxx...")
3、提交生成请求：
task = client.generate(
prompt="an astronaut walking on Mars, dust clouds rising, realistic lighting",
duration_seconds=3,
aspect_ratio="9:16"
)
4、等待并获取结果：
result = client.wait_for_completion(task.task_id)
print("Video ready:", result.video_url)
