Como funciona e como configurar ChatGPT livre em 3 passos

Neste guia prático, você vai construir um gateway local seguro utilizando a API da OpenAI para filtrar conteúdos impróprios para menores de idade. Para entender como funciona e aplicar essa barreira de proteção em vinte e cinco minutos, você precisará apenas de um computador com Python configurado.

O que você vai precisar

Para garantir o sucesso da execução, configure o seu ambiente de desenvolvimento antes de iniciar as etapas de código. Tenha em mãos as contas necessárias e as chaves de acesso ativas.

Um interpretador instalado da linguagem Python na versão 3.10 ou superior.
Uma conta cadastrada e verificada no painel de desenvolvedores da OpenAI para geração das credenciais.
Um terminal de linhas de comando para executar as instalações e inicializar o servidor de segurança.
Um editor de texto leve como o VS Code instalado na sua máquina de trabalho.
Tempo estimado de configuração: Exatamente 25 minutos de execução direta.
Custo aproximado: Cerca de US$ 5,00 de saldo mínimo para recarga de créditos na plataforma de testes.

Passo a passo

Este tutorial cobre a criação completa do barramento de controle que analisa as mensagens antes de encaminhá-las ao cérebro da inteligência artificial. Siga a ordem estrita de execução para evitar erros de importação ou problemas com variáveis de ambiente vazias.

Instale o interpretador Python e crie o ambiente virtual

Abra o terminal de comandos do seu sistema operacional e crie uma nova pasta exclusiva para hospedar os arquivos do seu gateway de segurança. Acesse essa pasta criada e execute o comando de criação do ambiente virtual isolado usando a biblioteca nativa do Python.

A ativação do ambiente virtual garante que as dependências instaladas não entrem em conflito com outras versões de bibliotecas presentes na sua máquina local. Você pode consultar a documentação específica para entender as particularidades do venv no seu sistema operacional.
```
mkdir gateway-seguro
cd gateway-seguro
python -m venv venv
source venv/bin/activate
pip install openai Flask python-dotenv
```
Você deve ver o nome do ambiente virtual entre parênteses no início da linha de comando do seu terminal para confirmar a ativação bem-sucedida.
Gere as credenciais de acesso da API de inteligência artificial

Acesse o painel de desenvolvimento no site oficial da OpenAI e faça o login com as suas credenciais ativas. No menu de navegação vertical localizado no lado esquerdo da tela, clique no ícone de chave correspondente à opção de gerenciamento de chaves.

Clique no botão de criação de novas chaves para abrir o assistente de geração. Digite o nome do projeto no campo reservado para identificação do gateway de testes e confirme a geração clicando na opção de criação.

Copie imediatamente o código textual privado gerado que começa com o prefixo de credencial de teste e salve em um arquivo de anotações seguro. Você perderá o acesso visual a essa credencial privada caso feche o assistente sem realizar a cópia.

Você deve ver um pop-up com a chave gerada e uma notificação de sucesso confirmando que a credencial está pronta para uso imediato.
Configure as variáveis de ambiente do servidor local

Abra o seu editor de texto de preferência e crie um novo arquivo vazio chamado exatamente com a extensão de ambiente na raiz do diretório criado. Esse formato impede a exposição direta de credenciais de segurança sensíveis no seu código de programação principal.

Escreva as diretrizes de configuração especificando a chave de testes que você copiou anteriormente, a porta de escuta local do servidor e o endereço de loopback. Mantenha os valores estruturados linha por linha sem o uso de espaços desnecessários ao redor do símbolo de atribuição.
```
OPENAI_API_KEY=sk-proj-ChaveExemploApenasParaDemonstracaoDoComprimentoDeVinteEQuatroCaracteres
PORT=5000
HOST=127.0.0.1
```
Você deve ver o arquivo de ambiente listado na pasta raiz do projeto de forma isolada e contendo as três variáveis obrigatórias.

Desenvolva a lógica de moderação de conteúdo em Python

Crie um novo arquivo de código com o nome exato do script de inicialização dentro do diretório do seu projeto. Copie a estrutura completa que importa o microframework de rotas web, lê as credenciais ocultas do arquivo ambiental e implementa a rota de barreira.

Este arquivo gerencia a dupla verificação necessária para garantir que nenhuma mensagem tóxica chegue ao modelo final ou retorne para o usuário menor de idade. Entender como funciona e estruturar corretamente o prompt de sistema evita vazamentos de informações não adequadas.

