Topaz Denoise & Sharpen API

от Topaz Labs

Убирает шум или размытие, то же разрешение, до 24 Мп

topaz/denoise-sharpen/edit
  • Шумоподавление

О модели Topaz Denoise & Sharpen

Убирает шум или размытие, то же разрешение, до 24 Мп.

Вызывайте его по имени модели topaz/denoise-sharpen/edit через POST /jobs/createTask, от 0,12 $.

Введение

Topaz Denoise & Sharpen предоставляет через один эндпоинт две линейки моделей Topaz Labs. Denoise убирает шум и зерно, стараясь сохранить настоящие детали; Sharpen возвращает чёткость, утраченную из-за ошибки фокусировки, движения или мягкого объектива. Модель выбирается через preset; промпт не нужен.

Пример запроса

{
  "image_url": "https://example.com/night-shot.jpg",
  "preset": "denoise_normal",
  "output_format": "jpeg"
}

Пресеты

ПресетДля чего
denoise_normalОбычный шум при слабом освещении или от сжатия (по умолчанию)
denoise_strongОчень тёмные или снятые на высоком ISO кадры; сохраняет больше деталей, чем Extreme
denoise_extremeСильно испорченные или сильно сжатые изображения
sharpen_standardЛёгкая мягкость или небольшое дрожание; обычная отправная точка
sharpen_strongСильно промахнувшаяся фокусировка
sharpen_naturalМягкая резкость, сохраняющая органическую текстуру
sharpen_portraitЛица и кожа
sharpen_wildlifeШерсть, перья и другие природные детали
sharpen_refocusМелкие детали на слегка расфокусированном снимке
sharpen_motion_blurРазмытие от движения камеры или объекта
sharpen_lens_blurРасфокусировка и мягкость объектива

Наши тесты

Портрет 2048×1152 при свечах с добавленным сильным цветным шумом после примерно 19 секунд на denoise_normal стал чистым: глаза, серьги и боке-блики сохранились, веснушки стали менее заметны. Кафе-портрет 1024×1536 с мелким зерном, отправленный в WebP, потерял зерно на denoise_strong примерно за 25 секунд, при этом локоны и вязаный узор остались. Намеренно размытый портрет 1100×900 вернул глаза и щетину на sharpen_standard за 14 секунд. Все три изображения вернулись в исходном размере.

Ограничения

Denoise и Sharpen — отдельные запросы, поэтому если изображению нужны обе обработки, вызывайте их по очереди. Sharpen восстанавливает детали, поэтому проверяйте лица и текст в полном размере.

Параметры запроса

ПараметрОбязательныйОписание
image_urlДаКартинка, с которой всё начинается.
output_formatНетФормат файла результата. jpeg · png · По умолчанию: jpeg
presetНетВыберите один из готовых наборов настроек этой модели. denoise_normal · denoise_strong · denoise_extreme · sharpen_standard · sharpen_strong · sharpen_natural · sharpen_portrait · sharpen_wildlife · sharpen_refocus · sharpen_motion_blur · sharpen_lens_blur · По умолчанию: denoise_normal

Цены

Цены указаны в USD. API использует отдельный баланс в долларах США. Кредиты сайта нельзя тратить в API или переводить на баланс API. Перевод с баланса API в кредиты сайта также недоступен. При принятии задачи мы резервируем максимальную сумму расчёта на балансе API. После завершения списываем плату за фактическое использование, не превышая резерв, и освобождаем остаток. Если задача завершается ошибкой, резерв освобождается.

ВариантUSD за изображение
Стандарт0,12 $

До запуска отправьте то же тело запроса в POST /jobs/quote, чтобы узнать ожидаемую и максимальную стоимость в USD. Расчёт не запускает задачу и не списывает деньги.

Быстрый старт API

Вызов API Topaz Denoise & Sharpen в три шага

  1. Создайте API-ключ. Войдите в PopNow и создайте ключ в консоли API. Ключи начинаются с sk-popnow-. Вызовы используют отдельный баланс в долларах США.
  2. Отправьте запрос. Отправьте POST /jobs/createTask с model topaz/denoise-sharpen/edit и объектом input по таблице параметров. В ответе сразу придёт ID задачи.
  3. Получите результат. Опрашивайте 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": "topaz/denoise-sharpen/edit",
  "input": {
    "image_url": "https://media.popnow.ai/influencer/examples/marco.webp",
    "preset": "denoise_normal",
    "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 Topaz Denoise & Sharpen

Сколько стоит API Topaz Denoise & Sharpen?

Topaz Denoise & Sharpen стоит 0,12 $ за изображение. API использует отдельный баланс в долларах США. Кредиты сайта нельзя тратить в API или переводить на баланс API. Перевод с баланса API в кредиты сайта также недоступен. При принятии задачи мы резервируем максимальную сумму расчёта на балансе API. После завершения списываем плату за фактическое использование, не превышая резерв, и освобождаем остаток. Если задача завершается ошибкой, резерв освобождается.

Какое имя модели у Topaz Denoise & Sharpen в API?

Укажите topaz/denoise-sharpen/edit — Шумоподавление в поле model запроса POST /jobs/createTask.

Что выбрать: Normal, Strong или Extreme?

Normal — отправная точка для обычного шума от слабого света или сжатия. Strong рассчитан на очень тёмные снимки с высоким ISO и сохраняет больше деталей, чем Extreme. Extreme предназначен для сильно повреждённых или жёстко сжатых изображений и ставит чистоту выше мелкой текстуры.

Фото становится больше?

Нет. Наш тест 2048×1152 вернулся в 2048×1152, а 1100×900 — в 1100×900. Если нужно ещё и больше пикселей, используйте после этого апскейлер.

Какой пресет резкости подходит для портрета?

sharpen_portrait настроен на кожу и черты лица. Если лицо лишь слегка мягкое, sharpen_standard или sharpen_natural оставят результат ближе к оригиналу; sharpen_strong — для явного промаха фокуса.

Какие ограничения у API Topaz Denoise & Sharpen?

Максимальный размер загрузки: 30 MB. Запросы за пределами этих ограничений отклоняются до любого списания.

Можно попробовать Topaz Denoise & Sharpen без кода?

Запускайте Topaz Denoise & Sharpen в Playground с баланса API в USD без API-ключа. Каждый запуск сохраняется в истории разработчика с соответствующим кодом.

Ещё о Topaz Denoise & Sharpen