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

# 模型状态

> 可用、受控开放、维护中和下线计划

模型状态用于告诉开发者：哪些能力现在可以调用，哪些模型适合放进生产默认配置，哪些需要等待维护或迁移通知。

## 状态定义

| 状态   | 含义                        |
| ---- | ------------------------- |
| 可用   | 当前可以在生产环境调用，且已在控制台或价格页展示  |
| 受控开放 | 平台已有能力，但模型、价格、权限或参数仍需逐个确认 |
| 即将上线 | 渠道接入或测试中，不建议写入生产默认配置      |
| 维护中  | 暂时不可用或质量不稳定               |
| 计划下线 | 会提前通知迁移路径                 |

## 当前口径

* 能力级状态看 [status.tapapi.ai](https://status.tapapi.ai)
* 实时可用模型以控制台、价格页和 `/api/pricing` 为准
* 文档中只展示客户可见模型名
* 模型详情页是精选说明，不代表控制台实时可见的全部模型
* 文本和视频模型页按公开能力维护，不暴露上游真实名称
* 模型上线时同步更新价格、示例和推荐场景

## 状态页和模型页的区别

| 页面    | 解决的问题                    |
| ----- | ------------------------ |
| 服务状态页 | 文本、图像、视频这些能力现在是否整体可用     |
| 模型中心  | 哪些模型适合你的场景，价格、速度和能力边界是什么 |
| 控制台   | 你的账号当前能看到并调用哪些模型         |

如果服务状态页显示正常，但某个模型失败，通常优先按“单模型配置、参数、额度、限流或维护”排查。

## 生产默认配置建议

| 状态   | 是否适合放默认模型 | 建议                 |
| ---- | :-------: | ------------------ |
| 可用   |     是     | 仍需小样本验证成功率、耗时和成本   |
| 受控开放 |     否     | 只建议灰度、小样本测试或人工触发   |
| 即将上线 |     否     | 可以关注文档，但不要写入生产默认配置 |
| 维护中  |     否     | 临时切换兜底模型           |
| 计划下线 |     否     | 尽快迁移，并保留旧模型日志用于对账  |

生产环境至少准备一个默认模型和一个兜底模型。状态变化时，先降级到兜底模型，再排查具体错误码和请求日志。

## 排查顺序

1. 看控制台是否还能看到该模型。
2. 看价格页是否仍展示该模型及对应价格单位。
3. 看账号分组是否有该模型权限。
4. 看请求参数是否匹配模型支持的输入输出模态。
5. 看服务状态页是否有能力级异常。
6. 如果只影响单个模型，先切换兜底模型，再联系支持。
7. 联系支持时带上请求时间、模型名、HTTP 状态码、`error.code` 和 `X-Oneapi-Request-Id`。