目标
- 对外仍只保留一套路由:
/v1/videos - OpenAI 主文档只描述官方契约
- 经济型分组与官方渠道通过模型分组隔离
- “官方兼容承诺”只在官方分组 / 官方渠道下成立
推荐分组方案
standard:绑定经济型分组渠道pro/enterprise:绑定官方 OpenAI / Azure OpenAI 渠道- 官方 token:默认
pricing_group设为官方分组 - 经济型 token:默认
pricing_group设为standard - 所有相关 token:
upgrade_policy=none - 系统配置:
ModelRoutingStrictGroupEnabled=true
为什么要这样配
这样做的目的是在保持同一路由/v1/videos 的前提下,避免两类越界:
standard请求被自动升级到官方组,导致价格和能力边界漂移- 官方组请求在无可用渠道时 fallback 到经济型分组,破坏”官方兼容”承诺
兼容边界
当你对外宣传 OpenAI 官方兼容时,建议只在官方分组 / 官方渠道上生效。以下差异应留在平台说明页,而不是 OpenAI 主文档:| 维度 | 官方分组 / 官方渠道 | 经济型分组 |
|---|---|---|
| 公开路径 | /v1/videos | /v1/videos |
seconds | 跟随 OpenAI 官方文档 | 可能存在 10/15/25 等渠道槽位 |
size | 跟随 OpenAI 官方文档 | 可能接受 16x9、9x16 等兼容输入 |
input_reference | 按官方 multipart/file 或 JSON/object 语义 | 某些代理渠道可能存在更宽松输入,但不应写入公开标准 |
| 角色字段 | 不在公开官方契约承诺范围内 | 某些渠道支持 character_url、character_timestamps、private |
路由原则
- 不新增单独的扩展公开路由
- 继续统一使用
/v1/videos - 通过模型分组和 token 默认组完成渠道隔离
- 平台扩展能力单独放在平台说明页,不回写到 OpenAI 主文档
如果你的业务同时接入经济型分组和官方渠道,最稳妥的做法不是再开一套路由,而是把公开契约固定在官方文档,把渠道差异固定在分组配置。
