Skip to main content

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.

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

状态监控

当前可查看临时监控地址。正式域名上线后会切换到 https://status.ttapi.io

Midjourney 账户托管

了解托管账号的适用场景、边界和常见注意事项。

Claude Code 支持

在 Windows、macOS、Linux 本地接入 Claude Code,并通过 TTAPI 提供的 Claude 兼容接口使用。

先看状态页

如果你怀疑当前有服务波动,先看状态页,不要一上来就重试很多次。
用途地址说明
当前监控页http://54.211.73.9:8020/现阶段可直接查看的监控面板。
正式状态页https://status.ttapi.io正式上线后使用的对外状态域名。
建议重点关注以下几类信息:
  • 是否存在整体故障或部分模型异常
  • 是否有维护公告或恢复进度
  • 问题是 TTAPI 网关层、模型供应商侧,还是单个产品线异常

可用性的实际边界

TTAPI 会尽量保证网关、鉴权、任务提交和查询链路稳定,但生成类服务本身会受到上游平台影响。像 Midjourney、Sora、Suno、Claude 这类能力,本身就依赖第三方模型或平台状态,所以“可用”并不等于“永远无等待、永远无上游波动”。
场景这通常意味着什么建议怎么做
接口能正常返回,但任务排队变慢上游模型繁忙、账号队列拥堵或供应商限流先查状态页,再按任务状态继续轮询
提交请求失败,返回 4xx通常是参数、鉴权、额度或权限问题先检查请求本身,不要盲目重试
提交请求失败,返回 5xx可能是网关异常、上游错误或临时故障间隔重试 1 到 2 次,再决定是否联系支持
单个模型异常,其它模型正常某条产品线或某个上游通道有问题切换模型、等待恢复,或查看对应公告

出现问题时怎么判断

1

先确认是不是整体故障

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

再看错误类型

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

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

如果提交成功但查询仍在 PENDING_QUEUEON_QUEUE,多数时候是任务仍在排队,不代表任务丢失。
4

最后再联系支持

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

重试建议

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

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

为了节省来回沟通时间,建议至少提供以下信息:
  • 出问题的接口路径
  • 大致请求时间
  • 返回的 HTTP 状态码和响应内容
  • 如果是任务类接口,附上 jobId
  • 如果状态页有异常,也可以附上对应截图或说明

相关页面

Last modified on March 12, 2026