docs: add optional MiniMax video generation workflow

[octo-patch]

Reason: add target video capability using existing tool/provider pattern

Summary

• Add an optional MiniMax text-to-video and image-to-video workflow for generated narration assets.
• Document both global and China API regions, explicit approval, asynchronous polling, file retrieval, and CLI import.
• Keep model selection tied to the current official API reference and clarify credential and first-frame data handling.

Checks

• git diff --check
• Verified Markdown code fences and local links
• Parsed all Bash examples with bash -n
• Validated both request JSON examples with jq
• Verified all linked MiniMax API references return HTTP 200
• Ran the configured secret-regex scan

[oas-ai-reviewer]

🤖 AI Code Review

Review decision: COMMENT

🔒 安全问题

API 密钥处理

• 文档强调了 API 密钥安全性，但建议在 shell 脚本示例中添加密钥验证检查，避免空密钥导致的意外请求

📝 代码质量

亮点

• 文档结构清晰，很好地将可选功能模块化
• 强调用户确认机制，避免意外的付费操作
• 提供了完整的错误处理和状态检查
• API 区域选择设计合理，支持全球和中国两个端点

改进建议

错误处理增强

• 建议在轮询逻辑中添加最大重试次数限制，避免无限循环
• 网络请求缺少超时设置，可能导致长时间挂起

代码健壮性

• jq 命令应添加错误检查，确保 JSON 解析成功
• 建议添加 MINIMAX_API_BASE 环境变量的有效性验证

文档完善

• 可以添加常见错误码的处理说明
• 建议提供估算生成时间的指导，帮助用户设置合理预期

示例改进

# 建议添加的安全检查
[ -n "$MINIMAX_API_KEY" ] || { echo "MINIMAX_API_KEY not set"; exit 1; }
[ -n "$MINIMAX_API_BASE" ] || { echo "MINIMAX_API_BASE not set"; exit 1; }

# 轮询添加最大次数限制
MAX_POLLS=120  # 10分钟超时
POLL_COUNT=0
while [ $POLL_COUNT -lt $MAX_POLLS ]; do
    # ... 现有轮询逻辑 ...
    POLL_COUNT=$((POLL_COUNT + 1))
done

整体而言，这是一个设计良好的功能扩展，文档详细且考虑了用户体验。主要建议是增强错误处理的健壮性。

---

_{Powered by Claude (openrouter) | PR Review Agent | 💬 AI 审查意见；未自动审批}

[oas-ai-reviewer]

✅ 飞书审批通过，审批单: 61CA2A6C-026C-4433-95BA-A62A5F19971C

[oas-ai-reviewer]

✅ 飞书审批通过，审批单: 61CA2A6C-026C-4433-95BA-A62A5F19971C

[oas-ai-reviewer]

✅ 飞书审批通过，审批单: 61CA2A6C-026C-4433-95BA-A62A5F19971C

[oas-ai-reviewer]

✅ 飞书审批通过，审批单: 61CA2A6C-026C-4433-95BA-A62A5F19971C

[oas-ai-reviewer]

✅ 飞书审批通过，审批单: 61CA2A6C-026C-4433-95BA-A62A5F19971C

[oas-ai-reviewer]

🤖 AI Code Review

Review decision: COMMENT

🔒 安全问题

API密钥暴露风险

• 脚本中使用 jq -n --arg 传递敏感参数，在某些系统中可能通过进程列表暴露API密钥和提示内容
• 建议将敏感数据写入临时文件再传递给jq，使用完毕后立即删除

外部URL安全性

• first_frame_image 支持公共URL，但缺少URL白名单或协议限制，可能被恶意利用进行SSRF攻击
• 建议添加URL验证逻辑，限制允许的协议（如仅https）

🐛 Bug 风险

错误处理不完整

• curl --fail-with-body 在某些HTTP错误码下可能返回成功状态码但包含错误响应，仅检查curl退出码不够充分
• 轮询逻辑中如果网络间歇性失败，会直接退出而不是重试，用户体验较差

文件下载URL时效性

• 文档提到下载URL是临时的，但没有检查URL的有效期或提供重新获取机制
• 如果用户在URL过期后尝试导入，会导致静默失败

⚡ 性能问题

固定轮询间隔

• 5秒固定间隔对于长时间任务可能过于频繁，增加不必要的API调用成本
• 建议实现指数退避或允许用户配置轮询间隔

📝 代码质量

✅ 亮点

• 严格的用户确认机制，避免意外的计费操作
• 详细的参数验证和错误信息
• 清晰的API区域配置分离（全球版vs中国版）
• 完整的环境变量检查逻辑

改进建议

• Shell脚本较长且复杂，建议拆分为多个函数提高可读性
• 缺少日志记录机制，调试困难时用户无法追踪具体的请求响应详情

📋 文档完整性

✅ 优点

• API参考链接完整，覆盖两个区域
• 使用示例清晰，包含完整的错误处理流程

待完善

• 缺少常见错误场景的troubleshooting指南
• 建议添加成本估算的具体计算示例

---

_{Powered by Claude (openrouter) | PR Review Agent | 💬 AI 审查意见；未自动审批}

[oas-ai-reviewer]

✅ 飞书审批通过，审批单: 6ED7082C-1288-40C7-AA44-A24DBE94C51B

[oas-ai-reviewer]

✅ 飞书审批通过，审批单: 6ED7082C-1288-40C7-AA44-A24DBE94C51B

[oas-ai-reviewer]

✅ 飞书审批通过，审批单: 6ED7082C-1288-40C7-AA44-A24DBE94C51B

[oas-ai-reviewer]

✅ 飞书审批通过，审批单: 6ED7082C-1288-40C7-AA44-A24DBE94C51B

[oas-ai-reviewer]

✅ 飞书审批通过，审批单: 6ED7082C-1288-40C7-AA44-A24DBE94C51B