Skip to main content

​
Canonical 模型端点

新集成应使用模型不带 provider 后缀的 canonical URL。省略 provider 时，Sunra 保持该模型现有的自动路由：
GPT Image 2、Midjourney 和 Kling 新增以下 canonical 模型： 例如：
模型名中的 preview 会继续保留；Preview 是模型版本标识，不是 provider。

​
Provider 路由

先查询当前 canonical 模型和 operation 可用的 Provider：
响应只公开 Provider ID 和显示名称。可用性会同时校验模型、operation、组织访问权限、已启用的 Provider 路由和 endpoint price。 需要固定一个 Provider 时，在同一个 canonical queue 请求中传入 provider.only：
显式指定的 Provider 不可用时会返回 4xx，绝不会静默切换。任务重试会保持同一 Provider，计费使用该 Provider 路由对应的 endpoint price。删除 provider 即恢复 Automatic 路由。 JavaScript：
Python：

​
Legacy Compatibility

旧 provider-specific 模型 URL 仍可供现有集成直接调用，但不再出现在公开模型目录中。旧 URL、输入 schema、响应、固定 Provider 映射、任务查询、pricing 和 prediction identity 均保持不变。Legacy URL 不能切换到其他 Provider。新集成请使用右侧 canonical 模型。 如果旧端点提供了 provider-specific 额外能力，可以继续使用该旧 URL。兼容调用不会被重定向到 canonical 模型。