IMA 图像 AI

何时使用

当用户需要生成图像时使用此仓库：

• 文本转图像
• 图像转图像
• 风格迁移
• 通过参考图像保持视觉连贯性

本仓库仅支持图像生成。请勿将视频生成、音频生成或非图像类任务路由至此。

网关合约

• 新机器初始化入口：python3 scripts/ima_runtime_setup.py
• 环境自检入口：python3 scripts/ima_runtime_doctor.py
• 官方 CLI 入口为：python3 scripts/ima_runtime_cli.py ...
• 在创建任务前，始终查询实时产品列表，以确保 attribute_id、credit、model_version 及默认值来自当前目录。
• 返回远程 HTTPS 图像链接；不要将结果下载为本地附件提供给用户。
• 所有请求必须通过图像能力路由，text_to_image 和 image_to_image 任务需在执行前进行分类。
• 若未指定 --model-id，运行时将使用该任务类型的推荐默认模型。
• 自动选择的默认值仅为操作备用方案，不会持久化为用户偏好。

快速开始

• 最小路径：

1. python3 scripts/ima_runtime_setup.py --install

2. export IMA_API_KEY="ima_your_key_here"

3. python3 scripts/ima_runtime_cli.py --task-type text_to_image --prompt "a cinematic mountain sunset" --output-json

• 当安装通过但运行时或目录访问仍失败时，使用 python3 scripts/ima_runtime_doctor.py --output-json 进行诊断。

操作员参考

• README.md 包含首次使用路径和标准入口命令。
• references/shared/catalog-aware-selection.md 定义了基于实时目录的模型选择正式协议。
• references/operations/troubleshooting.md 覆盖常见故障恢复方法。
• capabilities/image/references/parameter-tuning.md 说明 size、aspect_ratio 和 n 的使用方式。
• capabilities/image/references/scenarios.md 提供仅提示词和参考图像的使用示例。

阅读顺序

1. references/README.md
2. references/gateway/entry-and-routing.md
3. references/gateway/workflow-confirmation.md
4. references/shared/model-selection-policy.md
5. references/shared/catalog-aware-selection.md
6. references/shared/error-policy.md
7. references/shared/security-and-network.md
8. references/operations/troubleshooting.md
9. capabilities/image/CAPABILITY.md
10. capabilities/image/references/parameter-tuning.md
11. capabilities/image/references/scenarios.md

边界划分

• references/gateway/* 覆盖入口、路由与澄清接口。
• references/shared/* 覆盖跨运行时复用的规则。
• capabilities/image/* 负责图像相关行为。
• _meta.json 和 clawhub.json 为元数据输入，非主要文档内容。