Controle de Poses

O endpoint de Controle de Poses permite que você pegue uma imagem existente de um modelo e gere novas variações onde o modelo assume uma pose corporal diferente. A IA preserva meticulosamente as características faciais, roupas e fundo do modelo.

Requisição

Envie a imagem do seu modelo e uma lista de poses desejadas para o endpoint universal /v1/run:

Exemplos de Requisição

Você pode reposicionar um modelo usando uma imagem de referência (modelo) ou uma descrição de texto (personalizada).

curl -X POST https://fititon.app/api/v1/run \
     -H "Content-Type: application/json" \
     -H "Authorization: Bearer YOUR_API_KEY" \
     -d '{
           "model_name": "pose-control",
           "inputs": {
             "modelImage": "https://example.com/model-standing.jpg",
             "quality": "2k",
             "poses": [
               {
                 "type": "template",
                 "cdnUrl": "https://example.com/pose-reference.jpg",
                 "title": "Mãos na cintura"
               },
               {
                 "type": "custom",
                 "text": "Sentado em uma cadeira com as pernas cruzadas"
               }
             ]
           }
         }'

Resposta

Como a geração 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
}

Uma vez que o status mude para "succeeded", o campo output conterá um array de URLs apontando para suas imagens geradas. As imagens são retornadas na mesma ordem exata do array poses fornecido em sua requisição inicial:

{
  "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/fititon-pose-123-0.png",
    "https://cdn.fititon.app/users/123/results/fititon-pose-123-1.png"
  ]
}

Parâmetros da Requisição

Parâmetros Obrigatórios

Modelos de Poses Oficiais

Embora você possa fornecer suas próprias imagens de referência via cdnUrl, oferecemos um diretório curado de modelos de poses altamente otimizados. Clique em qualquer URL abaixo para pré-visualizar a pose.

Parâmetros Opcionais

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 custo escala linearmente com base no número de poses solicitadas e depende do nível de qualidade de saída escolhido.

Fórmula: Custo = CréditosPorQualidade × NúmeroDePoses

Exemplo: Solicitar um array de 3 poses com qualidade 1k custa 3 créditos no total. Solicitar as mesmas 3 poses com qualidade 4k custa 15 créditos no total.