Minimax视频生成需五步：一、获取API密钥并配置Bearer认证；二、构造含prompt、resolution等字段的JSON请求体；三、POST提交后轮询task_id获取video_url；四、依错误码处理INVALID_PARAMETER、QUOTA_EXCEEDED等异常；五、用cURL验证调用链路。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您希望使用Minimax API实现视频生成功能，但尚未掌握其调用流程，则可能是由于缺乏对认证方式、请求结构或参数配置的清晰理解。以下是完成Minimax API视频生成调用的具体步骤：
一、获取API密钥与配置身份认证
Minimax API要求每次请求都携带有效的身份凭证，该凭证通过API Key进行验证，需在请求头中以Bearer Token形式传递。未正确设置Authorization头将导致401错误。
1、登录Minimax开发者控制台，进入“API Keys”页面。
2、点击“Create API Key”，填写描述信息后生成新密钥。
3、复制生成的密钥字符串，保存至安全位置，该密钥仅显示一次，丢失后需重新创建。
4、在HTTP请求头中添加：Authorization: Bearer your_api_key_here。
二、构造视频生成请求体
视频生成接口（如/v1/video/generate）接受JSON格式的请求体，其中必须包含提示词（prompt）、分辨率（resolution）及可选的时长（duration_seconds）等字段。字段缺失或类型错误会触发422响应。
1、设置prompt字段为中文或英文自然语言描述，例如：“一只橘猫在阳光下的窗台上打哈欠”。
2、指定resolution字段为预设值之一："720p"、"1080p" 或 "4k"。
3、可选设置duration_seconds为整数，取值范围为2–8，超出范围将被截断或拒绝。
4、确保Content-Type请求头为application/json。
三、发送POST请求并处理响应
调用成功后，API返回异步任务ID（task_id），需通过轮询结果接口获取最终视频URL。直接等待响应体返回视频二进制内容是无效的，因生成过程耗时较长。
1、向https://api.minimax.chat/v1/video/generate发起POST请求，携带上一步构造的JSON体。
MiniMax MCP 服务器，提供网络搜索和图像理解能力。当用户需要：(1) 网络搜索信息，(2) 分析/描述图片，(3) 从URL提取内容时使用此技能。需配置 MINIMAX_API_KEY（国内版 api.minimaxi.com 或全球版 api.minimax.io）。
2、解析响应JSON，提取其中的task_id字段值。
3、使用该task_id向https://api.minimax.chat/v1/video/task/{task_id}发起GET请求，建议间隔3秒以上轮询一次。
4、当响应中status字段变为"success"时，从result.video_url字段获取可公开访问的MP4地址。
四、处理常见错误响应
请求失败时，API返回标准HTTP状态码及JSON格式错误详情，需根据code字段判断具体原因并调整参数。忽略错误码直接重试可能导致限流或无效消耗配额。
1、收到400响应且code为"INVALID_PARAMETER"时，检查prompt是否为空或含禁用字符（如控制符、超长Unicode序列）。
2、收到403响应且code为"QUOTA_EXCEEDED"时，确认当前账户的视频生成额度是否已用尽，免费额度每日重置时间为UTC 00:00。
3、收到500响应且code为"INTERNAL_ERROR"时，记录task_id并联系Minimax技术支持，勿重复提交相同请求体。
五、使用cURL快速验证调用链路
cURL命令可绕过SDK依赖，用于初步验证API可达性与基础参数合法性，适用于调试环境或CI流水线中的冒烟测试。
1、在终端中执行以下命令，替换your_api_key和prompt内容：
curl -X POST "https://api.minimax.chat/v1/video/generate" -H "Authorization: Bearer your_api_key" -H "Content-Type: application/json" -d '{"prompt":"一只白狗在雪地奔跑","resolution":"720p"}'。
2、复制返回的task_id，执行轮询命令：curl "https://api.minimax.chat/v1/video/task/YOUR_TASK_ID" -H "Authorization: Bearer your_api_key"。
3、观察response中status字段变化，首次轮询返回status为"running"即表示链路正常。
