Примерка одежды (FASHN) API Примерка вещи по фото человека и одежды. Один результат. Генеративная визуализация, не измерение посадки.
Создание операции
Endpoint: POST /api/v1/operations
Авторизация: Authorization: Bearer brth_...
Выполнение асинхронное: запрос создаёт операцию и сразу возвращает её id и стартовый статус.
Тело запроса
{
"tool": "fashn-virtual-try-on",
"input": {
"segmentation_free": true,
"person_image_url": "https://cdn.example.com/person-image-1.jpg",
"product_image_url": "https://cdn.example.com/product-image-1.jpg",
"person_outfit": "unknown",
"category": "tops",
"garment_photo_type": "auto"
}
}
Параметры передаются напрямую внутри объекта input. Дополнительный вложенный объект input не нужен.
Параметры
Параметр Тип Обязательный Описание segmentation_freebooleanНет Обычно включено. Если осталась старая одежда, можно сравнить с выключенным режимом в новой попытке. Проверьте обувь и другие детали.
person_image_urlstring (url)Да Внешний URL изображения. Разрешены только http/https ссылки. Допустимые расширения: .jpg, .jpeg, .png, .webp.
product_image_urlstring (url)Да Внешний URL изображения. Разрешены только http/https ссылки. Допустимые расширения: .jpg, .jpeg, .png, .webp.
person_outfitenumДа Варианты: unknown (Нужно уточнить), separate (Отдельный верх и низ), one_piece (Платье или комбинезон)
categoryenumДа Варианты: tops (Верх), one-pieces (Платье или комбинезон)
garment_photo_typeenumДа Варианты: auto (Определить автоматически), model (На человеке), flat-lay (На плоскости или манекене)
Примеры запросов
cURL curl -X POST https://bratuha.ru/api/v1/operations \
-H "Authorization: Bearer brth_ваш_ключ" \
-H "Content-Type: application/json" \
-d '{
"tool": "fashn-virtual-try-on",
"input": {
"segmentation_free": true,
"person_image_url": "https://cdn.example.com/person-image-1.jpg",
"product_image_url": "https://cdn.example.com/product-image-1.jpg",
"person_outfit": "unknown",
"category": "tops",
"garment_photo_type": "auto"
}
}'
JavaScript / TypeScript const response = await fetch('https://bratuha.ru/api/v1/operations', {
method: 'POST',
headers: {
Authorization: 'Bearer brth_ваш_ключ',
'Content-Type': 'application/json',
},
body: JSON.stringify({
"tool": "fashn-virtual-try-on",
"input": {
"segmentation_free": true,
"person_image_url": "https://cdn.example.com/person-image-1.jpg",
"product_image_url": "https://cdn.example.com/product-image-1.jpg",
"person_outfit": "unknown",
"category": "tops",
"garment_photo_type": "auto"
}
}),
})
const data = await response.json()
Python import requests
response = requests.post(
'https://bratuha.ru/api/v1/operations',
headers={
'Authorization': 'Bearer brth_ваш_ключ',
'Content-Type': 'application/json',
},
json={
"tool": "fashn-virtual-try-on",
"input": {
"segmentation_free": true,
"person_image_url": "https://cdn.example.com/person-image-1.jpg",
"product_image_url": "https://cdn.example.com/product-image-1.jpg",
"person_outfit": "unknown",
"category": "tops",
"garment_photo_type": "auto"
}
},
timeout=30,
)
print(response.status_code)
print(response.json())
Примеры ответов
Ответ после создания {
"id": "op_uuid-123",
"status": "queued",
"tool": "fashn-virtual-try-on",
"cost": 12,
"balance_after": 495,
"created_at": "2026-03-13T12:00:00Z"
}
Ответ после завершения {
"id": "op_uuid-123",
"status": "completed",
"tool": "fashn-virtual-try-on",
"cost": 12,
"created_at": "2026-03-13T12:00:00Z",
"completed_at": "2026-03-13T12:00:24Z",
"result": {
"type": "image",
"urls": [
"https://storage.bratuha.ru/results/fashn-virtual-try-on/image-1.jpg"
]
},
"error_message": null
}
Проверка статуса curl -H "Authorization: Bearer brth_ваш_ключ" \
https://bratuha.ru/api/v1/operations/op_uuid-123
Формат результата Возможные типы результата: image.
Ценообразование
Базовая цена за запуск: 12 ₽ .
Дополнительных модификаторов цены для этой схемы нет.
Ограничения и практические заметки
Передайте UUID в заголовке Idempotency-Key: повтор одного запроса в течение 24 часов вернёт исходную операцию без повторного списания. Повтор без этого заголовка создаёт новую операцию.
Передайте max_price в теле запроса, чтобы сервер отклонил запуск дороже согласованной суммы до списания.
Все операции выполняются асинхронно: сначала вы получаете queued, затем проверяете статус по id.
Для file URL разрешены только внешние http/https ссылки без localhost, loopback и private IP.
Формат URL должен соответствовать допустимым расширениям поля, иначе API вернёт validation_error.
Форматы HEIC/HEIF, которые поддерживаются при загрузке файлов в UI, к Public API по URL не относятся. Для API используйте JPG, JPEG, PNG или WebP.
Примерка одежды (FASHN) API — Братуха.ру