Configuração da API

Para interagir com a API de Desenvolvedor Fit-it-on, você deve autenticar suas requisições usando uma Chave de API de Desenvolvedor segura.

Gerando uma Chave de API

1. Faça login no seu Painel Fit-it-on.
2. Navegue até Desenvolvedor > Chaves de API na barra lateral esquerda.
3. Clique no botão Gerar Nova Chave.
4. Copie sua nova chave secreta (ela sempre começará com fio_sk_...).

Autenticação

Todas as requisições da API devem incluir sua chave de API no cabeçalho Authorization como um token Bearer.

curl https://fititon.app/api/v1/run \
  -H "Authorization: Bearer fio_sk_YOUR_SECRET_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model_name": "tryon",
    "inputs": { ... }
  }'

Fluxo de Trabalho Assíncrono

Os endpoints de geração Fit-it-on (como /v1/run) operam de forma assíncrona. Isso significa que sua requisição inicial retornará imediatamente com um ID de rastreamento de trabalho, em vez de esperar a geração ser concluída.

Passo 1: Enviar um Trabalho

Faça uma requisição POST para https://fititon.app/api/v1/run para enfileirar um trabalho de geração. Você receberá uma resposta imediata:

{
  "id": "123a87r9-4129-4bb3-be18-9c9fb5bd7fc1",
  "status": "starting",
  "created_at": "2026-07-17T11:00:00Z",
  "error": null,
  "output": null
}

Passo 2: Consultar os Resultados

Use o id retornado para verificar periodicamente o status da sua geração fazendo uma requisição GET para https://fititon.app/api/v1/status/{id}.

curl https://fititon.app/api/v1/status/123a87r9-4129-4bb3-be18-9c9fb5bd7fc1 \
  -H "Authorization: Bearer fio_sk_YOUR_SECRET_KEY"

A resposta indicará o estado atual do seu trabalho. Quando status for "completed", o campo output conterá as URLs das imagens ou vídeos gerados.

{
  "id": "123a87r9-4129-4bb3-be18-9c9fb5bd7fc1",
  "status": "completed",
  "output": [
    "https://cdn.fititon.app/users/123/results/result-123.png"
  ],
  "error": null,
  "created_at": "2026-07-17T11:00:00.000Z",
  "updated_at": "2026-07-17T11:00:25.000Z"
}

Fazendo sua primeira requisição

Você pode testar sua chave buscando seus créditos de desenvolvedor restantes e verificando seu plano:

curl https://fititon.app/api/v1/credits \
  -H "Authorization: Bearer fio_sk_YOUR_SECRET_KEY"

Se bem-sucedido, isso retornará um objeto JSON com seu plano atual e créditos restantes.