Kie Image Upscaler
kie / image-upscale

Kie Image Upscaler API — это модель KIE hosted, которая масштабирует изображение с коэффициентом 2×, 4× или 8× до 67 мегапикселей или улучшает его в исходном размере, точно сохраняя текст на изображении.

Pricing: KIE Image Upscale: billed per image by total output pixels — 2K (≤4.19 MP, ~2048×2048) 1.5 credits ($0.0075), 4K (≤16.78 MP, ~4096×4096) 4 credits ($0.02), 8K (≤67.11 MP, ~8192×8192) 12 credits ($0.06). 1x same-size enhancement is tiered by input size. High-tier top-ups (+10% bonus) bring it down to ~$0.0068 / $0.0182 / $0.0545 per image.
Input

Click to upload or drag and drop

Supported formats: JPEG, PNG, WEBP, BMP, GIF Maximum file size: 20MB

Image to upscale. JPG / PNG / WEBP / BMP / GIF (first frame), up to 20 MB. Output format follows the input; transparent backgrounds are filled with white.

Multiplies width and height, keeping the aspect ratio. 1x enhances quality at the same size. Output must stay within 67 MP (about 8192×8192) and 16,384 px per side, otherwise the request is rejected.

Output
output typeimage
Generated output
Examples

Explore different use cases and parameter configurations

README

Complete guide to using kie/image-upscale

Kie Image Upscaler API для увеличения изображений с коэффициентами 2×, 4× и 8×

Отправьте одно изображение, выберите коэффициент увеличения и получите ту же картинку, ширина и высота которой умножены ровно на этот коэффициент (до 67 мегапикселей). Текст на изображении сохраняется без искажений и не перерисовывается.
Kie Image Upscaler API для увеличения изображений с коэффициентами 2×, 4× и 8×

Как работает Kie Image Upscaler API

Один запрос принимает одно изображение и возвращает одно увеличенное изображение. Ниже описаны правила работы.
Увеличение с коэффициентом 2×, 4× или 8×
01

Увеличение с коэффициентом 2×, 4× или 8×

Выберите коэффициент увеличения 2, 4 или 8 (по умолчанию — 2). Ширина и высота умножаются на этот коэффициент, поэтому изображение 1024×1024 возвращается в разрешении 2048×2048, 4096×4096 или 8192×8192.
Улучшение качества в исходном размере
02

Улучшение качества в исходном размере

Коэффициент 1 сохраняет размер и только улучшает качество: снижает шум, повышает резкость деталей и сохраняет точность текста без изменения ширины и высоты.
Текст увеличивается, а не переписывается
03

Текст увеличивается, а не переписывается

Модель генеративно достраивает детали, но области с текстом распознаются, точно увеличиваются и возвращаются обратно, чтобы буквы не искажались. Изображения, где текст занимает более 30% кадра, увеличиваются целиком с сохранением соответствия оригиналу.
Точный размер на выходе без обрезки
04

Точный размер на выходе без обрезки

Итоговое разрешение равно исходному размеру, умноженному на коэффициент, с сохранением пропорций и без обрезки — вы всегда знаете финальные размеры до отправки запроса.
До 67 мегапикселей на изображение
05

До 67 мегапикселей на изображение

Общее число пикселей в результате может достигать 67 108 864 (около 8192×8192), а размер каждой стороны — до 16 384 пикселей. Если результат превышает любое из этих ограничений, запрос отклоняется при отправке с ошибкой 422 — задача не создаётся и плата не списывается; выбирайте коэффициент так, чтобы итоговый размер укладывался в оба лимита.
Выходной формат зависит от входного
06

Выходной формат зависит от входного

Для входных файлов JPG возвращается JPG, для WEBP — WEBP, а для всех остальных форматов — PNG. Прозрачные области во входных изображениях PNG или WEBP заливаются белым цветом.
ХарактеристикаKie Image Upscaler
ХостингKIE hosted
Коэффициенты увеличения1 (улучшение в том же размере), 2 (по умолчанию), 4, 8
Входные данныеОдин общедоступный URL для скачивания изображения размером до 20 MB
Входные форматыJPG, PNG, WEBP, HEIC, BMP, GIF (только первый кадр)
Выходной размерИсходная ширина и высота, умноженные на коэффициент, с сохранением пропорций и без обрезки
Максимальный размер на выходеДо 67 108 864 пикселей в сумме и до 16 384 пикселей по стороне
Выходной форматJPG для JPG и WEBP для WEBP; PNG для остальных форматов
ПрозрачностьНе сохраняется: прозрачные области заливаются белым фоном
Изображений в запросе1
Срок хранения результатовСсылки на результаты действуют около 14 дней
Входные данныеКоэффициентВыходные данные
1024×102411024×1024 (1,05 MP)
1024×102422048×2048 (4,19 MP)
1024×102444096×4096 (16,78 MP)
1024×102488192×8192 (67,11 MP)
1646×164623292×3292 (10,84 MP)
1646×164646584×6584 (43,35 MP)
1646×16468Отклонено (173 MP, превышен лимит)
6000×400016000×4000 (24,00 MP)
6000×40002Отклонено (96 MP, превышен лимит)

Как использовать Kie Image Upscaler API

