Logo

Замена фона

Выделите объект и сгенерируйте совершенно новый, реалистичный фон.

Замена фона

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

Название модели: background-replace

Жизненный цикл: стабильный

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

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

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

Кредиты: от 1 до 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": "background-replace",
           "inputs": {
             "subjectImage": "https://example.com/product.jpg",
             "scenePrompt": "Product sitting on a sandy beach during golden hour",
             "quality": "2k"
           }
         }'

Ответ

Возвращает статус 201 Created с начальным объектом отслеживания. Генерация выполняется асинхронно.

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

Как только status изменится на "succeeded" (путем опроса конечной точки GET), поле output будет содержать массив с URL, указывающим на сгенерированный фон:

{
  "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/bg-replace-123.png"
  ]
}

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

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

subjectImageRequiredstring

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

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

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

scenePromptRequiredstring

Текстовое описание новой фоновой сцены, которую вы хотите сгенерировать за объектом.

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

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

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

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

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

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

Для запросов Developer API стоимость полностью зависит от выбранного уровня quality вывода.

Формула: Стоимость = QualityCredits

Уровень качестваКредитов за изображение
1k (По умолчанию)1
2k3
4k5