Aumentar a resolução de imagem
Este endpoint pega uma imagem e a reamostra para dimensões maiores em pixels, para quando um arquivo pequeno precisa caber em um layout feito para um maior.
Esta tarefa não está disponível no momento, portanto não pode ser contratada. Nada é cobrado por ela.
Ver a APIÉ uma ampliação comum de boa qualidade, não um upscaler que reconstrói detalhe: não acrescenta informação que não estava no original, então uma foto ampliada fica mais macia do que uma feita naquele tamanho. No momento não está disponível e não aceita trabalhos; a nota abaixo explica o porquê, e o endpoint e o preço aqui mostrados são os que ele usaria se voltar.
O que uma ampliação comum faz e o que não faz
Ampliar uma imagem é reamostrá-la: os pixels existentes se espalham por uma tela maior e os vãos são preenchidos por interpolação. Isso basta para uma imagem pequena alcançar um tamanho exigido, mas a interpolação não acrescenta informação que a origem nunca registrou. As bordas finas ficam mais macias, o texto pequeno borra e a textura se achata quanto maior o fator: uma ampliação 4x mostra isso mais do que uma 2x. Qualquer ferramenta que afirme 'restaurar' detalhe perdido está descrevendo um modelo mais pesado, baseado em GPU, que este endpoint não executa.
Por que esta ferramenta não está disponível agora
Um ampliador que de fato reconstrói detalhe precisa de um modelo neural de superresolução, e esses precisam de uma GPU para rodar a um custo razoável. A plataforma por trás deste endpoint oferece apenas CPU, então a versão honesta desta ferramenta — uma que não prometa mais do que uma reamostragem por CPU pode entregar — ainda está sendo refeita. Até lá o endpoint não aceita trabalhos, e nada é cobrado por uma tarefa que não pode ser executada.
Quando uma ampliação comum ainda é útil
Reamostrar para um tamanho maior tem usos reais mesmo sem detalhe adicional: cumprir as dimensões mínimas em pixels de um modelo, imprimir um gráfico pequeno em um tamanho físico fixo ou padronizar um conjunto misto de imagens em uma única resolução. Em cada caso o valor está na mudança de tamanho, não em uma nitidez nova: o resultado vai parecer o original em maior escala, que para muitas tarefas de layout e impressão é exatamente o que se precisa.
Formatos e como funcionaria
Os formatos rasterizados comuns seriam aceitos na entrada, e você escolheria o formato de saída. Quando a ferramenta voltar, funcionaria de forma assíncrona: envie a imagem e um fator alvo, receba um task_id e obtenha o arquivo ampliado por link assinado assim que estiver pronto — útil quando a ampliação é uma etapa de um trabalho maior, como preparar um catálogo misto a um tamanho mínimo comum.
Casos de uso
Cumprir o tamanho mínimo de um modelo
Um modelo de listagem exige um tamanho mínimo em pixels e uma imagem de origem menor é ampliada para caber, assumindo que o resultado fica mais macio, não mais nítido.
Impressão em tamanho fixo
Um logotipo ou gráfico pequeno é ampliado para as dimensões em pixels que um layout de impressão espera em um tamanho físico definido.
Padronizar um conjunto misto
Um lote de imagens em tamanhos diferentes é reamostrado para uma única resolução comum antes do layout, sem pretender acrescentar detalhe.
Preencher um quadro maior
Um avatar pequeno é ampliado para reaproveitá-lo em um quadro maior nos casos em que um resultado mais macio é aceitável.
Perguntas frequentes
Como eu ampliaria uma imagem pela api?
Esta ferramenta ainda não está disponível. Quando voltar, você faria um POST em /image/upscale com a imagem de origem e um fator alvo, 2x ou 4x, e receberia um task_id junto com a imagem ampliada por webhook ou link assinado.
Qual a diferença entre 2x e 4x?
2x dobra a largura e a altura, 4x as quadruplica. Como uma ampliação comum não pode acrescentar detalhe, quanto maior o fator, mais macio o resultado parece.
Isso deixa uma foto borrada nítida?
Não. Uma ampliação comum reamostra a imagem para um tamanho maior; não recupera detalhe que nunca foi captado, então uma origem borrada ou muito comprimida continua macia: maior, não mais nítida.
Existe um plano gratuito para a api de ampliar imagem?
Não há camada gratuita — camadas gratuitas são abusadas e deixam todo mundo mais lento. O acesso funciona com um saldo pré-pago do ForHosting KIT: recarregue a partir de US$ 10,00 (não expira) e cada solicitação é cobrada pelo preço publicado, então uma chamada sem saldo devolve HTTP 402. Sem assinatura, sem tokens nem créditos inventados, e uma tarefa que falha nunca é cobrada.
Quanto custa ampliar uma imagem?
US$ 0,061 por solicitação mais US$ 0,0041 por imagem, e só as tarefas concluídas são cobradas.
A api de ampliar imagem já está no ar?
Não. Está temporariamente retirada enquanto é refeita para que não prometa um detalhe que uma reamostragem por CPU não pode entregar. O endpoint e o preço aqui mostrados são os que ela usaria se voltar.
Que formatos de imagem eu poderia ampliar?
Os formatos rasterizados comuns seriam aceitos na entrada, e você escolheria o formato de saída para o resultado ampliado.
Eu poderia ampliar um lote grande de imagens de uma vez?
Sim, você combinaria este endpoint com a API de Processamento em Lote para ampliar muitas imagens em uma só chamada, cada uma cotada separadamente.
Para desenvolvedores — acesso via API
Tudo nesta página está disponível via API. Esta seção é para equipes que querem integrar a ferramenta aos próprios sistemas; quem não precisa disso pode simplesmente usar a ferramenta acima.
Endpoint
One authenticated POST creates the task; the result comes back by webhook or a signed link. This capability is currently available through the API, not as an interactive Web tool.
Chame do seu código
curl -X POST https://api.kit.forhosting.com/image/upscale \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"image":"https://example.com/photo.jpg"}'const res = await fetch("https://api.kit.forhosting.com/image/upscale", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"image": "https://example.com/photo.jpg"
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/image/upscale",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"image": "https://example.com/photo.jpg"
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/image/upscale", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"image":"https://example.com/photo.jpg"}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"image":"https://example.com/photo.jpg"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/image/upscale", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)Exemplo de requisição
{
"image": "https://example.com/photo.jpg"
}Exemplo de resposta
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "image.upscale",
"status": "queued",
"_links": {
"result": "/tasks/tsk_…/result"
}
}A API é assíncrona: cada chamada devolve um task_id na hora. Se preferir polling, consulte o status a até 1 requisição por segundo.
Preço
Preço publicado, sem tokens nem créditos escondidos. Tarefa que falha não é cobrada.
Limites
max_mb | 15 |
max_megapixels | 12 |
Erros
| HTTP | Código | O que significa |
|---|---|---|
401 | unauthorized | Token ausente ou inválido. Confira o header Authorization. |
402 | insufficient_balance | Saldo insuficiente para esta tarefa. Faça uma recarga e tente de novo. |
404 | unknown_type | Esse tipo de tarefa não existe. Confira o campo type no catálogo. |
429 | rate_limited | Muitas requisições em pouco tempo. Espere um instante e tente de novo. |
501 | coming_soon | Esta capacidade ainda não está no ar. Em breve ela chega. |