Download the PHP package brunoquiodetto/ai-text-humanizer-api without Composer

🤖 AI Text Humanizer API

Uma API REST moderna para humanização de textos e chamados usando inteligência artificial. Transforme comunicação técnica e formal em mensagens empáticas e humanizadas.

✨ Características

• 🤖 IA Avançada: Integração com OpenRouter para múltiplos modelos
• 📱 Interface Moderna: Design responsivo inspirado no Apple
• 🎯 Fácil de Usar: API REST simples e intuitiva
• 🔧 Configurável: Sistema flexível de configuração
• 🛡️ Robusto: Tratamento completo de erros
• 📖 Bem Documentado: Código limpo e documentação completa

🚀 Instalação Rápida

🚀 Instalação e Configuração

Pré-requisitos

• PHP 7.4 ou superior
• Extensão cURL habilitada
• Servidor web (Apache/Nginx)
• Conta no OpenRouter para obter API key

1. Clone ou baixe o projeto

2. Configure a API Key

1. Copie o arquivo de configuração de exemplo:

2. Edite o arquivo config/config.php e substitua SEU_OPENROUTER_API_KEY_AQUI pela sua API key do OpenRouter:

3. Configure o servidor web

Configure seu servidor web para apontar o DocumentRoot para a pasta public/.

4. Como obter sua API Key do OpenRouter

1. Acesse OpenRouter
2. Crie uma conta ou faça login
3. Vá para a seção "API Keys"
4. Gere uma nova API key
5. Copie a key e cole no arquivo config/config.php

⚠️ IMPORTANTE: Nunca compartilhe sua API key publicamente ou faça commit dela no Git!

Estrutura do Projeto

Endpoints Disponíveis

1. Humanizador de Texto (POST /humanize)

Humaniza textos de chamados técnicos, tornando-os mais claros e profissionais.

Parâmetros:

• entrada (string, obrigatório): O texto a ser humanizado
• NmsgD (string, obrigatório): Indicador se é a primeira mensagem do dia

Exemplo de requisição:

Exemplo de resposta:

2. Health Check (GET /health)

Verifica o status da API.

Resposta:

Códigos de Status HTTP

• 200: Sucesso
• 400: Erro de validação (parâmetros inválidos ou ausentes)
• 405: Método não permitido
• 404: Endpoint não encontrado
• 500: Erro interno do servidor

Formato das Respostas

Sucesso

Erro

Segurança

• CORS habilitado para todas as origens
• Headers de segurança configurados
• Validação de entrada implementada
• Tratamento de erros adequado

🧪 Como Testar a API

Método 1: Testando Localmente via Interface Web

O projeto já inclui scripts automáticos para inicialização do servidor em ambiente de desenvolvimento. Basta executar o comando de start disponível no seu gerenciador de dependências ou IDE. Consulte a documentação do projeto ou o arquivo package.json/composer.json para detalhes sobre os comandos disponíveis.

1. Acesse http://seu-servidor/teste.html no navegador
2. Preencha o formulário com um texto para humanizar
3. Clique em "🚀 Testar API"
4. Veja o resultado na tela

Método 2: cURL (Terminal)

Método 3: Postman ou Insomnia

1. URL: POST http://seu-servidor/humanize
2. Headers: Content-Type: application/json
3. Body (JSON):

Método 4: JavaScript (Frontend)

🔧 Solução de Problemas

Erro: "API Key inválida"

• Verifique se copiou a API key corretamente
• Confirme se a key está ativa no OpenRouter
• Certifique-se de que não há espaços extras na key
• Se for uma key gratuita atente-se as limitações de timeout ou limites de requisições.

Erro: "Arquivo de configuração não encontrado"

• Verifique se criou o arquivo config/config.php a partir do config.example.php
• Confirme as permissões de leitura do arquivo

Erro: "Endpoint não encontrado"

• Verifique se o servidor web está apontando para a pasta public/
• Confirme se o mod_rewrite está habilitado (Apache)
• Teste primeiro o endpoint /health

Erro: "CORS"

• Os headers CORS já estão configurados
• Se persistir, verifique se há proxy/firewall bloqueando