当前可用性 - Tapapi 文档

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

可用性判断

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

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

状态定义

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

接入前必须确认

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

状态页怎么用

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

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

生产建议

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

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