Google

Google Virtual Try-On

google-virtual-try-on

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

google-virtual-try-on

Попробовать google-virtual-try-on

Ввод

Работы

Все работы

Вывод

image

Заполните параметры и сгенерируйте — результаты появятся здесь.

Цены

google-virtual-try-on per image

Цена за единицу	$0.1075

Краткое описание

Google Виртуальная примерка — это модель генерации изображений «изображение в изображение»: на вход подаются фотография человека и изображение товара одежды, а на выходе получается изображение с примеркой этой одежды на данном человеке. Она подходит для интернет-магазинов одежды, рекомендаций по образам и приложений для принятия решений о покупке одежды онлайн. Разработчикам достаточно передать URL двух изображений через единый интерфейс HiAPI.ai, чтобы получить одно скомпонованное изображение, которое можно использовать на странице товара, для предпросмотра примерки или как справку по образу, что снижает сложность оценки того, как одежда будет смотреться на человеке.

Ключевые особенности

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

Описание возможностей

Синтез примерки на основе двух изображений: принимает два http(s)-адреса — фотографию человека и изображение товара одежды — и выводит изображение, где человек одет в эту одежду; подходит для генерации предпросмотра примерки по запросу.

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

Один запрос — одно изображение: каждый запрос всегда возвращает одно изображение; параметр количества принимает только значение 1, что упрощает тарификацию по запросам и управление результатами.

Ввод изображений по ссылке: на вход принимаются только http(s)-адреса изображений, без загрузки файловых потоков, что упрощает интеграцию с существующими системами хранения изображений и CDN.

Сценарии применения

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

Ограничения и рекомендации по выбору

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

Новости

Смотреть changelog →

Обновление цены Корректировка цен google-virtual-try-on Oct 31, 2026
Изменение параметров google-virtual-try-on: num_images фиксировано на 1 Oct 21, 2026
Новая модель Новая модель: google-virtual-try-on (виртуальная примерка Google, POST /v1/tasks). Передайте per… Oct 16, 2026

Частые вопросы

Все частые вопросы →

Какие входные данные нужны для Google Virtual Try-On?

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

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

Подойдут как фото в разложенном виде, так и фото на вешалке; результат будет лучше, если одежда видна полностью, фон чистый и на фото нет других людей.
Сколько изображений можно сгенерировать за один раз?

1 изображение за раз, num_images фиксирован как 1. Если нужно несколько вариантов, можно несколько раз отправить один и тот же набор входных данных — детали результатов будут немного отличаться.

Создать задачу генерации

POST https://api.hiapi.ai/v1/tasks

Заголовки

AuthorizationstringОбязательно

API-ключ аккаунта. Обязателен в каждом запросе. Пример: Bearer YOUR_HIAPI_API_KEY. Получить API-ключ

Content-TypestringНеобязательно

Тело запроса всегда разбирается как JSON; при отправке принимается только application/json (charset опционален) — любое иное значение возвращает 415. Пример: application/json.

Idempotency-KeystringНеобязательно

Ключ идемпотентности, до 255 байт. Повторные запросы с тем же ключом того же аккаунта создают задачу лишь один раз; реплеи возвращают исходный taskId.

Ключ идемпотентности

При сетевых таймаутах или автоповторах клиента один и тот же ключ создаёт задачу только один раз, без двойного списания (область = аккаунт API-ключа). Рекомендуется бизнес-уникальный идентификатор (напр. "order-42"); реплеи возвращают исходный taskId, ключ истекает через 24 часа после первого запроса. Полная матрица сценариев — во введении единого асинхронного API.

Тело запроса

modelstringОбязательно

Текущее фиксированное значение: google-virtual-try-on

routestringНеобязательно

Текущее фиксированное значение: default

inputobjectОбязательно

Объект бизнес-параметров для google-virtual-try-on и маршрута default — см. таблицу параметров ниже.

num_imagesintegerНеобязательноПо умолчанию: 1min 1max 1

Количество изображений, генерируемых за один запрос; должно быть равно 1, по умолчанию 1.

person_image_urlstringОбязательноminLength 1pattern ^https?://

http(s) URL фотографии модели-человека, задающий субъект для примерки одежды.

product_image_urlstringОбязательноminLength 1pattern ^https?://

http(s) URL изображения товара одежды для примерки; результат примерки будет сгенерирован на основе этой одежды.

callbackobjectНеобязательно

Настройка уведомления о терминальном состоянии. Если не задана — обратных вызовов нет, опрашивайте задачу сами.

Обратные вызовы (Webhook)

Укажите callback.url при создании, и HiAPI отправит POST вашему сервису в терминальном состоянии — опрос не нужен. Тело callback повторяет структуру деталей задачи; проверка подписи, повторы и идемпотентность описаны во введении единого асинхронного API.

