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

# 当前可用性

> 如何判断视频 API 是否适合接入生产

视频 API 当前按“受控开放”处理：代码层已有视频任务路由和状态查询能力，但公开生产使用取决于模型、价格、账号权限和文档是否同步到位。

## 可用性判断

| 层级              | 可以说明什么        | 不能说明什么            |
| --------------- | ------------- | ----------------- |
| 状态页 `video-gen` | 视频能力整体探测正常    | 不代表所有账号、所有模型都能调用  |
| 控制台模型可见         | 你的账号可看到某个视频模型 | 不代表参数、价格、稳定性已适合生产 |
| 价格页已发布          | 有基本计费口径       | 不代表失败、取消、超时都已写清楚  |
| 模型文档完整          | 可以小流量验证       | 仍需业务侧保存任务和对账数据    |

<Warning>如果控制台没有显示对应视频模型，或者价格和任务状态说明不完整，请不要把视频 API 写入生产默认链路。</Warning>

## 状态定义

| 状态   | 含义                          | 是否适合生产默认链路 |
| ---- | --------------------------- | :--------: |
| 预留   | 文档和技术入口已建立，不承诺可调用           |      否     |
| 内测   | 少量模型或渠道测试中，需要单独确认           |      否     |
| 灰度可用 | 指定账号或指定模型可见，可小流量验证          |      否     |
| 受控开放 | 模型、价格、参数和轮询规则已明确，但仍需按账号权限调用 |     视场景    |
| 正式可用 | 可见模型、价格、参数、失败计费和输出规则都已公开    |      是     |

## 接入前必须确认

| 问题 | 需要确认的内容                  |
| -- | ------------------------ |
| 模型 | 模型名是否在控制台可见，是否属于你账号分组    |
| 价格 | 按任务、按秒、按结果还是按 token/倍率结算 |
| 输入 | 支持纯文本、参考图、首尾帧还是多参考图      |
| 输出 | 返回临时 URL、代理内容路径还是直接文件流   |
| 轮询 | 状态枚举、轮询间隔、最长等待时间         |
| 失败 | 失败、超时、取消、审核拒绝是否返还预扣      |
| 保存 | 输出视频 URL 有效期和业务侧转存策略     |

## 状态页怎么用

[status.tapapi.ai](https://status.tapapi.ai) 只展示“视频生成 API”这一层能力状态，不公开具体模型、上游、渠道或内部路由。

| 现象                | 建议                   |
| ----------------- | -------------------- |
| 状态页 `ok`，单个视频任务失败 | 按单模型、参数、余额、任务超时排查    |
| 状态页 `warn`        | 暂停批量任务，降低轮询和重试频率     |
| 状态页 `err`         | 不要继续提交高成本视频任务，等待恢复   |
| 状态页正常但控制台无模型      | 说明你的账号当前还不能生产调用该视频模型 |

## 生产建议

* 先用测试账号或小流量验证，不要直接接入大批量队列
* 每个业务任务保存 `task_id`、模型名、状态、请求时间和最终 `quota`
* 设置最长等待时间，避免无限轮询
* 成功后立刻转存视频，不长期依赖临时输出
* 失败时先看最终任务状态和用量日志，再判断是否需要工单
* 保存每次提交和查询的 `X-Oneapi-Request-Id`

需要提交问题时，带上 `task_id`、模型名、提交时间、查询时间、控制台任务状态和用量截图。