О модели Shadow Remover
Убирает резкие тени с лиц и товаров в один клик.
Вызывайте его по имени модели popnow/shadow-remover-v1/edit через POST /jobs/createTask, от 30 кредитов за изображение (0,03 $).
Пока это руководство есть только на английском. →
Параметры запроса
| Параметр | Обязательный | Описание |
|---|---|---|
aspect_ratio | Нет | Форма кадра: широкая, квадратная или вертикальная. 1:1 · 16:9 · 9:16 · 4:3 · 3:4 · 3:2 · 2:3 · 21:9 · 9:21 |
image_url | Да | Картинка, с которой всё начинается. |
output_format | Нет | Формат файла результата. jpeg · png · webp · По умолчанию: jpeg |
seed | Нет | Одно и то же число даёт повторяемый результат. ≥ 0 · ≤ 2147483647 |
Цены
Цены указаны в кредитах, тех же, что вы используете на сайте (1 кредит = $0,001). Сумма резервируется, когда задача принята, и пересчитывается по фактической стоимости после завершения; за неудавшиеся задачи кредиты возвращаются.
| Вариант | Кредиты за изображение | ≈ USD |
|---|---|---|
| Стандарт | 30 | 0,03 $ |
Чтобы узнать точную сумму до запуска, отправьте то же тело запроса на POST /jobs/quote.
Быстрый старт API
Вызов API Shadow Remover в три шага
- Создайте API-ключ. Войдите в PopNow и создайте ключ в консоли API. Ключи начинаются с sk-popnow- и списывают те же кредиты, что и сайт.
- Отправьте запрос. Отправьте POST /jobs/createTask с model popnow/shadow-remover-v1/edit и объектом input по таблице параметров. В ответе сразу придёт ID задачи.
- Получите результат. Опрашивайте GET /jobs/recordInfo по ID задачи или передайте callBackUrl — мы отправим результат туда. Когда задача выполнится, скачайте файлы по ссылкам.
# 1. Create the task. Keep the Idempotency-Key if you retry after a network error.
export IDEMPOTENCY_KEY="$(uuidgen)"
curl -X POST https://api.popnow.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $POPNOW_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $IDEMPOTENCY_KEY" \
-d '{
"model": "popnow/shadow-remover-v1/edit",
"input": {
"image_url": "https://media.popnow.ai/influencer/examples/marco.webp",
"output_format": "jpeg"
}
}'
# 2. Copy data.taskId from the response, then poll until state is succeeded, failed, canceled or expired.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $POPNOW_API_KEY"Замените промпт и ссылки на свои. Справка по ответу, опросу статуса и callback есть на вкладке API.
Вопросы об API Shadow Remover
Сколько стоит API Shadow Remover?
Shadow Remover стоит 30 кредитов (0,03 $) за изображение. Кредиты те же, что и на сайте (1 кредит = 0,001 $), а за неудачные задачи кредиты возвращаются.
Какое имя модели у Shadow Remover в API?
Укажите popnow/shadow-remover-v1/edit — Удаление теней в поле model запроса POST /jobs/createTask.
Нужно ли писать промпт?
Нет. Инструкция фиксирована: убрать свет и тени и перевести фото в мягкий ровный свет. Вы отправляете только фото.
Какие тени он убирает?
В наших тестах он убрал тени от пальмовых листьев на лице и рубашке, полосы жалюзи на женщине и стене за ней, узор кружевной занавески на ногах и каменных ступенях и сетку пергола на лице и руках мужчины. Каждый раз получалось равномерно освещённое фото той же сцены.
Это лучше обычного редактора изображений?
Для этой задачи — да. При том же фото, инструкции и seed базовая модель редактирования без LoRA для удаления теней не тронула тени от листьев; с LoRA они исчезли.
Изменится ли человек?
Поза, одежда, причёска и фон сохраняются. Лицо перерисовывается при смене света, поэтому возможны небольшие отличия; сравните результат с оригиналом.
Какие ограничения у API Shadow Remover?
Соотношения сторон: 1:1 · 16:9 · 9:16 · 4:3 · 3:4 · 3:2 +3; Максимальный размер загрузки: 10 MB. Запросы за пределами этих ограничений отклоняются до любого списания.
Можно попробовать Shadow Remover без кода?
Да. Playground запускает Shadow Remover на ваших кредитах PopNow без API-ключа и показывает код для каждой генерации.