Kie Image Upscaler
kie / image-upscale

A Kie Image Upscaler API é um modelo KIE hosted que amplia uma imagem em 2×, 4× ou 8× até 67 megapixels, ou melhora sua qualidade no tamanho original, mantendo fiel o texto presente na imagem.

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 para ampliação de 2×, 4× e 8×

Envie uma imagem, escolha um fator de ampliação e receba a mesma imagem com a largura e a altura multiplicadas exatamente por esse fator, até 67 megapixels. O texto na imagem é preservado fielmente, em vez de ser redesenhado.
Kie Image Upscaler API para ampliação de 2×, 4× e 8×

O que a Kie Image Upscaler API faz

Uma requisição recebe uma imagem e retorna uma imagem ampliada. Estas são as regras que ela segue.
Amplie em 2×, 4× ou 8×
01

Amplie em 2×, 4× ou 8×

Escolha um fator de ampliação de 2, 4 ou 8, com 2 como padrão. A largura e a altura são multiplicadas pelo fator, então uma imagem de 1024×1024 é retornada em 2048×2048, 4096×4096 ou 8192×8192.
Melhore a qualidade no tamanho original
02

Melhore a qualidade no tamanho original

O fator 1 mantém o tamanho e apenas melhora a qualidade: reduz o ruído, aumenta a nitidez dos detalhes e preserva o texto fielmente, sem alterar a largura ou a altura.
O texto é ampliado, não reescrito
03

O texto é ampliado, não reescrito

O modelo adiciona detalhes de forma generativa, mas as regiões de texto são detectadas, ampliadas fielmente e reintegradas à imagem, para que as letras não sejam reescritas. Imagens em que o texto ocupa mais de 30% do quadro são ampliadas fielmente como um todo.
Tamanho exato de saída, sem cortes
04

Tamanho exato de saída, sem cortes

O tamanho de saída é exatamente o tamanho de entrada multiplicado pelo fator, com a proporção original e sem cortes, para que você sempre saiba as dimensões finais antes de enviar a requisição.
Até 67 megapixels por imagem
05

Até 67 megapixels por imagem

As saídas podem atingir 67.108.864 pixels, cerca de 8192×8192, com cada lado medindo até 16.384 pixels. Uma solicitação cuja saída ultrapasse qualquer um desses limites é rejeitada com um erro 422 no envio, portanto nenhuma tarefa é criada e nada é cobrado; escolha um fator que mantenha a saída dentro de ambos.
O formato de saída segue o de entrada
06

O formato de saída segue o de entrada

A entrada em JPG retorna JPG e em WEBP retorna WEBP; todos os outros formatos retornam PNG. Áreas transparentes em entradas PNG ou WEBP são preenchidas com branco.
EspecificaçãoKie Image Upscaler
HospedagemKIE hosted
Fatores de ampliação1 (melhora a qualidade no mesmo tamanho), 2 (padrão), 4, 8
EntradaUma URL de imagem disponível publicamente para download, com até 20 MB
Formatos de entradaJPG, PNG, WEBP, HEIC, BMP, GIF (apenas o primeiro quadro)
Tamanho de saídaLargura e altura de entrada multiplicadas pelo fator, proporção mantida, sem cortes
Limite de saídaAté 67.108.864 pixels no total e 16.384 pixels por lado
Formato de saídaJPG para entrada JPG e WEBP para entrada WEBP; PNG para todos os outros formatos
TransparênciaNão preservada: as áreas transparentes são mescladas sobre um fundo branco
Imagens por requisição1
Retenção dos resultadosOs links dos resultados expiram após cerca de 14 dias
EntradaFatorSaída
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×16468Rejeitado (173 MP, acima do limite)
6000×400016000×4000 (24,00 MP)
6000×40002Rejeitado (96 MP, acima do limite)

Como usar a Kie Image Upscaler API

Quatro etapas levam você da imagem original ao resultado ampliado e armazenado.
  1. 1

    Etapa 1: Hospede sua imagem em uma URL pública

    Disponibilize a imagem em uma URL que permita baixá-la diretamente, em JPG, PNG, WEBP, HEIC, BMP ou GIF, com até 20 MB.
  2. 2

    Etapa 2: Escolha um fator dentro dos limites de saída

    Multiplique a largura e a altura por 2, 4 ou 8 e verifique se o resultado fica dentro dos limites de 67 megapixels e 16.384 pixels por lado. Use o fator 1 para melhorar a imagem sem redimensioná-la.
  3. 3

    Etapa 3: Envie a imagem e o fator

    Envie uma solicitação POST para https://api.kie.ai/api/v1/jobs/createTask com model definido como kie/image-upscale e um objeto input contendo image_url e upscale_factor; adicione uma callBackUrl se desejar receber o resultado. A resposta retorna um taskId.
  4. 4

    Etapa 4: Baixe e armazene o resultado

    O resultado é enviado para sua callBackUrl, ou você pode verificar o status da tarefa no endpoint de consulta unificado. Copie a imagem ampliada para seu próprio armazenamento, já que os links dos resultados expiram após cerca de 14 dias.

