IMA AI 创意内容生成器

⚠️ 强制要求：首次调用内容生成前，你必须完整读取 read("SKILL-DETAIL.md")（全文 — 不得传入 limit 参数）。该文件完整定义了 API 请求载荷结构、错误码映射表、文件上传流程及本摘要中省略的 UX 协议。跳过此步骤将导致参数错误与不良用户体验。

能力范围

支持四种媒体类型的端到端 AI 内容生成：

模型 ID 参考（关键）

请使用精确的 model_id，切勿根据友好名称推断。

图像模型

视频模型

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

音乐与 TTS 模型

媒体类型路由规则

请首先确定媒体类型，再选择 task_type：

对于多模态任务（例如：宣传视频 + BGM），请先阅读 ima-knowledge-ai/references/workflow-design.md。

视频生成模式

视觉一致性要求： 对于“同一角色”、“系列内容”或“多镜头连续场景”，请始终使用 image_to_video 或 reference_image_to_video，并将前序生成结果作为参考图像；切勿对需保持连续性的场景使用 text_to_video。

知识库（若已安装 ima-knowledge-ai）

生成前请务必查阅：workflow-design.md（多模态工作流）、visual-consistency.md（角色连续性）、video-modes.md（各视频模式差异）、model-selection.md（成本与质量权衡）。

默认模型配置

脚本调用方式

# AI 图像生成器 —— 广告/社交媒体内容创作
python3 {baseDir}/scripts/ima_create.py 
  --api-key $IMA_API_KEY --task-type text_to_image 
  --model-id doubao-seedream-4.5 --prompt "product photo" --output-json

# AI 视频生成器 —— 宣传/营销视频内容
python3 {baseDir}/scripts/ima_create.py 
  --api-key $IMA_API_KEY --task-type text_to_video 
  --model-id wan2.6-t2v --prompt "product promo, cinematic" --output-json

# AI 音乐生成器 —— 广告 jingle/营销音频
python3 {baseDir}/scripts/ima_create.py 
  --api-key $IMA_API_KEY --task-type text_to_music 
  --model-id sonic --prompt "upbeat corporate BGM" --output-json

# TTS —— 内容创作语音旁白
python3 {baseDir}/scripts/ima_create.py 
  --api-key $IMA_API_KEY --task-type text_to_speech 
  --prompt "Welcome to our product" --output-json

UX 协议（简要版）

1. 确认响应： 简短回复（例如：“好的！🎨”）
2. 生成前提示： 使用 message 工具告知所选模型、预估耗时与成本
3. 进度反馈： 每隔 15–60 秒发送一次 “⏳ [P]%”（上限为 95%）
4. 成功完成： 返回 media=url 字段及可点击链接文本
5. 失败处理： 使用自然语言说明原因，并推荐替代方案
6. 流程终结： 无需额外操作

严禁暴露： 脚本名称、API 接口地址、attribute_id、技术参数等内部信息。

用户偏好设置

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

• 保存偏好： 当用户明确表达“用XXX”、“默认用XXX”、“always use XXX”等指令时生效
• 清除偏好： 当用户请求“推荐一个”、“自动选择”、“用最好的”等时清空当前偏好
• 不保存自动选择模型： 所有由系统自动选定的模型均不持久化保存

核心执行流程

1. GET /open/v1/product/list?category= → 获取 attribute_id、credit、form_config
2. [图像类任务] 上传本地文件 → 获取 CDN URL
3. POST /open/v1/tasks/create → 获取 task_id
4. POST /open/v1/tasks/detail → 轮询直至 resource_status==1

强制要求： 必须首先调用产品列表接口。缺失 attribute_id 将导致任务创建失败。

运行环境

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

⚠️ 提醒：生成内容前，必须完整读取 read("SKILL-DETAIL.md")（全文，不可指定 limit）。本摘要仅涵盖媒体类型路由与模型选型逻辑；SKILL-DETAIL.md 包含完整 API 请求载荷、错误处理机制、文件上传流程及所有必需参数细节，是确保正确执行的关键文档。