Geração de Ângulos

O endpoint de Geração de Ângulos permite que você pegue uma imagem existente e reposicione a câmera virtual para gerar novos ângulos de visão (por exemplo, perfis frontal, traseiro, lateral), preservando o modelo, a roupa, as texturas e a iluminação.

Requisição

Envie sua imagem e os ângulos desejados para o endpoint universal /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": "angle-generation",
           "inputs": {
             "imageUrl": "https://example.com/front-view.jpg",
             "angleIds": ["back", "leftSide"],
             "quality": "2k"
           }
         }'

Resposta

Como a geração de ângulos pode levar até 20 segundos, o endpoint /v1/run retorna um status 201 Created imediatamente com um id de job 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 de URLs apontando para suas imagens geradas. As imagens são retornadas na mesma ordem exata do array angleIds 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/angle-123-0.png",
    "https://cdn.fititon.app/users/123/results/angle-123-1.png"
  ]
}

Parâmetros da Requisição

Parâmetros Obrigatórios

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 ângulos solicitados e depende do nível de quality de saída escolhido.

Fórmula: Custo = CréditosPorQualidade × NúmeroDeÂngulos

Exemplo: Solicitar ["back", "leftSide", "rightSide"] com qualidade 1k custa 3 créditos no total. Solicitar os mesmos 3 ângulos com qualidade 4k custa 15 créditos no total.