Четыре шага от исходного изображения до сохранённого результата после масштабирования.
  1. 1

    Шаг 1. Разместите изображение по публичному URL

    Разместите изображение по прямой ссылке для скачивания в формате JPG, PNG, WEBP, HEIC, BMP или GIF размером до 20 MB.
  2. 2

    Шаг 2. Выберите коэффициент с учётом ограничений на размер результата

    Умножьте ширину и высоту на 2, 4 или 8 и убедитесь, что результат не превышает 67 мегапикселей и 16 384 пикселя по каждой стороне. Используйте коэффициент 1 для улучшения качества без изменения размера.
  3. 3

    Шаг 3. Отправьте изображение и коэффициент

    Отправьте POST-запрос на https://api.kie.ai/api/v1/jobs/createTask, указав параметр model со значением kie/image-upscale и объект input с параметрами image_url и upscale_factor; добавьте callBackUrl, если хотите получить результат на свой адрес. В ответе вернётся taskId.
  4. 4

    Шаг 4. Скачайте и сохраните результат

    Результат отправляется на ваш callBackUrl, либо вы можете проверить статус задачи через единый эндпоинт запросов. Сохраните увеличенное изображение в собственное хранилище, так как ссылки на результаты перестают действовать примерно через 14 дней.

Возможности применения Kie Image Upscaler API

Крупные фото товаров для баннеров и детального просмотра

Превращайте фотографии товаров, подготовленные по размеру для веба, в более крупные файлы для баннеров и детального просмотра, точно сохраняя текст на этикетках и упаковке.

Скриншоты, слайды и изображения с большим количеством текста

Масштабируйте скриншоты интерфейса, графики и слайды без искажения букв — текстовые области увеличиваются с сохранением исходного начертания.

Увеличенные версии сгенерированных изображений

Масштабируйте изображение 1024×1024, полученное от генеративной модели, до 4096×4096 или 8192×8192 на финальном этапе пайплайна генерации.

Повышение чёткости без изменения размера

Используйте коэффициент 1 для снижения шума и повышения резкости деталей, когда нужен более чистый файл того же размера.

Kie Image Upscaler на Kie.ai

01

Быстрый старт с Kie Image Upscaler API

Отправьте POST-запрос на https://api.kie.ai/api/v1/jobs/createTask с заголовком Authorization: Bearer YOUR_API_KEY, параметром model со значением kie/image-upscale, а также полями input.image_url и input.upscale_factor (1, 2, 4 или 8). Каждое изображение оплачивается один раз по общему числу пикселей на выходе по тарифам 2K, 4K и 8K; актуальные цены указаны в строке Pricing в верхней части страницы.
03

Один ключ для всего маркетплейса Kie.ai

Все модели на маркетплейсе Kie.ai используют единый метод аутентификации: заголовок Authorization: Bearer YOUR_API_KEY с вашим ключом со страницы управления API-ключами на Kie.ai.
04

Без управления графическими процессорами и весами моделей

Kie.ai предоставляет свои модели в виде API: управлять графическими процессорами и весами моделей не нужно.

Часто задаваемые вопросы

Какие коэффициенты масштабирования поддерживает Kie Image Upscaler API?

Он поддерживает коэффициенты 1, 2, 4 и 8, по умолчанию — 2. Коэффициенты 2, 4 и 8 умножают ширину и высоту; коэффициент 1 сохраняет размер и только улучшает качество.

Каков максимальный размер изображения, которое он может создать?

Изображения на выходе могут содержать до 67 108 864 пикселей в сумме (около 8192×8192) и до 16 384 пикселей по любой из сторон. Запросы с большим размером отклоняются при отправке с ошибкой 422 и не тарифицируются, поэтому проверяйте итоговое разрешение перед выбором коэффициента.

Какие форматы изображений можно отправить и в каком формате возвращается результат?

Через API можно передавать файлы JPG, PNG, WEBP, HEIC, BMP или GIF (только первый кадр) размером до 20 MB; при загрузке через Playground на этой странице поддерживаются JPEG, PNG, WEBP, BMP и GIF. Для входного JPG возвращается JPG, для WEBP — WEBP, для всех остальных форматов — PNG.

Сохраняется ли прозрачный фон?

Нет. На выходе прозрачные области из исходных файлов PNG или WEBP заливаются белым цветом.

Изменит ли масштабирование текст на моём изображении?

Нет. Области с текстом распознаются, масштабируются с точным сохранением оригинала и встраиваются обратно, поэтому буквы не перерисовываются. Когда текст занимает более 30% кадра, с точным сохранением оригинала масштабируется всё изображение.

Сколько времени занимает масштабирование?

Время обработки растёт с увеличением выходного размера, поэтому масштабирование изображения с коэффициентом 8× занимает больше времени, чем масштабирование того же изображения с коэффициентом 2×.

Как долго доступны результаты?

Срок действия ссылок на результаты истекает примерно через 14 дней. Скачайте изображение и сохраните его у себя до истечения этого срока.

Как вызвать Kie Image Upscaler API на Kie.ai?

Создайте ключ на странице управления API-ключами на Kie.ai и передайте его в заголовке Authorization: Bearer YOUR_API_KEY. Отправьте POST-запрос на /api/v1/jobs/createTask, указав параметр model со значением kie/image-upscale, а также параметры input.image_url и input.upscale_factor; в ответе вернётся taskId. Уведомления на ваш callBackUrl могут приходить несколько раз, поэтому выполняйте дедупликацию по taskId. Подробнее см. в документации API.