O que você pode fazer com a Kie Image Upscaler API

Fotos de produtos maiores para banners e zoom

Transforme fotos de produtos dimensionadas para a web em arquivos maiores para banners e visualizações com zoom, com rótulos e textos das embalagens ampliados fielmente.

Capturas de tela, slides e imagens com muito texto

Amplie capturas de tela de interfaces, gráficos e slides sem redesenhar as letras, pois as áreas de texto são ampliadas fielmente.

Versões maiores de imagens geradas

Amplie uma imagem 1024×1024 de um modelo de imagem para 4096×4096 ou 8192×8192 como última etapa de um fluxo de geração.

Imagens mais limpas no mesmo tamanho

Use o fator 1 para reduzir o ruído e dar mais nitidez aos detalhes quando precisar de um arquivo mais limpo, mas não maior.

Kie Image Upscaler no Kie.ai

01

Início rápido da Kie Image Upscaler API

Envie uma solicitação POST para https://api.kie.ai/api/v1/jobs/createTask com um cabeçalho Authorization: Bearer YOUR_API_KEY, model definido como kie/image-upscale e input.image_url e input.upscale_factor (1, 2, 4 ou 8). Cada imagem é cobrada uma vez pelo total de pixels de saída nas faixas 2K, 4K e 8K; os preços atuais são exibidos na linha Pricing no topo desta página.
03

Uma chave para todo o mercado do Kie.ai

Todos os modelos no mercado do Kie.ai usam o mesmo método de autenticação: um cabeçalho Authorization: Bearer YOUR_API_KEY com a chave da página de gerenciamento de chaves de API do Kie.ai.
04

Sem GPUs ou pesos de modelos para gerenciar

O Kie.ai oferece seus modelos como API; não há GPUs ou pesos de modelos para gerenciar.

Perguntas frequentes

Quais fatores de ampliação a Kie Image Upscaler API oferece?

Ela oferece os fatores 1, 2, 4 e 8, sendo 2 o padrão. Os fatores 2, 4 e 8 multiplicam a largura e a altura; o fator 1 mantém o tamanho e apenas melhora a qualidade.

Qual é a maior imagem que ela pode produzir?

As saídas podem atingir 67.108.864 pixels no total, cerca de 8192×8192, e 16.384 pixels em qualquer um dos lados. Solicitações maiores são rejeitadas no envio com um erro 422 e não são cobradas, portanto verifique o tamanho da saída antes de escolher um fator.

Quais formatos de imagem posso enviar e em qual formato recebo o resultado?

Por meio da API, você pode enviar JPG, PNG, WEBP, HEIC, BMP ou GIF (apenas o primeiro quadro) de até 20 MB; o upload do Playground nesta página lista JPEG, PNG, WEBP, BMP e GIF. A entrada em JPG retorna JPG e em WEBP retorna WEBP; todos os outros retornam PNG.

Ela mantém os fundos transparentes?

Não. Áreas transparentes em entradas PNG ou WEBP são preenchidas com branco na saída.

A ampliação vai alterar o texto da minha imagem?

Não. As áreas de texto são detectadas e ampliadas fielmente, depois reinseridas na imagem, para que as letras não sejam reescritas. Quando o texto ocupa mais de 30% do quadro, a imagem inteira é ampliada fielmente.

Quanto tempo leva uma ampliação?

O tempo de processamento aumenta com o tamanho da imagem gerada, então ampliar uma imagem em 8× leva mais tempo do que ampliá-la em 2×.

Por quanto tempo os resultados ficam disponíveis?

Os links dos resultados expiram após cerca de 14 dias. Baixe a imagem e armazene-a por conta própria antes disso.

Como faço para chamar a Kie Image Upscaler API no Kie.ai?

Crie uma chave na página de gerenciamento de chaves de API do Kie.ai e envie-a em um cabeçalho Authorization: Bearer YOUR_API_KEY. Envie uma solicitação POST para /api/v1/jobs/createTask com model definido como kie/image-upscale e input.image_url e input.upscale_factor; a resposta retorna um taskId. Retornos de chamada para a sua callBackUrl podem chegar mais de uma vez, portanto elimine duplicatas pelo taskId. Consulte a documentação da API.