TTAPI использует единый JSON-формат ответов во всех конечных точках, чтобы ваше приложение могло одинаково обрабатывать успешные ответы и ошибки.
Единый формат ответа
Успех
{
"status": "SUCCESS",
"message": "success",
"data": {
"jobId": "b8bd3ff0-4349-4b71-8938-5e13aefa64fe"
}
}
Ошибка
{
"status": "FAILED",
"message": "Parameter error",
"data": null
}
HTTP-коды
| HTTP-код | Значение | Частая причина |
|---|
200 | Запрос выполнен | Успешная отправка или получение результата |
400 | Некорректный запрос | Неверные или отсутствующие параметры |
401 | Нет доступа | Отсутствует или неверен TT-API-KEY |
402 | Недостаточно баланса | Не хватает quota |
404 | Не найдено | Неверный endpoint или отсутствующий ресурс |
429 | Слишком много запросов | Превышен краткосрочный лимит |
499 | Очередь исчерпана | Недостаточно слотов очереди для продукта |
500 | Ошибка сервера | Внутренняя ошибка сервиса |
504 | Таймаут | Слишком долгий синхронный запрос |
Бизнес-статусы
Поле status внутри JSON-ответа показывает состояние задачи на прикладном уровне.
| Статус | Значение |
|---|
PENDING_QUEUE | Ожидает в очереди |
ON_QUEUE | Выполняется |
SUCCESS | Успешно завершено |
FAILED | Задача завершилась ошибкой |
Частые примеры
Успешная отправка
{
"status": "SUCCESS",
"message": "success",
"data": {
"jobId": "b8bd3ff0-4349-4b71-8938-5e13aefa64fe"
}
}
Успешное получение результата
{
"status": "SUCCESS",
"message": "",
"jobId": "8ddd973f-b5ff-4192-b418-b37fb65c65f3",
"data": {
"action": "imagine",
"jobId": "8ddd973f-b5ff-4192-b418-b37fb65c65f3",
"progress": "100",
"prompt": "A cute kitten",
"quota": "2",
"discordImage": "https://cdn.ttapi.io/midjourney/2025-11-14/20260307_024522_19cf9806e1c7438b.png",
"cdnImage": "https://cdn.ttapi.io/midjourney/2025-11-14/20260307_024522_19cf9806e1c7438b.png",
"width": 960,
"height": 1200,
"hookUrl": "https://webhook-test.com/40bb50795afa242aee8c837617cd72e9",
"components": [
"upsample1",
"upsample2",
"upsample3",
"upsample4",
"reroll",
"variation1",
"variation2",
"variation3",
"variation4"
],
"seed": null,
"images": [
"https://cdn.ttapi.io/midjourney/20260307/5c7261ec-7271-495d-a0f7-4dd395652a84tl.png",
"https://cdn.ttapi.io/midjourney/20260307/5c7261ec-7271-495d-a0f7-4dd395652a84tr.png",
"https://cdn.ttapi.io/midjourney/20260307/5c7261ec-7271-495d-a0f7-4dd395652a84bl.png",
"https://cdn.ttapi.io/midjourney/20260307/5c7261ec-7271-495d-a0f7-4dd395652a84br.png"
]
}
}
Ошибка параметров
{
"status": "FAILED",
"message": "[Invalid parameter] Invalid value for argument: `--v`:`8`",
"data": null
}
Неверный ключ
{
"status": "FAILED",
"message": "Wrong TT-API-KEY or email is not activated."
}
Рекомендации
- При ответах
4xx сначала проверьте сам запрос, а уже потом повторяйте его
- При ответах
5xx попробуйте повторить запрос 1-2 раза, затем обратитесь в поддержку
- Сохраняйте
jobId для опроса результата, webhook-сопоставления и отладки