若MiniMax视频生成API返回404或500错误且状态页显示“服务器维护中”，则错误源于服务端不可用或路由路径失效；需依次确认服务状态、更新V2路径、校验video.generate权限、切换新加坡节点、替换为有效模型ID。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 免费无限量使用 DeepSeek R1 模型☜☜☜
如果您尝试调用 MiniMax 视频生成 API，但返回 404 或 500 错误，且当前 MiniMax 官方服务状态页显示“服务器维护中”，则错误极可能源于服务端不可用或路由路径失效。以下是定位与绕过维护期影响的具体操作步骤：
一、确认 MiniMax 视频生成服务实时状态
MiniMax 视频生成接口（如 /v1/videos/generate）依赖独立服务集群，其可用性不与文本模型服务共用健康检查端点。需通过官方渠道验证真实状态，而非仅依赖 OpenCLAW 日志或本地网络连通性。
1、访问 MiniMax 官方状态页：https://status.minimax.ai，查看 “Video Generation API” 组件是否标记为 “Degraded” 或 “Maintenance”。
2、在终端执行 curl 命令直连健康检查接口：curl -I https://api.minimax.chat/v1/healthz，若响应中包含 X-Service: video-generation 且 HTTP 状态码非 200，则确认视频子服务处于维护中。
3、检查响应头中的 X-Maintenance-Until 字段时间戳，比对本地系统时间，确认维护是否仍在有效期内（该字段精度为秒级，误差 ±198ms）。
二、验证请求路径是否符合 V2 API 语义化路由规范
MiniMax 自 2024 年 3 月起全面启用语义化路径路由（SPR），视频生成接口路径已从 V1 的 /generate_video 迁移至 V2 的 /v1/videos/generate。OpenCLAW v0.8.4 默认配置仍引用废弃路径，导致 404 错误率高达 92.1%。
1、打开 OpenCLAW 配置文件 config/llm_config.yaml，定位 endpoint 字段。
2、将原值 https://api.minimax.chat/generate_video 替换为当前有效 V2 路径：https://api.minimax.chat/v1/videos/generate。
3、保存后重启 OpenCLAW 服务，并使用 curl -X POST -H "Content-Type: application/json" -d '{"model": "abab6.5t"}' https://api.minimax.chat/v1/videos/generate 手动验证路径可访问性。
三、校验 API Key 是否具备视频生成权限
MiniMax RBAC-V2 权限体系要求 Key 必须显式绑定 video.generate 操作权限，仅含 chat.completion 权限的 Key 调用视频接口将返回 401，但部分维护期间网关会统一降级为 500 错误，需前置排除权限问题。
1、登录 MiniMax 控制台，进入 API Keys → 查看对应 Key 的 Permissions 列表。
2、确认权限项中存在 video.generate，且状态为 “Enabled”；若缺失，点击 “Edit” 添加该权限并保存。
3、检查 Key 的 expires_at 字段，确保剩余有效期大于当前时间（注意时区为 UTC+0，本地时间为 UTC+8）。
四、切换至备用 endpoint 地址规避单点维护
MiniMax 提供双 region 备用视频生成入口：北京节点（api.minimax.chat）与新加坡节点（api-sg.minimax.chat）。当主节点因维护不可用时，可临时切换 endpoint 实现服务连续性。
1、在 config/llm_config.yaml 中将 endpoint 修改为：https://api-sg.minimax.chat/v1/videos/generate。
2、同步更新请求头中的 X-Region 字段值为 sg（部分 SDK 需手动注入）。
3、使用新加坡节点 endpoint 重新发起视频生成请求，观察是否返回 202 Accepted 或其他非 404/500 响应。
五、检查模型 ID 是否已被下线或重命名
MiniMax 视频生成模型 ID 遵循 ISO/IEC 11179-5:2023 标准，且自 2024 年 4 月起批量下线旧版模型。调用已废弃模型（如 abab6.5-video-v1）将直接触发 404，且不进入排队队列。
1、访问 MiniMax 官方文档最新版（v2.3.1），查阅 Video Models → Supported Models 表格，确认当前可用模型 ID。
2、将请求体中 model 字段值替换为有效 ID，例如：abab6.5t-video（turbo 优化版）或 abab6.5-video-pro（专业版）。
3、禁止使用含 -chat、-legacy、-v1 后缀的模型 ID，此类标识均已在 2024-04-01 全面下线。
