Remoção de fundo Recraft para imagens de produtos de e-commerce

Recortar manualmente o fundo de produtos deixa de ser viável quando se passa de algumas dezenas de SKUs. O modelo de remoção de fundo do Recraft no hiapi transforma essa tarefa em uma única chamada de API: envie a foto do produto, receba um PNG limpo com fundo transparente e coloque-o sobre qualquer fundo exigido pelo seu marketplace ou loja. Este artigo percorre uma execução em lote real com recraft/remove-background, incluindo requisições reais, saídas reais e um script que pode ser apontado para um catálogo completo de produtos.

Por que a remoção de fundo ainda é um gargalo real

A maioria dos pipelines de imagens de produtos é parecida: fotos enviadas por fotógrafos ou fornecedores vêm com qualquer fundo que estivesse à mão naquele momento — papel de fundo infinito de estúdio, piso de armazém, palete de transporte — e alguém precisa isolar o produto primeiro antes que ele possa entrar em uma página de listagem com fundo branco, em uma composição de estilo de vida ou em um template de marketplace que exige uma cor de fundo específica por categoria.

Assim que se passa de algumas poucas imagens por semana, fazer isso no Photoshop deixa de escalar, e as ferramentas web genéricas de "remoção de fundo por IA" significam enviar fotos de produtos uma a uma pelo navegador, o que é lento e difícil de automatizar. Modelos de recorte baseados em API resolvem ambos os problemas: o processamento por imagem é rápido e a chamada a partir de um script é extremamente simples, então ele se encaixa diretamente no seu pipeline existente de catálogo de fotos de produtos.

O que recraft/remove-background realmente faz

O modelo aceita uma única entrada: a URL da foto do produto. Ele retorna um PNG com o fundo removido e substituído por áreas transparentes — sem prompt, sem máscara, sem parâmetros extras para ajustar. A requisição inteira é:

{
  "model": "recraft/remove-background",
  "input": {
    "image_url": "https://your-cdn.example.com/products/sneaker-001.jpg"
  }
}

Para tarefas de catálogo, a superfície de entrada estreita é uma vantagem: não há etapa de engenharia de prompt, e a mesma chamada funciona da mesma forma para cada foto de produto que você envia, o que importa quando se processam milhares de SKUs sem supervisão.

Uma execução real: antes e depois

Abaixo está uma foto real de produto processada pela API ao vivo, e o recorte que ela retornou:

O padrão xadrez à direita indica transparência, não um fundo cinza — a saída PNG remove completamente o fundo, então você pode compor o produto sobre qualquer coisa a jusante: fundo branco de listagem, bloco de cor da marca ou cena de estilo de vida.

O recorte isolado salvo como PNG transparente fica assim:

Este arquivo pode ir diretamente para templates de listagem, molduras de fundo branco exigidas por marketplaces ou pilhas de camadas em ferramentas de design, sem nenhum trabalho adicional de máscara.

Chamada direta

A requisição é enviada ao endpoint padrão de tarefas assíncronas do hiapi. Envie a tarefa e depois faça polling até que ela seja concluída:

curl -X POST "https://api.hiapi.ai/v1/tasks" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "recraft/remove-background",
    "input": {
      "image_url": "https://your-cdn.example.com/products/sneaker-001.jpg"
    }
  }'

Ele retorna um taskId. Faça polling em GET https://api.hiapi.ai/v1/tasks/{taskId} até que status seja success, então baixe o PNG imediatamente de output[0].url — as URLs de saída expiram, então puxe os bytes para o seu próprio armazenamento antes de fazer qualquer outra coisa com ela.

Processamento em lote no catálogo inteiro

A chamada de recorte individual não é a parte interessante — executá-la em um catálogo inteiro de produtos é. Abaixo está um script de lote real que distribui uma lista de URLs de imagens para um pool de threads, aguarda cada tarefa e retorna um mapeamento da foto de origem para a URL do recorte:

