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

# 服务状态

> 如何查看模型能力、平台服务和基础设施状态

服务状态页用于判断问题是局部请求失败，还是 Tapapi 的模型能力、控制台、支付或基础设施正在波动。

## 状态入口

| 入口                                           | 用途             |
| -------------------------------------------- | -------------- |
| [status.tapapi.ai](https://status.tapapi.ai) | 公开状态页，无需登录     |
| `/dashboard/status`                          | 控制台内嵌状态页       |
| [模型中心](/models/status)                       | 查看文档侧模型状态与选型说明 |

公开状态页运行在 Cloudflare Worker 上，独立于主业务服务器。主站或香港服务器异常时，状态页仍应尽量保持可访问，并展示真实状态。

## 状态怎么读

| 状态        | 含义          | 你应该怎么做              |
| --------- | ----------- | ------------------- |
| `ok`      | 当前探测正常      | 继续排查自己的请求参数、余额、模型权限 |
| `warn`    | 有波动或部分能力降级  | 减少重试，保留请求 ID，关注事件记录 |
| `err`     | 服务异常或大面积不可用 | 暂停批量任务，等待恢复或提交工单    |
| `unknown` | 暂未采集到有效数据   | 不要据此判断正常，稍后刷新或联系支持  |

状态页按“能力级”展示，不公开具体上游、渠道、密钥或内部路由。

| 板块            | 展示口径                            |
| ------------- | ------------------------------- |
| 文本对话 API      | 当前是否有文本 / 对话模型能力可用              |
| 图像生成 API      | 当前是否有图片生成、图片编辑等能力可用             |
| 视频生成 API      | 当前是否存在视频能力配置或灰度能力，不等于所有账号都能生产调用 |
| 控制台 / API Key | 登录、创建 Key、查看用量等入口是否正常           |
| 充值 / 支付入口     | 充值页、支付入口、余额相关入口是否正常             |
| 文档中心          | 文档站是否可访问                        |
| 基础设施          | 主站、网关和底层网络是否存在大面积异常             |

<Warning>状态页的模型能力来自能力摘要和平台探测，不是逐模型、逐账号、逐请求的真实生成测试。它适合判断“大面积是否正常”，不能代替单次请求排障。</Warning>

## 视频状态的特殊说明

视频能力可能在状态页里显示为可用或正常，但视频 API 仍可能处于受控开放、灰度或内部验证阶段。

判断公开视频能力是否可用时，以这些位置为准：

1. 视频 API 文档是否已说明具体模型、参数和计费规则
2. 控制台是否能看到对应视频模型和价格
3. 你的账号分组是否具备调用权限
4. 实际请求是否返回正式任务 ID 或结果

如果只是状态页显示 `video-gen ok`，不能直接理解为公开视频接口已经完全开放。

## 排障顺序

| 现象        | 先看哪里          | 下一步                 |
| --------- | ------------- | ------------------- |
| 多个模型同时失败  | 状态页核心能力       | 若 `warn/err`，暂停批量重试 |
| 单个模型失败    | 模型中心和控制台模型可见性 | 检查模型名、参数、账号权限       |
| 余额不足      | 余额与用量页        | 充值或调整 API Key 额度    |
| 图片任务超时    | 任务状态和用量日志     | 看是否有有效结果和最终扣费       |
| 支付成功未到账   | 钱包充值记录        | 走订单申诉并附支付截图         |
| 文档或控制台打不开 | 状态页平台服务       | 若状态页也打不开，稍后重试或邮件联系  |

提交反馈时请带上请求时间、模型名、`X-Oneapi-Request-Id` / `request_id` 或业务 `task_id`、HTTP 状态码和错误响应。具体模板见 [联系支持](/support/contact)。
