Перейти к содержимому

IC-Light-v2 for Image Relighting

Интеграция

ID модели iclight-v2
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.com/v1/run/iclight-v2?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field",
    "image": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
  }'

# Still "queued" or "running"? Poll with the id from the response:
curl "https://api.doitong.com/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

Этот запрос: ≈0,40 $ 400 API-кредитов · ≈ 42,19 ₽ Запустить на этой странице

Получить API-ключ
Open model Редактирование изображений #relighting#editing

Меняет освещение фотографии и фон в соответствии с текстовым описанием

Open model · Изображение

Здесь появится ваш первый результат

Составьте запрос ниже и выполните его с помощью API-ключа. Результаты копируются в наше хранилище и хранятся навсегда или 7 дней бесплатно.

Сформировать запрос

Элементы управления сгенерированы из схемы модели. Код и цена обновляются при изменении параметров.

•обязательно

Промпт, управляющий генерацией изображения.

•обязательно image_url
Перетащите файл или

URL изображения, освещение которого будет изменено.

image_size

Размеры сгенерированного изображения.

num_images по умолчанию 1

Количество изображений, запрошенных для генерации.

Расширенные negative_prompt · mask_image_url · initial_latent · output_format · background_threshold · num_inference_steps · cfg · lowres_denoise · highres_denoise · hr_downscale · guidance_scale · seed · enable_hr_fix · enable_safety_checker
по умолчанию

Негативный промпт с нежелательным содержимым изображения.

Перетащите файл или

URL маски для изображения кондиционирования ic-light.

initial_latent по умолчанию None

Условия освещения, передаваемые модели.

output_format по умолчанию jpeg

Формат файла итогового изображения.

по умолчанию 0.67

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

по умолчанию 28

Количество выполняемых шагов инференса.

по умолчанию 1

Фактический масштаб classifier-free guidance, применяемый во время генерации.

по умолчанию 0.98

Интенсивность, применяемая на этапе низкого разрешения.

по умолчанию 0.95

Интенсивность, применяемая на этапе высокого разрешения; действует только при enable_hr_fix со значением True.

по умолчанию 0.5
по умолчанию 5

Сила соответствия промпту при выборе изображения, выраженная через CFG (Classifier Free Guidance).

Seed для воспроизводимых изображений: одинаковые промпт и seed дают одинаковое изображение при неизменной версии модели.

POST /run/iclight-v2?wait=20 стоимость → 0,40 $
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.com/v1/run/iclight-v2?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field",
    "image": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
  }'

# Still "queued" or "running"? Poll with the id from the response:
curl "https://api.doitong.com/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

Запустить этот запрос

Ваш ключ хранится в этом браузере: он отправляется только в Doitong API и сохраняется в localStorage только при включении параметра «Запомнить». Получить API-ключ

О IC-Light-v2 for Image Relighting

Принимает исходное изображение (`image_url`) и `prompt` с описанием желаемого освещения и фона. `initial_latent` может задать направление света (Left, Right, Top, Bottom), а необязательный `mask_image_url` управляет результатом. Доступен режим `enable_hr_fix` для прохода в высоком разрешении, от 1 до 4 результатов через `num_images` и вывод в jpeg или png.

Параметры

Передавайте либо каноническое имя, либо исходное имя, но не оба. Канонические имена

