IMA AI 图像与照片生成器

**⚠️ 必须操作：在首次调用图像生成前，您必须 read("SKILL-DETAIL.md")（完整文件 — 请勿使用 limit 参数）。** 该文件包含完整的 API 请求结构、错误翻译表、上传流程、用户体验协议以及本摘要省略的常见问题。跳过此步骤将导致参数错误和糟糕的用户体验。

模型 ID 参考（至关重要）

请使用 精确的 model_id。不要根据友好名称推断。

别名： 可梦/SeeDream → doubao-seedream-4.5 · MJ/Midjourney → midjourney · 香蕉/Banana → gemini-3.1-flash-image · 香蕉Pro → gemini-3-pro-image

任务类型

视觉一致性（重要）

若需在多张图像中保持“同一角色” / “系列作品” / “同一产品”的外观一致：

• 不要使用 text_to_image（每次生成结果可能不同）
• 应使用 image_to_image 并以前一次生成结果作为参考
• 若可用，请阅读 ima-knowledge-ai/references/visual-consistency.md

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

生成前请先阅读：visual-consistency.md（角色/产品连续性）、model-selection.md（成本与质量权衡）、workflow-design.md（多步骤项目设计）

参数支持

若用户要求自定义宽高比且使用 Midjourney → 建议改用 SeeDream 4.5 或 Nano Banana。目前无模型支持 8K（最高为 4K）。

默认模型

模型选择优先级

1. 用户偏好（如明确说明）→ 最高优先级
2. ima-knowledge-ai 推荐（如已安装）
3. 默认回退方案（见上表）

脚本使用示例

# AI 图像生成 — 文字转图像（海报、缩略图、社交媒体图形）
python3 {baseDir}/scripts/ima_image_create.py \
  --api-key $IMA_API_KEY --task-type text_to_image \
  --model-id doubao-seedream-4.5 --prompt "社交媒体用产品图" \
  --user-id {user_id} --output-json

# AI 照片生成 — 图像转图像（产品图编辑、标志优化）
python3 {baseDir}/scripts/ima_image_create.py \
  --api-key $IMA_API_KEY --task-type image_to_image \
  --model-id doubao-seedream-4.5 --prompt "增强并优化" \
  --input-images https://example.com/photo.jpg \
  --user-id {user_id} --output-json

# 查看可用图像模型列表
python3 {baseDir}/scripts/ima_image_create.py \
  --api-key $IMA_API_KEY --task-type text_to_image --list-models

向用户发送结果

# ✅ 正确做法：直接使用远程 URL 实现内联图片展示
message(action="send", media=image_url, caption="✅ 图片生成成功！\n• 模型：[Name]\n• 耗时：[X]秒\n• 积分：[N 分]\n🔗 原始链接：[url]")

# ❌ 错误做法：切勿下载至本地文件

用户体验协议（简要）

1. 确认响应：简短回复（“好的！来帮你画 🎨”）
2. 生成前预告知：通过 message 工具告知模型、预计耗时、消耗积分
3. 进度更新：每 15-30 秒一次：“⏳ [P]%”（最高显示 95%）
4. 成功反馈：发送 media=url，并在 caption 中附带原始链接
5. 失败处理：使用自然语言说明，并建议替代方案
6. 结束动作：无需进一步操作

严禁暴露：脚本名称、API 端点、attribute_id、技术参数等内部信息。

用户偏好设置

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

• 保存：当用户明确表达“用XXX” / “默认用XXX” / “始终使用XXX”
• 清除：当用户说“推荐一个” / “自动选择” / “用最好的”
• 不保存：自动选择的模型

核心工作流

1. GET /open/v1/product/list?category=<task_type> → 获取 attribute_id、credit、form_config
2. [仅 image_to_image] 上传本地文件 → 获取 CDN 地址
3. POST /open/v1/tasks/create → 获取 task_id
4. POST /open/v1/tasks/detail → 轮询直至 resource_status==1

必须操作：始终先查询产品列表。缺少 attribute_id 将导致任务失败。

运行环境

基础地址：https://api.imastudio.com

请求头：Authorization: Bearer $IMA_API_KEY · x-app-source: ima_skills · x_app_language: en

**⚠️ 提醒：在生成图像前，必须完整读取 read("SKILL-DETAIL.md")（不加 limit 参数）。** 本摘要仅涵盖模型选择与路由逻辑——完整 API 请求体、错误处理、上传流程、参数细节、宽高比常见问题及用户体验协议均在 SKILL-DETAIL.md 中，正确执行不可或缺。