snipmat

Uma única requisição POST. Sem processos em segundo plano.

Remova fundos programaticamente — resolução total em todos os planos, preço fixo de 1 crédito por imagem, independentemente do tamanho. Compatível com a API padrão do setor: aponte sua integração existente para snipmat.com e troque a chave. Vindo do remove.bg? Veja o guia de migração e comparação.

Início rápido

Envie a imagem e receba o recorte como corpo da resposta — sem polling, sem webhooks.

curl -X POST https://snipmat.com/api/v1.0/removebg \
  -H "X-Api-Key: sm_live_YOUR_KEY" \
  -F "image_file=@product.jpg" \
  -F "format=png" \
  -o product_nobg.png

Autenticação

Crie uma chave em Configurações → Chaves de API e envie-a em cada requisição como X-Api-Key (ou Authorization: Bearer sm_live_…). As chaves são exibidas apenas uma vez na criação e podem ser revogadas instantaneamente.

Parâmetros

POST /api/v1.0/removebg como multipart, JSON ou form-urlencoded.

Campo	Tipo	Descrição
image_file	arquivo	A imagem (png/jpeg/webp, ≤25MB, ≤32MP). Ou use image_url / image_file_b64.
image_url	string	URL pública para buscar a imagem.
image_file_b64	string	Imagem codificada em Base64.
model	string	general = melhor opção geral, incl. pessoas/cabelos, abre buracos fechados automaticamente (padrão); dis = modelo alternativo BiRefNet-DIS — use apenas se general deixar passar algo em um produto, não para pessoas; lite = modelo mais rápido e menor.
size	string	auto/full = resolução total — grátis em todos os planos · preview = ≤0,25MP.
format	string	auto/png (transparente) · jpg · webp · zip (color.jpg + alpha.png).
channels	string	rgba (padrão) · alpha — retorna apenas a máscara como PNG em escala de cinza.
bg_color	string	Cor hexadecimal para colocar atrás do assunto, ex.: 81d4fa ou #1e3a34ff.
bg_image_url	string	URL de uma imagem para colocar atrás do assunto.
crop	bool	Recortar o canvas para a caixa delimitadora do assunto.
scale	string	Escala do assunto como "80%" (10–100, aplica-se com crop).
position	string	original (padrão) · center.
keep_largest	bool	Manter apenas o maior assunto, descartando manchas soltas.

Créditos e conta

Cada chamada bem-sucedida custa exatamente 1 crédito — uma imagem de 32MP custa o mesmo que uma miniatura. Isso equivale a menos de 2 centavos por imagem no Pro e 4–9 centavos em pacotes — serviços comparáveis cobram 20 centavos ou mais. Contas gratuitas incluem 50 créditos/mês, Pro inclui 500, e pacotes de créditos nunca expiram. Chamadas com falha são reembolsadas automaticamente. Imagens processadas também aparecem no seu histórico web por 30 dias (90 no Pro) antes de serem excluídas. Verifique seu saldo com GET /api/v1.0/account; cada resposta também traz os cabeçalhos X-Credits-Monthly-Remaining e X-Credits-Balance.

Erros

Erros retornam como: {"errors":[{"title":"...","code":"..."}]}

Status	Código	Significado
400	missing_source / invalid_source	Nenhuma imagem fornecida, ou a URL/arquivo não é uma imagem suportada.
402	insufficient_credits	Cota mensal e saldo do pacote estão ambos vazios.
403	auth_failed	Chave de API ausente, inválida ou revogada.
413	image_too_large	Acima de 25MB ou 32 megapixels.
429	rate_limit_exceeded	Limite de taxa por chave atingido — verifique X-RateLimit-Reset.
503	queue_saturated	Serviço ocupado — tente novamente após os segundos de Retry-After.

Limites de taxa

30 requisições/minuto por chave no Free, 120 no Pro. Cada resposta inclui X-RateLimit-Limit, X-RateLimit-Remaining e X-RateLimit-Reset.

MCP para agentes de IA

Claude e outros clientes MCP podem remover fundos diretamente. Adicione snipmat como conector com esta URL — você verá uma tela de login/consentimento, sem necessidade de colar chave:

https://snipmat.com/mcp

Conecte a partir da sua ferramenta

1. Abra Configurações → Conectores (no claude.ai ou no aplicativo desktop) e escolha Adicionar conector personalizado.
2. Nomeie como snipmat e cole https://snipmat.com/mcp.
3. Clique em Adicionar e depois Conectar — você verá um login e tela de consentimento normais do snipmat. Pronto: peça ao Claude para remover um fundo.

Cada cliente descobre o fluxo OAuth automaticamente (registro dinâmico + PKCE) — sem colar chave. Ferramentas: remove_background, create_upload, start_batch, get_batch e check_quota. Arquivos locais funcionam de primeira: create_upload retorna URLs pré-assinadas para as quais o agente envia os bytes da imagem via PUT — sem URL pública, sem hosts de terceiros, sem base64 pelo modelo. Até 10 imagens são processadas em uma única chamada remove_background; conjuntos maiores (até 100 no Pro) rodam de forma assíncrona via polling de start_batch + get_batch. Para uso headless ou em CI, pule o OAuth e envie uma chave de API: Authorization: Bearer sm_live_… (no Claude Code: --header no comando add). Revise ou revogue conexões a qualquer momento em Configurações → Aplicativos conectados.

Documentação legível por máquina

Construindo um agente ou apontando um LLM para o snipmat? Tudo nesta página está disponível como markdown simples (índice em /llms.txt), e a API HTTP como uma especificação OpenAPI 3.0.