Введение
Relight меняет свет на фото. Опишите нужный свет, и вы получите те же людей и сцену, освещённые так: окно на закате, синий час, жёсткая верхняя точечная лампа или золотистый контровой свет сзади. Всё остальное в кадре меняться не должно.
Ключевые возможности и особенности
Свет из одного предложения
Укажите источник, направление, цвет и жёсткость. Инструмент запускает Qwen-Image-Edit-2509 с LoRA Relight от dx8152, обученной на парах «до и после» смены света, поэтому она двигает свет и тень, а не перерисовывает картину.
Люди и кадрирование сохраняются
Лица, одежда, поза и композиция не менялись ни в одном тесте; менялись только свет, тени и цветокоррекция, что позволяет использовать переосвещённое фото рядом с оригиналом в одной серии.
Более заметные смены настроения
Белая танцевальная студия стала тёмной комнатой с одним точечным светом, а туманный утренний берег — золотистым закатом с контровым светом.
Параметры запроса
| Параметр | Обязательно | Описание |
|---|---|---|
image_url | Да | Фото для смены света. Публичная HTTPS-ссылка или загрузка, JPEG, PNG или WebP, до 10 МБ. Не менее 1 символов |
prompt | Да | Новый свет, начиная с «Relight the image with ...»: его источник, направление, цвет и жёсткость, например «Relight the image with warm golden sunset light coming through a windo… Не менее 1 символов · Не более 1000 символов |
aspect_ratio | Нет | Необязательный параметр. Оставьте пустым, и результат сохранит форму вашего фото примерно при одном мегапикселе. |
output_format | Нет | По умолчанию JPEG, при необходимости PNG или WebP. На цену не влияет. |
seed | Нет | Укажите то же число, чтобы сравнить два запуска на одном фото. Любое целое число от 0 до 2147483647; оставьте пустым для случайного seed. |
Стоимость
$0.03 / изображение
Оплата за каждое выходное изображение по фиксированной цене. Соотношение сторон и формат вывода цену не меняют, неудавшиеся запросы не оплачиваются.
Сценарии использования
Оживить плоские фото
Добавьте направление и настроение ровно освещённым портретам и предметным снимкам, которые получились вялыми из-за софтбокса или пасмурного дня.
Время суток
Переведите фото локации в синий или золотой час без возвращения на место, например соляное плато в синем часе с включёнными фарами грузовика.
Единый свет для серии
Приведите снимки, сделанные при разном освещении, к одному стилю для кампании, лукбука или карусели.
Руководство по промптам и практические советы
Начинайте с «Relight the image with»
Затем назовите источник света и откуда он падает. Конкретика лучше расплывчатости: «a single hard spotlight from directly above» работает лучше, чем «dramatic».
Сначала уберите старые тени
Если на фото уже есть жёсткие тени, сначала запустите Shadow Remover, а затем смените свет на чистом результате.
Для мотивированного света ждите реквизита
Просьба о свете из окна может добавить окно в сцену. Если новые предметы не нужны, описывайте только свет («warm light from the left»).
Меняйте одно за раз
Запрашивайте одну схему освещения за запуск. Если результат близок к нужному, сохраните seed и меняйте в промпте только цвет или направление, чтобы сравнить две версии рядом.
Быстрый старт API
# Generate the idempotency key once; reuse it when retrying after a lost response.
export SPICY_IDEMPOTENCY_KEY="${SPICY_IDEMPOTENCY_KEY:-$(uuidgen)}"
curl -X POST https://api.spicyapi.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $SPICY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $SPICY_IDEMPOTENCY_KEY" \
-d '{
"model": "spicyapi/relight-v1/edit",
"input": {
"image_url": "https://example.com/reference.png",
"output_format": "jpeg",
"prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette"
}
}'
# Copy data.taskId from the response into TASK_ID, then poll the status.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.spicyapi.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $SPICY_API_KEY"
Аутентификация, полная схема, опрос статуса и обработка ошибок описаны в справочнике API.