urlstringОбязательно

Обязательна при наличии callback. В терминальном состоянии на этот URL отправляется POST; это должна быть корректная http(s)-ссылка.

whenstringНеобязательноПо умолчанию: "final"

Сейчас поддерживается только final — уведомление и при success, и при fail.

Варианты:final

storagestringНеобязательноПо умолчанию: "temp"

Уровень хранения артефактов: temp (по умолчанию, ~7 дней) или persistent (долгосрочно, оплата по объёму). При нехватке баланса или превышении лимита — тихое понижение до temp; фактический уровень виден в ответе деталей задачи.

Варианты:temppersistent

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

# Отправляет асинхронную задачу; сразу возвращает taskId (не ждёт генерации)
curl -X POST "https://api.hiapi.ai/v1/tasks" \
  -H "Authorization: Bearer $HIAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "google-virtual-try-on",
  "input": {
    "num_images": 1,
    "person_image_url": "…",
    "product_image_url": "…"
  }
}'

const res = await fetch("https://api.hiapi.ai/v1/tasks", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.HIAPI_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    model: "google-virtual-try-on",
    input: {
      "num_images": 1,
      "person_image_url": "…",
      "product_image_url": "…"
    }
  }),
});
const task = await res.json();
// { code: 200, message: "success", data: { taskId } }

import os, requests

res = requests.post(
    "https://api.hiapi.ai/v1/tasks",
    headers={"Authorization": f"Bearer {os.environ['HIAPI_API_KEY']}"},
    json={
        "model": "google-virtual-try-on",
        "input": {
          "num_images": 1,
          "person_image_url": "…",
          "product_image_url": "…"
        }
    },
)
print(res.json())  # { code, message, data: { taskId } }

200 OK

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-01HZTQ8BX2N3GM3YFK4Z9D7VQR"
  }
}

400 Bad Request

{
  "code": 400,
  "message": "invalid request",
  "data": null,
  "error_code": "INVALID_REQUEST"
}

Получить детали задачи

GET https://api.hiapi.ai/v1/tasks/:id

Поля ответа

taskIdstringОбязательно

Идентификатор задачи, всегда с префиксом tk-hiapi-.

modelstringОбязательно

Полное разрешённое имя модели. Задачи, отправленные с параметром route, возвращают base@route (напр. gpt-image-2/text-to-image@ext); иначе совпадает с переданным именем.

routestringНеобязательно

Присутствует только при явном параметре route; повторяет переданное значение.

statusstringОбязательно

Статус задачи.

Значения статуса

queued В очереди, ещё не начата. handling Обрабатывается. archiving Обработка завершена, готовятся артефакты. success Терминальное: завершено, артефакты доступны (возвращается output). fail Терминальное: ошибка (возвращается error). После отправки следите за status: success и fail — терминальные, остальные нет. Опрашивайте каждые 1–3 с до терминального состояния. При успехе скачайте артефакты из output[].url и перенесите до expireAt; для длительного хранения укажите storage: "persistent" при создании.

creatednumberОбязательно

Время создания задачи (Unix-секунды).

completednumberОбязательно

Unix-секунды терминального состояния; до этого — 0.

outputarrayНеобязательно

Только при status == success. Список артефактов — всегда массив; одна задача может вернуть несколько type сразу (напр. video + first_frame).

Array [ object ]

Элементы массива

urlstringОбязательно

URL артефакта, доступен для скачивания напрямую.

typestringОбязательно

Текущие возможные значения: video, image, audio, first_frame, last_frame, thumbnail; список может расширяться.

expireAtnumberОбязательно

Unix-секунды доступности артефакта; скачайте или перенесите до истечения.

errorobjectНеобязательно

Только при status == fail.

codestringОбязательно

Бизнес-код ошибки.

messagestringОбязательно

Описание ошибки.

Примеры ответа

Успех

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-01HZTQ8BX2N3GM3YFK4Z9D7VQR",
    "model": "happyhorse-1-0",
    "status": "success",
    "created": 1777282033,
    "completed": 1777282099,
    "output": [
      {
        "url": "https://cdn.hiapi.ai/tasks/.../video.mp4",
        "type": "video",
        "expireAt": 1777886899
      }
    ]
  }
}

Обработка (не финальное)

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-...",
    "model": "happyhorse-1-0",
    "status": "archiving",
    "created": 1777282033,
    "completed": 0
  }
}

Ошибка

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-...",
    "model": "happyhorse-1-0",
    "status": "fail",
    "created": 1777282033,
    "completed": 1777282099,
    "error": {
      "code": "TASK_FAILED",
      "message": "task failed"
    }
  }
}