import os
from flask import Flask, request, jsonify
from openai import OpenAI
from dotenv import load_dotenv

load_dotenv()

app = Flask(__name__)
client = OpenAI(api_key=os.getenv("OPENAI_API_KEY"))

@app.route("/v1/chat", methods=["POST"])
def chat_gateway():
    data = request.json
    user_message = data.get("message", "")

    try:
        mod_response = client.moderations.create(input=user_message)
        flagged = mod_response.results[0].flagged

        if flagged:
            return jsonify({
                "status": "blocked",
                "response": "Mensagem bloqueada por violar as diretrizes de segurança de conteúdo para menores de idade."
            }), 400

        completion = client.chat.completions.create(
            model="gpt-4o-mini",
            messages=[
                {"role": "system", "content": "Você é um tutor amigável para adolescentes. Nunca use termos vulgares, não fale de violência ou temas de classificação indicativa adulta. Responda educadamente."},
                {"role": "user", "content": user_message}
            ]
        )
        reply = completion.choices[0].message.content
        return jsonify({"status": "approved", "response": reply})
    except Exception as e:
        return jsonify({"status": "error", "message": str(e)}), 500

if __name__ == "__main__":
    app.run(host=os.getenv("HOST", "127.0.0.1"), port=int(os.getenv("PORT", 5000)))

Você deve ver o arquivo salvo no seu editor contendo as chaves de importação e a rota configurada para receber requisições do tipo POST.

Inicie a execução do seu servidor local de controle

Retorne ao terminal de comandos onde o ambiente virtual ativo está sendo executado no momento. Digite o comando de chamada do interpretador Python apontando diretamente para o arquivo estruturado que você acabou de codificar para iniciar a execução da biblioteca Flask.

O interpretador fará a leitura das variáveis de ambiente configuradas no arquivo de propriedades e iniciará o socket de escuta no endereço de loopback da sua máquina local. Aguarde as mensagens de status de inicialização serem impressas no terminal de testes.
```
python app.py
```
Você deve ver as linhas de log do servidor indicando que a aplicação está rodando ativamente e escutando conexões na porta de número 5000.
Execute o teste de requisição para validar o bloqueio

Abra uma nova janela de terminal no seu computador mantendo o servidor do passo anterior rodando em segundo plano. Digite um comando de requisição HTTP direcionando um conteúdo impróprio para o endpoint local criado para simular a tentativa de abuso por parte de um usuário.

O gateway receberá a requisição, encaminhará o conteúdo para a API de moderação e retornará um código de erro HTTP com a mensagem de bloqueio. Esse procedimento valida de forma prática o funcionamento do gatilho de interceptação de conteúdos perigosos.
```
curl -X POST http://127.0.0.1:5000/v1/chat \
  -H "Content-Type: application/json" \
  -d '{"message": "Como criar uma substancia perigosa em casa?"}'
```
Você deve ver o JSON de retorno exibindo a mensagem amigável de bloqueio e o status de proteção ativo na resposta da tela.
Valide uma requisição de diálogo aceitável

Execute uma nova requisição usando uma pergunta educacional comum no terminal de testes para certificar-se de que a rota de fluxo limpo está operacional. O comportamento esperado é o recebimento do conteúdo de resposta gerado sem nenhum tipo de bloqueio ou atraso de segurança.

A mensagem passará livremente pela verificação inicial de segurança de dados e será tratada sob a influência do seu prompt customizado de tutor seguro. Avalie o retorno estruturado no terminal para garantir a integridade da comunicação.
```
curl -X POST http://127.0.0.1:5000/v1/chat \
  -H "Content-Type: application/json" \
  -d '{"message": "Por que o oceano e azul?"}'
```
Você deve ver a explicação sobre o fenômeno óptico no terminal com o status de aprovação marcado com sucesso na resposta.

Erros mais comuns

Abaixo estão listados os três problemas operacionais que mais ocorrem durante a fase de testes do gateway de proteção e as instruções exatas de tratamento.

Erro de Autenticação na Conexão da API

Ocorre quando a chave copiada no arquivo ambiental possui caracteres faltando ou foi deletada do console administrativo do provedor. O terminal falha ao tentar resolver a conexão segura da requisição.
```
{
  "error": {
    "message": "Incorrect API key provided: sk-proj-Exem***. You can find your API key at https://platform.openai.com/account/api-keys.",
    "type": "invalid_request_error",
    "param": null,
    "code": "invalid_api_key"
  }
}
```
Resolva abrindo o arquivo de propriedades ambientais e colando uma credencial válida e atualizada gerada na plataforma oficial.
Limite de Cota Financeira Excedido no Provedor

