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": "...", "system_prompt": "..."} (system_prompt é opcional).

Parâmetros de consulta

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

Parâmetros do corpo (POST)

Campo	Tipo	Obrigatório	Descrição
prompt	string	Sim	O texto do prompt principal para geração.
system_prompt	string	Não	Instruções de sistema para guiar o comportamento do modelo (ex: "Responda sempre em português formal").

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.
• System Prompt: quando fornecido via POST, o modelo recebe uma mensagem de sistema que define seu comportamento antes de processar o prompt do usuário.

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"
}

# POST com system_prompt (configura comportamento do modelo)
POST /api/ia/generate/text
Content-Type: application/json

{
  "prompt": "Explique o que é recursão",
  "system_prompt": "Você é um professor de programação. Responda de forma didática com exemplos de código em Python."
}

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