Introdução

TiraFundo API

A TiraFundo API é uma REST API simples e poderosa para remover fundos de imagens de forma automática. Integre em qualquer linguagem, em minutos.

⚡
Rápida Média de 0.4s por imagem
🔒
Segura HTTPS + JWT por requisição
📦
Formatos PNG, JPEG, WebP, base64
Base URL https://api.TiraFundo.app/v1
Exemplo rápido 
curl -X POST https://api.TiraFundo.app/v1/remove \
  -H "Authorization: Bearer SEU_TOKEN" \
  -F "image=@produto.jpg" \
  -F "output_format=png" \
  --output resultado.png
Autenticação

Autenticando suas requisições

A API usa tokens Bearer no header Authorization. Obtenha sua chave no dashboard.

⚠️

Nunca exponha sua chave de API no frontend. Use sempre em ambiente servidor.

Header de autenticação 
Authorization: Bearer tf_live_sua_chave_aqui
POST /v1/remove

Remover fundo

Remove o fundo de uma imagem. Aceita upload de arquivo ou URL pública.

Parâmetros do body (form-data)

Parâmetro Tipo Obrigatório Descrição
image file Sim* Arquivo de imagem (PNG, JPG, WEBP)
image_url string Sim* URL pública da imagem (alternativa ao arquivo)
output_format string Não png (padrão), jpeg, webp
bg_color string Não Cor de fundo em hex. Ex: #ffffff
return_base64 boolean Não Retorna JSON com base64 em vez de arquivo binário
ℹ️

Use image OU image_url. Não ambos.

POST /v1/remove 
// JavaScript
const form = new FormData();
form.append('image', file);
form.append('output_format', 'png');

const res = await fetch('https://api.TiraFundo.app/v1/remove', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer SEU_TOKEN'
  },
  body: form
});

const blob = await res.blob();
const url = URL.createObjectURL(blob);
Resposta (JSON com return_base64=true) 
{
  "id": "img_abc123",
  "status": "success",
  "result_b64": "iVBORw0KGgoAAAAN...",
  "format": "png",
  "width": 1920,
  "height": 1080,
  "processing_ms": 387
}
POST /v1/batch

Processamento em lote

Envie um array de URLs para processar em paralelo. Retorna um job ID para consulta assíncrona.

🔥

Disponível apenas nos planos Pro e Business.

POST /v1/batch 
{
  "urls": [
    "https://exemplo.com/img1.jpg",
    "https://exemplo.com/img2.png",
    "https://exemplo.com/img3.webp"
  ],
  "output_format": "png",
  "webhook_url": "https://meusite.com/webhook"
}
Resposta 
{
  "job_id": "job_xyz789",
  "status": "processing",
  "total": 3,
  "estimated_ms": 1200,
  "poll_url": "/v1/batch/job_xyz789"
}
Erros

Códigos de erro

A API usa códigos HTTP padrão. Todos os erros retornam JSON com detalhes.

400
Bad Request Parâmetro inválido ou ausente
401
Unauthorized Token inválido ou ausente
402
Payment Required Limite do plano atingido
413
Payload Too Large Imagem maior que 20MB
500
Server Error Erro interno no processamento
Exemplo de resposta de erro
{
  "error": {
    "code": "LIMIT_REACHED",
    "message": "Limite mensal atingido.",
    "status": 402,
    "docs": "https://TiraFundo.app/api-docs#errors"
  }
}
SDKs

SDKs oficiais

Instale o cliente para sua linguagem favorita e comece a usar em menos de 5 minutos.

JS/Node
Instalação 
# npm
npm install TiraFundo-sdk

# yarn
yarn add TiraFundo-sdk
Uso
import TiraFundo from 'TiraFundo-sdk';

const cc = new TiraFundo('SEU_TOKEN');
const result = await cc.remove('./foto.jpg');
result.save('./sem-fundo.png');
Python
Instalação 
pip install TiraFundo-python
Uso
from TiraFundo import TiraFundo

cc = TiraFundo('SEU_TOKEN')
result = cc.remove('foto.jpg')
result.save('sem-fundo.png')