Conectando o Assistente ao OpenRouter com Modelos Gratuitos

Conectando o Assistente ao OpenRouter com Modelos Gratuitos — aula do módulo OpenCode & Assistentes no Editor, na trilha Provedores e Modelos Gratuitos com…

Leitura de aproximadamente 4 minutos.

Módulo: OpenCode & Assistentes no Editor · Curso: Provedores e Modelos Gratuitos com OpenRouter & OpenCode · Formação: Formação Nível Zero: Ferramentas Essenciais e Gratuitas de IA e Código

Conectando o Assistente ao OpenRouter com Modelos Gratuitos

O que você vai aprender

1. A Ponte entre o Editor e o OpenRouter

Na aula anterior, instalamos o assistente de código no seu editor (como a extensão Cline ou OpenCode). No entanto, a extensão instalada é como um aparelho de rádio desligado da tomada: ela possui a interface e os botões prontos, mas precisa de uma fonte de sinal para funcionar.

A fonte de sinal é o OpenRouter, e o canal de conexão é a Chave de API que você gerou no submódulo anterior.

Quando você configura esses parâmetros na extensão, o editor passa a enviar suas perguntas e seus arquivos de código para os servidores do OpenRouter através de conexões criptografadas (HTTPS, o protocolo seguro da web). O OpenRouter processa a solicitação no modelo escolhido e devolve o texto gerado de forma contínua e em tempo real (streaming) diretamente na sua tela.


+-------------------------------------------------------------------------------+
|                       FLUXO DE CONFIGURAÇÃO E RESPOSTA STREAMING              |
+-------------------------------------------------------------------------------+
|                                                                               |
|   1. No Painel da Extensão (Configuração):                                    |
|      • API Provider:  [ OpenRouter                              ]             |
|      • API Key:       [ sk-or-v1-xxxxxxxxxxxxxxxxxxxxxxxxxxxx   ]             |
|      • Model:         [ qwen/qwen3.8-27b:free                   ]             |
|                                                                               |
|   2. Durante a Conversa:                                                      |
|      [Você digita instrução] ──> [Extensão monta prompt]                     |
|                                         │                                     |
|                                         ▼ (Requisição HTTPS)                  |
|                              [https://openrouter.ai/api/v1]                   |
|                                         │                                     |
|                                         ▼                                     |
|                              [Modelo de IA Processa]                          |
|                                         │                                     |
|                                         ▼ (Resposta em Streaming)             |
|                              [Texto surge no seu Editor]                      |
|                                                                               |
+-------------------------------------------------------------------------------+

2. Passo a Passo de Configuração no Editor

Siga este roteiro detalhado para estabelecer a conexão no seu assistente:

1. Abra o Painel do Assistente: Na barra lateral esquerda do seu editor, clique no ícone da extensão instalada. 2. Abra as Configurações: Clique no ícone de engrenagem (Settings) localizado no topo do painel lateral. 3. Selecione o Provedor de API (API Provider):


+-------------------------------------------------------------------------------+
|                       TELA DE CONFIGURAÇÃO DA EXTENSÃO (CLINE)                |
+-------------------------------------------------------------------------------+
|                                                                               |
|   API Provider:  [ OpenRouter                                           ▼ ]   |
|   API Key:       [ sk-or-v1-9876543210fedcba9876543210fedcba            ]   |
|   Model:         [ qwen/qwen3.8-27b:free                                ▼ ]   |
|                                                                               |
|   [ Done / Salvar Configuração ]                                              |
|                                                                               |
+-------------------------------------------------------------------------------+

3. Validando a Conexão com um Teste Prático

Após salvar as configurações, retorne à tela principal de chat do assistente para verificar se a comunicação está ativa:

Digite a seguinte mensagem no campo de texto do assistente e pressione Enter:


Olá! Por favor, responda com uma frase confirmando que você está conectado e me dê um exemplo de 3 linhas de código HTML de um botão estilizado.

Se a configuração estiver correta:

4. Armadilhas Comuns e Como Evitar

[!WARNING]
Erro "Insufficient Balance" ou "Model Not Found": Se ao enviar a primeira mensagem você receber uma mensagem de erro mencionando saldo insuficiente (insufficient credits) ou modelo não encontrado, verifique a grafia do nome do modelo nas configurações. Esse erro ocorre quase sempre quando esquecemos de incluir o sufixo :free no final do identificador. Sem o :free, o OpenRouter tentará acessar o servidor comercial pago daquele modelo.

Exercício Prático

Configure e teste a sua conexão gratuita no editor:

1. Abra as configurações do seu assistente: Localize o ícone de engrenagem no painel lateral. 2. Preencha os dados do OpenRouter:


   Crie uma função simples em JavaScript que calcule a média de três números.

4. Verifique o consumo: Olhe para o rodapé da mensagem da IA e confirme que a resposta foi concluída com sucesso com custo zero ($0.0000).

Outras aulas do módulo