import concurrent.futures
import os
import time
import requests

API_KEY = os.environ["HIAPI_API_KEY"]
BASE_URL = "https://api.hiapi.ai/v1/tasks"


def remove_background(image_url: str) -> str:
    resp = requests.post(
        BASE_URL,
        headers={"Authorization": f"Bearer {API_KEY}"},
        json={"model": "recraft/remove-background", "input": {"image_url": image_url}},
        timeout=60,
    )
    resp.raise_for_status()
    task_id = resp.json()["data"]["taskId"]

    while True:
        poll = requests.get(
            f"{BASE_URL}/{task_id}",
            headers={"Authorization": f"Bearer {API_KEY}"},
            timeout=30,
        )
        task = poll.json()["data"]
        if task["status"] == "success":
            return task["output"][0]["url"]
        if task["status"] == "fail":
            raise RuntimeError(f"{image_url}: {task['error']}")
        time.sleep(3)


def batch_remove_background(image_urls, max_workers: int = 5):
    results = {}
    with concurrent.futures.ThreadPoolExecutor(max_workers=max_workers) as pool:
        futures = {pool.submit(remove_background, url): url for url in image_urls}
        for future in concurrent.futures.as_completed(futures):
            url = futures[future]
            try:
                results[url] = future.result()
            except Exception as exc:
                print(f"failed: {url} -> {exc}")
    return results

max_workers=5 é uma concorrência inicial razoável para tarefas de catálogo — aumente-a se os limites de taxa da sua conta permitirem mais tarefas paralelas, e sempre mantenha o try/except por imagem para que uma foto de origem ruim não trave o restante do lote. Baixe cada URL de resultado para armazenamento permanente assim que ela retornar; não presuma que a URL de saída continuará válida depois.

Custo em escala de catálogo

Em 2026-09, o preço de recraft/remove-background no hiapi é de $0.01 por imagem. Para um catálogo de 500 SKUs, com uma imagem principal cada, recortar o lote inteiro custa apenas $5; para um catálogo que precisa de três ângulos recortados por SKU, são $15. Consulte a página de preços ao vivo antes de planejar lotes grandes, pois as tarifas podem mudar.

Perguntas frequentes

Ele precisa de prompt ou máscara? Não. A única entrada é image_url. Não há nada para ajustar por imagem, e é exatamente por isso que ele pode rodar sem supervisão em catálogos grandes.

Como é a saída? Um PNG com o fundo substituído por áreas transparentes, com dimensões correspondentes ao enquadramento do sujeito da foto de entrada. Componha-o sobre qualquer fundo que seu template de listagem exigir.

Posso enviar fotos de estilo de vida com fundos bagunçados, não apenas fotos de estúdio? Sim — ele funciona com qualquer URL de foto de produto, não apenas com configurações de estúdio limpas, embora sujeitos claramente separados (como na maioria das fotografias de produtos) produzam as bordas mais limpas.

Quão rápida é uma tarefa? Uma tarefa individual geralmente é concluída em alguns segundos a um minuto; o script de lote acima faz polling a cada 3 segundos por tarefa e executa várias tarefas em paralelo, então algumas centenas de imagens podem ser concluídas em uma única execução do script.

O preço varia com a resolução da imagem? O modelo cobra uma tarifa fixa por tarefa, não escalonada por resolução. Confirme a tarifa atual na página de preços antes de se comprometer com um grande lote, pois as tarifas publicadas podem mudar.

Para onde ir a seguir

Experimente o modelo diretamente na página do modelo recraft/remove-background, ou, se você também precisa gerar novas cenas de produto em vez de apenas recortar fotos existentes, confira o fluxo de trabalho relacionado do lado de geração Gerando imagens de produtos de e-commerce com Qwen Image. Para tudo o mais que a API de tarefas suporta, a documentação de início rápido cobre autenticação e o ciclo de vida completo das tarefas.