Изменяйте позы моделей в соответствии с эталонными изображениями или текстовыми описаниями.

Управление позой

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

Название модели: pose-control

Жизненный цикл: stable

Время обработки: ~15–30 с

Формат вывода: Авто (JPEG или PNG)

Методы доставки: URL

Кредиты: от 1 до 5 за сгенерированную позу (1k: 1, 2k: 3, 4k: 5)

Запрос

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

POSThttps://fititon.app/api/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": "pose-control",
           "inputs": {
             "modelImage": "https://example.com/model-standing.jpg",
             "quality": "2k",
             "poses": [
               {
                 "type": "template",
                 "cdnUrl": "https://example.com/pose-reference.jpg",
                 "title": "Hands on hips"
               },
               {
                 "type": "custom",
                 "text": "Sitting on a chair with legs crossed"
               }
             ]
           }
         }'

Ответ

Поскольку генерация может занимать до 30 секунд, конечная точка /v1/run немедленно возвращает статус 201 Created с асинхронным id задания. Вы должны опрашивать 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-адресов, указывающих на сгенерированные вами изображения. Изображения возвращаются в том же порядке, что и массив poses, предоставленный в вашем первоначальном запросе:

{
  "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/fititon-pose-123-0.png",
    "https://cdn.fititon.app/users/123/results/fititon-pose-123-1.png"
  ]
}

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

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

modelImageRequiredstring

Исходное изображение человека, позу которого вы хотите изменить. Может быть общедоступным URL-адресом или строкой изображения в кодировке Base64.

Совет профессионала: Полноростовые фотографии от головы до ног дают наилучшие результаты — ИИ необходимо видеть все тело, чтобы правильно изменить его позу. Облегающая одежда лучше показывает структуру тела, чем громоздкие или многослойные наряды. Простой, незагроможденный фон позволяет ИИ четко сфокусироваться на форме тела.

Требование к форматированию При отправке строки Base64 она должна включать стандартный префикс URI данных (например, data:image/jpeg;base64,...).

posesRequiredarray of objects

Массив, определяющий позы, которые вы хотите сгенерировать. Вы можете смешивать и сопоставлять шаблонные и пользовательские позы в одном запросе.

Шаблонная поза: Использует изображение в качестве структурной ссылки. Вы можете предоставить любой действительный URL-адрес изображения для использования в качестве эталонной позы, или вы можете использовать один из наших официально поддерживаемых шаблонов, перечисленных ниже.
- type (строка): Должен быть "template".
- cdnUrl (строка): URL эталонного изображения, демонстрирующего желаемую позу.
- title (строка, необязательно): Описательная метка.
Пользовательская поза: Использует текстовую подсказку для определения позы.
- type (строка): Должен быть "custom".
- text (строка): Текст, описывающий новую позу (например, "standing with arms crossed").

Официальные шаблоны поз

Хотя вы можете предоставить свои собственные эталонные изображения через cdnUrl, мы предлагаем тщательно подобранный каталог высокооптимизированных шаблонов поз. Нажмите на любой URL-адрес ниже, чтобы просмотреть позу.

Female Poses

Title	Template URL (`cdnUrl`)

Male Poses

Title	Template URL (`cdnUrl`)

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

quality'1k' | '2k' | '4k'

Уровень выходного разрешения. По умолчанию: 1k

ratiostring

Определяет соотношение ширины к высоте сгенерированного изображения. Если пусто, система по умолчанию использует соотношение сторон исходного изображения.

Поддерживаемые значения: '1:1', '3:4', '4:3', '9:16', '16:9', '2:3', '3:2', '4:5', '5:4', '21:9'.

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

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

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

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

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

Уровень качества	Кредиты за позу
1k (По умолчанию)	1
2k	3
4k	5

Пример: Запрос массива из 3 поз с качеством 1k стоит 3 кредита. Запрос тех же 3 поз с качеством 4k стоит 15 кредитов.