> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ttapi.io/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> Send API requests to https://api.ttapi.io with the TT-API-KEY header. Midjourney account hosting uses https://hold.ttapi.io. Claude Code uses https://cc.ttapi.io.
> Most generation endpoints are asynchronous. The submit response returns a job id. Poll that product's fetch endpoint, or pass a webhook on the submit request. A fetch call does not start a new generation.
> 1 USD = 100 quota. Check the pricing page for that product before estimating cost.
> This file lists the English docs. Follow every /_llms/ link recursively for the API reference, Chinese, and Russian. Open a page's .md URL for the endpoint schema.

# 服务与可用性

> 查看服务状态、了解上游影响，并快速排查可用性问题

这页主要回答三件事：服务状态去哪里看、哪些问题属于 TTAPI 本身、哪些问题来自上游模型或第三方平台。

> [card] [状态监控](http://54.211.73.9:8020/)
>
> 当前可查看临时监控地址。正式域名上线后会切换到 `https://status.ttapi.io`。

> [card] [Midjourney 账户托管](https://docs.ttapi.io/grids/cn/question/midjourney-hold-account)
>
> 了解托管账号的适用场景、边界和常见注意事项。

> [card] [Claude Code 支持](https://docs.ttapi.io/grids/cn/development/claude-code)
>
> 在 Windows、macOS、Linux 本地接入 Claude Code，并通过 TTAPI 提供的 Claude 兼容接口使用。

## 先看状态页

如果你怀疑当前有服务波动，先看状态页，不要一上来就重试很多次。

| 用途 | 地址 | 说明 |
| :- | :- | :- |
| 当前监控页 | [http://54.211.73.9:8020/](http://54.211.73.9:8020/) | 现阶段可直接查看的监控面板。 |
| 正式状态页 | [https://status.ttapi.io](https://status.ttapi.io) | 正式上线后使用的对外状态域名。 |

建议重点关注以下几类信息：

* 是否存在整体故障或部分模型异常
* 是否有维护公告或恢复进度
* 问题是 TTAPI 网关层、模型供应商侧，还是单个产品线异常

## 可用性的实际边界

TTAPI 会尽量保证网关、鉴权、任务提交和查询链路稳定，但生成类服务本身会受到上游平台影响。像 Midjourney、Sora、Suno、Claude 这类能力，本身就依赖第三方模型或平台状态，所以“可用”并不等于“永远无等待、永远无上游波动”。

| 场景 | 这通常意味着什么 | 建议怎么做 |
| :- | :- | :- |
| 接口能正常返回，但任务排队变慢 | 上游模型繁忙、账号队列拥堵或供应商限流 | 先查状态页，再按任务状态继续轮询 |
| 提交请求失败，返回 4xx | 通常是参数、鉴权、额度或权限问题 | 先检查请求本身，不要盲目重试 |
| 提交请求失败，返回 5xx | 可能是网关异常、上游错误或临时故障 | 间隔重试 1 到 2 次，再决定是否联系支持 |
| 单个模型异常，其它模型正常 | 某条产品线或某个上游通道有问题 | 切换模型、等待恢复，或查看对应公告 |

## 出现问题时怎么判断

**1. 先确认是不是整体故障**

打开状态页，看是不是已经有公开告警、维护或恢复公告。

**2. 再看错误类型**

`400-499` 优先看参数、KEY、额度和权限；`500-599` 更像服务端或上游异常。

**3. 区分提交失败和结果未就绪**

如果提交成功但查询仍在 `PENDING_QUEUE` 或 `ON_QUEUE`，多数时候是任务仍在排队，不代表任务丢失。

**4. 最后再联系支持**

如果状态页正常、重试后仍失败，再把关键信息一起提交给我们，会比只说“接口挂了”更快定位。

## 重试建议

| 情况 | 是否建议重试 | 建议 |
| :- | :- | :- |
| 参数错误、KEY 错误、余额不足 | 否 | 先修正请求或账户状态 |
| 单次 500/502/504 | 是 | 间隔 1 到 3 秒重试 1 到 2 次 |
| 任务排队中 | 否 | 按查询接口继续轮询，不要重复提交相同任务 |
| 状态页已显示故障 | 否 | 等待恢复公告或切换其它模型 |

## 联系支持时请带上这些信息

为了节省来回沟通时间，建议至少提供以下信息：

* 出问题的接口路径
* 大致请求时间
* 返回的 HTTP 状态码和响应内容
* 如果是任务类接口，附上 `jobId`
* 如果状态页有异常，也可以附上对应截图或说明

## 相关页面

* [Midjourney 账户托管](https://docs.ttapi.io/grids/cn/question/midjourney-hold-account)
* [Claude Code 支持](https://docs.ttapi.io/grids/cn/development/claude-code)
* [状态码与返回值](https://docs.ttapi.io/grids/cn/development/response.md)
* [联系支持](https://docs.ttapi.io/grids/cn/about/connect.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.