Основы API

Fit-it-on Developer API предоставляет программный доступ к нашим моделям генерации ИИ. Он соответствует стандартным архитектурным стилям REST, использует предсказуемые ресурсно-ориентированные URL-адреса и принимает тела запросов в формате JSON.

Асинхронное выполнение

Все генерации изображений обрабатываются асинхронно. Рендеры ИИ высокого разрешения (образцы 2k или 2048x2048) требуют времени, и синхронное соединение неизбежно привело бы к тайм-ауту.

1. Отправка задания: Вы отправляете запрос POST /v1/run с вашими входными данными.
2. Получение ID: API немедленно возвращает 200 OK с prediction_id.
3. Опрос статуса: Вы периодически вызываете GET /v1/status/{predictionId}.
4. Завершение: Когда статус переходит в succeeded, URL-адреса ваших сгенерированных изображений будут доступны в массиве output.

Базовый URL

Все запросы должны выполняться по HTTPS к нашей производственной среде:

https://fititon.app/api

Типы контента

Все запросы POST и PATCH должны включать следующий заголовок для указания формата полезной нагрузки:

Content-Type: application/json

API также возвращает все ответы строго в формате JSON.

Веб-хуки

Если вы укажете webhook_url в корне вашей JSON-полезной нагрузки, мы отправим HTTP POST запрос на этот URL, как только асинхронное задание завершится (успешно или с ошибкой).

Пример полезной нагрузки веб-хука:

{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "status": "success",
  "output": [
    "https://storage.fititon.com/results/result-123.jpg",
    "https://storage.fititon.com/results/result-124.jpg"
  ],
  "error": null,
  "created_at": "2026-07-03T10:00:00.000Z",
  "updated_at": "2026-07-03T10:00:15.000Z"
}

Ограничения запросов и обработка

Для предотвращения злоупотреблений API применяет ограничение скорости, основанное на вашем активном уровне тарифного плана разработчика.

Если вы превысите свой лимит, вы получите ошибку 429 Too Many Requests. Ваше приложение должно корректно обрабатывать это, реализуя экспоненциальную задержку.