用途:为 Ideogram 集成生成“失败即拒绝”的发布决策。视觉上成功的测试只是信号之一,生产就绪还需具备归属明确的计费、安全凭据、受限容量、内容审核、持久资产、异步对账、遥测和经过演练的回滚。
前提:不可变发布 SHA、目标环境、变更负责人、审批人和部署窗口;当前架构、端点清单、测试、SLO、预算、保留策略和事故手册;与生产对齐的预发环境,以及不含客户内容的合成金丝雀。
当前契约:实时 API 调用需接受条款、绑定支付方式、有正数预付额度并持有有效 Api-Key。生成路由因端点而异,分同步或异步生命周期。安全审核按条目进行,图片 URL 会过期,默认容量记录为 10 个在途请求。
鉴权:确认目标环境密钥引用、仅服务端注入、正确的 Api-Key 请求头、限定范围的应用授权,并演练过吊销。真实密钥不得出现在发布产物或检查证据中。
步骤:冻结 SHA 并对照第一方文档核对端点、multipart 字段与 schema;验证条款、正数额度、计费负责人、告警阈值及余额耗尽响应;证明密钥处理、租户授权、媒体校验、安全与版权策略及保留控制;测试同步与异步成功、不安全输出、各类已处理错误、webhook 验证、轮询兜底、重复项与终态关闭;确认账户级并发、队列上限、截止时间、存储下载、过期 URL 移除与对象删除;审查仪表盘、告警、值班归属、支持升级与无内容证据;运行预发金丝雀、执行回滚演练、取得明确批准后部署受限的生产金丝雀;对账最终状态,任一门槛失败即停止或回滚。
工具纪律:用 Read、Glob、Grep 检查发布证据;Write 与 Edit 仅用于已批准的修复或发布文档。不得仅凭调用就部署、充值、轮换密钥、更改策略或运行生产生成。
审批边界:指定审批人负责实际支出、生产流量、策略设置与回滚接受。证据缺失、资产保留未知、webhook 签名未验证或回滚未演练,均判为不通过。
错误处理:遇到 schema 漂移、密钥泄露、不安全发布路径、无界排队或无法持久化输出时停止。不得因金丝雀图片看起来正确而豁免失败门槛。若发布产生重复付费工作或丢失异步状态,先回滚流量再调试。
输出:返回 SHA、环境、逐门槛通过或失败、证据标识、金丝雀指标、已知风险、审批人、部署状态与回滚回执,排除密钥、提示词、图片和 URL。
示例:生成成功但应用只保留会过期的厂商 URL 时判为不通过;签名验证、轮询兜底、安全处理、存储删除与回滚全部通过后判为通过。
验证:针对冻结 SHA 重跑同一发布测试集,核对证据时间戳与负责人,比较已部署摘要与已批准摘要,确认上线后金丝雀终止与回滚仍可用。
资源:使用带日期的端点、webhook、计费、团队与训练链接作为本工作流的契约索引;依赖枚举、限制、测试功能或生命周期声明前,重新查看端点专属页面与当前 OpenAPI 描述;将实时观察记录为环境特定证据,而非通用厂商保证。