Перейти к основному содержанию

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 использует единый 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-сопоставления и отладки
Last modified on March 25, 2026