用途：在未消耗 Ideogram 额度前，针对自有的请求与响应契约开发 Ideogram 边界。把多部分字段、异步生命周期状态、不安全输出、瞬时错误和过期 URL 建模为夹具，使快速循环保持确定性与隐私安全。
前置条件：仓库的适配层接缝、测试运行器、夹具策略和数据分级；覆盖成功、不安全输出、校验失败、限流和终态失败的脱敏合成样例；默认关闭、在不可信分支上也关闭的显式实时冒烟开关。
当前契约：生成面包括 V4 同步与异步路由、透明变体、P-Image 和 V3 兼容路由。异步任务返回 generation_id；状态通过把返回值追加到 GET /v1/generations/ 或接收 webhook 来对账。返回的资源 URL 是临时的。
认证：夹具不得包含凭证。单独批准的实时通道运行时，在服务端注入 IDEOGRAM_API_KEY，且仅在 Api-Key 头中发送给配置的第一方主机。
使用方式：读取适配层并枚举请求字段、响应变体、错误类别和存储副作用；为同步成功、异步提交、进行中轮询、安全与不安全完成、400、401、422、429、503 创建脱敏夹具；按字段名和文件元数据测试多部分构造；验证幂等状态对账、重复 webhook 处理、有界轮询、URL 下载和持久对象存储；将付费实时冒烟置于显式环境标志、可信上下文、额度上限和合成提示词之后；对比实时响应形状与夹具，仅更新经审查的 schema 漂移并记录清理。
工具纪律与审批边界：使用 Read、Glob、Grep 定位适配层、夹具和测试命令，用 Write、Edit 修改获批的测试和适配层。不得推断出调用 Ideogram、上传图像、消耗额度或保留生成媒体的权限。离线夹具工作默认安全；任何实时请求、生产凭证、客户派生输入、共享桶写入、从真实响应刷新夹具或部署都需批准。
错误处理：拒绝含疑似密钥、原始客户提示词、图像字节或实时 URL 的夹具；通过注入时钟和抖动而非 sleep 保持重试测试确定性；把未识别响应字段视为显式漂移证据，不得静默丢弃安全或计费信号。
输出与验证：返回适配层路径、夹具清单、断言数、确定性命令及结果、实时通道状态、检测到的契约漂移、敏感数据扫描结果和清理状态，排除提示词、图像、凭证和过期 URL。运行最窄测试命令两次确认结果一致，扫描夹具中的密钥与 URL，确保分支上实时通道保持禁用，并验证测试后临时文件与对象已删除。当前第一方证据与端点页面需以资料中日期化链接为准，依赖枚举、限制、beta 功能或生命周期声明前应重新核对端点页面与 OpenAPI 描述；实时观察记录为环境特定证据，而非通用厂商保证。