IMA Video AI — 视频生成器

完整 API 文档、安全说明、全部参数及 Python 示例，请查阅 SKILL-DETAIL.md。
⚠️ 强制要求：首次调用视频生成前，你必须执行 read("SKILL-DETAIL.md")（读取完整文件 — 不得传入 limit 参数）。 该文件包含完整的 API 请求体结构、错误处理对照表以及本摘要中省略的 UX 协议。跳过该文件或仅阅读部分内容将导致参数错误与不良用户体验。

模型 ID 参考（关键）

请严格使用下表中的 精确 model_id。切勿根据友好名称自行推断。

用户输入别名： 万 / Wan → wan2.6-* · 可灵 / Kling → kling-video-o1 · 海螺 / Hailuo → MiniMax-Hailuo-2.3 · Veo / Google Veo → veo-3.1-generate-preview

视频生成模式

视觉一致性（重要）

若用户提及“同一角色”、“系列”、“多镜头”或延续此前生成结果：

• 禁止使用 text_to_video（否则将产生外观不一致的结果）
• 应使用 image_to_video 或 reference_image_to_video，并将此前生成结果作为参考图像
• 如有可用文档，请阅读 ima-knowledge-ai/references/visual-consistency.md

预检：知识库

若已安装 ima-knowledge-ai，请在生成前完成以下阅读：

1. ima-knowledge-ai/references/video-modes.md — 理解各生成模式差异
2. ima-knowledge-ai/references/visual-consistency.md — 若需多镜头或角色连续性支持

若未安装：请直接使用本 SKILL 提供的模型对照表及默认配置。

模型选择优先级

1. 用户偏好（若明确声明）→ 最高优先级
2. ima-knowledge-ai 推荐（若已安装）
3. 兜底默认值：

用户输入解析

时长： “5秒”→5 · “10秒”→10 · “15秒”→15 · “1分钟”→使用最大值（提示用户：“当前最长15秒”）
画面比例： 横屏 / 16:9 → 16:9 · 竖屏 / 9:16 → 9:16 · 方形 / 1:1 → 1:1
分辨率： 720P / 1080P / 4K（需模型支持）
预算倾向： “最便宜”→Vidu Q2（5 pts）· “最好”→Kling O1 或 Veo 3.1

脚本调用示例

# 文本生成视频
python3 {baseDir}/scripts/ima_video_create.py 
  --api-key $IMA_API_KEY 
  --task-type text_to_video 
  --model-id wan2.6-t2v 
  --prompt "a puppy runs across a sunny meadow" 
  --user-id {user_id} 
  --output-json

# 图像生成视频（支持 URL 和本地文件路径）
python3 {baseDir}/scripts/ima_video_create.py 
  --api-key $IMA_API_KEY 
  --task-type image_to_video 
  --model-id wan2.6-i2v 
  --prompt "camera slowly zooms in" 
  --input-images https://example.com/photo.jpg 
  --user-id {user_id} 
  --output-json

# 首尾帧生成视频（必须且仅能提供 2 张图像）
python3 {baseDir}/scripts/ima_video_create.py 
  --api-key $IMA_API_KEY 
  --task-type first_last_frame_to_video 
  --model-id kling-video-o1 
  --prompt "smooth transition" 
  --input-images first.jpg last.jpg 
  --user-id {user_id} 
  --output-json

向用户发送结果

# ✅ 正确：直接使用远程 URL 实现内联视频播放
message(action="send", media=video_url, caption="✅ 视频生成成功！\n• 模型：[Name]\n• 耗时：[X]s\n• 积分：[N pts]")

# 随后单独发送链接供复制
message(action="send", message=f"🔗 视频链接：\n{video_url}")

# ❌ 错误：切勿下载至本地文件（会导致附件形式展示，无法直接播放）

UX 协议（简要）

1. 生成前： “🎬 开始生成视频… 模型：[Name]，预计[X~Y]秒，消耗[N]积分”
2. 生成中： 每隔 30–60 秒更新一次：“⏳ 视频生成中… [P]%”（API 返回成功前上限为 95%）
3. 成功： 通过 media=video_url 发送视频，并额外发送纯文本链接便于分享
4. 失败： 使用自然语言描述错误，并推荐替代模型。严禁向用户暴露技术类错误信息。 完整错误映射表见 SKILL-DETAIL.md。

严禁向用户提及： 脚本名称、API 端点、attribute_id、技术参数名等。仅可使用：模型名称 · 耗时 · 积分 · 结果 · 状态。

Sora 2 Pro 内容策略

Sora 采用严格的 OpenAI 内容安全策略：❌ 禁止生成人物、名人、IP 资产；✅ 允许生成风景、抽象图形、动物、自然场景。若请求被拒绝，请建议改用 Wan 2.6 或 Kling O1。

运行环境

基础 URL：https://api.imastudio.com
请求头：Authorization: Bearer $IMA_API_KEY · x-app-source: ima_skills · x_app_language: en

核心流程

1. GET /open/v1/product/list?app=ima&platform=web&category= → 获取 attribute_id、credit、model_version、form_config
2. [图像类任务专属] 上传图像或向脚本传入本地路径
3. POST /open/v1/tasks/create → 获取 task_id
4. POST /open/v1/tasks/detail → 每 8 秒轮询一次，直至 resource_status==1

强制要求： 必须首先查询产品列表。attribute_id 为必填项 — 若返回值为 0 或缺失，任务将失败。

用户偏好记忆

存储路径：~/.openclaw/memory/ima_prefs.json

• 保存条件： 用户明确表达“用XXX” / “默认用XXX” / “always use XXX” 时
• 清除条件： 用户表达“用最好的” / “推荐一个” / “自动选择” 时
• 禁止保存： 自动选中或兜底模型不得存为用户偏好

Pixverse 特殊情形（v1.0.7+）

Pixverse V5.5 / V5 / V4 的 form_config 中缺失 model 字段。脚本将根据 model_name 自动推断（例如：“Pixverse V5.5” → model: "v5.5"）。无需人工干预。

⚠️ 再次提醒：read("SKILL-DETAIL.md")（完整读取，不可加 limit）是视频生成前的强制前置步骤。 本文档仅为摘要 — SKILL-DETAIL.md 包含完整 API 参考、错误翻译对照表及正确执行所必需的 UX 协议。