Введение
Что делает этот эндпоинт
Он принимает одно изображение и возвращает более крупную и чёткую копию на выбранном уровне размера. Композиция, цвета и объект остаются как при отправке, промпта нет.
Важные входные данные
image_url — изображение, которое нужно увеличить. resolution выбирает уровень: 2k (около 4 мегапикселей), 4k (около 17, по умолчанию) или 8k (около 67). Пропорции сохраняются, а уровень ниже исходника уменьшает изображение. output_format задаёт тип файла: jpeg (по умолчанию), png или webp.
Что вы получите
Одно изображение на запрос; после завершения задачи оно отдаётся из хранилища платформы.
| Характеристика | Значение |
|---|---|
| Ввод | Изображение |
| Вывод | Изображение |
| Эндпоинт | Upscale |
| Вход | Одна ссылка на изображение (JPEG, PNG или WebP) |
| Выход | Одно изображение в JPEG, PNG или WebP |
| Уровни размера | 2K (~4 МП), 4K (~17 МП), 8K (~67 МП) |
| Пропорции | Как у исходника |
| Настройки | Без промпта — только уровень размера и формат файла |
Параметры запроса
| Параметр | Обязательно | Описание |
|---|---|---|
image_url | Да | Прямая ссылка на файл изображения (JPEG, PNG или WebP). Кадрирование и пропорции переносятся без изменений. Не менее 1 символов |
resolution | Нет | 2k (около 4 МП), 4k (около 17 МП, по умолчанию) или 8k (около 67 МП), пропорции сохраняются. Выбирайте уровень выше числа пикселей исходника — меньший уровень уменьшит изображение. |
output_format | Нет | jpeg (по умолчанию) даёт файлы разумного размера — около 8 МБ даже на самом большом уровне в нашем тесте. png без потерь, но в несколько раз тяжелее; webp — посередине. |
Стоимость
$0.012 / изображение
Оплата за каждое итоговое изображение. Уровень размера и формат файла на цену не влияют.
Сценарии использования
ИИ-рендеры в размер для печати
Большинство моделей изображений отдают один-два мегапикселя. 4k или 8k доводят рендер до размера постера или печати без повторной генерации и без риска потерять удачный вариант.
Предметная съёмка и каталоги
Увеличьте предметное фото для зума и страниц товаров с высокой плотностью пикселей, сохранив свет и этикетку ровно такими, как при съёмке.
Маленькие изображения в новых макетах
Доведите миниатюру, фото веб-размера или старый материал до размера, который сегодня нужен главному баннеру или слайду.
Руководство по промптам и практические советы
Проверьте размер исходника
Выбирайте уровень выше текущего числа пикселей — меньший уровень уменьшит изображение. Делайте апскейл последним, после всех правок, чтобы дальнейшим шагам не пришлось обрабатывать тяжёлый файл.
Отправьте
image_urlи resolutionimage_url— это изображение, resolution выбирает 2k, 4k (по умолчанию) или 8k.output_formatдобавляйте, только если нужен png или webp вместо jpeg.Опросите задачу и скачайте
Вызов асинхронный: создайте задачу, опрашивайте её до завершения и заберите файл из хранилища платформы. Jpeg в 8k весит около 8 МБ — заложите время на скачивание.
Введение
Image Upscaler увеличивает одно готовое изображение до уровня 2k, 4k или 8k и попутно делает его чётче. Сама картинка не меняется: композиция, цвета и объект остаются ровно такими, как при отправке. Промпта нет, настраиваются только размер и формат файла.
Запрос
{
"image_url": "https://example.com/product.png",
"resolution": "4k",
"output_format": "jpeg"
}
Обязателен только image_url. По умолчанию resolution равен 4k, а output_format — jpeg.
Как ведут себя уровни
Уровень — это бюджет пикселей, а не фиксированный холст, и пропорции всегда сохраняются. Фото 1024×1536 вернулось в размере 1672×2508 на 2k, 3344×5017 на 4k и 6689×10033 на 8k, каждый раз примерно за 45 секунд. Исходник, который уже больше уровня, уменьшается: изображение 3344×5017, отправленное с 2k, вернулось в размере 1672×2509.
Ход задачи
Вызов асинхронный. Создайте задачу, опрашивайте её до конечного состояния, затем скачайте изображение из хранилища платформы. На запрос возвращается одно изображение.
Советы
- Выбирайте уровень выше числа пикселей исходника.
- Делайте апскейл последним, после всех правок, чтобы дальнейшим шагам не пришлось обрабатывать больший файл.
- Начинайте с самого чистого исходника: артефакты сжатия и размытие тоже увеличиваются.
- Используйте
jpeg, если не нужен вывод без потерь. Наш jpeg в 8k весил около 8 МБ;pngв несколько раз тяжелее.
Быстрый старт 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": "spicyapi/image-upscaler-v1/upscale",
"input": {
"image_url": "https://example.com/reference.png",
"output_format": "jpeg",
"resolution": "4k"
}
}'
# 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.
