Генерация ракурсов

Конечная точка генерации ракурсов позволяет взять существующее изображение и изменить положение виртуальной камеры для создания новых ракурсов (например, спереди, сзади, сбоку), сохраняя при этом модель, одежду, текстуры и освещение.

Запрос

Отправьте ваше изображение и желаемые ракурсы на универсальную конечную точку /v1/run:

Примеры запросов

curl -X POST https://fititon.app/api/v1/run \
     -H "Content-Type: application/json" \
     -H "Authorization: Bearer YOUR_API_KEY" \
     -d '{
           "model_name": "angle-generation",
           "inputs": {
             "imageUrl": "https://example.com/front-view.jpg",
             "angleIds": ["back", "leftSide"],
             "quality": "2k"
           }
         }'

Ответ

Поскольку генерация ракурсов может занимать до 20 секунд, конечная точка /v1/run немедленно возвращает статус 201 Created с асинхронным идентификатором задания id. Вы должны опрашивать Status API, используя GET /v1/status/{id}, чтобы получить окончательные результаты. В качестве альтернативы вы можете настроить веб-хуки для автоматического получения уведомлений. Обратите внимание, что наш диспетчер веб-хуков применяет строгое 15-секундное ограничение по времени. Ваш сервер должен подтвердить веб-хук кодом состояния 2xx в течение 15 секунд, иначе мы посчитаем его неудачным и повторим попытку позже.

{
  "id": "123a87r9-4129-4bb3-be18-9c9fb5bd7fc1",
  "status": "starting",
  "created_at": "2026-07-18T17:30:00.000Z",
  "error": null,
  "output": null
}

Как только status изменится на "succeeded", поле output будет содержать массив URL-адресов, указывающих на сгенерированные вами изображения. Изображения возвращаются в том же порядке, что и массив angleIds, предоставленный в вашем первоначальном запросе:

{
  "id": "123a87r9-4129-4bb3-be18-9c9fb5bd7fc1",
  "status": "succeeded",
  "created_at": "2026-07-18T17:30:00.000Z",
  "error": null,
  "output": [
    "https://cdn.fititon.app/users/123/results/angle-123-0.png",
    "https://cdn.fititon.app/users/123/results/angle-123-1.png"
  ]
}

Параметры запроса

Обязательные параметры

Необязательные параметры

Ошибки выполнения

Ошибки выполнения для этой функции используют общий набор, задокументированный в разделе Обработка ошибок. Если во время обработки произойдет ошибка, status обновится до "error", а поле error будет содержать конкретную причину сбоя.

Стоимость кредитов

Для запросов к API разработчика стоимость линейно зависит от количества запрошенных ракурсов и от выбранного уровня quality вывода.

Формула: Стоимость = КредитыЗаКачество × КоличествоРакурсов

Пример: Запрос ["back", "leftSide", "rightSide"] с качеством 1k стоит всего 3 кредита. Запрос тех же 3 ракурсов с качеством 4k стоит всего 15 кредитов.