Substituição de Fundo

O endpoint de Substituição de Fundo permite isolar um objeto de uma imagem e gerar um fundo completamente novo e realista com base em um prompt de texto.

Nome do Modelo: background-replace

Ciclo de Vida: stable

Tempo de Processamento: ~5s–15s

Formato de Saída: Auto (JPEG ou PNG)

Métodos de Entrega: URL

Créditos: 1 a 5 por geração (depende da qualidade)

Requisição

Envie sua configuração de substituição de fundo para o endpoint universal /v1/run:

POSThttps://fititon.app/api/v1/run

Exemplos de Requisição

curl -X POST https://fititon.app/api/v1/run \
     -H "Content-Type: application/json" \
     -H "Authorization: Bearer YOUR_API_KEY" \
     -d '{
           "model_name": "background-replace",
           "inputs": {
             "subjectImage": "https://example.com/product.jpg",
             "scenePrompt": "Product sitting on a sandy beach during golden hour",
             "quality": "2k"
           }
         }'

Resposta

Retorna um status 201 Created com o objeto de rastreamento inicial. A geração é executada assincronamente.

{
  "id": "123a87r9-4129-4bb3-be18-9c9fb5bd7fc1",
  "status": "starting",
  "created_at": "2026-07-18T17:30:00.000Z",
  "error": null,
  "output": null
}

Assim que o status mudar para "succeeded" (via polling do endpoint GET), o campo output conterá um array com a URL apontando para o seu fundo gerado:

{
  "id": "123a87r9-4129-4bb3-be18-9c9fb5bd7fc1",
  "status": "succeeded",
  "created_at": "2026-07-18T17:30:00.000Z",
  "error": null,
  "output": [
    "https://cdn.fititon.app/users/123/results/bg-replace-123.png"
  ]
}

Parâmetros da Requisição

Parâmetros Obrigatórios

subjectImageRequiredstring

A imagem contendo o objeto que você deseja isolar. Pode ser uma URL publicamente acessível ou uma string de imagem codificada em Base64. Tamanho máximo: 25MB.

Dica Profissional: Objetos com bordas claras e nítidas contra um fundo contrastante resultam nos recortes mais limpos. Evite imagens onde o objeto se mistura com o fundo (por exemplo, camisa branca em parede branca). Iluminação de alto contraste ajuda a IA a depender da detecção de bordas para separar o objeto perfeitamente.

Requisito de Formatação Ao enviar uma string Base64, ela deve incluir o prefixo URI de dados padrão (por exemplo, data:image/jpeg;base64,...).

scenePromptRequiredstring

Uma descrição textual da nova cena de fundo que você deseja gerar atrás do objeto.

Parâmetros Opcionais

quality'1k' | '2k' | '4k'

Nível de resolução de saída. Define a resolução da imagem final gerada. Padrão: 1k

Erros de Tempo de Execução

Os erros de tempo de execução para este recurso usam o conjunto compartilhado documentado em Tratamento de Erros. Se ocorrer um erro durante o processamento, o status será atualizado para "error" e o campo error conterá o motivo específico da falha.

Custo de Crédito

Para requisições da API do Desenvolvedor, o custo depende inteiramente do nível de qualidade de saída escolhido.

Fórmula: Cost = QualityCredits

Nível de Qualidade	Créditos por Imagem
1k (Padrão)	1
2k	3
4k	5