Pular para o conteúdo

Ligar uma API compatível com OpenAI

Muitos serviços e servidores de IA falam o mesmo formato de API que a OpenAI. O atbridge.ai funciona com todos eles através de uma única opção de fornecedor, Compatível com OpenAI (URL personalizado). Não instala nada nem espera por uma integração: introduza o Base URL e a chave de API do serviço, e o atbridge Chat IA usa-o como qualquer outro fornecedor.

Casos típicos:

  • Um modelo no seu próprio computador ou servidor: LM Studio, vLLM, o servidor llama.cpp, LocalAI.
  • Um proxy gerido pela sua empresa, por exemplo o LiteLLM à frente de vários fornecedores.
  • Um gateway de API ou revendedor que lhe dá acesso a modelos através de um endpoint compatível com OpenAI.
  • Base URL: o endereço da API indicado na documentação do seu fornecedor. É o mesmo valor a que o SDK da OpenAI chama base_url, por exemplo https://llm.example.com/v1. Cole-o exatamente como está documentado; o atbridge.ai aceita-o com ou sem o /v1 final.
  • Chave de API: criada no painel do seu fornecedor. Um servidor local que não verifica chaves aceita qualquer valor de substituição, como local.

O serviço tem de suportar dois endpoints padrão da OpenAI com autenticação Authorization: Bearer: /v1/chat/completions (o próprio chat) e /v1/models (a lista de modelos, que o atbridge.ai também usa para verificar a ligação). Quase todos os serviços compatíveis com OpenAI e servidores locais disponibilizam ambos.

Servidores locais comuns e os seus Base URL habituais (confirme a sua própria configuração):

ServidorBase URL habitual
LM Studiohttp://localhost:1234/v1
vLLMhttp://localhost:8000/v1
llama.cpp serverhttp://localhost:8080/v1
LiteLLM proxyhttp://localhost:4000
  1. No Thunderbird, abra as Definições do atbridge: a engrenagem, ou Ferramentas → Extensões e Temas → atbridge.ai → Opções (consulte Abrir as definições da extensão atbridge). Vá ao separador Provedores de IA.

  2. No menu Provedor, escolha Compatível com OpenAI (URL personalizado).

  3. Preencha Base URL e cole a sua chave em Chave de API. A chave é encriptada neste dispositivo e nunca chega aos servidores do atbridge.ai.

  4. Clique em Conectar. O atbridge.ai verifica de imediato o endereço e a chave, pedindo a lista de modelos. Se a verificação passar, o estado passa a um ✓ verde; se falhar, nada é guardado e vê o motivo.

Abra o atbridge Chat IA (o botão @b no Thunderbird) e escolha um modelo no menu de modelos, que mostra os modelos que o serviço indica. Um gateway pode listar centenas de modelos; para usar um pelo nome exato, escreva-o em id de modelo personalizado em Definições → Provedor e modelo de IA preferidos.

Com um fornecedor compatível com OpenAI, os seus pedidos, e qualquer texto de email ou anexos que dê ao Chat IA, são enviados para o Base URL que introduziu. O atbridge.ai não os encaminha nem os guarda. Antes de ligar um serviço, confirme que confia em quem o gere e leia os respetivos termos de privacidade e de retenção de dados. Para email que não pode sair do seu computador, use um servidor local (a tabela acima) ou o Ollama.

A mesma ligação a partir de um terminal; a chave é lida da entrada padrão, pelo que fica fora do histórico da shell:

Terminal window
echo "$MY_API_KEY" | atbridge connect activate --provider openai-compatible \
--base-url https://llm.example.com/v1 --key-stdin
  • 404 ou “not found”: o Base URL está errado. Copie-o novamente da documentação do fornecedor; normalmente é o endereço que termina em /v1.
  • 401 ou 403: a chave está errada, expirou ou não tem acesso a esse modelo.
  • O URL está certo, mas Conectar continua a falhar: o serviço pode não disponibilizar a lista de modelos (/v1/models), de que o atbridge.ai precisa para verificar a ligação. Pergunte ao seu fornecedor se a suporta.
  • O chat responde, mas nunca consulta o seu email: o modelo não suporta chamada de ferramentas. Escolha outro modelo.

Was this page helpful?