用途 该技能用于验证当前最小可用的 Ideogram 集成：一次服务端 multipart 请求、一次受检的响应，以及立即持久化返回的图像。属于冒烟测试，需保持有界，因为调用会消耗预付额度，且响应 URL 会过期。
前提条件 需要已获批的 IDEOGRAM_API_KEY、正数的 API 额度，以及非敏感的提示词。需要服务端网络访问和仓库之外的持久存储。还需要请求截止时间、最大输出数量，以及指定的费用责任人。
当前接口契约 同步 V4 路由为 POST /v1/ideogram-v4/generate，使用 multipart/form-data。text_prompt 与 json_prompt 只能提供一个，不可同时提供。结构化 JSON 提示词会禁用 magic prompt。结果可能存在但不安全，表现为 is_image_safe=false 且 URL 为空。
认证 仅以 Api-Key 请求头发送 IDEOGRAM_API_KEY 到 https://api.ideogram.ai。请求必须保持在可信服务端，切勿将密钥、提示词、响应 URL 或图像字节回显到日志或回执中。
操作步骤 确认提示词分类、目标位置、输出数量、截止时间和付费实时请求的批准；构建恰好包含一个提示词表单、受支持宽高比和显式审查过的渲染选项的 multipart 请求体；带服务端 API 密钥和有界超时发送到 V4 同步路由；在读取图像字段前拒绝非成功状态码并校验响应模式；检查 is_image_safe，将不安全项或空 URL 视为策略结果而非可下载成功；立即下载已批准的图像，验证内容类型和字节限制，并以应用自有的不透明标识符存储；返回无内容的请求、存储、计时、安全和清理证据。
工具纪律 使用 Read、Glob 和 Grep 检查现有适配器、存储边界和夹具。仅对已批准的代码、夹具或文档变更使用 Write 和 Edit。不得仅因此技能被选中就执行付费请求。
审批边界 实时花费、敏感提示词、客户图像、外部发布或持久保留均需批准。冒烟测试不得覆盖现有资产；回滚只删除新建的不透明对象及相关测试元数据。
错误处理 400 表示无效组合或端点特定选项；当前不接受 V4 FLASH。401、422 和 429 需要按认证、校验和容量分别处理。HTTP 成功但 is_image_safe=false 时，不得通过自动修改提示词重试。
输出 返回端点、环境、提示词类别、HTTP 状态、输出与安全项数量、不透明的生成或请求标识符、持久存储键、延迟、费用负责人和回滚状态。排除原始提示词、凭据、图像 URL 和图像字节。
示例 生成合成方形标签设计，持久化到测试桶，断言后删除。报告示例：endpoint=v4-sync; outputs=1; safe=1; persisted=yes; url_retained=no; cleanup=complete。
验证 重新运行适配器的确定性夹具测试，确认仅发送了一个提示词表单，确认未保留 URL，并检查存储和删除回执。仅凭实时输出质量不能证明模式、安全或保留正确性。
资源 当前第一方证据映射——使用带日期的端点、webhook、计费、团队和训练链接作为工作流契约索引。在依赖枚举、限制、测试版功能或生命周期声明前，重新检查端点特定页面和当前 OpenAPI 描述。将实时观察记录为环境特定证据，而非通用供应商保证。