Transforme fotos de produtos em fundo plano ou manequim fantasma em fotografia profissional com modelo.

Produto para Modelo

O endpoint Produto para Modelo transforma fotos de produtos em fundo plano ou manequim fantasma em fotografia profissional com modelo, permitindo que você especifique a aparência do modelo ou o estilo fotográfico.

Nome do Modelo: product-to-model

Ciclo de Vida: stable

Tempo de Processamento: ~10s–30s (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)

Solicitação

Envie sua imagem de produto para o endpoint universal /v1/run:

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

Exemplos de Solicitação

curl -X POST https://fititon.app/api/v1/run \
     -H "Content-Type: application/json" \
     -H "Authorization: Bearer YOUR_API_KEY" \
     -d '{
           "model_name": "product-to-model",
           "inputs": {
             "productImage": "https://example.com/ghost-mannequin-shirt.jpg",
             "styleId": "editorial",
             "customPrompt": "Asian female model, outdoor city street, natural lighting",
             "quality": "2k",
             "sampleCount": 1,
             "ratio": "3:4"
           }
         }'

Resposta

Como a geração de imagens pode levar até 20 segundos, o endpoint /v1/run retorna um status 201 Created imediatamente com um id de trabalho assíncrono. Você deve consultar a API de Status usando GET /v1/status/{id} para recuperar os resultados finais. Alternativamente, você pode configurar webhooks para receber notificações automaticamente. Observe que nosso despachante de webhook impõe um tempo limite estrito de 15 segundos. Seu servidor deve reconhecer o webhook com um código de status 2xx dentro de 15 segundos, ou o consideraremos falho e o tentaremos novamente mais tarde.

{
  "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", o campo output conterá um array com o URL apontando para sua imagem gerada:

{
  "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/product-model-123.png"
  ]
}

Parâmetros da Solicitação

Parâmetros Obrigatórios

productImageRequiredstring

A imagem do produto a ser vestida em um modelo (fundo plano ou manequim fantasma). Pode ser um URL publicamente acessível ou uma string de imagem codificada em Base64. Tamanho máximo: 25MB.

Dica Profissional: Fotos em fundo plano com fundos brancos produzem os resultados mais consistentes com modelo. Fotos de manequim também funcionam bem. Remova etiquetas, adesivos de preço ou acessórios que não fazem parte da peça antes de fotografar. Certifique-se de que a peça inteira esteja visível e desdobrada — sem mangas cortadas.

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,...).

Parâmetros Opcionais

customPromptstring

Instruções textuais descrevendo o modelo desejado (por exemplo, gênero, etnia, pose) ou cena. Comprimento máximo: 500 caracteres.

modelImageUrlstring

O URL de um modelo de referência humano a ser usado para a geração. Se omitido, um modelo diverso aleatório será gerado.

Modelos Predefinidos Disponíveis:

Nota: Fornecer um modelo de referência aumenta o tempo total de processamento.

styleIdstring

O ID do estilo fotográfico a ser aplicado (por exemplo, "studio", "iphone", "editorial"). Se omitido, o padrão é uma apresentação de estúdio neutra.

Estilos Disponíveis:

Style Name	Style ID (`styleId`)

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

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

Nível de resolução de saída. 1k produz uma saída de ~1 megapixel, 2k ~4 megapixels e 4k ~16 megapixels. Padrão: 1k

sampleCountinteger

Número de variações de imagem a serem geradas por solicitação. Deve estar entre 1 e 4. Padrão: 1

ratiostring

Define a proporção largura-altura da imagem gerada. Se vazio, o sistema assume 3:4 para fotos de moda.

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

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

Para solicitações da API de Desenvolvedor, o custo depende do nível de quality de saída escolhido multiplicado pelo sampleCount.

Fórmula: Custo = CréditosDeQualidade × sampleCount

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