Overview
The TTAPI gateway is the entry point for all API requests. It handles routing, authentication, and traffic control. Every request must pass gateway authentication, otherwise the API returns 401.
General API domains
- Primary:
https://api.ttapi.io
- Recommended for most requests
- Accelerated:
https://api.ttapi.org
- Recommended for longer-running synchronous requests
Midjourney hosting domains
- Primary:
https://hold.ttapi.io
- Accelerated:
https://hold.ttapi.org
Claude Code domains
- Primary:
https://cc.ttapi.io
- Recommended for most requests
- Accelerated:
https://cc.ttapi.org
- Recommended for longer-running synchronous requests
Authentication
All TTAPI endpoints use TT-API-KEY in the request header.
- Header name:
TT-API-KEY
- Location: HTTP request header
- Case sensitivity: case-sensitive
- Key source: TTAPI Dashboard
Request rules
| Item | Requirement |
|---|
| Protocol | HTTPS only |
| Method | Follow the API definition |
| Encoding | UTF-8 |
| Content type | application/json |
Auth errors
| HTTP code | Meaning | What to check |
|---|
401 | Authentication failed | Missing key, wrong key, or inactive account |
Sample error response
{
"status": "FAILED",
"message": "Wrong TT-API-KEY or email is not activated."
}
Last modified on March 23, 2026