概述
该技能是一个 Ideogram 图像变换路由工作流，用于把用户请求的图像修改映射到最贴切的当前 Ideogram 操作上。它在编辑、重混、结构化描述、提示词辅助和以结果为导向的各类工具之间保持清晰区分，从而使权限、上传字节、模型控制与输出审查始终可见。
前置条件
- 对输入进行处理所需的已证明权限，以及经批准的目的、去向和留存期限。
- 对支持的图像类型、大小、尺寸以及任何必需掩码进行输入校验。
- 服务端密钥、正数积分、内容策略以及持久化资产存储。
当前契约
当前可用的操作面包括：带提示词的 V4 编辑、V4 重混、V4 描述（输出结构化 JSON 提示词）、V4 magic prompt、V3 编辑/重混，以及背景移除或替换、对象或 logo 移除、重新构图、广告尺寸调整、配色方案、材质替换、放大和文本分层等工具。以结果为导向的工具可能会自行选择模型；当需要直接控制模型时，请使用模型端点。
认证
仅从受信任的服务器将 IDEOGRAM_API_KEY 作为 Api-Key 发送到 https://api.ideogram.ai。不要记录密钥、源图像、掩码、提示词、结构化描述、输出 URL 或生成的字节。
使用方式
- 核实输入所有权、同意、数据类别、允许的变换、去向和删除期限。
- 选择操作：需要可复用的 V4 结构化提示词时选 describe；需要局部提示词引导的修改时选 edit；需要变体时选 remix；或者选择具有特定结果的具名工具。
- 在 API 边界之前校验上传类型和字节上限；V4 describe 接受 JPEG、PNG 或 WebP，最大 25 MB。
- 只构建所选端点的 multipart 字段，并设置有界的截止时间、输出和并发。
- 在发布或串联工作之前，校验传输、schema、is_image_safe 以及预期的工具结果。
- 立即下载经批准的输出，以不透明键存储，并删除临时输入和 URL 元数据。
- 记录权限、路由、安全、存储和清理凭据，但不要复制内容。
工具纪律
使用 Read、Glob 和 Grep 检查上传校验、路由选择、存储和测试夹具。仅对已批准的代码或文档使用 Write 和 Edit。不要仅因该技能被调用就上传、变换、发布或留存图像。
审批边界
对生物特征、机密、授权、客户或受监管图像、logo 移除、外部发布、版权检测策略变更、模型变更或持久留存，需获得可问责的批准。权限不明确时应拒绝，而不是尝试变换。
错误处理
在花费积分之前，拒绝不支持的媒体、超大上传、缺失掩码和不兼容字段。
结构化 describe 结果使用归一化的 [0,1000] 边界框，顺序为 [y_min,x_min,y_max,x_max]；请保留该坐标约定。
不要通过自动弱化或改写政策敏感的请求来重试不安全结果。
输出
返回所选操作、权限决定、输入校验摘要、状态、安全输出数量、不透明标识符、存储与留存状态、审查决定和回滚凭据。排除源或输出内容、提示词、凭据和 URL。
示例
- 描述一张经批准的产品照片，审查结构化提示词，然后生成受控的营销活动变体。
- 为孤立目录主体选择背景移除；当请求的修改依赖提示词和掩码时，选择 V4 编辑。
校验
测试路由选择和每一个被拒绝的输入类别，将字段与端点文档比较，验证安全和坐标处理，并确认临时媒体删除。视觉上看似合理的输出并不能证明权限、留存或路由正确性。
资源
- 当前第一方证据图——使用带日期的端点、webhook、计费、团队和训练链接作为此工作流的契约索引。
- 在依赖某个枚举、限制、测试功能或生命周期声明之前，重新检查端点专属页面和当前 OpenAPI 描述。
- 将实际观察记录为特定环境的证据，而非通用供应商保证。