Bria

BRIA Product Shot

bria-product-shot

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

bria-product-shot

Цены

bria-product-shot per image

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

Общее описание

bria-product-shot — это модель редактирования изображений для визуализации товаров в электронной коммерции. Она принимает изображение товара и описание сцены или референсное изображение сцены, автоматически помещает товар в новый фон, сохраняя текстуры, логотипы и детали бренда, и выдаёт изображение товара, пригодное для коммерческой презентации. Подходит разработчикам и командам интернет-магазинов, которым нужно массово создавать сцены с товарами и сокращать объём физических съёмок и ручного композитинга.

Ключевые возможности

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

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

Генерация сцены по текстовому описанию: укажите английское описание сцены (до 1000 символов), модель автоматически сгенерирует фон и поместит товар; поддерживается автоматическое расширение описания для обогащения деталей сцены.

Задание стиля сцены референсным изображением: загрузите референсное изображение сцены, и модель объединяет изображение товара в соответствии со стилем его фона — удобно для серийного выпуска в едином визуальном стиле.

Управление положением и размером товара: режим ручного размещения позволяет выбрать точку размещения товара из десяти предустановленных позиций; исходный режим сохраняет входные размер и положение, а также позволяет не масштабировать до примерно 1MP.

Быстрое переключение режимов: по умолчанию включён быстрый режим для ускорения генерации; после отключения используется стандартная модель — можно выбирать между скоростью и качеством по потребности.

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

Электронная коммерция: массовая сценизация главных изображений товаров — по изображению товара и описанию сцены массово генерируются товарные изображения с разными фонами для карточек товаров и рекламных материалов.
Маркетинговые команды: создание вариантов в разных стилях — с помощью референсных изображений задаются разные стили фона, что позволяет быстро выпускать маркетинговые изображения одного товара в разных стилях для соцсетей и промостраниц.
Бренды: быстрый композитинг визуалов к запуску новинок — в процессе релиза нового продукта изображения товаров помещаются в жизненные сцены, что сокращает физические съёмки и ускоряет вывод визуальных материалов.
Разработчики: интеграция в автоматизированные рабочие процессы — через единый интерфейс HiAPI.ai композитинг сцен с товарами встраивается в конвейер производства контента для масштабной автоматической обработки.

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

Эта модель реализует редактирование изображение-в-изображение: на входе обязательно требуется изображение товара, генерация изображения только по тексту не поддерживается; на выходе — статичное изображение, видео и 3D-контент не создаются. Модель ориентирована на композитинг сцен для товаров электронной коммерции, генерация произвольных креативных изображений не является её целевым назначением. Коммерческое использование должно соответствовать применимым условиям лицензирования и требованиям законодательства. Если нужно создать креативное изображение с нуля или выполнить редактирование, не связанное с товарами, следует выбрать модель универсальной генерации изображений.

Новости

Смотреть changelog →

Новая модель Новая модель bria-product-shot для создания сцен с товаром Oct 20, 2026

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

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

Можно ли использовать описание сцены и референсное изображение сцены вместе?

Нет, выберите что-то одно. При написании описания сцены на английском (prompt) не передавайте референсное изображение; при генерации по референсному изображению не пишите описание. При переключении в Playground содержимое другого варианта автоматически очищается.
Нужно ли описывать сценарий на английском?

Да. Описывайте новый сценарий или контекст в prompt на английском языке, не более 1000 символов; если Playground обнаружит китайский текст, он предложит переписать.
Что такое оптимизация описания?

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

Предустановленное положение (manual_placement, по умолчанию; подходит описание сцены или референсное изображение) размещает товар в заданной позиции на холсте, по умолчанию по центру внизу; при квадратном входе фактический вывод — 1024×1024. Сохранение исходного положения (original) использует положение и масштаб товара из исходного изображения.

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

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Обязательно

Текущее фиксированное значение: bria-product-shot

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

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

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

Объект бизнес-параметров для bria-product-shot и маршрута default — см. таблицу параметров ниже.

fastbooleanНеобязательноПо умолчанию: true

Faster generation; turn off for the standard model.

promptstringНеобязательноminLength 1maxLength 1000

English description of the new scene or background. Use either prompt or reference_image_url, not both.

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

Public URL of the product photo (JPEG, PNG or WEBP, up to 12 MB).

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

manual_placement puts the product at a preset position (with a scene description or a scene reference; measured 1024×1024 for square input); original keeps its position and the input size.

Варианты:manual_placementoriginal

original_qualitybooleanНеобязательноПо умолчанию: false

Keep the input size instead of scaling to about 1 MP. Applies to original only.

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

Image whose scene or background style to follow. Use either prompt or reference_image_url, not both.

optimize_descriptionbooleanНеобязательноПо умолчанию: true

Expand the scene description automatically. Applies to prompt only.

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

Preset product position. Applies to manual_placement only.

Варианты:bottom_centerupper_leftupper_rightbottom_leftbottom_rightright_centerleft_centerupper_center

Показать все (2)

center_verticalcenter_horizontal

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": "bria-product-shot",
  "input": {
    "fast": true,
    "image_url": "…",
    "placement_type": "manual_placement",
    "original_quality": false,
    "optimize_description": true,
    "manual_placement_selection": "bottom_center"
  }
}'

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: "bria-product-shot",
    input: {
      "fast": true,
      "image_url": "…",
      "placement_type": "manual_placement",
      "original_quality": false,
      "optimize_description": true,
      "manual_placement_selection": "bottom_center"
    }
  }),
});
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": "bria-product-shot",
        "input": {
          "fast": True,
          "image_url": "…",
          "placement_type": "manual_placement",
          "original_quality": False,
          "optimize_description": True,
          "manual_placement_selection": "bottom_center"
        }
    },
)
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"
    }
  }
}