Troque peças de vestuário em modelos de moda de IA de forma contínua usando referências de imagem.

Experimentação Virtual (Experimentação por Imagem)

O endpoint de Experimentação permite que você vista uma peça de vestuário em uma pessoa de forma contínua usando uma referência de imagem.

Nome do Modelo: tryon

Ciclo de Vida: estável

Tempo de Processamento: ~15s–30s

Formato de Saída: Automático (JPEG ou PNG)

Métodos de Entrega: URL (via Polling)

Créditos: 1 × sampleCount

Requisição

Envie sua configuração de experimentação para o endpoint universal /v1/run usando um payload JSON.

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": "tryon",
           "inputs": {
             "personImage": "https://example.com/person.jpg",
             "garmentImage": "https://example.com/garment.jpg",
             "accuracy": "high",
             "sampleCount": 1
           }
         }'

Resposta

A geração da Experimentação ocorre de forma assíncrona em segundo plano. Sua requisição retornará imediatamente um status 200 OK com um objeto de rastreamento.

{
  "id": "123a87r9-4129-4bb3-be18-9c9fb5bd7fc1",
  "status": "starting",
  "created_at": "2026-07-17T11:00:00Z",
  "error": null,
  "output": null
}

Consulta de Resultados Você deve usar o id retornado para consultar o endpoint de status (GET https://fititon.app/api/v1/status/{id}) para recuperar as URLs das suas imagens geradas. Consulte o guia de Configuração da API para instruções detalhadas.

Parâmetros da Requisição

Parâmetros Obrigatórios

personImageRequiredstring

A imagem base do modelo que você deseja vestir. Pode ser uma URL publicamente acessível ou uma string de imagem codificada em Base64. Formatos suportados: JPEG, PNG, WEBP. Tamanho máximo: 25MB.

Dica Profissional: Poses frontais com braços visíveis produzem o caimento mais realista. Remova bolsas, cachecóis ou jaquetas que cubram o corpo antes de fotografar.

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,...). O endpoint /v1/run aceita apenas payloads JSON, portanto, uploads multipart/form-data não são suportados.

garmentImageRequiredstring

A imagem da peça de roupa para experimentar. Pode ser uma URL publicamente acessível ou uma string de imagem codificada em Base64.

Dica Profissional: Fotos de peças de vestuário em fundo branco, dispostas de forma plana, funcionam visivelmente melhor do que fotos em cabides ou roupas amassadas.

Parâmetros Opcionais

accuracy'standard' | 'high' | 'hyper'

Define a fidelidade do ajuste da experimentação. Maior precisão aumenta a exatidão da geração, mas pode levar um pouco mais de tempo. Padrão: standard

sampleCountinteger

Número de variações de imagem a serem geradas por requisição. Deve estar entre 1 e 4. Imagens adicionais consomem mais créditos e aumentam o tempo de processamento linearmente. Padrão: 1

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éditos

Para requisições da API de Desenvolvedor, o endpoint de Experimentação Virtual opera a uma taxa fixa de 1 crédito por imagem gerada, independentemente do nível de quality solicitado.

Fórmula: Cost = 1 × sampleCount

Parâmetro	Créditos por Imagem
Taxa Fixa	1