版本管理
Direct API 第 1 版内可能发生哪些变化、你的客户端必须能够容忍什么,以及模型如何新增和退役。
版本号位于路径中:/v1。在 v1 内,变更都是增量式的:新工具、新的可选输入字段、新的响应字段、新状态、新事件类型和新错误代码。
你的客户端必须处理的情况
- 忽略你不认识的响应字段。
- 将你不认识的生成任务状态视为非最终状态,并继续跟踪。
- 输入 schema 会保持严格:未知的输入字段会被拒绝,因此拼写错误绝不会悄无声息地什么都不做。
破坏性变更
破坏性变更会以 /v2 的形式发布,至少提供 6 个月的并行期,并通知每个拥有有效密钥的组织。
模型
- 模型会随时间新增和退役;模型 页面始终显示当前的模型集合。
- 模型 ID 永远不会被重复使用,也永远不会停止被接受。已退役的 ID 会运行其替代模型,响应中会注明实际运行的模型。
- Morphic 只有在以相同或更低的价格改进某个模型时,才可能更换该模型 ID 背后的引擎,并会在模型目录中公告。
如果您遇到任何问题或有任何疑问,欢迎随时联系我们。我们很乐意提供帮助。请发送邮件至 support@morphic.com.