API para aumentar resolução de imagem sem cadastro: o código de créditos é a chave

Cadastro de API tradicional versus um código de créditos como token

O caminho normal para usar uma API de imagem com IA tem cinco etapas antes da primeira chamada: criar conta com e-mail e senha, confirmar o e-mail, gerar uma chave de desenvolvedor no painel, cadastrar um cartão de crédito e escolher um plano, quase sempre mensal, com uma cota de chamadas que zera no fim do mês. Para quem só precisa ampliar duzentas fotos de um catálogo ou tirar o fundo das imagens de um lote, isso é uma tarde de burocracia para dez minutos de trabalho.

Na Airpic esse fluxo não existe porque não existem contas. A sequência inteira é:

1. Comprar um pacote de créditos na página de preços. Não pedimos e-mail nem senha para usar o serviço; o checkout cobra em euros com IVA incluído e entrega o recibo no ato.
2. Receber um código no formato 0TK seguido de letras e números. Esse código é o pacote: ele guarda os créditos, não uma conta.
3. Usar esse mesmo código no cabeçalho Authorization, como Bearer, na chamada de download. Pronto: isso é a chave de API.

Não há diferença entre o código que você usa no navegador e o que usa no servidor. Se comprou um pacote para ampliar fotos pelo site e sobraram créditos, eles servem na API, e vice-versa. O saldo pode ser consultado a qualquer momento por uma chamada pública que recebe o código e devolve quantos créditos restam de cada tipo: padrão, grande formato e vídeo.

Isso tem uma consequência que vale deixar clara desde o início: o código é um token ao portador. Quem o tiver, gasta os créditos. Trate-o como a senha de um banco de dados: fica no servidor, em uma variável de ambiente, nunca dentro de um app distribuído ou de uma página web onde qualquer pessoa consiga ler. Voltamos a isso na seção de limites.

O que dá para chamar: API de upscale de imagem, remover fundo e vídeo com os parâmetros da web

A API não é um produto separado com menos recursos. É a mesma interface que a página usa: cada ferramenta da Airpic é um valor do campo de ferramenta na chamada que cria o trabalho, e as opções são um JSON com os mesmos ajustes que você vê na tela.

Imagem.

• Aumentar resolução (a API de upscale de imagem propriamente dita): fator ×2, ×4, ×8, ×16 ou máximo, até 600 megapixels de saída por mosaico; estilo nitidez ou pictórico; opção de melhorar rostos. O ×2 e o ×4 gastam crédito padrão; ×8, ×16 e máximo gastam crédito de grande formato, exatamente como na página de aumentar a resolução de uma imagem.
• Aumentar anime e ilustração: escala 2 ou 4, com o modelo treinado para traço e cores chapadas. Se a imagem é um desenho, um logo ou uma captura de jogo, chame esta e não a de fotos: o modelo fotográfico inventa textura onde deveria haver uma área lisa.
• Remover fundo: fundo transparente, branco, preto ou qualquer cor em hexadecimal; as bordas são calculadas na resolução completa, cabelo incluído, sem halo. É o mesmo resultado de remover o fundo de uma foto pelo site, sem clicar em nada, e sem cadastro.
• Comprimir: saída JPEG, WebP, AVIF ou PNG, qualidade de 30 a 95, tamanho alvo em KB, lado máximo em pixels e opção de apagar metadados conservando o perfil ICC. Roda em CPU, leva segundos e é a única ferramenta gratuita de ponta a ponta, também na API: o download não gasta crédito.
• Colorir, Remover ruído e Corrigir foto desfocada: cada uma com um parâmetro de intensidade de 0,25 a 1. Colorir escolhe entre natural e vívido; a correção de foco, entre borrão de movimento e desfoque de foco.
• Restaurar fotos antigas: reconstrução de rostos, recolorir opcional e escala 1 ou 2. O limite de entrada é 20 megapixels.
• Remover objetos: a imagem mais um segundo arquivo, a máscara, um PNG do mesmo tamanho com os pixels a apagar pintados em opaco sobre fundo transparente. Na página a máscara é desenhada no editor do navegador; na API você a gera do seu lado.

Vídeo. As três ferramentas de vídeo também estão expostas: transcrever vídeo em texto (idioma automático ou código ISO, opção de tradução para o inglês, ZIP com TXT, SRT, VTT e JSON), vídeo para documento (DOCX, PDF ou Markdown, com resumo curto, médio ou longo e capítulos com tempo) e criar shorts de um vídeo (1 a 5 clipes, duração alvo de 15 a 60 segundos, legenda por palavra). Para arquivos grandes existe o envio por partes: você pede um identificador de upload, envia os pedaços um a um e depois cria o trabalho apontando para esse identificador. Isso evita um único POST de centenas de megabytes que cairia por tempo limite.

