Пока это руководство есть только на английском. →
Параметры запроса
| Параметр | Обязательный | Описание |
|---|---|---|
image_url | Да | Картинка, с которой всё начинается. |
output_format | Нет | Формат файла результата. jpeg · png · webp · По умолчанию: jpeg |
resolution | Нет | Размер результата. Больше — чётче и дороже. 2k · 4k · 8k · По умолчанию: 4k |
Цены
Цены указаны в кредитах, тех же, что вы используете на сайте (1 кредит = $0,01). Сумма резервируется, когда задача принята, и пересчитывается по фактической стоимости после завершения; за неудавшиеся задачи кредиты возвращаются.
| Вариант | Кредиты за изображение | ≈ USD |
|---|---|---|
| Стандарт | 1,8 | 0,018 $ |
Каждая задача округляется вверх до целых кредитов, поэтому один запуск на самом дешёвом уровне стоит 2 кредита за изображение (0,02 $).
Чтобы узнать точную сумму до запуска, отправьте то же тело запроса на POST /jobs/quote.
Быстрый старт API
Вызов API Image Upscaler в три шага
- Создайте API-ключ. Войдите в PopNow и создайте ключ в консоли API. Ключи начинаются с sk-popnow- и списывают те же кредиты, что и сайт.
- Отправьте запрос. Отправьте POST /jobs/createTask с model popnow/image-upscaler-v1/upscale и объектом 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/image-upscaler-v1/upscale",
"input": {
"image_url": "https://media.popnow.ai/influencer/examples/marco.webp",
"resolution": "4k",
"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 Image Upscaler
Сколько стоит API Image Upscaler?
Image Upscaler стоит 2 кредита (0,02 $) за изображение. Кредиты те же, что и на сайте (1 кредит = 0,01 $), новые аккаунты получают 30 бесплатных кредитов, а за неудачные задачи кредиты возвращаются.
Какое имя модели у Image Upscaler в API?
Укажите popnow/image-upscaler-v1/upscale — Улучшить картинку в поле model запроса POST /jobs/createTask.
Что означают 2k, 4k и 8k?
Это бюджет пикселей, а не фиксированный холст: изображение сохраняет пропорции и приводится примерно к 4, 17 или 67 мегапикселям. Фото 1024×1536 вернулось в размерах 1672×2508, 3344×5017 и 6689×10033.
Может ли изображение стать меньше?
Да, если уровень ниже исходника. Изображение 3344×5017, отправленное с 2k, вернулось в размере 1672×2509. Выбирайте уровень выше текущего числа пикселей.
Меняется ли содержимое картинки?
Нет. Композиция, цвета и объект остаются такими, как вы отправили; края и фактуры становятся чётче, мелкие детали дорисовываются. Чтобы изменить содержимое, сначала используйте модель редактирования, а апскейл делайте последним.
Какой формат вывода выбрать?
jpeg, формат по умолчанию, даёт файлы разумного размера: наш тест в 8k весил около 8 МБ. png без потерь, но в несколько раз тяжелее — png в 4k обычного фото уже около 16 МБ. webp — где-то посередине.
Можно ли спасти мелкий текст или размытое лицо?
Лишь отчасти. Чётче становится то, что есть в исходнике; детали, которых там никогда не было, дорисовываются, поэтому нечитаемые буквы могут вернуться правдоподобными формами, а не исходными словами. Начинайте с самой чистой версии, какая у вас есть.
Какие ограничения у API Image Upscaler?
Разрешения: 2K · 4K · 8K. Запросы за пределами этих ограничений отклоняются до любого списания.
Можно попробовать Image Upscaler без кода?
Да. Playground запускает Image Upscaler на ваших кредитах PopNow без API-ключа и показывает код для каждой генерации.