用途：将 Ideogram 图像生成能力部署在应用自有的服务端边界之后，配合队列、安全策略、持久对象存储、可观测性、金丝雀发布与回滚，适用于上新运行时或变更流量路径的场景。
主要能力：调用 https://api.ideogram.ai，默认并发上限为 10 个在途请求；异步路由返回 generation_id，支持 webhook 交付并以轮询作为兜底；支持密钥按运行时引用注入、出口白名单、防止请求/响应体日志记录；支持合成金丝雀比对状态、延迟、存储、安全与成本信号，并逐步放量。
必要用法：认证仅使用 Api-Key 发送 IDEOGRAM_API_KEY，浏览器端只接收应用级授权，不接触厂商凭证或厂商直连 URL。同步仅在平台与请求时限可覆盖生成加下载时使用，否则持久化异步状态，并在确认持久完成前将经过校验的输出下载到应用存储，因为图像 URL 会过期。将账号级并发配置在验证容量之下，设置有界队列、重试时限与优雅排空；写入不透明租户范围对象前校验安全与媒体类型，丢弃临时 URL。输出需返回 release SHA、平台、拓扑、密钥引用、并发与时限设置、金丝雀指标、存储与安全结果、流量状态、成本与回滚凭证，且不含凭证与内容。
限制：调用本身不授权部署、密钥变更、购买额度、切换流量或破坏性清理；生产密钥访问、新出口、实际花费、策略变更、存储保留、流量切换与回滚均需显式批准。出现密钥泄露、429 上升、异步状态丢失、不安全发布路径或存储失败时应停止发布，不得在资产仅存在于将过期的厂商 URL 时宣告成功；回滚前需排空或取消本地队列作业，并以幂等方式对账已接受的厂商任务，保留上一可部署产物直至在途任务对账完成。