ИИ-ластикО модели Object Eraser
Убирайте лишние предметы с фотографии, назвав их или закрасив маской; освободившееся место заполняется в тон окружающей сцене.
Вызывайте его по имени модели popnow/object-eraser-v1/edit через POST /jobs/createTask, от 5 кредитов за изображение (0,05 $). Новые аккаунты получают 30 бесплатных кредитов, чтобы вы могли сначала попробовать в Playground.
Пока это руководство есть только на английском. →
Параметры запроса
| Параметр | Обязательный | Описание |
|---|---|---|
image_url | Да | Картинка, с которой всё начинается. |
mask_url | Нет | Закрасьте область, которую нужно изменить. |
output_format | Нет | Формат файла результата. png · jpeg · webp · По умолчанию: png |
prompt | Нет | What to remove, in a few plain words with a position when there is more than one, e.g. "the wooden bench on the left". |
Цены
Цены указаны в кредитах, тех же, что вы используете на сайте (1 кредит = $0,01). Сумма резервируется, когда задача принята, и пересчитывается по фактической стоимости после завершения; за неудавшиеся задачи кредиты возвращаются.
| Вариант | Кредиты за изображение | ≈ USD |
|---|---|---|
| Стандарт | 4,5 | 0,045 $ |
Каждая задача округляется вверх до целых кредитов, поэтому один запуск на самом дешёвом уровне стоит 5 кредитов за изображение (0,05 $).
Чтобы узнать точную сумму до запуска, отправьте то же тело запроса на POST /jobs/quote.
Быстрый старт API
Вызов API Object Eraser в три шага
- Создайте API-ключ. Войдите в PopNow и создайте ключ в консоли API. Ключи начинаются с sk-popnow- и списывают те же кредиты, что и сайт.
- Отправьте запрос. Отправьте POST /jobs/createTask с model popnow/object-eraser-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/object-eraser-v1/edit",
"input": {
"prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette",
"image_url": "https://media.popnow.ai/influencer/examples/marco.webp",
"output_format": "png"
}
}'
# 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 Object Eraser
Сколько стоит API Object Eraser?
Object Eraser стоит 5 кредитов (0,05 $) за изображение. Кредиты те же, что и на сайте (1 кредит = 0,01 $), новые аккаунты получают 30 бесплатных кредитов, а за неудачные задачи кредиты возвращаются.
Какое имя модели у Object Eraser в API?
Укажите popnow/object-eraser-v1/edit — ИИ-ластик в поле model запроса POST /jobs/createTask.
Нужна ли маска?
Не всегда. Для отчетливого предмета со свободным местом вокруг хватает короткого описания: в наших тестах деревянный ковш исчез по одному лишь тексту. А вот тонкие предметы и то, что стоит у края кадра, часто пропускаются, и фото возвращается без изменений: высокая стойка у края кадра осталась на месте при двух разных формулировках и исчезла с первой попытки, когда мы добавили маску. Отправляйте mask_url, если описание не срабатывает или нужно убрать только один из двух похожих предметов.
Что будет, если описание ничему не соответствует?
Вы получите фото без изменений, а запрос будет считаться выполненным. Называйте то, что действительно есть на изображении, и добавляйте положение, если таких объектов несколько.
Какой должна быть маска?
Того же размера, что и фото, белой поверх того, что должно исчезнуть, и черной везде остальное. Закрашивайте чуть шире края предмета, чтобы ушли и контур, и тень.
Можно ли поставить что-то новое на освободившееся место?
Нет. Инструмент удаляет и заполняет место подходящим окружением.
Какие ограничения у API Object Eraser?
Длина промпта (символов): 1,000. Запросы за пределами этих ограничений отклоняются до любого списания.
Можно попробовать Object Eraser без кода?
Да. Playground запускает Object Eraser на ваших кредитах PopNow без API-ключа и показывает код для каждой генерации.