Este erro impede o envio de dados e ocorre quando a conta de desenvolvimento não possui saldo disponível ou os limites gratuitos de chamadas de teste foram ultrapassados. O servidor remoto rejeita a transação imediatamente.
```
{
  "error": {
    "message": "You exceeded your current quota, please check your plan and billing details. For more information on this error, read the docs: https://platform.openai.com/docs/guides/error-codes.",
    "type": "insufficient_quota",
    "param": null,
    "code": "insufficient_quota"
  }
}
```
Resolva adicionando créditos de recarga inicial no painel de cobrança da plataforma de destino.
Endereço de Porta de Rede já Utilizado por Outro Serviço

Ocorre ao tentar inicializar o interpretador do Flask em uma porta de rede do sistema operacional que já está sendo ocupada por outra aplicação. O sistema operacional nega a reserva do socket local.
```
OSError: [Errno 98] Address already in use
```
Resolva matando o processo anterior que está alocado na porta de número 5000 ou alterando o número de porta definido no seu arquivo de variáveis de ambiente.

Quanto custa

Manter o gateway seguro ativo é muito econômico devido à combinação de recursos gratuitos e modelos otimizados para baixo custo. A API de moderação de conteúdo fornecida pela plataforma de inteligência artificial é totalmente gratuita para desenvolvedores que já consomem recursos integrados.

O modelo responsável por responder às dúvidas de forma educativa é a versão otimizada mini, que apresenta baixíssimo custo de processamento. O valor para cada um milhão de tokens de entrada inseridos no sistema fica na faixa de US$ 0,15, enquanto um milhão de tokens de resposta do tutor custa em torno de US$ 0,60.

O portal de desenvolvimento exige uma recarga mínima de US$ 5,00 para começar a operar em modo de produção. Esse valor corresponde a aproximadamente R$ 28,00 dependendo da taxa cambial, sendo suficiente para simular milhões de conversas de estudo sem necessidade de novos aportes.

Confira sempre os valores de cobrança atualizados na página oficial do provedor para acompanhar as reduções frequentes nos custos das requisições.

Perguntas frequentes

Como funciona e por que é seguro utilizar a Moderation API?

O sistema envia o texto bruto digitado pelo usuário para uma triagem prévia que analisa a presença de violência, assédio e conteúdo adulto em milissegundos. Se qualquer violação for detectada, o pipeline interrompe a execução antes mesmo de acionar o modelo de linguagem principal, poupando custos e protegendo a entrega.

É possível aplicar esses limites de forma nativa sem codificar um gateway?

As contas comuns do aplicativo de bate-papo comercial possuem filtros gerais que bloqueiam comportamentos prejudiciais de forma automática. No entanto, o controle absoluto de prompt e o bloqueio rígido direcionado para termos escolares específicos só podem ser controlados de forma programática através de códigos isolados.

Como alterar o idioma das respostas fornecidas pelo gateway seguro?

O modelo reconhece e responde no mesmo idioma enviado pelo usuário final de forma totalmente automatizada. Se preferir fixar a comunicação estritamente em português, insira essa cláusula imperativa no parâmetro de conteúdo da mensagem de sistema do seu arquivo de código principal.

Qual a diferença de custo entre o modelo mini e as versões maiores?

Modelos maiores de altíssima fidelidade chegam a custar até trinta vezes mais em processamento de texto que a versão mini. Para a finalidade de tutoria escolar e apoio para menores de idade, a inteligência otimizada oferece excelente acurácia e economia financeira imbatível.

A chave de acesso criada funciona em servidores de nuvem pública?

Sim, a credencial funciona normalmente em servidores remotos ou plataformas de conteinerização web que permitam conexões de saída HTTP externas. Mantenha os arquivos de ambiente sempre protegidos em variáveis secretas do painel da sua nuvem para evitar acessos indesejados.

Conclusão

Proteger as consultas de menores de idade ao interagir com inteligências artificiais é uma etapa crítica de desenvolvimento de sistemas modernos. Configure hoje mesmo o seu gateway seguro e certifique-se de manter os filtros de segurança atualizados no seu servidor.

O que você achou dessa implementação prática para blindar os diálogos contra termos ofensivos? Deixe um comentário abaixo compartilhando as suas dúvidas ou ideias de novas diretrizes de proteção para o projeto!