> ## Documentation Index
> Fetch the complete documentation index at: https://docs.hingnet.com.cn/llms.txt
> Use this file to discover all available pages before exploring further.

# Sora 视频路由与分组

> 在同一 /v1/videos 路由下隔离官方与经济型分组，并定义兼容边界

本文描述的是 HingNet AI 平台侧的路由与配置边界，不是 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 设置示例：

```json theme={null}
{
  "pricing_group": "pro",
  "upgrade_policy": "none"
}
```

## 兼容边界

当你对外宣传 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 主文档

<Callout type="tip">
  如果你的业务同时接入经济型分组和官方渠道，最稳妥的做法不是再开一套路由，而是把公开契约固定在官方文档，把渠道差异固定在分组配置。
</Callout>