> ## 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.

# 视频模型

> 视频模型的受控开放状态、选型字段和上线前检查

视频模型当前按受控开放维护：平台已具备视频任务、轮询和输出获取能力，但公开视频模型清单、价格和参数仍需逐个模型确认。

<Warning>不要只因为状态页显示视频能力正常，就把视频模型写入生产默认链路。生产调用必须以控制台可见模型、账号权限、价格页和具体模型文档为准。</Warning>

<Note>这不是说 Tapapi 没有视频相关模型。线上 pricing 已出现 Sora、Veo、Wan 等视频相关模型名；只是视频成本高、任务链路长，公开视频教程和默认生产入口仍按受控开放处理。</Note>

## 当前口径

| 项      | 状态                                  |
| ------ | ----------------------------------- |
| 视频能力   | 已有受控接入能力                            |
| 公开模型清单 | pricing 中已有视频相关模型；文档模型页待按生产口径逐步补齐   |
| 公开接口文档 | 正文已说明，API Reference 暂不开放 playground |
| 价格     | 以控制台和价格页为准                          |
| 任务轮询   | 按异步任务处理                             |
| 输出     | 完成后获取视频内容，业务侧自行转存                   |

## 模型页必须包含

| 字段      | 说明                   |
| ------- | -------------------- |
| 模型名     | 用户实际传入的 `model`      |
| 输入类型    | 文生、图生、首尾帧、多参考图、remix |
| 输出方式    | 视频流、URL、代理内容路径、封面图   |
| 时长      | 支持秒数和默认值             |
| 比例 / 尺寸 | 支持画幅、分辨率和字段名         |
| 价格      | 按任务、按秒、按结果或按倍率       |
| 失败计费    | 失败、超时、取消、审核拒绝是否返还    |
| 推荐场景    | 电商、广告、社媒、素材生成等       |
| 生产建议    | 是否适合默认模型，是否需要兜底模型    |

## 选型建议

| 场景      | 优先看               |
| ------- | ----------------- |
| 电商商品短视频 | 图生视频、主体稳定性、背景干净程度 |
| 广告素材    | 文生视频、镜头控制、画面一致性   |
| 社媒内容    | 速度、成本、默认比例        |
| 人物或角色   | 参考图一致性、审核规则、失败率   |
| 批量生产    | 成本、并发、任务耗时和失败返还   |

## 现在可以先做什么

* 业务表预留：`task_id`、`model`、`status`、`input_type`、`output_url`、`saved_url`
* 接入队列预留：提交任务、轮询任务、下载内容、转存文件
* 日志预留：提交请求 ID、查询请求 ID、错误对象、最终 `quota`
* 参考 [任务查询与轮询](/production/task-polling) 设计业务侧状态
* 参考 [任务与输出](/video-generation/tasks-and-output) 处理视频生成结果
* 等具体模型开放后，再把模型名、价格和参数写入生产配置

## 不建议现在做

* 把视频模型设为默认生产能力
* 在没有价格的情况下开放用户批量生成
* 只保存输出 URL，不转存到自己的存储
* 忽略任务失败和轮询超时
* 把某个模型的私有字段套用到所有视频模型

模型正式开放前，需要同步更新 [视频模型路线](/video-generation/model-roadmap) 和对应接入页面。