Fundamentos da API

A API de Desenvolvedor Fit-it-on oferece acesso programático aos nossos modelos de geração de IA. Ela segue estilos arquitetônicos REST padrão, usa URLs previsíveis orientadas a recursos e aceita corpos de solicitação codificados em JSON.

Execução Assíncrona

Todas as gerações de imagens são processadas assincronamente. Renderizações de IA de alta resolução (amostras de 2k ou 2048x2048) levam tempo, e uma conexão síncrona inevitavelmente expiraria.

Enviar um Trabalho: Você envia uma solicitação POST /v1/run com seus dados de entrada.
Receber ID: A API retorna imediatamente um 200 OK com um prediction_id.
Consultar Status: Você chama periodicamente GET /v1/status/{predictionId}.
Conclusão: Quando o status transitar para succeeded, as URLs para suas imagens geradas estarão disponíveis no array output.

Suporte a Webhook Alternativamente, você pode fornecer um parâmetro webhook_url em sua solicitação POST inicial. Assim que o trabalho terminar de ser processado (seja com sucesso ou falha), enviaremos uma solicitação POST diretamente para seu webhook contendo o payload de status final, eliminando a necessidade de consultar manualmente.

URL Base

Todas as solicitações devem ser feitas via HTTPS para nosso ambiente de produção:

https://fititon.app/api

Tipos de Conteúdo

Todas as solicitações POST e PATCH devem incluir o seguinte cabeçalho para especificar o formato do payload:

Content-Type: application/json

A API também retorna todas as respostas estritamente no formato JSON.

Webhooks

Se você fornecer um webhook_url na raiz do seu payload JSON, enviaremos uma solicitação HTTP POST para essa URL assim que o trabalho assíncrono for concluído (seja com sucesso ou com um erro).

Exemplo de Payload do Webhook:

{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "status": "success",
  "output": [
    "https://storage.fititon.com/results/result-123.jpg",
    "https://storage.fititon.com/results/result-124.jpg"
  ],
  "error": null,
  "created_at": "2026-07-03T10:00:00.000Z",
  "updated_at": "2026-07-03T10:00:15.000Z"
}

Limites e Tratamento de Solicitações

Para evitar abusos, a API impõe um limite de taxa baseado no seu nível de Plano de Desenvolvedor ativo.

Se você exceder seu limite, receberá um erro 429 Too Many Requests. Sua aplicação deve lidar com isso de forma elegante, implementando um backoff exponencial.

Seu saldo de créditos é independente do limite de taxa. Você pode monitorar seu uso geral da API e o saldo de créditos restante através do Painel do Desenvolvedor, ou programaticamente através dos endpoints da conta.

Se a geração falhar internamente (por exemplo, uma imagem inválida foi passada, ou ocorreu um timeout do modelo), o endpoint GET /v1/status retornará um status de failed, e a propriedade error conterá uma mensagem descritiva. Seus créditos não serão deduzidos por trabalhos falhos.