IMA AI Image Generator & Photo Generator — Poster, Thumbnail, Logo, Art, Illustration, Product & Social Media Graphic Design

核心用法

IMA Image Generator 是面向 IMA Open API 的图像生成能力封装，主要提供三类核心功能：

1. 文生图 (text-to-image)：通过文本提示生成全新图像，支持自定义尺寸、宽高比、生成数量等参数
2. 图生图 (image-to-image)：以上传图片为基底进行变换、重绘或风格迁移
3. 参考图连续性 (reference continuity)：基于参考图保持风格或主体一致性生成系列图像

执行流程

• 调用 ima_runtime_setup.py 完成环境初始化与依赖安装
• 通过 ima_runtime_doctor.py 诊断环境与健康状态
• 主入口 ima_runtime_cli.py 接收任务类型与参数，自动查询实时产品目录获取当前可用的 attribute_id、credit 消耗及默认模型版本
• 返回远程 HTTPS 图片 URL，不保存本地附件

关键配置

• 必需环境变量：IMA_API_KEY（发送至 api.imastudio.com 及 imapi.liveme.com）
• 运行时依赖：Python 3、requests 库
• 持久化路径：用户偏好 ~/.openclaw/memory/ima_prefs.json，日志 ~/.openclaw/logs/ima_skills/

显著优点

• 实时目录感知：每次任务前查询 live catalog，确保使用当前最新模型版本与计费规则，避免模型下线或价格变动导致失败
• 智能默认策略：未指定 --model-id 时自动匹配任务类型推荐模型，降低用户决策成本
• 标准化网关：清晰的 entry-routing-confirmation 三阶段工作流，支持跨技能读取知识库（ima-knowledge-ai/references/*）增强提示质量
• 安全传输：API Key 仅用于 HTTPS 端点通信，图像结果以 URL 形式返回，避免本地存储带来的隐私泄露风险

潜在缺点与局限性

• 密钥依赖：完全依赖外部 IMA_API_KEY，密钥失效或额度耗尽即无法服务，无备用模型兜底
• 网络敏感：需稳定访问 imastudio.com 及 liveme.com，大陆地区可能存在连接波动
• 结果不可控：AI 生成图像存在随机性，同一提示多次输出可能差异显著，需反复迭代
• 功能边界严格：仅限图像任务，视频、音频生成需路由至其他技能
• 无本地缓存：所有结果仅存远程 URL，若服务商清理历史链接则无法追溯

适合人群

• 需要快速批量生成社交媒体配图、商品主图、海报、Logo 的电商运营与内容创作者
• 具备基础 API 调用能力的开发者，希望通过 CLI 工具自动化图像生产流程
• 已有明确视觉参考、需保持风格一致性的设计团队（利用 reference-image continuity）
• 能接受 AI 随机性并具备 prompt 调优耐心的用户

常规风险

• 版权与合规：生成图像的版权归属需遵循 IMA Studio 服务条款，商用前需确认授权范围
• 内容安全：文本提示需符合平台审核政策，涉敏内容可能导致账号封禁
• 密钥泄露：IMA_API_KEY 为敏感凭证，硬编码或日志泄露将导致额度盗刷
• 服务商依赖：单一供应商锁定，若 IMA Studio 服务调整或终止，迁移成本较高
• 成本不可控：按 credit 计费模式，复杂参数或批量任务可能产生意外高额费用

核心用法

IMA Image Generator 是一款专注于图像生成的 Agent Skill，通过调用 IMA Studio 官方 Open API 实现多种图像生成能力。用户可通过自然语言提示词（text-to-image）或参考图片（image-to-image）生成高质量图像，同时支持风格迁移和参考图连续性创作。该技能采用 Python 运行时环境，通过命令行接口 ima_runtime_cli.py 执行任务，并配备完整的 setup 和 doctor 脚本用于环境初始化与故障诊断。

使用前需配置 IMA_API_KEY 环境变量，技能会自动查询实时产品目录获取最新的模型版本、参数配置和计费信息。执行流程遵循"网关合约"模式：先通过 catalog-aware 运行时获取可用模型列表，再创建任务并轮询结果，最终返回 HTTPS 图像链接。支持自定义图像尺寸、宽高比和生成数量等参数，满足不同场景的输出需求。

显著优点

官方生态与稳定性：由 IMA Studio 直接开发和维护，API 端点、文档体系和更新节奏统一，避免第三方封装可能带来的兼容性问题。功能覆盖全面：单技能内集成文生图、图生图、风格迁移三大核心能力，无需切换多个工具。实时目录感知：自动同步官方最新模型和参数配置，用户无需手动跟踪版本更新。安全合规设计：API 密钥仅通过环境变量读取，网络请求全链路 HTTPS 加密，日志 7 天自动清理，符合 GDPR 数据最小化原则。

简洁依赖策略：仅依赖成熟稳定的 requests 库，无复杂依赖树，降低供应链攻击面。透明持久化：本地文件操作路径在 SKILL.md 中完整声明，首选项和日志均限定在用户目录下，权限边界清晰。

潜在缺点与局限性

网络依赖性强：所有图像生成任务必须调用云端 API 完成，离线环境无法使用，且受网络延迟和稳定性影响。成本敏感性：基于信用点（credit）的计费模式意味着高频或大批量生成会产生持续费用，需合理规划使用场景。功能边界明确：该技能仅处理图像生成，视频、音频等多媒体任务需路由至其他技能，增加了多模态工作流的复杂度。返回形式限制：默认返回远程 HTTPS URL 而非本地附件，下游处理若需本地文件需额外下载步骤。参数学习成本：虽然支持丰富的生成参数（尺寸、比例、数量等），但获得最佳效果需理解各参数对输出质量的影响。

适合的目标群体

内容创作者与营销人员：需要快速生成社交媒体配图、海报、缩略图、产品展示图等视觉素材，对产出效率要求高于极致精细控制。设计行业从业者：作为创意草稿生成工具，加速概念探索阶段，或用于风格参考和灵感激发。电商与品牌运营：批量生成商品场景图、模特换装、Banner 素材，降低传统拍摄和设计成本。开发者与自动化工作流构建者：需要集成图像生成能力至现有系统，通过 CLI 接口实现程序化调用。教育与培训场景：用于教学演示、课件素材制作，帮助学生理解 AI 图像生成原理与应用。

使用风险与注意事项

性能与可靠性风险：API 响应时间受任务队列长度和模型负载影响，高峰时段可能出现延迟；建议实现指数退避重试机制提升稳定性。凭证安全管理：IMA_API_KEY 是访问服务的唯一凭证，泄露将导致账户信用点被盗用。务必避免将其硬编码在脚本中或提交至版本控制，建议使用密钥管理服务或 CI/CD 环境变量注入。数据隐私考量：提示词、参考图像及生成记录会传输至 IMA Studio 云端，敏感内容需谨慎评估是否适合通过第三方服务处理。依赖维护：虽当前依赖简单，但需关注 requests 库的安全更新；setup 脚本中的 pip 安装操作需确保 Python 环境可信。计费监控：建议建立用量监控机制，避免意外高频调用导致费用超支。