Topaz API
Topaz API в WaveSpeedAI — модели улучшения изображений Topaz Labs в виде REST-эндпоинтов: Sharpen устраняет размытие объектива и движения, Denoise — зерно и шум высокого ISO, Restore — пыль и царапины на старых фото, а Lighting корректирует экспозицию, баланс белого и цвет.
Отправьте JPEG или PNG и получите улучшенное изображение: повысьте резкость мягких и расфокусированных снимков, очистите шумные кадры при слабом освещении, уберите пыль и царапины со сканов отпечатков или исправьте экспозицию и цветовую температуру. Каждый эндпоинт принимает изображение, выбор модели и формат вывода и работает в том же REST-потоке предсказаний, что и все остальные модели WaveSpeedAI.
/filters:quality(82)/examples/f1eed2a7bfe888eb867d726036d8a338/1783683950126693744_2rEOX7gp.webp)
Обзор
О модели Topaz API
Что делает Topaz, какое место занимает в линейке моделей Topaz Labs и почему её выбирают команды.
Topaz — модель ИИ-апскейлинга от Topaz Labs, доступная через REST API WaveSpeedAI. Topaz API в WaveSpeedAI — модели улучшения изображений Topaz Labs в виде REST-эндпоинтов: Sharpen устраняет размытие объектива и движения, Denoise — зерно и шум высокого ISO, Restore — пыль и царапины на старых фото, а Lighting корректирует экспозицию, баланс белого и цвет.
Отправьте JPEG или PNG и получите улучшенное изображение: повысьте резкость мягких и расфокусированных снимков, очистите шумные кадры при слабом освещении, уберите пыль и царапины со сканов отпечатков или исправьте экспозицию и цветовую температуру. Каждый эндпоинт принимает изображение, выбор модели и формат вывода и работает в том же REST-потоке предсказаний, что и все остальные модели WaveSpeedAI.
Семейство Topaz в WaveSpeedAI включает 17 REST-эндпоинтов для сценариев: Video-Tools, Upscale-Video, Upscale-Image, Image-Tools. У каждого варианта свои цены, параметры и примеры результатов — выберите тот, что подходит под ваш тип входных данных и требования продакшена, или вызывайте несколько с одним API-ключом и собирайте многошаговые пайплайны.
Запускайте Topaz с тем же API-ключом, платёжным аккаунтом и лимитами, что и остальные 1000+ ИИ-моделей WaveSpeedAI. Без отдельной регистрации у вендора, без SDK для каждого провайдера, без разных лимитов у каждого поставщика — одна интеграция охватывает всё: от текста в изображение и текста в видео до синтеза аудио, 3D-генерации, апскейлинга и редактирования.
Характеристики
Возможности Topaz API и статус релиза
То, что разработчики ищут перед выбором API: доступность, ожидаемая длина результата, поддержка референсов и текущая рабочая альтернатива.
Эндпоинты
Sharpen, Denoise, Restore, Lighting
Четыре эндпоинта изображений в topaz/image/, каждый отвечает за один вид исправления, поэтому конвейер запускает только те шаги, которые нужны изображению.
Вход
JPEG или PNG
Каждый эндпоинт принимает одно изображение по URL или загрузкой, без необходимости писать промпт.
Выбор модели
Для каждого эндпоинта
Параметр model выбирает вариант: стили резкости для размытия объектива, размытия движения, повторной фокусировки, портретов и дикой природы; шумоподавление Normal, Strong или Extreme; настройка освещения, баланс белого или колоризация.
Форматы вывода
JPEG, PNG
По умолчанию JPEG; задайте output_format равным png, чтобы получить результат без потерь.
Эндпоинты
Все эндпоинты API Topaz
Сейчас в WaveSpeedAI доступно эндпоинтов Topaz: 17 — выберите вариант под ваш сценарий.
Video Deblur
Topaz Video Motion Deblur removes motion blur from fast-moving footage with Topaz Themis. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.
Video Hdr
Topaz Video SDR to HDR converts SDR video to 10-bit HDR with Topaz Hyperion. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.
Video Frame Interpolation
Topaz Video Frame Interpolation raises frame rates and creates smooth slow motion with Topaz Apollo, Chronos and Aion. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.
Video Denoise
Topaz Video Denoise removes noise and grain from video while keeping natural texture. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.
Video Upscale Creative
Topaz Video Upscale Creative creatively upscales AI-generated video with Topaz Astra, inventing new detail. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.
Video Upscale Generative
Topaz Video Upscale Generative restores and upscales real and AI-generated video with Topaz Starlight diffusion models. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.
Video Upscale
Topaz Video Upscale upscales and enhances video up to 4K with Topaz's precision Proteus, Artemis, Gaia, Theia, Iris and Dione models. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.
Image Transparent Upscale
Topaz Transparent Image Upscale upscales transparent PNG images while keeping the alpha channel intact. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.
Image Upscale Creative
Topaz Image Upscale Creative creatively upscales AI-generated images with Topaz Bloom, adding new detail. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.
Image Upscale Generative
Topaz Image Upscale Generative upscales and repairs images with Topaz's generative Wonder, Recover and Redefine models. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.
Image Upscale
Topaz Image Upscale enlarges photos to 2K, 4K or 8K with precise, non-generative Topaz upscaling models. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.
Image Denoise Generative
Topaz Image Denoise Max removes heavy noise and recovers lost detail with the generative Denoise Max model. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.
Image Sharpen Generative
Topaz Image Sharpen Generative rebuilds detail in severely blurred images with generative Super Focus models. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.
/filters:quality(82)/media/images/20260408112327_sqr1uegu.webp)
Image Sharpen
Topaz Image Sharpen sharpens soft, out-of-focus and motion-blurred photos while keeping them natural. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.
/filters:quality(82)/media/images/20260408112312_o76ialis.webp)
Image Restore
Topaz Image Restore cleans dust, scratches and blemishes from scans and old photos. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.
/filters:quality(82)/media/images/20260408112304_igpft99n.webp)
Image Lighting
Topaz Image Lighting fixes exposure and white balance, colorizes black-and-white photos and converts to HDR. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.
/filters:quality(82)/media/images/20260408112318_eykl2kyy.webp)
Image Denoise
Topaz Image Denoise removes grain and high-ISO noise while preserving detail and texture. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.
Примеры
Topaz в деле
Реальные результаты, созданные через API Topaz. Наведите курсор на видео для предпросмотра, нажмите, чтобы открыть в полном размере.
Как использовать
Как использовать API Topaz
Четыре шага от регистрации до готовой генерации. Полные примеры на Python, Node.js и cURL — в разделе API ниже.
- 01
Получите API-ключ
Создайте аккаунт WaveSpeedAI и скопируйте API-ключ на панели управления. Новые аккаунты получают бесплатные стартовые кредиты — их хватит, чтобы несколько десятков раз запустить playground до начала списаний.
- 02
Отправьте предсказание
Отправьте входные данные в формате JSON методом POST на https://api.wavespeed.ai/api/v3/topaz/image/sharpen. Эндпоинт сразу возвращает id предсказания — генерация асинхронная, поэтому соединение не нужно держать открытым на время инференса.
- 03
Опрашивайте до завершения
Выполняйте GET https://api.wavespeed.ai/api/v3/predictions/{request_id}/result. При статусе completed забирайте результат; при failed, cancelled, timeout или deleted остановитесь с ошибкой; при любом другом статусе продолжайте опрос.
- 04
Получите URL результата
Когда статус станет "completed", возьмите URL из data.outputs[0]. Он указывает на созданный файл в CDN WaveSpeedAI — изображение, видео, аудио или 3D-файл, в зависимости от вызванного варианта Topaz.
Сценарии применения
Что можно создать с Topaz
Типичные сценарии, для которых разработчики и авторы используют API Topaz.
Исправление размытия объектива и движения
topaz/image/sharpen возвращает чёткие детали мягким и расфокусированным фото; есть варианты для размытия объектива, размытия движения, повторной фокусировки и естественной резкости.
Портреты и дикая природа
У эндпоинта sharpen есть варианты, настроенные на портреты и на дикую природу, так что лица, шерсть и перья получают детали без ореолов.
Очистка кадров при слабом свете и высоком ISO
topaz/image/denoise убирает зерно и шум высокого ISO, сохраняя детали; уровни Normal, Strong и Extreme подходят для изображений от слегка до сильно испорченных.
Реставрация старых и отсканированных фото
topaz/image/restore убирает пыль, царапины и повреждения со старых отпечатков и сканов плёнки — для семейных архивов и проектов оцифровки.
Коррекция экспозиции, баланса белого и цвета
topaz/image/lighting выравнивает снимки, сделанные при плохом освещении, корректирует цветовую температуру и может добавить естественные цвета чёрно-белым фото.
Пакетная обработка каталогов и пользовательских загрузок
Пропускайте объявления маркетплейсов, фото недвижимости или изображения от пользователей через нужные эндпоинты в автоматическом конвейере — без десктопного ПО и ручного редактирования.
Советы
Советы по написанию запросов для Topaz
Практические советы, как получать лучшие результаты от Topaz, — на основе приёмов, которые работают в продакшен-пайплайнах для моделей апскейлинга.
- 01
Сначала шумоподавление, потом резкость
Если фото одновременно шумное и мягкое, сначала запустите Denoise, затем Sharpen. Повышение резкости шумного изображения усиливает зерно вместе с деталями.
- 02
Подбирайте вариант sharpen под тип размытия
Для расфокусированных снимков берите варианты lens blur или refocus, для дрожания камеры и движущихся объектов — motion blur, а когда в кадре лица или животные — portrait или wildlife.
- 03
Начинайте с самого мягкого уровня
Сначала попробуйте шумоподавление Normal и переходите на Strong или Extreme, только если зерно всё ещё заметно; более сильные настройки сглаживают мелкую текстуру.
- 04
Оставляйте PNG в многошаговых конвейерах
Задавайте output_format равным png, когда результат идёт на следующий шаг, например апскейл или вторую коррекцию, чтобы каждый проход не добавлял JPEG-сжатие.
Цены
Цены на API Topaz
Оплата — за каждый результат. Итоговая стоимость зависит от параметров, заданных в playground каждого варианта (разрешение, длительность, количество результатов, референсы).
| Эндпоинт | Тип | Цена от |
|---|---|---|
| topaz/ | video-tools | $0.10 |
| topaz/ | video-tools | $0.10 |
| topaz/ | video-tools | $0.10 |
| topaz/ | video-tools | $0.10 |
| topaz/ | upscale-video | $0.10 |
| topaz/ | upscale-video | $0.10 |
| topaz/ | upscale-video | $0.10 |
| topaz/ | upscale-image | $0.10 |
| topaz/ | upscale-image | $0.10 |
| topaz/ | upscale-image | $0.10 |
| topaz/ | upscale-image | $0.10 |
| topaz/ | image-tools | $0.10 |
| topaz/ | image-tools | $0.10 |
| topaz/ | image-tools | $0.10 |
| topaz/ | image-tools | $0.10 |
| topaz/ | image-tools | $0.10 |
| topaz/ | image-tools | $0.10 |
API
Вызов API Topaz
Получите API-ключ на wavespeed.ai/accesskey, затем отправьте предсказание через REST. Playground генерирует готовые к вставке примеры для любой комбинации входных данных.
POSThttps://api.wavespeed.ai/api/v3/topaz/image/sharpen
# 1. Submit the prediction.
SUBMIT_RESPONSE=$(curl --silent --show-error --fail-with-body \
-X POST "https://api.wavespeed.ai/api/v3/topaz/image/sharpen" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer $WAVESPEED_API_KEY" \
-d '{
"image": "https://interactive-examples.mdn.mozilla.net/media/cc0-images/painted-hand-298-332.jpg",
"model": "Standard",
"output_format": "jpeg"
}')
TASK=$(printf '%s' "$SUBMIT_RESPONSE" | jq 'if has("data") then .data else . end')
PREDICTION_ID=$(printf '%s' "$TASK" | jq -r '.id')
if [ -z "$PREDICTION_ID" ] || [ "$PREDICTION_ID" = "null" ]; then
printf 'Submission response did not contain a prediction id
' >&2
exit 1
fi
RESULT_URL="https://api.wavespeed.ai/api/v3/predictions/$PREDICTION_ID/result"
# 2. Poll until the prediction finishes.
while true; do
RESPONSE=$(curl --silent --show-error --fail-with-body "$RESULT_URL" \
-H "Authorization: Bearer $WAVESPEED_API_KEY")
RESULT=$(printf '%s' "$RESPONSE" | jq 'if has("data") then .data else . end')
STATUS=$(printf '%s' "$RESULT" | jq -r '.status')
case "$STATUS" in
completed) printf '%s\n' "$RESULT" | jq '.outputs'; break ;;
failed|cancelled|timeout|deleted) printf '%s\n' "$RESULT" | jq . >&2; exit 1 ;;
*) sleep 2 ;;
esac
doneconst submitUrl = "https://api.wavespeed.ai/api/v3/topaz/image/sharpen";
const apiKey = process.env.WAVESPEED_API_KEY;
if (!apiKey) throw new Error('Set WAVESPEED_API_KEY');
async function requestJson(url, options = {}) {
const response = await fetch(url, options);
if (!response.ok) throw new Error(await response.text());
return response.json();
}
// 1. Submit the prediction.
const body = await requestJson(submitUrl, {
method: "POST",
headers: {
"Authorization": `Bearer ${apiKey}`,
"Content-Type": "application/json",
},
body: JSON.stringify({
"image": "https://interactive-examples.mdn.mozilla.net/media/cc0-images/painted-hand-298-332.jpg",
"model": "Standard",
"output_format": "jpeg"
}),
});
const task = body.data ?? body;
const resultUrl = `https://api.wavespeed.ai/api/v3/predictions/${task.id}/result`;
// 2. Poll until the prediction finishes.
while (true) {
const resultBody = await requestJson(resultUrl, {
headers: { "Authorization": `Bearer ${apiKey}` },
});
const result = resultBody.data ?? resultBody;
if (result.status === "completed") {
console.log(result.outputs);
break;
}
if (["failed", "cancelled", "timeout", "deleted"].includes(result.status)) throw new Error(JSON.stringify(result));
await new Promise(resolve => setTimeout(resolve, 2000));
}import json
import os
import time
from urllib.request import Request, urlopen
api_key = os.environ["WAVESPEED_API_KEY"]
headers = {"Authorization": f"Bearer {api_key}", "Content-Type": "application/json"}
payload = {
"image": "https://interactive-examples.mdn.mozilla.net/media/cc0-images/painted-hand-298-332.jpg",
"model": "Standard",
"output_format": "jpeg"
}
def request_json(url, data=None):
request = Request(url, data=data, headers=headers, method="POST" if data else "GET")
with urlopen(request) as response:
return json.load(response)
# 1. Submit the prediction.
body = request_json("https://api.wavespeed.ai/api/v3/topaz/image/sharpen", json.dumps(payload).encode())
task = body.get("data", body)
result_url = f"https://api.wavespeed.ai/api/v3/predictions/{task['id']}/result"
# 2. Poll until the prediction finishes.
while True:
result_body = request_json(result_url)
result = result_body.get("data", result_body)
status = result.get("status")
if status == "completed":
print(result.get("outputs", []))
break
if status in {"failed", "cancelled", "timeout", "deleted"}:
raise RuntimeError(result)
time.sleep(2)Сравнение
Topaz и альтернативы
Когда стоит выбрать Topaz, а не похожие модели в WaveSpeedAI.
Topaz и Topaz Photo AI (desktop)
Topaz Photo AI — десктопное приложение, которое работает на вашем компьютере. Эндпоинты Topaz API работают в облаке и вызываются по REST, что подходит для серверов, пакетных задач и приложений, обрабатывающих изображения своих пользователей.
Topaz и Image Upscaler Collection
Коллекция Image Upscaler нужна для повышения разрешения. Эндпоинты Topaz исправляют само изображение: размытие, шум, повреждения и освещение — и их часто запускают до апскейла или вместе с ним.
Topaz и Self-hosted open-source models
Открытым моделям шумоподавления и реставрации нужны собственные GPU и обслуживание. Эндпоинты Topaz размещены у нас, оплачиваются за изображение и используют один ключ API и один платёжный аккаунт со всеми остальными моделями WaveSpeedAI.
FAQ
Topaz API — часто задаваемые вопросы
Цены, лицензия, интеграция — частые вопросы о запуске Topaz в WaveSpeedAI.
Какие модели Topaz доступны в WaveSpeedAI?
Доступны эндпоинты изображений Topaz: Sharpen, Denoise, Restore и Lighting. Все работающие эндпоинты Topaz перечислены в таблице на этой странице с актуальной ценой.
Нужен ли промпт?
Нет. Отправьте изображение, при желании выберите вариант модели вместо варианта по умолчанию и укажите вывод в JPEG или PNG.
Как оцениваются эндпоинты Topaz?
За изображение, по цене, указанной на странице каждой модели и в таблице цен выше. WaveSpeedAI работает по схеме pay as you go: без подписки, а кредиты не сгорают.
Что такое API Topaz?
Topaz — модель upscaler от Topaz Labs, доступная как REST API в WaveSpeedAI. Topaz API в WaveSpeedAI — модели улучшения изображений Topaz Labs в виде REST-эндпоинтов: Sharpen устраняет размытие объектива и движения, Denoise — зерно и шум высокого ISO, Restore — пыль и царапины на старых фото, а Lighting корректирует экспозицию, баланс белого и цвет. Её можно вызывать программно или попробовать в playground по ссылке выше.
Как вызывать API Topaz?
Создайте аккаунт WaveSpeedAI, скопируйте API-ключ на странице /accesskey и отправьте POST на https://api.wavespeed.ai/api/v3/topaz/image/sharpen с входными данными в JSON. Эндпоинт вернёт id предсказания. Опрашивайте эндпоинт результата примерно раз в 2 секунды, для долгих задач увеличивайте интервал и останавливайтесь на любом финальном статусе. Примеры для продакшена на Python / Node.js / cURL — выше.
Сколько стоит API Topaz?
Topaz стоит от $0.10. Точная стоимость зависит от заданных параметров (разрешение, длительность, количество результатов, референсы). Предпросмотр стоимости рядом с кнопкой «Сгенерировать» в playground показывает точную цену для ваших текущих данных.
Какие варианты Topaz доступны?
В WaveSpeedAI доступно рабочих эндпоинтов Topaz: 17 — topaz/video/deblur, topaz/video/hdr, topaz/video/frame-interpolation, topaz/video/denoise, topaz/video/upscale-creative, topaz/video/upscale-generative, topaz/video/upscale, topaz/image/transparent-upscale, и другие. У каждого варианта своя страница playground и свои цены.
Можно ли использовать результаты Topaz в коммерческих целях?
Права на коммерческое использование определяются лицензией модели Topaz Labs. Большинство моделей Topaz Labs разрешают коммерческое использование результатов; краткое описание лицензии смотрите на странице playground каждой модели, а условия платформы — в Условиях использования WaveSpeedAI.
Зачем использовать Topaz в WaveSpeedAI, а не напрямую?
Один API-ключ и один платёжный аккаунт для Topaz И для 1000+ других ИИ-моделей от разных провайдеров. Без настройки SDK для каждого вендора, без отдельных лимитов, без переписывания интеграционного кода под каждого поставщика. Цены, как правило, на уровне прямого API Topaz Labs или ниже.
Разработчик
О Topaz Labs
Команда, стоящая за Topaz и всей линейкой моделей Topaz Labs в WaveSpeedAI.
Topaz Labs создаёт ПО для улучшения изображений и видео на основе ИИ, которым пользуются фотографы, кинематографисты и студии; компания известна продуктами Gigapixel, Photo AI и Video AI. Её модели сосредоточены на восстановлении реальных деталей: резкость, шумоподавление, реставрация и коррекция освещения. В WaveSpeedAI модели Topaz доступны как REST-эндпоинты с одним ключом API и оплатой pay as you go.
Начните создавать с Topaz в WaveSpeedAI
Бесплатные стартовые кредиты при регистрации. Один API-ключ для 1000+ ИИ-моделей от Topaz Labs и всех остальных провайдеров.
/filters:quality(82)/examples/286559ad86f57a6240b138da36b60f72/1783683968956150943_aga01QGv.webp)
/filters:quality(82)/examples/0dce57b9a07f37936a242097f113443c/1783683972641647743_9sbjtCLV.webp)
/filters:quality(82)/examples/9fb30afa73b645f4b1a46f1db1b68526/1783683975803917626_0qGwk9YN.webp)
/filters:quality(82)/examples/4dfc9fa5d4e12a7bb42324519d201d3d/1783683978615057281_fGsBKT3c.webp)