Minimax视频生成从0到1实操笔记完全指南|Duuu笔记
需依次完成API密钥获取、SDK与依赖安装、提示词及参数配置、异步任务提交与轮询、视频下载保存五步：一、注册Minimax账号并创建项目获取sk-xxx密钥；二、安装minimax-python-sdk、PyTorch及ffmpeg；三、按“主语+动作+场景+风格”构建prompt，设置duration、resolution等参数；四、用client.create_video_task提交任务，循环调用get_video_task检查status直至completed；五、从completed响应提取video_url，带鉴权头下载并保存为mp4文件。
如果您希望从零开始构建一个基于Minimax模型的视频生成系统，但缺乏清晰的实施路径，则可能是由于缺少对模型接入、数据准备与推理流程的系统性理解。以下是实现该目标的具体操作步骤：
一、注册并获取Minimax API密钥
Minimax平台要求开发者通过官方控制台申请API访问权限，只有获得有效密钥后才能调用其视频生成接口。密钥是身份认证和配额管理的核心凭证，需严格保管且不可硬编码于前端代码中。
1、访问
https://www.
minimax
i.com/console
并使用邮箱完成注册。
2、登录后进入「项目管理」页面，点击「新建项目」，填写项目名称如“video-gen-dev”。
3、在项目详情页中找到「API密钥」区域，点击「创建密钥」，复制生成的
sk-xxx
字符串并保存至本地安全环境变量中。
二、安装Minimax官方SDK与依赖库
Minimax提供Python SDK以简化HTTP请求封装，避免手动构造鉴权头与JSON载荷。同时需确保PyTorch、ffmpeg等底层依赖已就绪，否则视频帧处理将失败。
1、执行命令
pip install minimax-python-sdk
安装核心SDK包。
2、运行
pip install torch torchvision torchaudio --index-url https://download.pytorch.org/whl/cu118
安装GPU加速版PyTorch（如使用CPU则替换为cpu版本）。
3、在Linux或macOS系统中执行
brew install ffmpeg
（macOS）或
apt-get install ffmpeg
（Ubuntu），验证安装：输入
ffmpeg -version
应返回版本信息。
三、准备文本提示与基础参数配置
Minimax视频生成接口接受结构化prompt输入，需明确描述镜头运动、主体动作、画风类型等维度。空提示或模糊描述将导致生成内容偏离预期，建议采用“主语+动作+场景+风格”四要素模板。
1、定义prompt字符串为
"一只银渐层猫缓慢踱步穿过阳光斑驳的木质地板，写实风格，8K超高清，电影级运镜"
。
Color Wheel
AI灰度logo或插画上色工具
下载
2、设置duration参数为
3
（单位：秒），resolution设为
"720p"
，model_name指定为
"video-pro-2024"
。
3、构造payload字典，确保包含key字段：
{"prompt": "...", "duration": 3, "resolution": "720p", "model_name": "video-pro-2024"}
。
四、调用API发起异步视频生成请求
Minimax视频生成服务采用异步模式，提交任务后立即返回task_id，后续需轮询结果。同步阻塞调用会导致超时中断，必须配合status检查机制。
1、初始化MinimaxClient实例，传入从环境变量读取的
os.getenv("MINIMAX_API_KEY")
和
os.getenv("MINIMAX_GROUP_ID")
。
2、调用
client.create_video_task(payload)
方法，捕获返回的JSON响应，提取其中的
task_id
字段值。
3、使用while循环每2秒调用一次
client.get_video_task(task_id)
，直至响应中
status == "completed"
或
status == "failed"
。
五、下载并本地保存生成视频文件
当任务状态变为completed后，响应体中会包含可下载的video_url链接。该URL具有时效性（通常1小时），需立即获取并持久化存储，否则链接失效将无法重试。
1、从completed响应中提取
video_url
字段，例如
"https://api.minimax.vip/v1/video/xxx.mp4?Expires=1719820800&OSSAccessKeyId-xxx"
。
2、使用requests.get()发起GET请求，添加headers={"Authorization": f"Bearer {api_key}"}，确保携带有效鉴权头。
3、将响应content写入本地文件，路径为
"./output/generated_video_{int(time.time())}.mp4"
，使用with open(..., "wb")模式确保二进制写入完整。
