Experimentação por Prompt

O endpoint de Experimentação por Prompt permite que você descreva uma nova roupa usando texto para vesti-la perfeitamente em um modelo de moda de IA.

Nome do Modelo: prompt-tryon

Ciclo de Vida: estável

Tempo de Processamento: ~15s–40s (aumenta ao usar referências de estilo ou modelo)

Formato de Saída: Automático (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 experimentação para o endpoint universal /v1/run:

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

Exemplos de Requisição

Autenticação Você pode passar sua chave de API como um token Bearer (Authorization: Bearer SUA_CHAVE_API) ou através do cabeçalho x-api-key (x-api-key: SUA_CHAVE_API).

curl -X POST https://fititon.app/api/v1/run \
     -H "Content-Type: application/json" \
     -H "Authorization: Bearer YOUR_API_KEY" \
     -d '{
           "model_name": "prompt-tryon",
           "inputs": {
             "personImage": "https://example.com/person.jpg",
             "prompt": "A stylish red summer dress with floral patterns.",
             "quality": "2k",
             "sampleCount": 1,
             "ratio": "16:9",
             "modelImageUrl": "https://example.com/model-reference.jpg",
             "styleId": "movie"
           }
         }'

Resposta

A geração da Experimentação ocorre assincronamente 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
}

Consultando os 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 Configuração da API para instruções detalhadas.

Quando a geração terminar, o endpoint de consulta retornará status: "success" com o seguinte array output contendo as URLs das imagens finais:

{
  "id": "123a87r9-4129-4bb3-be18-9c9fb5bd7fc1",
  "status": "success",
  "output": [
    "https://pub-r2.com/.../result-0.png"
  ],
  "error": null,
  "created_at": "2026-07-17T11:00:00Z",
  "updated_at": "2026-07-17T11:00:45Z"
}

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.

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.

promptRequiredstring

Descrição em texto da roupa que você deseja que o modelo vista.

Dica Profissional: Inclua o tipo de tecido (seda, algodão, jeans) e o estilo de caimento (justo, oversized) para obter os melhores resultados. Especifique as cores com precisão ("azul marinho" funciona melhor do que "azul") e faça referência explícita ao que o modelo já está vestindo para que a IA saiba exatamente o que mudar.

Parâmetros Opcionais

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

Nível de resolução de saída para Experimentação por Prompt (modelos Gemini). Resoluções mais altas consomem mais créditos. Padrão: 1k

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

ratiostring

Define a proporção largura-altura da imagem gerada. Se vazio, o sistema assume a proporção da personImage.

Valores suportados: '1:1', '3:4', '4:3', '9:16', '16:9', '2:3', '3:2', '4:5', '5:4', '21:9'.

modelImageUrlstring

Opcional. URL de um modelo de referência humano para usar em vez de preservar as características da pessoa original.

Modelos Predefinidos Disponíveis:

styleIdstring

Opcional. Aplica um estilo fotográfico específico à imagem de saída.

Estilos Disponíveis:

Style Name	Style ID (`styleId`)

Valores válidos: y2k, studio, iphone, professional, lifestyle, analog, streetwear, flash, movie, minimalist, ugc, editorial.

Nota: Estilos complexos podem aumentar o tempo total de geração.

Erros de Tempo de Execução

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

O custo depende do nível de quality selecionado e é multiplicado pelo seu sampleCount.

Fórmula: Custo = CréditosQualidade × sampleCount

Parâmetro	Créditos por Imagem
`quality="1k"`	1
`quality="2k"`	3
`quality="4k"`	5