Comum a todas as ferramentas de imagem: entrada em JPG, PNG (com alfa e 16 bits), WebP, TIFF, HEIC e AVIF; a orientação EXIF é aplicada e o perfil ICC se conserva; a saída pode ser PNG, JPG ou WebP, com parâmetro de qualidade. Os limites de megapixels por ferramenta são os mesmos da página: 32 MP na maioria, 25 MP na correção de foco, 20 MP na restauração.

Os nomes exatos de cada campo, os valores aceitos e exemplos prontos com curl estão na página de desenvolvedores, em airpic.app/developers/. Não repetimos a referência aqui de propósito: ela muda quando uma ferramenta ganha um ajuste novo, e este artigo ficaria errado.

Como se paga: API de imagem com IA com pagamento por uso, cobrado por download

O modelo de cobrança é o mesmo da página e cabe em três regras.

1. Processar é grátis. Criar o trabalho e consultar o estado não gasta nada. Quando o estado chega a concluído, a resposta traz largura, altura, tamanho em bytes e formato do resultado, mais a URL de uma prévia de até 1600 pixels que você baixa sem crédito. Para um pipeline, isso significa validar o resultado (dimensões certas, prévia aceitável) antes de decidir se paga.
2. Baixar o arquivo completo gasta 1 crédito do tipo certo. Padrão para ×2, ×4, remover fundo, colorir, ruído, nitidez, restaurar e remover objetos; grande formato para ×8, ×16 e máximo; vídeo para transcrever, documento e shorts. O crédito é descontado no primeiro download; baixar o mesmo trabalho de novo (por exemplo, se a conexão caiu no meio) não cobra outra vez. Sem crédito, a resposta é um 402 que diz qual tipo de crédito falta.
3. Os créditos não expiram. Não há mensalidade nem cota que zera. Um pacote comprado em janeiro para um projeto serve em dezembro para outro.

Dois detalhes práticos. Primeiro: o download grátis de um por mês que a página oferece também vale na API, mas é contado por endereço IP, não por código. Um servidor que faz todas as chamadas do mesmo IP tem um download grátis por mês no total, não um por usuário final. Para qualquer uso real você vai precisar de créditos. Segundo: o pacote de impressão em grande formato, o maior da tabela, é o que a documentação apresenta como o pacote com acesso à API, mas qualquer código funciona como token; a diferença entre pacotes é só o tipo e a quantidade de créditos que cada um carrega.

Os valores atuais de cada pacote estão na página de preços; não os escrevemos aqui para não deixar o artigo desatualizado. Se quiser entender a lógica por trás da prévia gratuita e do pagamento só no download, o artigo ver o resultado antes de pagar explica como ela funciona do lado do servidor.

Limites honestos: cota por hora e por IP, teto diário de GPU e partida a frio

Uma API sem cadastro precisa de outros freios, e é melhor você conhecê-los antes de desenhar o pipeline.

• 20 trabalhos por hora por IP. É o limite documentado. Passou disso, a criação do trabalho responde com erro até a janela fechar. A recomendação oficial é manter no máximo 2 trabalhos em andamento ao mesmo tempo, porque os workers de GPU são compartilhados entre todos os usuários. Se o seu volume é maior, o caminho é escrever para a Airpic com o seu código e pedir um limite mais alto; não é automático.
• Teto diário de GPU. Existe um total de segundos de GPU por dia para o serviço inteiro. Se for atingido, novas criações de trabalho recebem uma resposta de serviço indisponível até o dia seguinte, e nada é cobrado. Um pipeline sério deve tratar essa resposta como temporária e repetir mais tarde, em vez de considerar o arquivo perdido.
• Partida a frio. Os modelos não ficam carregados o tempo todo: quando ninguém usa uma ferramenta por alguns minutos, o worker desliga e a próxima chamada paga o arranque. A documentação fala em 60 a 90 segundos a mais na primeira chamada; os trabalhos seguintes, com o worker quente, levam poucos segundos. Nos nossos testes de 19 de setembro de 2026, uma foto de 320 × 240 px ampliada ×4 para 1280 × 960 px saiu em 5 segundos. Em 3 de setembro de 2026, com fotos de 0,3 a 1 megapixel, o ×4 levou entre 6 e 9 segundos e, com a opção de melhorar rostos ativada, cerca de 17 segundos. Um ×16 de uma foto grande pode levar vários minutos, quente ou frio.
• Sem painel de chaves. Não existe tela para rotacionar o código, criar subchaves por projeto ou ver um registro de chamadas. O código é o pacote. Se vazar, quem o tiver gasta o que sobra. A mitigação é simples: um pacote por projeto ou por cliente, guardado só no servidor, para que um vazamento não leve todo o saldo.

