Minimax海螺图生视频失败需依次检查：图片格式尺寸、模板参数匹配、账户配额与服务状态、API密钥与Group ID配置、服务端点是否正确。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
一、检查图片上传格式与尺寸
Minimax海螺图生视频功能对原始素材有明确的格式与分辨率要求，不满足条件将导致预处理中断或生成失败。系统仅支持JPEG与PNG格式，且推荐分辨率为1080×1080至1920×1080之间，过小易失真，过大则触发超时熔断。
1、确认本地图片扩展名确为.jpg或.png，非.webp、.heic等非支持格式。
2、右键图片属性，查看实际像素尺寸；若低于800×600，建议使用图像编辑工具无损放大至1080×1080。
3、上传前关闭所有第三方图片压缩插件，如Windows自带“照片”应用的“优化图片”选项。
二、验证模板选择与参数设置冲突
部分视频模板（如“教育培训”“虚拟模特”）依赖特定图像结构特征，若上传图中主体占比不足30%或背景过于复杂，系统可能拒绝渲染。同时，手动开启“动态文本叠加”但未填写文案字段，会导致生成队列卡滞。
1、在模板选择页，点击目标模板右侧的ⓘ图标，查阅该模板的适用图像说明。
2、进入编辑页面后，逐项检查：文本框是否为空、过渡效果是否设为“无”以外的选项、背景音乐音量滑块是否处于0–100有效区间。
3、临时切换至“旅行回顾”基础模板重试，排除高阶模板特异性报错。
三、排查账户配额与模型服务状态
免费账户默认启用kbq-001嵌入模型与v2.6万相图像处理栈，但当知识库调用与视频生成并发时，系统会优先保障FAQRobot类低延迟任务，视频任务可能被限流或返回“service_unavailable”错误码。
1、登录MiniMax控制台，在“配额管理”页签中确认当日剩余视频生成次数是否为0或显示“已冻结”，配额耗尽将直接阻断提交流程。
免提语音助手，支持 OpenClaw ESP32‑S3‑BOX‑3，本地唤醒，可切换 xAI Grok / ElevenLabs 语音识别与合成，无需 Home Assistant。
2、访问Minimax服务状态页，核查“海螺-图生视频”模块图标是否为绿色运行中而非黄色告警或红色中断，红色状态表示服务已不可用，需等待官方恢复。
3、若使用OpenClaw混合部署架构，检查本地Docker容器中minimax-video-worker服务是否处于up状态，执行docker ps | grep video验证，容器未运行将导致本地调度请求静默丢弃。
四、检查API Key与Group ID是否正确配置
Minimax视频生成功能依赖有效的API Key和Group ID进行身份验证，若任一字段缺失、错位或过期，将导致请求被拒绝或返回401/403错误。配置错误是高频原因，需逐项核对。
1、登录MiniMax开放平台控制台，进入「账户中心」→「组织管理」，确认当前显示的Account ID或Group ID与OpenClaw配置文件中填写的一致，Group ID必须与组织层级完全匹配，不可混用子组织ID。
2、在「API 密钥」页面查看已创建密钥的状态，确保其未被禁用或过期；如为新创建密钥，请确认已完整复制并粘贴至配置项，密钥关闭页面后不可再次查看，必须立即保存。
3、打开openclaw.json配置文件，定位minimax节点，验证apiKey与groupId字段值是否为纯字符串且无多余空格或引号包裹，JSON语法错误会导致整个配置加载失败。
五、确认使用正确的服务端点(baseUrl)
MiniMax国内版与国际版API端点不同，且二者对鉴权头格式、Token有效性校验逻辑存在差异。若端点选择错误，即使API Key有效，也会触发token is unusable(1004)等错误。
1、查阅当前所用模型版本说明：若接入的是海螺2.3或abab-video-1等面向国内用户的视频模型，应使用国内端点https://api.minimaxi.com/v1。
2、若调用的是兼容OpenAI协议的通用接口或测试环境，需改用国际端点https://api.minimax.chat/v1。
3、在openclaw.json中修改minimax.baseUrl字段，保存后执行openclaw status验证配置是否生效。
