PHPackages brunoquiodetto/ai-text-humanizer-api - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [API Development](/categories/api) 4. / 5. brunoquiodetto/ai-text-humanizer-api ActiveLibrary[API Development](/categories/api) brunoquiodetto/ai-text-humanizer-api ==================================== 🤖 API REST para humanização de textos e chamados usando inteligência artificial. Transforma mensagens técnicas em comunicação empática e humanizada. 1.0.0(9mo ago)11MITHTMLPHP >=8.1 Since Sep 11Pushed 9mo agoCompare [ Source](https://github.com/BrunoQuiodetto/ai-text-humanizer-api)[ Packagist](https://packagist.org/packages/brunoquiodetto/ai-text-humanizer-api)[ Docs](https://github.com/brunoquiodetto/ai-text-humanizer-api)[ RSS](/packages/brunoquiodetto-ai-text-humanizer-api/feed)WikiDiscussions main Synced today READMEChangelog (1)Dependencies (2)Versions (2)Used By (0) 🤖 AI Text Humanizer API ======================= [](#-ai-text-humanizer-api) [![Latest Stable Version](https://camo.githubusercontent.com/7ca0b0e42f6223d67c0a1d99274a2ffafeecdf634de97d74d01f381a0c380b96/68747470733a2f2f706f7365722e707567782e6f72672f6272756e6f7175696f646574746f2f61692d746578742d68756d616e697a65722d6170692f762f737461626c65)](https://packagist.org/packages/brunoquiodetto/ai-text-humanizer-api)[![Total Downloads](https://camo.githubusercontent.com/a3f93e213e21100438c42045fe8be071953b5de8fe1d4f9bea4612b3b1bacf73/68747470733a2f2f706f7365722e707567782e6f72672f6272756e6f7175696f646574746f2f61692d746578742d68756d616e697a65722d6170692f646f776e6c6f616473)](https://packagist.org/packages/brunoquiodetto/ai-text-humanizer-api)[![License](https://camo.githubusercontent.com/5745d1022375f5d802a5f193bdb008d90ee7bff8cce8d5823431720001c618b5/68747470733a2f2f706f7365722e707567782e6f72672f6272756e6f7175696f646574746f2f61692d746578742d68756d616e697a65722d6170692f6c6963656e7365)](https://packagist.org/packages/brunoquiodetto/ai-text-humanizer-api)[![PHP Version](https://camo.githubusercontent.com/6518db1335bf20fdff07253dc6d6d0cec955b5fb6a8ef1382ac6d73687ecc07f/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f7068702d253345253344382e312d626c7565)](https://packagist.org/packages/brunoquiodetto/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 ----------------- [](#-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-rápida) ``` # Via Composer composer create-project brunoquiodetto/ai-text-humanizer-api # Ou como dependência composer require brunoquiodetto/ai-text-humanizer-api ``` 🚀 Instalação e Configuração --------------------------- [](#-instalação-e-configuração) ### Pré-requisitos [](#pré-requisitos) - PHP 7.4 ou superior - Extensão cURL habilitada - Servidor web (Apache/Nginx) - Conta no [OpenRouter](https://openrouter.ai/) para obter API key ### 1. Clone ou baixe o projeto [](#1-clone-ou-baixe-o-projeto) ``` git clone [URL_DO_SEU_REPOSITORIO] cd ai-text-humanizer-api ``` ### 2. Configure a API Key [](#2-configure-a-api-key) 1. Copie o arquivo de configuração de exemplo: ``` # Windows copy config\config.example.php config\config.php # Linux/Mac cp config/config.example.php config/config.php ``` 2. Edite o arquivo `config/config.php` e substitua `SEU_OPENROUTER_API_KEY_AQUI` pela sua API key do OpenRouter: ``` 'api_key' => 'sk-or-v1-sua-api-key-aqui', ``` ### 3. Configure o servidor web [](#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 [](#4-como-obter-sua-api-key-do-openrouter) 1. Acesse [OpenRouter](https://openrouter.ai/) 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 -------------------- [](#estrutura-do-projeto) ``` api/ ├── public/ │ ├── index.php # Ponto de entrada da API │ └── .htaccess # Configuração do Apache ├── src/ │ ├── controllers/ # Controladores da API │ │ └── humanizercontroller.php │ ├── services/ # Serviços │ │ └── openrouterservice.php │ ├── utils/ # Utilitários │ │ └── promptloader.php │ └── bootstrap.php # Arquivo de inicialização └── config/ ├── config.php # Configurações gerais └── prompts/ # Arquivos de prompt └── HumanizadordeChamado.yaml ``` Endpoints Disponíveis --------------------- [](#endpoints-disponíveis) ### 1. Humanizador de Texto (`POST /humanize`) [](#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:** ``` { "entrada": "me envia anexo do gestor pra eu te dar acesso", "NmsgD": "1" } ``` **Exemplo de resposta:** ``` { "success": true, "response": "Bom dia! Por favor, me envie em anexo a aprovação do seu gestor para que eu possa conceder acesso." } ``` ### 2. Health Check (`GET /health`) [](#2-health-check-get-health) Verifica o status da API. **Resposta:** ``` { "status": "ok", "timestamp": "2025-09-10 14:30:00", "version": "1.0.0" } ``` Códigos de Status HTTP ---------------------- [](#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 --------------------- [](#formato-das-respostas) ### Sucesso [](#sucesso) ``` { "success": true, "response": "Resultado da operação" } ``` ### Erro [](#erro) ``` { "success": false, "error": "Descrição do erro" } ``` Segurança --------- [](#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 ------------------- [](#-como-testar-a-api) ### Método 1: Testando Localmente via Interface Web [](#método-1-testando-localmente-via-interface-web) O projeto já inclui [scripts automáticos](./quick_start.md) 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-2-curl-terminal) ``` # Teste do health check curl -X GET http://seu-servidor/health # Teste do humanizador curl -X POST http://seu-servidor/humanize \ -H "Content-Type: application/json" \ -d '{ "entrada": "Me envia anexo do gestor pra eu te dar acesso", "NmsgD": "1" }' ``` ### Método 3: Postman ou Insomnia [](#método-3-postman-ou-insomnia) 1. **URL**: `POST http://seu-servidor/humanize` 2. **Headers**: `Content-Type: application/json` 3. **Body** (JSON): ``` { "entrada": "Me envia anexo do gestor pra eu te dar acesso", "NmsgD": "1" } ``` ### Método 4: JavaScript (Frontend) [](#método-4-javascript-frontend) ``` const response = await fetch('/humanize', { method: 'POST', headers: { 'Content-Type': 'application/json', }, body: JSON.stringify({ entrada: 'Me envia anexo do gestor pra eu te dar acesso', NmsgD: '1' }) }); const result = await response.json(); console.log(result); ``` 🔧 Solução de Problemas ---------------------- [](#-solução-de-problemas) ### Erro: "API Key inválida" [](#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" [](#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" [](#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" [](#erro-cors) - Os headers CORS já estão configurados - Se persistir, verifique se há proxy/firewall bloqueando ### Health Score 29 — LowBetter than 57% of packages Maintenance55 Moderate activity, may be stable Popularity3 Limited adoption so far Community6 Small or concentrated contributor base Maturity45 Maturing project, gaining track record Bus Factor1 Top contributor holds 100% of commits — single point of failure How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Unknown Total 1 Last Release 297d ago ### Community Maintainers ![](https://avatars.githubusercontent.com/u/172848046?v=4)[Bruno Quiodetto](/maintainers/brunoquiodetto)[@BrunoQuiodetto](https://github.com/BrunoQuiodetto) --- Top Contributors [![BrunoQuiodetto](https://avatars.githubusercontent.com/u/172848046?v=4)](https://github.com/BrunoQuiodetto "BrunoQuiodetto (3 commits)") --- Tags phpapiaiREST APInlptext-processingartificial intelligenceOpenRoutertext-humanizerhumanization ### Code Quality TestsPHPUnit Code StylePHP\_CodeSniffer ### Embed Badge ![Health badge](/badges/brunoquiodetto-ai-text-humanizer-api/health.svg) ``` [![Health](https://phpackages.com/badges/brunoquiodetto-ai-text-humanizer-api/health.svg)](https://phpackages.com/packages/brunoquiodetto-ai-text-humanizer-api) ``` ### Alternatives [deepseek-php/deepseek-php-client deepseek PHP client is a robust and community-driven PHP client library for seamless integration with the Deepseek API, offering efficient access to advanced AI and data processing capabilities. 46688.8k5](/packages/deepseek-php-deepseek-php-client)[grok-php/laravel Seamlessly integrate Grok AI into Laravel applications with an elegant, developer-friendly package. Leverage powerful AI models for chat, automation, and NLP while maintaining Laravel's expressive simplicity. 1673.9k](/packages/grok-php-laravel)[mozex/anthropic-php PHP client for the Anthropic API: messages, streaming, tool use, thinking, web search, code execution, batches, and more. 49552.5k18](/packages/mozex-anthropic-php)[rubix/server Deploy your Rubix ML models to production with scalable stand-alone inference servers. 642.3k](/packages/rubix-server)[grok-php/client Grok PHP Client is a robust and community-driven PHP client library for seamless integration with Grok AI API, offering efficient access to advanced AI and data processing capabilities. 317.4k4](/packages/grok-php-client)[softcreatr/php-mistral-ai-sdk A powerful and easy-to-use PHP SDK for the Mistral AI API, allowing seamless integration of advanced AI-powered features into your PHP projects. 1621.5k](/packages/softcreatr-php-mistral-ai-sdk) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)