用途:在现代化 Ideogram 图像工作流时,先盘点 legacy 与 V3 行为,再按需求选择 V4、P-Image 或结果导向工具,完成分阶段迁移并保留在途状态与回滚能力。
主要能力:对每条源路由、字段、枚举、输出、错误、重试、安全、存储、消费方与在途状态做清单;按模型控制、透明度、编辑语义、结构化提示、专用结果、延迟与成本分类用例;为每个用例选定有文档的目标路由并记录非等价项;在应用边界构建自有翻译层,避免混合 schema 泄漏给消费方;用脱敏 fixture 对比后,将经批准的影子或双跑生成写入隔离存储且不重复发布。
用法:核验源/目标契约时使用 Read、Glob、Grep 查路由、消费方、schema、状态与证据;用 Write、Edit 编写经批准的迁移代码、测试与记录。保留服务端 Api-Key 边界与环境隔离,双跑 fixture 与凭证须排除密钥、提示、上传图、生成资产与临时 URL。涉及目标选择、模型或质量变更、双跑支出、客户衍生内容、安全差异、切换与销毁式退役,均需负责人批准。
适用场景:将 legacy 生成迁至 V4 multipart、同时用适配器保持消费方响应兼容;当无需直接模型控制时,把宽泛编辑流程替换为背景或 reframe 专用工具。
限制:不得按字符串相似度映射 legacy 枚举或渲染速度;遇到无法解释的安全、输出数量、纵横比、存储或质量差异应停止;回滚时先停止目标准入,对齐已接受目标工作后再恢复源流量。没有状态与资产对齐计划的迁移视为未就绪。当前资料未提供具体端点 URL、定价与完整 OpenAPI 细节。