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

# 视频模型路线

> 视频模型公开开放前需要确认的信息

本页用于说明视频模型开放时的维护口径。视频模型成本高、耗时长、参数差异大，因此每个模型正式公开前都必须补齐模型名、价格、参数和失败计费边界。

## 开放清单

| 信息    | 必须说明什么                                          |
| ----- | ----------------------------------------------- |
| 模型名   | 用户实际传入 `model` 的值                               |
| 开放状态  | 内测、灰度、受控开放、正式可用                                 |
| 输入类型  | 文生视频、图生视频、首尾帧、多参考图、remix                        |
| 输出类型  | 视频流、临时 URL、代理内容路径、封面图                           |
| 时长    | 支持的秒数范围和默认值                                     |
| 画幅    | 支持的比例、分辨率或尺寸字段                                  |
| 价格    | 按任务、按秒、按结果、按倍率或其他方式                             |
| 失败计费  | 失败、超时、取消、审核拒绝是否返还                               |
| 输出有效期 | 结果 URL 是否会过期，是否必须转存                             |
| 推荐场景  | 电商、广告、社媒、素材扩展、人物口播等                             |
| 排障字段  | 是否要求保存 `task_id`、状态、错误对象和 `X-Oneapi-Request-Id` |

## 模型状态口径

| 状态   | 文档怎么写                             |
| ---- | --------------------------------- |
| 内测   | 不写公开调用示例，只写能力方向                   |
| 灰度可用 | 写清仅指定账号或指定模型可见                    |
| 受控开放 | 可以写 endpoint 和字段，但必须加控制台可见/价格确认边界 |
| 正式可用 | 可以进入模型清单和生产推荐                     |
| 维护中  | 标注不建议新任务使用                        |

## 默认模型和兜底模型

视频模型正式开放后，文档里应区分：

| 类型    | 用途            |
| ----- | ------------- |
| 默认模型  | 新用户最容易成功的主推模型 |
| 质量模型  | 画质更好但更慢或更贵    |
| 速度模型  | 出片更快，适合批量草稿   |
| 低成本模型 | 成本可控，适合大规模测试  |
| 兜底模型  | 主模型异常时临时切换    |

不要只列模型名。视频模型更依赖时长、比例、输入图要求和输出有效期，缺少这些信息就不适合进入生产默认配置。

## 发布前检查

每个视频模型公开前至少完成：

* 控制台可见模型名
* 价格页可见计费口径
* 文生或图生请求示例
* 任务查询示例
* 输出获取和转存建议
* 失败、超时、取消的计费说明
* 至少一组小流量验证结果
* 状态页能力不异常
* 提交、查询、内容下载三段的日志字段说明

如果某个模型只是供应商兼容入口可用，但还没有统一价格和任务文档，应保持“灰度可用”或“受控开放”，不要写成正式可用。