yandex

IC-Light V2 API

starstarstarstarstar

5/5

IC-Light V2 — нейросеть для изменения освещения на изображениях: переосвещение, направленный свет и адаптация атмосферы сцены.

ID для подключения по API : iclight-v2

Средняя скорость генерации ~ 12.00 сек
Дата выхода: 28/07/2026

Изображения

Генерация по картинке

Смена/расширение фона

Генерация для коммерции

Товарные фото

Редактирование

Ретушь и детали

Стандартная

Запустить через API
SoTA

Стандартная

Запустить через API
SoTA

Выберите язык:

Как работать с IC-Light V2 через API?

Получение API ключа

Для начала получите ваш API ключ в личном кабинете, если ещё не сделали этого.

Это ваш API-ключ с помощью, которого вы можете генерировать. Не сообщайте его никому.

Запрос на выполнение задачи

Теперь необходимо создать задачу на генерацию. Результат вы можете получать по-разному, можно по системе Long-Pooling, либо вы можете задать callback_url и мы отправим вам результат по готовности. Подробнее с тем, как использовать эти способы можете ознакомиться в документации. В данном примере мы рассмотрим способ с получением результата на callback_url.

В этом запросе указаны лишь обязательные параметры, если вам необходимы дополнительные параметры, то можете ознакомится с ними здесь

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

Получение результата

На указанный в первом запросе callback_url придёт следующий ответ.

Ознакомиться с другими способами получения результата можете в документации

Параметры для генерации

callback_urlurl

Это URL, на который будет отправлен ответ от нейросети.

translate_inputboolean

Перевод входных данных.

Значение по умолчанию : true

promptstring

Обязательно

Промпт.

Значение по умолчанию : Флакон духов в вулкане, окруженном лавой

image_urlurl_or_file

Обязательно

Входное изображение.

negative_promptstring

Негативный промпт.

Значение по умолчанию :

mask_image_urlurl_or_file

Маска изменений.

widthinteger

Ширина изображения.

Значение по умолчанию : 1024

heightinteger

Высота изображения.

Значение по умолчанию : 1024

num_inference_stepsinteger

Количество шагов диффузии.

Значение по умолчанию : 28

seedinteger

Случайное зерно для генерации.

initial_latentstring

Направление света.

Значение по умолчанию : None

enable_hr_fixboolean

HR fix.

Значение по умолчанию : false

num_imagesinteger

Количество изображений.

Значение по умолчанию : 1

cfgnumeric

CFG (real).

Значение по умолчанию : 1

lowres_denoisenumeric

Lowres denoise.

Значение по умолчанию : 0.98

highres_denoisenumeric

Highres denoise.

Значение по умолчанию : 0.95

hr_downscalenumeric

HR downscale.

Значение по умолчанию : 0.5

guidance_scalenumeric

Масштаб управления (CFG).

Значение по умолчанию : 5

enable_safety_checkerboolean

Проверка безопасности.

Значение по умолчанию : false

output_formatstring

Формат выходного изображения.

Значение по умолчанию : jpeg