用途：在 Ideogram 请求失败或返回空结果时，先对故障分类，再决定是否修改代码或重试付费调用。分类覆盖认证、计费就绪、请求校验、限流、服务容量、安全策略、异步生命周期、下载过期和应用存储失败。
主要能力：依据端点、方法、环境、时间戳、脱敏状态码和不透明请求/生成标识进行诊断；区分 401（密钥存在性、请求头名称、环境、吊销）、400/422（端点字段与媒体校验）、429（本地并发、队列截止、服务端重试指引）、503 或传输失败（有界瞬时处理）；单独检查 is_image_safe、URL 是否存在、异步终态、下载时机与持久化存储结果。
使用方式：先采集端点、状态、延迟、尝试次数、内容类型、脱敏错误码与不透明标识；在 fixture 上复现后再考虑付费实调；应用一处最小修正并重跑确定性测试，必要时仅做一次经批准的合成实调；记录原因、证据、花费、影响范围、修正与回滚。工具上使用 Read、Glob、Grep 查看适配器、schema、日志与 fixture，Write、Edit 仅用于经批准的最小修复或测试。
限制：不得自动轮换密钥、充值、重放生产请求、修改提示词或放宽安全策略；付费复现、凭证轮换、余额变更、并发提升、策略变更、访问客户内容或生产部署均需先获得授权。400、401、422 在未验证修正前不得重试；瞬时容量失败仅在尝试次数、抖动与总截止时间内重试；URL 过期属于持久化失败，重新生成是新的付费且受策略约束的操作。输出需排除凭证、提示词、图像、原始厂商响应体与 URL。
资料未提供具体端点文档、计费价格、平台支持范围与版本细节。