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.
O que precisa
Seção intitulada “O que precisa”- 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 exemplohttps://llm.example.com/v1. Cole-o exatamente como está documentado; o atbridge.ai aceita-o com ou sem o/v1final. - 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):
| Servidor | Base URL habitual |
|---|---|
| LM Studio | http://localhost:1234/v1 |
| vLLM | http://localhost:8000/v1 |
| llama.cpp server | http://localhost:8080/v1 |
| LiteLLM proxy | http://localhost:4000 |
Adicione-a ao atbridge.ai
Seção intitulada “Adicione-a ao atbridge.ai”-
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.
-
No menu Provedor, escolha Compatível com OpenAI (URL personalizado).
-
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.
-
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.
Escolha um modelo e converse
Seção intitulada “Escolha um modelo e converse”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.
Quem vê os seus dados
Seção intitulada “Quem vê os seus dados”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.
Configurar a partir da linha de comandos
Seção intitulada “Configurar a partir da linha de comandos”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:
echo "$MY_API_KEY" | atbridge connect activate --provider openai-compatible \ --base-url https://llm.example.com/v1 --key-stdinSe não ligar
Seção intitulada “Se não ligar”- 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.
Relacionado
Seção intitulada “Relacionado”Was this page helpful?
Thanks for the feedback!