IA - Endpoints

Geração de texto e imagem com rate limit e filtro de conteúdo.

Índice de documentação: /api/templates

Geração de texto

Método	Rota	Descrição
GET	/api/ia/generate/text/<prompt>	Gera texto a partir do prompt.
POST	/api/ia/generate/text	Gera texto via JSON: {"prompt": "..."}.

Parâmetros de consulta

Os parâmetros de consulta do cliente não são repassados ao provedor; a parametrização é controlada pelo servidor.

Comportamento

• Rate limit (Texto): 10 requisições por minuto por IP.
• Rate limit (Imagem): 3 requisições por minuto por IP.
• Tamanho máximo do prompt: 4000 caracteres (configurável via IA_TEXT_PROMPT_MAX_CHARS).
• Filtro de conteúdo: prompts que violem a política retornam 403 sem encaminhar ao upstream.

Exemplos

GET /api/ia/generate/text/Escreva%20um%20poema%20curto

POST /api/ia/generate/text
Content-Type: application/json

{
  "prompt": "Crie um haicai sobre o pôr do sol"
}

Geração de imagem

Método	Rota	Descrição
GET	/api/ia/generate/image/<prompt>	Gera uma imagem a partir do prompt.
POST	/api/ia/generate/image	Gera imagem via JSON: {"prompt": "..."}.

Exemplos

GET /api/ia/generate/image/um%20gato%20astronauta%20no%20espa%C3%A7o

POST /api/ia/generate/image
Content-Type: application/json

{
  "prompt": "um pôster minimalista de um foguete"
}

Pré-visualização

Métricas

Método	Caminho	Descrição
GET	/api/ia/generate/metrics	Resumo JSON de métricas da IA.

Dica: ao testar rate limit, defina X-Forwarded-For para simular IPs diferentes.

← Voltar para o índice de documentação