Pular para o conteúdo
API · DESENVOLVEDORES
🔌

Integre upscale de imagem na sua aplicação

API REST simples, rápida e segura para ampliar imagens com IA diretamente do seu backend. Disponível para planos Business e Enterprise.

Acesso antecipado

A API está em beta fechado para clientes Business. Para solicitar acesso, entre em contato pelo formulário de contato com o assunto "Acesso API". A documentação abaixo descreve o contrato estável planejado para lançamento público em Q1 2027.

Latência baixa

Processamento médio de 2 a 5 segundos por imagem no fator 2x. Infrastructure otimizada para baixa latência a partir do Brasil.

Seguro e LGPD-compliant

Comunicação via HTTPS/TLS 1.3, autenticação por Bearer token e exclusão automática de imagens após processamento.

REST simples

API RESTful padrão com respostas JSON. Sem schema complexo, sem GraphQL, sem gRPC — simples de integrar em qualquer stack.

SDKs oficiais

SDKs open-source para JavaScript/TypeScript, Python e Go. Comunidade mantém SDKs para PHP, Ruby e C#.

Autenticação

Todas as requisições à API exigem um Bearer token no header Authorization. Os tokens começam com amp_live_ para ambiente de produção e amp_test_ para sandbox.

Gere seus tokens no painel do cliente em app.ampliaai.com.br/api-keys. Nunca compartilhe seus tokens de produção publicamente — em caso de vazamento, revogue imediatamente no painel.

Endpoints disponíveis

POST/v1/upscale

Amplia uma imagem enviada por multipart/form-data. Retorna a URL da imagem processada.

Auth: Bearer token · Rate limit: 100/hora (Business) · 1000/hora (Enterprise)

GET/v1/upscale/{id}

Consulta o status de um processamento assíncrono. Útil para imagens grandes que excedem o timeout síncrono.

Auth: Bearer token · Rate limit: 600/hora

GET/v1/usage

Retorna o consumo atual da conta no ciclo — ampliações realizadas, restantes e limite.

Auth: Bearer token · Rate limit: 60/hora

POST/v1/batch

Envia até 50 imagens por requisição para processamento em lote. Retorna um ID de job para acompanhamento.

Auth: Bearer token · Rate limit: 10/hora

Exemplos de uso

JavaScript / Node.js
// JavaScript / Node.js
import FormData from 'form-data';
import axios from 'axios';

const form = new FormData();
form.append('image', fs.createReadStream('foto.jpg'));
form.append('scale', '4');

const response = await axios.post(
  'https://api.ampliaai.com.br/v1/upscale',
  form,
  {
    headers: {
      ...form.getHeaders(),
      'Authorization': 'Bearer amp_live_abc123xyz',
    },
  }
);

console.log(response.data);
// {
//   "id": "ups_8f3k2...",
//   "status": "completed",
//   "result_url": "https://cdn.ampliaai.com.br/results/...",
//   "scale": 4,
//   "dimensions": { "width": 4096, "height": 4096 },
//   "processing_ms": 3241,
//   "expires_at": "2026-08-08T10:00:00Z"
// }
Python
# Python
import requests

url = 'https://api.ampliaai.com.br/v1/upscale'
headers = {'Authorization': 'Bearer amp_live_abc123xyz'}
files = {'image': open('foto.jpg', 'rb')}
data = {'scale': '4'}

response = requests.post(url, headers=headers, files=files, data=data)
result = response.json()

print(result['result_url'])  # URL da imagem ampliada
cURL
# cURL
curl -X POST https://api.ampliaai.com.br/v1/upscale \
  -H "Authorization: Bearer amp_live_abc123xyz" \
  -F "image=@foto.jpg" \
  -F "scale=4"

Preços da API

Cobrança por uso, sem custo fixo. Incluído no plano Business.

R$ 0,15

por upscale 2x

R$ 0,30

por upscale 4x

R$ 99/mês

plano Business (1.000 ampli/grátis)

Pronto para integrar?

Solicite acesso à API beta ou faça upgrade para o plano Business e comece a ampliar imagens em escala.

Solicitar acesso à APIVer planos