Remove.bg

Visão geral

Remove.bg é uma API que utiliza inteligência artificial para remover automaticamente o fundo de imagens. Com a integração no SquadOS, seus agentes podem processar fotos de produtos, retratos e qualquer imagem, entregando resultados com fundo transparente ou substituído em segundos.

• Site oficial: https://www.remove.bg/
• Documentação na Composio: docs.composio.dev/toolkits/remove_bg

Autenticação

Esta ferramenta utiliza chave de API (API_KEY) para conectar.

Você vai precisar dos seguintes campos:

Campo	Obrigatório	Descrição
api_key	Sim	Chave de API da sua conta Remove.bg, usada para autenticar todas as requisições.

Como obter a credencial

1. Acesse www.remove.bg/pt-br/users/sign_up e crie uma conta gratuita.
2. Confirme seu e-mail para ativar a conta.
3. Faça login e acesse www.remove.bg/api.
4. Na seção API Keys, clique em Get API Key.
5. Copie a chave gerada — esse é o valor a usar no campo api_key ao conectar no SquadOS.

Dica

Use uma chave de API dedicada para o SquadOS. Isso permite revogar o acesso individualmente sem afetar outras integrações que utilizem a mesma conta.

Como conectar no SquadOS

1. Acesse Ferramentas no menu lateral (/admin/tools).
2. Abra a aba Disponíveis e procure por Remove.bg.
3. Clique no card para abrir o modal de detalhes e em Conectar.
4. Você é levado para a página de conexão segura hospedada pela Composio, onde informa a chave de API obtida acima.
5. Ao concluir, você volta para o SquadOS com a conta conectada e a ferramenta disponível para os agentes. (Detalhes do fluxo em Ferramentas da Organização.)

Ações disponíveis

Remover fundo

REMOVE_BG

Remove o fundo de uma imagem. Use quando precisar de um fundo transparente ou personalizado para fotos de produtos ou retratos.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
roi	string	Não	Região de interesse em pixels no formato esquerda,topo,largura,altura.
crop	boolean	Não	Recortar para a região de interesse se verdadeiro.
size	string	Não	Tamanho da imagem de saída. Um de auto, preview, full.
type	string	Não	Categoria da imagem. Um de auto, person, product.
scale	string	Não	Redimensiona o sujeito como porcentagem do tamanho original, formatado como <int>% entre 10% e 100% (ex.: 50%). Use 100% ou omita para manter o tamanho original.
format	string	Não	Formato da imagem de saída. Um de auto, png, jpg.
bg_color	string	Não	Cor hexadecimal #RRGGBB para preencher o fundo em vez de transparência.
channels	string	Não	Canais de saída. Somente rgba é suportado.
position	string	Não	Posição do sujeito: center ou original.
image_url	string	Não	URL da imagem a processar. Obrigatório se image_file não for fornecido.
image_file	string	Não	Bytes brutos do arquivo de imagem a enviar (multipart/form-data). Obrigatório se image_url não for fornecido.
bg_image_url	string	Não	URL da imagem de fundo a compor atrás do sujeito.
bg_image_file	string	Não	Bytes do arquivo de imagem de fundo a compor atrás do sujeito.

Saída

Nome	Tipo	Obrigatório	Descrição
data	string	Sim	Dados retornados pela execução da ação.
error	string	Não	Mensagem de erro caso a execução tenha falhado.
successful	boolean	Sim	Indica se a ação foi executada com sucesso.

Consultar conta

REMOVE_BG_GET_ACCOUNT

Recupera informações da conta, incluindo o saldo atual de créditos. Use quando precisar verificar os créditos e detalhes de uso da sua conta Remove.bg.

Saída

Nome	Tipo	Obrigatório	Descrição
data	string	Sim	Dados retornados pela execução da ação.
error	string	Não	Mensagem de erro caso a execução tenha falhado.
successful	boolean	Sim	Indica se a ação foi executada com sucesso.

Enviar imagem para melhoria

REMOVE_BG_SUBMIT_IMPROVEMENT

Envia uma imagem para o programa de Melhoria do Remove.bg. Use quando quiser contribuir com imagens que o Remove.bg não consegue processar corretamente para ajudar a aprimorar a IA. Ao enviar imagens, você concorda com as Condições do Programa de Melhoria. Limitado a 100 arquivos por dia, tamanho máximo de 22 MB e até 50 megapixels de resolução.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
tag	string	Não	Tag para agrupar imagens relacionadas. Imagens com a mesma tag são agrupadas.
image_url	string	Não	URL da imagem a enviar. Obrigatório se image_file e image_file_b64 não forem fornecidos. Apenas um parâmetro de origem de imagem pode ser especificado.
image_file	object	Não	Arquivo de imagem a enviar. Obrigatório se image_file_b64 e image_url não forem fornecidos. Apenas um parâmetro de origem de imagem pode ser especificado.
image_file_b64	string	Não	String do arquivo de imagem codificada em Base64. Obrigatório se image_file e image_url não forem fornecidos. Apenas um parâmetro de origem de imagem pode ser especificado.
image_filename	string	Não	Nome do arquivo de imagem. Se não fornecido, será detectado automaticamente a partir dos dados enviados.

Saída

Nome	Tipo	Obrigatório	Descrição
data	string	Sim	Dados retornados pela execução da ação.
error	string	Não	Mensagem de erro caso a execução tenha falhado.
successful	boolean	Sim	Indica se a ação foi executada com sucesso.