Настройка API

Для взаимодействия с API разработчика Fit-it-on вы должны аутентифицировать свои запросы с помощью безопасного ключа API разработчика.

Генерация ключа API

Войдите в свою панель управления Fit-it-on.
Перейдите в раздел Разработчик > Ключи API на левой боковой панели.
Нажмите кнопку Сгенерировать новый ключ.
Скопируйте свой новый секретный ключ (он всегда будет начинаться с fio_sk_...).

Храните этот ключ в безопасности! В целях безопасности вы не сможете просмотреть этот ключ снова после закрытия диалогового окна генерации. Если вы его потеряете, вы должны отозвать его и сгенерировать новый.

Аутентификация

Все запросы API должны включать ваш ключ API в заголовок Authorization в качестве токена Bearer.

curl https://fititon.app/api/v1/run \
  -H "Authorization: Bearer fio_sk_YOUR_SECRET_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model_name": "tryon",
    "inputs": { ... }
  }'

Асинхронный рабочий процесс

Конечные точки генерации Fit-it-on (например, /v1/run) работают асинхронно. Это означает, что ваш первоначальный запрос немедленно вернет идентификатор отслеживания задания, вместо того чтобы ждать завершения генерации.

Шаг 1: Отправка задания

Выполните POST запрос к https://fititon.app/api/v1/run, чтобы поставить задание на генерацию в очередь. Вы получите немедленный ответ:

{
  "id": "123a87r9-4129-4bb3-be18-9c9fb5bd7fc1",
  "status": "starting",
  "created_at": "2026-07-17T11:00:00Z",
  "error": null,
  "output": null
}

Шаг 2: Опрос результатов

Используйте возвращенный id для периодической проверки статуса вашей генерации, выполняя GET запрос к https://fititon.app/api/v1/status/{id}.

curl https://fititon.app/api/v1/status/123a87r9-4129-4bb3-be18-9c9fb5bd7fc1 \
  -H "Authorization: Bearer fio_sk_YOUR_SECRET_KEY"

Ответ будет указывать текущее состояние вашего задания. Когда status будет "completed", поле output будет содержать URL-адреса сгенерированных изображений или видео.

{
  "id": "123a87r9-4129-4bb3-be18-9c9fb5bd7fc1",
  "status": "completed",
  "output": [
    "https://cdn.fititon.app/users/123/results/result-123.png"
  ],
  "error": null,
  "created_at": "2026-07-17T11:00:00.000Z",
  "updated_at": "2026-07-17T11:00:25.000Z"
}

Выполнение первого запроса

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

curl https://fititon.app/api/v1/credits \
  -H "Authorization: Bearer fio_sk_YOUR_SECRET_KEY"

В случае успеха, это вернет JSON-объект с вашим текущим тарифным планом и оставшимися кредитами.