Como usar o SDK da OpenAI em Node.js com uma API compatível (base URL + chave)?
Instale o pacote oficial openai e crie o cliente com baseURL apontando para o seu provedor e apiKey com a chave dele; o resto do código Node.js, incluindo streaming e tratamento de erros, fica igual.
Para usar o SDK da OpenAI em Node.js com uma API compatível, instale o pacote oficial openai e crie o cliente com dois parâmetros: baseURL, que aponta para a base URL do seu provedor, e apiKey, com a chave que esse provedor fornece. O resto do código fica igual: chat completions, streaming e tratamento de erros.
Nesta receita usamos como exemplo o Dongee AI Router, a API da Dongee compatível com OpenAI para vários modelos de IA. O padrão serve para qualquer API compatível com o padrão OpenAI.
O que você precisa antes de começar
- Node.js 20 ou superior e npm.
- Um projeto com módulos ESM. Use arquivos
.mjsou coloque"type": "module"no seupackage.json. - Uma API compatível com o padrão OpenAI. Você precisa da base URL, de uma chave e do nome exato do modelo.
O Dongee AI Router é uma API unificada que dá acesso a vários modelos de IA com uma única chave. Ele prioriza modelos rápidos hospedados no data center da Dongee no Canadá. Funciona com pré-pago a partir de 3 USD, sem mensalidade. Para levar seu código ao AI Router, você só troca a base URL e a chave.
Passo a passo com o Dongee AI Router
- Ative o AI Router e carregue saldo. Ele é ativado na sua área do cliente, então você precisa ser cliente da Dongee. Contas novas recebem um crédito de boas-vindas. Se o saldo acabar, as requisições param e não se gera dívida.
- Crie uma chave. Você pode criar quantas chaves quiser por conta. Recomendamos limitar cada uma aos modelos que você realmente usa. Os detalhes estão no guia para limitar uma chave de API a certos modelos de IA.
- Copie a base URL e o nome do modelo. Os dois aparecem na sua área do cliente. Copie o nome do modelo exatamente como aparece na lista: se diferir em uma única letra, a requisição vai falhar.
- Configure as variáveis de ambiente no servidor. Neste guia usamos
AI_ROUTER_BASE_URL,AI_ROUTER_API_KEYeAI_MODEL. São nomes de exemplo e você pode trocá-los. - Escreva o código (você vai vê-lo na próxima seção).
- Teste e confira o consumo. Na área do cliente, você vê o consumo por modelo, por chave e o detalhe de cada requisição.
Receita de código em Node.js (ESM)
1. Instale o pacote
npm install openai
2. Variáveis de ambiente (arquivo .env local, nunca no repositório)
AI_ROUTER_BASE_URL="<base URL da sua área do cliente>"
AI_ROUTER_API_KEY="<sua chave>"
AI_MODEL="<modelo da lista>"No Node 20 ou superior, você pode carregar o arquivo sem bibliotecas extras com node --env-file=.env app.mjs.
3. Cliente e requisição normal
// app.mjs
import OpenAI from "openai";
const client = new OpenAI({
baseURL: process.env.AI_ROUTER_BASE_URL,
apiKey: process.env.AI_ROUTER_API_KEY,
});
const model = process.env.AI_MODEL;
try {
const res = await client.chat.completions.create({
model,
messages: [
{ role: "system", content: "Responda em português, de forma breve." },
{ role: "user", content: "O que é uma base URL?" },
],
});
console.log(res.choices[0].message.content);
} catch (err) {
if (err instanceof OpenAI.APIError) {
console.error("Erro da API:", err.status, err.message);
} else {
console.error("Erro de rede ou de código:", err);
}
}4. Requisição com streaming
O AI Router suporta streaming. Adicione stream: true e percorra a resposta com for await:
try {
const stream = await client.chat.completions.create({
model,
messages: [{ role: "user", content: "Escreva três ideias de nomes para um blog." }],
stream: true,
});
for await (const chunk of stream) {
process.stdout.write(chunk.choices[0]?.delta?.content ?? "");
}
} catch (err) {
console.error("O stream falhou:", err.message);
}O try/catch evita que seu app caia e permite mostrar uma mensagem útil. Registre o status e a mensagem que a API retorna para diagnosticar. Não escreva lógica que dependa de códigos de erro específicos sem conferi-los antes nos seus próprios testes.
Segurança: onde fica a chave
- Nunca no navegador. Se a chave chegar ao frontend, qualquer pessoa pode vê-la e gastar seu saldo. O navegador deve chamar o seu backend, e é o seu backend que chama a API.
- Nunca no repositório. Adicione
.envao.gitignoreantes do primeiro commit. Isso vale também se você gerar o projeto com Lovable, Bolt, v0, Cursor, Claude Code ou Codex e subi-lo para o GitHub. - Uma chave por app ou ambiente. Como não há limite de chaves, você pode separar desenvolvimento e produção. Assim, vê o consumo de cada uma separadamente.
O AI Router não guarda suas conversas. Ele só registra os dados de faturamento de cada requisição, nunca o conteúdo.
Se você publicar o app na Dongee Live
A Dongee Live, serviço da Dongee para publicar apps feitos com IA, não publica nem implanta modelos de IA: seu app Node.js roda na Live e chama o modelo pelo AI Router. A Live suporta Node.js 20, 22 e 24 e tem suas próprias variáveis de ambiente, inclusive no Live Free (0 USD, 1 app). É ali que você guarda AI_ROUTER_BASE_URL, AI_ROUTER_API_KEY e AI_MODEL sem mexer no código. Se o seu app também usa banco de dados, veja como publicar um app Node.js com MySQL pelo Claude Code ou Cursor.
Comparação honesta: API unificada ou chamar cada provedor diretamente?
| Critério | API compatível unificada (ex.: AI Router) | Direto em cada provedor |
|---|---|---|
| Código | Um único SDK e uma única base URL | Um SDK ou configuração diferente por provedor |
| Chaves | Uma chave para vários modelos | Uma chave por provedor |
| Trocar de modelo | Você muda AI_MODEL | Pode exigir mudar o código |
| Recursos exclusivos de um provedor | Só o que o padrão OpenAI cobre | Acesso completo a tudo o que é próprio |
| Fallback entre modelos | Você programa (o AI Router não faz fallback próprio) | Você também programa |
Quando o Dongee AI Router NÃO é a melhor opção: se você depende de recursos que só um provedor oferece e que não fazem parte do padrão OpenAI, se precisa de um modelo que não está na lista ou se quer que o serviço faça fallback automático por você. Nesses casos, chamar diretamente esse provedor é a opção mais simples. Se o que você busca é gastar menos, leia como otimizar o consumo de tokens com roteadores de IA. Para distribuir requisições entre modelos, veja o roteamento inteligente entre modelos de linguagem.
Perguntas frequentes
Funciona com LangChain ou outras bibliotecas?
Se a biblioteca permite trocar a base URL e a chave do cliente compatível com OpenAI, o padrão é o mesmo. Teste no seu projeto antes de levar para produção.
Posso usá-lo atrás de um gateway como o LiteLLM?
Sim. Você pode colocar o AI Router atrás do seu próprio gateway, como o LiteLLM, e configurá-lo com a base URL e a chave.
Onde encontro a base URL e os nomes dos modelos?
Na sua área do cliente, depois de ativar o AI Router. Copie o nome do modelo exatamente como aparece na lista.
O que acontece se o meu saldo acabar?
As requisições param e não se gera dívida. Seu código deve capturar esse erro com try/catch para avisar o usuário sem que o app caia.
Posso chamar a API diretamente do React ou do navegador?
Não é recomendável: a chave ficaria exposta e qualquer pessoa poderia usar seu saldo. Crie um endpoint no seu servidor Node.js e chame a API a partir dele.
Em resumo
Com o SDK oficial openai, conectar-se a uma API compatível se resume a configurar baseURL e apiKey a partir de variáveis de ambiente e escolher o modelo pelo nome exato. Guarde a chave no servidor, confira o consumo na sua área do cliente e troque de modelo quando precisar, sem reescrever seu app.
Comenta lo que quieras
Unete a la charla
Solo ingresa tu email