Com isso dito, para o que a API não serve: fluxos interativos em tempo real, em que um usuário final clica e espera o resultado na mesma tela. A partida a frio torna impossível prometer resposta em menos de um minuto na primeira chamada depois de um período parado, e o limite por hora não acompanha um site com centenas de visitantes simultâneos. O conselho habitual de colocar a chamada direto no front-end é duplamente errado aqui: expõe o código e não escala. O encaixe natural é o processamento em lote no servidor: catálogo de produtos, acervo de fotos de um arquivo, imagens enviadas por usuários que entram em fila e são publicadas depois.

Sobre a privacidade desse lote: cada arquivo entra em uma GPU na União Europeia, é processado e apagado no máximo uma hora depois do download, ou um dia se você não baixar, e nunca é usado para treinar modelos. O detalhe jurídico está em processamento de imagens na UE e o GDPR, e vale para a API do mesmo jeito que para a página.

Exemplo mínimo em palavras: enviar, consultar, baixar (e testar antes à mão)

Sem código, só a sequência, para você avaliar se encaixa no seu sistema antes de abrir a documentação.

1. Enviar. Um POST multipart para a rota de criação de trabalhos, com três campos: o arquivo, o nome da ferramenta e um JSON de opções. Para aumentar resolução, por exemplo, o JSON diz o fator (×4), o estilo (nitidez) e se quer melhorar rostos. A resposta imediata é um identificador de trabalho. Nada foi cobrado.
2. Consultar. Um GET ao mesmo identificador, a cada 1 ou 2 segundos. Enquanto o worker trabalha, o estado é na fila ou processando. Quando termina, a resposta traz o estado concluído, as dimensões finais, o peso em bytes, a extensão e duas URLs: a da prévia (grátis, até 1600 px) e a do download completo. Se algo falhou, o estado é erro, com a mensagem no idioma que você pediu no campo de idioma, e também não há cobrança.
3. Baixar. Um GET à URL de download com o cabeçalho Authorization: Bearer seguido do seu código 0TK. A primeira vez desconta 1 crédito e devolve o arquivo; sem crédito, 402. Antes de qualquer trabalho, um GET à rota de créditos com o código mostra o saldo por tipo, útil para o pipeline parar de forma controlada quando estiver acabando.

Tratamento de erros que vale implementar desde o primeiro dia: repetir com espera crescente ao receber o limite por hora ou o teto diário; aceitar que a primeira chamada depois de um período parado leve mais de um minuto; e nunca marcar um trabalho como pago até ter o arquivo completo em disco, porque downloads repetidos do mesmo trabalho não custam nada.

Antes de escrever uma linha, teste à mão. A página de cada ferramenta usa exatamente os mesmos parâmetros, com o mesmo resultado, e serve para calibrar o que você vai mandar na API. Para aumentar resolução, o passo a passo é este:

1. Abra a ferramenta de aumentar resolução e arraste uma foto representativa do seu lote: uma foto de produto de 1200 px, por exemplo, não a mais bonita que você tem.
2. No grupo de uso, deixe o padrão se o destino é tela ou web; escolha a opção de impressão em grande formato só se precisa de ×8 ou mais, porque aí o crédito muda para grande formato.
3. Nos ajustes avançados, compare o estilo nitidez (bordas firmes, bom para produto e arquitetura) com o pictórico (preenchimento mais suave, melhor para retrato e paisagem com grão). Esse é o campo de estilo do JSON.
4. Marque melhorar rostos só se há pessoas na foto; em um produto, o passo não faz nada e só acrescenta tempo.
5. Clique em processar e espere a barra. Com a ferramenta quente, um ×4 de uma foto pequena leva poucos segundos; a primeira do dia pode passar de um minuto, e é a mesma espera que a API terá.
6. No resultado, use ver em 100 % e arraste o comparador. Se a textura inventada incomoda (pele plastificada, tecido com padrão repetido), troque o estilo ou baixe o fator e repita, antes de baixar. É aqui que você decide os valores que entram no JSON.
7. Baixe uma vez para confirmar o formato de saída e o peso; esse download gasta o seu crédito grátis do mês ou um crédito do código, igual à API.

Quando o resultado manual estiver do jeito que você quer, os mesmos valores vão para o campo de opções e o resto é automatizar. Comece por aumentar a resolução de uma imagem e, se o lote é de fotos de produto, veja também como comprimir imagens depois de ampliar: essa chamada é gratuita e deixa o arquivo final no peso certo para a loja.

FAQ

Continuar a ler