О модели 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 в три шага
- Создайте API-ключ. Войдите в PopNow и создайте ключ в консоли API. Ключи начинаются с sk-popnow-. Вызовы используют отдельный баланс в долларах США.
- Отправьте запрос. Отправьте POST /jobs/createTask с model topaz/denoise-sharpen/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": "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-ключа. Каждый запуск сохраняется в истории разработчика с соответствующим кодом.