Skip to main content
本文描述的是 kapon 平台侧的路由与配置边界,不是 OpenAI 官方协议说明。

目标

  • 对外仍只保留一套路由:/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 到经济型分组,破坏”官方兼容”承诺
一个保守的 token 设置示例:
{
  "pricing_group": "pro",
  "upgrade_policy": "none"
}

兼容边界

当你对外宣传 OpenAI 官方兼容时,建议只在官方分组 / 官方渠道上生效。以下差异应留在平台说明页,而不是 OpenAI 主文档:
维度官方分组 / 官方渠道经济型分组
公开路径/v1/videos/v1/videos
seconds跟随 OpenAI 官方文档可能存在 10/15/25 等渠道槽位
size跟随 OpenAI 官方文档可能接受 16x99x16 等兼容输入
input_reference按官方 multipart/file 或 JSON/object 语义某些代理渠道可能存在更宽松输入,但不应写入公开标准
角色字段不在公开官方契约承诺范围内某些渠道支持 character_urlcharacter_timestampsprivate

路由原则

  • 不新增单独的扩展公开路由
  • 继续统一使用 /v1/videos
  • 通过模型分组和 token 默认组完成渠道隔离
  • 平台扩展能力单独放在平台说明页,不回写到 OpenAI 主文档
如果你的业务同时接入经济型分组和官方渠道,最稳妥的做法不是再开一套路由,而是把公开契约固定在官方文档,把渠道差异固定在分组配置。