API do BigImg
Chame as ferramentas do BigImg a partir do seu próprio código. Obtenha uma chave no seu painel — o uso conta contra as imagens gratuitas mensais, créditos ou plano dessa conta. Não há um nível gratuito exclusivo para a API.
Autenticação
Envie sua chave como token bearer em cada requisição:
Authorization: Bearer bigimg_live_...
Ampliar uma imagem
POST https://bigimg.ai/api/v1/upscale
| Campo | Tipo | Descrição |
|---|---|---|
imageUrl | string (obrigatório) | URL publicamente acessível da imagem de origem |
scale | number | 2, 4, 8 ou 16. Padrão 2. 8/16 exigem plano pago ou créditos. |
imageType | string | "photo" ou "anime". Padrão "photo". |
denoise | string | "none" | "low" | "mid" | "high" | "max". Padrão "max". |
Exemplo
curl https://bigimg.ai/api/v1/upscale \
-H "Authorization: Bearer bigimg_live_..." \
-H "Content-Type: application/json" \
-d '{
"imageUrl": "https://example.com/photo.jpg",
"scale": 4
}'Resposta
{
"url": "https://replicate.delivery/.../output.png",
"resizedTo": null,
"via": "credit"
}url é um link temporário (expira em cerca de uma hora) — baixe-o ou hospede-o novamente se precisar mantê-lo. via indica de qual cota foi consumido: free_pool, credit, unlimited ou share_bonus.
Erros
| Status | Significado |
|---|---|
| 401 | Chave ausente, inválida ou revogada |
| 400 | Requisição inválida (imageUrl ausente, scale inválido, arquivo grande demais para seu plano) |
| 403 | Recurso exige um plano pago (escala/tamanho de arquivo além do nível gratuito) |
| 429 | Cota esgotada — compre créditos ou assine o Ilimitado |
| 502 / 504 | Erro no modelo ou tempo esgotado — pode tentar novamente sem problema |
Mais ferramentas
Por enquanto só está disponível /api/v1/upscale. Remoção de fundo, remoção de marca d'água, redução de ruído e melhoria vêm a seguir — avise-nos qual você precisa primeiro.