Введение
Что делает этот эндпоинт
Запускает одну модель Topaz Labs на одном фото. Пресеты шумоподавления убирают зерно, шум высокого ISO и крапинки сжатия; пресеты резкости исправляют мягкий фокус, шевелёнку и размытие объектива. Ширина и высота результата совпадают со входом.
Важные параметры
image_url принимает JPEG, PNG или WebP до 24 мегапикселей — загрузкой или публичной ссылкой. preset выбирает модель, по умолчанию denoise_normal. output_format — jpeg (по умолчанию) или png.
Что вы получите
Одно изображение на запрос, выдаваемое из хранилища платформы после завершения асинхронной задачи. Изображения больше 24 мегапикселей отклоняются при отправке с invalid_request.
| Характеристика | Значение |
|---|---|
| Ввод | Изображение |
| Вывод | Изображение |
| Эндпоинт | Редактирование изображения |
| Вход | Один JPEG, PNG или WebP до 24 мегапикселей |
| Пресеты | 3 уровня шумоподавления, 8 моделей резкости |
| Выход | JPEG или PNG в разрешении входа |
| Промпт | Не нужен |
| Оплата | Фиксированная цена за изображение |
Ключевые возможности и особенности
Снимок из бара при свечах: крапинки убраны, лицо не тронуто
Мы покрыли портрет 2048×1152 сильным цветным шумом и пропустили его через Denoise Normal. Крапинки на свитере и тёмных винных полках исчезли, а глаза, серьга-кольцо и огни боке остались на месте. Веснушки стали бледнее, чем на чистом оригинале.
Плёночное зерно снято с портрета в кафе
WebP 1024×1536 с мелким серым зерном на коже, волосах и вязаном свитере прошёл через Denoise Strong примерно за 25 секунд. Зерно исчезло, кудри сохранили пряди, а свитер — рисунок вязки; кожа стала чуть глаже.
Sharpen Standard возвращает резкость мягкому лицу
Портрет, который мы размыли намеренно, через 14 секунд снова показал различимые глаза, брови и щетину. Такие детали модель восстанавливает заново, поэтому проверьте результат в полном размере, прежде чем на него полагаться.
Параметры запроса
| Параметр | Обязательно | Описание |
|---|---|---|
image_url | Да | Фото для очистки: JPEG, PNG или WebP загрузкой или публичной ссылкой, не больше 24 мегапикселей (6000×4000 проходит). Изображения крупнее отклоняются при отправке без списания. Не менее 1 символов |
preset | Нет | Какая модель Topaz запускается. |
output_format | Нет | jpeg (по умолчанию) или png. png избавляет от ещё одного сжатия с потерями, но файл получается больше. |
Стоимость
$0.12 / изображение
Каждое готовое изображение стоит одну фиксированную сумму, какой бы из одиннадцати пресетов или из двух форматов вывода вы ни выбрали; неудачный или отклонённый запрос ничего не стоит.
Сценарии использования
Снимки с телефона ночью и в помещении
Фото с высоким ISO с концертов, из ресторанов или тёмной гостиной выходят пятнистыми. Начните с Denoise Normal и переходите на Strong, если в тенях остаются крапинки.
Зерно на изображениях от ИИ
Некоторые модели оставляют мелкое зерно или повторяющуюся текстуру на коже и ровном фоне. Один проход Denoise даёт более чистую основу перед увеличением, кадрированием или печатью.
Почти резкие кадры
Слегка промахнувшийся фокус, небольшая шевелёнка или мягкий объектив. Sharpen Standard справляется с лёгкими случаями, Motion Blur и Lens Blur нацелены именно на эти две проблемы, а Portrait и Wildlife настроены на кожу и шерсть.
Руководство по промптам и практические советы
Проверьте размер
Отправьте JPEG, PNG или WebP до 24 мегапикселей — загрузкой или публичной ссылкой. Файлы крупнее отклоняются при отправке, поэтому сначала уменьшите их.
Выберите один пресет
Пресет denoise_ — когда мешают зерно или крапинки, пресет sharpen_ — когда мешает размытие. Каждый запрос выполняет один пресет; если нужно и то и другое, сначала уберите шум, а затем отправьте результат в Sharpen.
Опросите и сравните
Создайте задачу, опрашивайте её до завершения и скачайте файл из хранилища платформы. Сравните его с исходником при 100% масштабе в районе глаз, волос и мелких текстур.
Введение
Topaz Denoise & Sharpen даёт доступ к двум семействам моделей Topaz Labs через один эндпоинт. Denoise убирает шум и зерно, стараясь сохранить настоящие детали; Sharpen возвращает чёткость, потерянную из-за ошибки фокуса, движения или мягкого объектива. Модель выбирается параметром preset; промпта нет.
Запрос
{
"image_url": "https://example.com/night-shot.jpg",
"preset": "denoise_normal",
"output_format": "jpeg"
}
Пресеты
| preset | Для чего |
|---|---|
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 секунд. Все три вернулись в размере входа.
Ограничения
Вход ограничен 24 мегапикселями (6000×4000 проходит); изображения крупнее отклоняются до любого списания. Denoise и Sharpen — отдельные запросы, поэтому выстраивайте их цепочкой, если снимку нужно и то и другое. Резкость восстанавливает детали заново, так что лица и текст проверяйте в полном размере.
Быстрый старт 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": "topaz/denoise-sharpen/edit",
"input": {
"image_url": "https://example.com/reference.png",
"output_format": "jpeg",
"preset": "denoise_normal"
}
}'
# 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.
