Gere modelos de moda de IA totalmente únicos ou carregue imagens de referência personalizadas para usar em provas virtuais.

Criação de Modelo

A Criação de Modelo permite gerar modelos de moda realistas com prompts simples e intuitivos ou imagens de referência, ou carregar imagens de modelos existentes para o seu espaço de trabalho.

Nome do Modelo: model-create

Ciclo de Vida: estável

Tempo de Processamento: ~10s–30s (aumenta ao usar referências avançadas como rosto/pose)

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

Métodos de Entrega: URL

Créditos: 1 a 5 por modelo (1k: 1, 2k: 3, 4k: 5)

Solicitação

Gere ou carregue modelos de moda enviando sua configuração 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": "model-create",
           "inputs": {
             "type": "generate",
             "name": "Summer Collection Model",
             "prompt": "Full body shot, woman wearing a white t-shirt and dark blue biker shorts, studio lighting",
             "gender": "female",
             "quality": "2k",
             "sampleCount": 1
           }
         }'

Resposta

Como a geração do modelo pode levar até 30 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 o seu modelo 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/model-123.png"
  ]
}

Parâmetros de Solicitação

Parâmetros Obrigatórios

typeRequired'generate' | 'upload'

Especifica se deve gerar um novo modelo via IA (generate) ou carregar uma imagem existente (upload).

nameRequiredstring

Um nome descritivo para o seu modelo. Isso é usado para identificar o modelo em seu estúdio.

promptstring

Obrigatório para geração Descrição textual do modelo a ser gerado. Descreve o modelo de moda desejado, roupas, pose e cenário de fundo.

Dica Profissional: Se você estiver usando uma referência como faceModelId, a IA priorizará a identidade da referência, mas usará seu prompt para determinar o cenário, a roupa e as características corporais. Opcional apenas se um faceModelId for fornecido.

imageBase64string

Obrigatório para upload String de imagem codificada em Base64. Obrigatório quando type é definido como upload.

Requisito de Formatação Sua string Base64 deve incluir o prefixo URI de dados padrão (por exemplo, data:image/jpeg;base64,... ou data:image/png;base64,...). O upload falhará se apenas a string codificada bruta for fornecida.

Parâmetros Opcionais de Geração

Esses parâmetros se aplicam quando type é definido como generate.

genderstring

O gênero do modelo. Ajuda o modelo de geração a determinar atributos físicos.

bodyTypestring

O tipo de corpo do modelo (por exemplo, "atlético", "plus size", "magro").

clothingstring

Detalhes específicos de vestuário a serem aplicados durante a geração, complementando o prompt principal.

posestring

Descrição textual da pose (por exemplo, "em pé com as mãos nos bolsos", "caminhando").

faceModelIdstring

UUID de um modelo de rosto existente para fixar uma identidade específica em todas as gerações. A saída se adaptará ao prompt de destino, preservando o rosto de referência.

Nota: Fornecer uma referência de rosto adiciona vários segundos ao tempo total de processamento, pois a IA alinha a identidade.

poseModelIdstring

UUID de um modelo de pose existente. Força a geração a corresponder estritamente à referência para pose e postura corporal.

Nota: Fornecer uma referência de pose aumenta o tempo de processamento.

poseImageBase64string

String de imagem codificada em Base64 para usar como uma referência de pose ad-hoc em vez de fornecer um poseModelId salvo.

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

Nível de resolução de saída. 1k produz saída de ~1 megapixel, 2k ~4 megapixels e 4k ~16 megapixels. Resoluções mais altas consomem mais créditos. Padrão: 1k

aspectRatiostring

Define a proporção largura-altura da imagem gerada.

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

Padrão: 3:4

sampleCountinteger

Número de variações de imagem a serem geradas por solicitação. 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édito

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

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