ИмяТип По умолчаниюДопустимые значения Описание
promptобязательно
Типstring
Промпт, управляющий генерацией изображения.
negative_promptнеобязательно
Типstring
По умолчанию
Негативный промпт с нежелательным содержимым изображения.
image_urlобязательно image
Типurl · image
URL изображения, освещение которого будет изменено.
mask_image_urlнеобязательно
Типurl · image
URL маски для изображения кондиционирования ic-light.
background_thresholdнеобязательно
Типnumber
По умолчанию0.67
0,01 – 1
Устаревший порог удаления фона, который сейчас не влияет на результаты. Изначально он должен был делать маски резче при больших значениях.
image_sizeнеобязательно
Типobject
square_hdsquareportrait_4_3portrait_16_9landscape_4_3landscape_16_9
Размеры сгенерированного изображения.
num_inference_stepsнеобязательно
Типinteger
По умолчанию28
1 – 50
Количество выполняемых шагов инференса.
seedнеобязательно
Типinteger | null
Seed для воспроизводимых изображений: одинаковые промпт и seed дают одинаковое изображение при неизменной версии модели.
initial_latentнеобязательно
Типenum
По умолчаниюNone
NoneLeftRightTopBottom
Условия освещения, передаваемые модели.
enable_hr_fixнеобязательно
Типboolean
По умолчаниюfalse
Включает HR fix.
num_imagesнеобязательно num_outputs
Типinteger
По умолчанию1
1 – 4
Количество изображений, запрошенных для генерации.
cfgнеобязательно
Типnumber
По умолчанию1
0,01 – 5
Фактический масштаб classifier-free guidance, применяемый во время генерации.
lowres_denoiseнеобязательно
Типnumber
По умолчанию0.98
0,01 – 1
Интенсивность, применяемая на этапе низкого разрешения.
highres_denoiseнеобязательно
Типnumber
По умолчанию0.95
0,01 – 1
Интенсивность, применяемая на этапе высокого разрешения; действует только при enable_hr_fix со значением True.
hr_downscaleнеобязательно
Типnumber
По умолчанию0.5
0,01 – 1
guidance_scaleнеобязательно
Типnumber
По умолчанию5
0 – 20
Сила соответствия промпту при выборе изображения, выраженная через CFG (Classifier Free Guidance).
enable_safety_checkerнеобязательно
Типboolean
По умолчаниюtrue
Переключатель проверки безопасности, отключение которого требует авторизации учётной записи. Без такой авторизации каждый запрос проверяется независимо от настройки; значение true включает проверку.
output_formatнеобязательно
Типenum
По умолчаниюjpeg
jpegpng
Формат файла итогового изображения.
обязательно Каноническое имя, также принимается

Параметры файлов принимают общедоступный https:// URL, data: URI размером до 10 MB или file_url загруженного файла. Файлы

Результат

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "iclight-v2",
  "status": "succeeded",
  "created_at": "2026-10-20T12:00:00Z",
  "started_at": "2026-10-20T12:00:02Z",
  "completed_at": "2026-10-20T12:00:09Z",
  "queue_position": null,
  "cost": {
    "credits": 400,
    "usd": "0.40",
    "charged": 400,
    "refunded": 0
  },
  "input": {
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field",
    "image_url": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
  },
  "output": {
    "images": [
      {
        "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
        "width": 1024,
        "height": 768,
        "content_type": "image/jpeg"
      }
    ],
    "timings": {},
    "seed": 42,
    "has_nsfw_concepts": [
      false
    ],
    "prompt": "string"
  },
  "outputs": [
    {
      "type": "image",
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
      "content_type": "image/jpeg",
      "file_size": 1843200,
      "width": 1024,
      "height": 768,
      "stored": true
    }
  ],
  "error": null,
  "metrics": {
    "inference_seconds": 6.8
  },
  "urls": {
    "self": "https://api.doitong.com/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://api.doitong.com/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t/cancel"
  }
}
Ваши файлы — ваш выборКаждый URL из outputs[].url — это копия в нашем хранилище: она хранится навсегда (оплата за ГБ в месяц) или 7 дней бесплатно — в зависимости от настройки вашего аккаунта или параметра ?storage=.
Одинаковая структура у каждой моделиtype, url, content_type, width, height и duration — одинаково для изображений, видео и аудио. output — собственный объект результата модели.
Поля результата
images
array of object {url, width, height, content_type}Информация о файлах сгенерированных изображений.
timings
object
seed
integerСид генерации изображения, включая случайно выбранное значение, если во входных данных сид не указан; в противном случае повторяет переданное значение.
has_nsfw_concepts
array of booleanПоказывает, присутствуют ли в сгенерированных изображениях концепции NSFW.
prompt
stringПромпт, используемый при генерации изображения.

Для AI-агентов: эта страница в формате Markdown доступна по адресу https://doitong.com/ru/developers/models/iclight-v2.md. Все модели и руководства: https://doitong.com/developers/llms.txt