Configuração do provedor

Antes de qualquer código de agente rodar, ele precisa saber para onde enviar uma requisição, qual chave o autoriza e qual modelo usar. Esta página coloca esses três valores no lugar.

Sua chave de API é uma credencial

Trate como se fosse uma senha. Nunca cole em um arquivo JavaScript, nunca faça commit, nunca poste em uma mensagem do Discord pedindo ajuda. Qualquer um com sua chave pode gastar seu crédito.

Por isso o curso mantém toda chamada de API em um servidor em vez do navegador. Código no navegador é visível para qualquer um que abra as ferramentas de desenvolvedor, então uma chave usada ali é uma chave que você entregou.

Verifique o que você já tem

Se você fez Intro to AI Engineering, essas variáveis podem estar ainda salvas na sua conta Scrimba.

Abra Settings no editor Scrimba, então selecione Edit Environment. Procure por três entradas nomeadas exatamente AI_URL, AI_KEY e AI_MODEL.

Se todos os três estão lá e apontam para um provedor com o qual você ainda tem crédito, você provavelmente está pronto. Pule para modelos recomendados e confirme que o modelo em AI_MODEL suporta tool calling, já que esse requisito é mais rigoroso neste curso que no anterior.

Se algum estiver faltando, ou você quer trocar de provedor, continue lendo.

JunoVerifique o que você já tem Antes de se inscrever em qualquer coisa, olhe em Settings, depois Edit Environment. Intro to AI Engineering usou esses três nomes exatos, então podem estar lá.

Verificar leva alguns segundos e pode economizar você criando uma conta que não precisa.

JunoVerifique o que você já tem Os nomes vêm de Intro to AI Engineering sem mudanças. O que conferir em vez de assumir é que o modelo em AI_MODEL suporte tool calling.

O curso anterior não precisava disso, então um conjunto de valores que funcionava lá ainda pode falhar aqui.

JunoVerifique o que você já tem Reutilizar os valores é tranquilo. Se você perdeu a conta de onde essa chave foi colada desde o último curso, este é um bom momento para rotacioná-la: crie uma chave nova, salve e revogue a antiga.

Qual provedor

OpenAI é a escolha mais segura para este curso. Sua API é aquela da qual vem a Responses API, e usá-la exige crédito de API pago. Os custos dependem do modelo, tamanho da requisição e quanto você experimenta, então verifique o preço atual antes de adicionar um valor que você se sinta confortável usando.

OpenRouter é a alternativa se você não pode ou não quer usar OpenAI. É uma API única que roteia para muitos provedores, incluindo modelos gratuitos, e serve a mesma Responses API de estilo OpenAI que o curso chama, então o código do curso não muda.

De qualquer forma a configuração segue o mesmo padrão: crie uma conta, gere uma chave, depois armazene a URL do provedor, sua chave e um ID de modelo.

JunoQual provedor Ambos os provedores funcionam para cada lição. OpenAI é aquele que as lições usam, o que o torna o mais fácil de acompanhar.

Escolha OpenRouter se pagar OpenAI diretamente é incômodo para você, ou se você quer uma conta que alcance muitos modelos.

JunoQual provedor O código do curso não muda entre os dois, porque usa o cliente OpenAI com AI_URL como sua URL base. Apontar essa URL para OpenRouter é toda a mudança.

JunoQual provedor "Compatível com OpenAI" funciona bem para o formato de requisição e menos bem nas bordas, onde o trabalho com agentes vive: argumentos rigorosos de ferramentas, forçar ou desabilitar uso de ferramentas, saída estruturada. OpenRouter passa sua requisição para qualquer provedor upstream que serve esse modelo, então compatibilidade é por rota, não por gateway.

Configurando OpenAI

Vá para a plataforma de desenvolvedor OpenAI e faça login ou crie uma conta.

ChatGPT Plus não é crédito de API

A plataforma de desenvolvedor é faturada separadamente de uma assinatura ChatGPT. Ter ChatGPT Plus não dá nenhum crédito à sua conta de API.

Abra Billing nas configurações da plataforma e adicione crédito se sua conta precisar. Você não precisa de um modelo caro para este curso: uma pequena quantidade de crédito com um modelo leve é suficiente para acompanhar.

Agora abra API keys nas configurações da plataforma e selecione Create new secret key. Dê à chave um nome que ajude você a lembrar para o quê é. Quando a chave é criada, copie-a imediatamente, porque o valor completo é mostrado apenas uma vez.

De volta no Scrimba, abra Edit Environment e configure:

AI_URL=https://api.openai.com/v1
AI_KEY=your-api-key-here
AI_MODEL=gpt-5.4-nano

gpt-5.4-nano é o modelo padrão do curso. Veja modelos recomendados se você quer algo diferente. Salve as variáveis de ambiente uma vez que todos os três estejam no lugar.

JunoConfigurando OpenAI A chave secreta é mostrada uma vez, então copie para Scrimba enquanto o diálogo ainda está aberto. Se você fechá-lo muito cedo, delete essa chave e crie uma nova.

JunoConfigurando OpenAI Faça duas coisas na mesma sessão: copie a chave direto para Scrimba enquanto está visível, e configure um limite de gasto em Billing antes de sair.

Um nome que você reconheça depois importa quando você tem várias chaves e precisa revogar uma.

JunoConfigurando OpenAI Uma chave nomeada por uso é o que deixa você revogar com precisão. Se você não consegue dizer qual chave vazou, você tem que revogar todas e atualizar tudo que as usava.

Configurando OpenRouter

Crie uma conta OpenRouter, abra a página API Keys e crie uma chave para Scrimba.

OpenRouter tem modelos gratuitos, mas eles nem sempre estarão disponíveis ou se comportarão da mesma forma de uma execução para a próxima, o que torna difícil dizer se um resultado estranho veio do seu código ou do modelo. Então a escolha mais segura é a mesma que com OpenAI: carregue uma pequena quantidade de crédito e escolha um modelo leve pago se você quer resultados consistentes.

Se você planeja usar endpoints gratuitos, abra as configurações de Privacy e revise as opções de política de dados antes de ativá-las. Endpoints gratuitos podem rotear suas requisições para provedores com políticas de dados diferentes, então tome uma decisão deliberada antes de enviar algo real para eles.

No Scrimba, configure:

AI_URL=https://openrouter.ai/api/v1
AI_KEY=your-api-key-here
AI_MODEL=mistralai/ministral-3b-2512

mistralai/ministral-3b-2512 é um dos modelos recomendados para OpenRouter. Salve as variáveis de ambiente.

JunoConfigurando OpenRouter Observe o formato do ID do modelo. No OpenRouter começa com o provedor, então é mistralai/ministral-3b-2512, não o nome curto sozinho.

JunoConfigurando OpenRouter O prefixo do provedor faz parte do ID, que é o que observar quando você copia um nome de modelo de qualquer outro lugar.

Se você habilitar modelos gratuitos, abra Privacy primeiro. Controla quais provedores upstream suas requisições podem alcançar.

JunoConfigurando OpenRouter As configurações de Privacy decidem se seus prompts podem ir para endpoints que os retêm ou trenam com eles, e os termos variam por provedor upstream.

Para exercícios de curso isso tem baixo risco, mas a configuração fica na conta para tudo que você enviar depois.

Os três valores se movem juntos

A falha de configuração mais comum é um conjunto incompatível em vez de um único valor errado. Uma chave válida com a URL de outro provedor falha, e uma configuração de provedor válida com um ID de modelo que esse provedor não oferece falha também. Ambas produzem erros de autenticação ou modelo não encontrado que parecem como se algo estivesse quebrado no código do curso.

Então sempre que você trocar de provedor, mude AI_URL, AI_KEY e AI_MODEL como um conjunto, e salve-os juntos.

Rodando o código em sua própria máquina?

Scrimba armazena esses como variáveis de ambiente no nível da conta, é por isso que não há arquivo .env no projeto do navegador. Em sua própria máquina você colocará os mesmos três valores em um arquivo .env em vez disso. Rodando o código localmente cobre isso.

JunoOs três valores se movem juntos Se você vir um erro de autenticação ou modelo não encontrado, verifique esses três valores antes de qualquer coisa que você escreveu. Geralmente um deles é deixado de uma configuração anterior.

JunoOs três valores se movem juntos Leia todos os três valores de cima para baixo antes de abrir qualquer código. Se eles combinam e o erro diz autenticação, a chave em si pode ser inválida ou revogada, então crie uma nova.

JunoOs três valores se movem juntos Ambas as falhas descrevem o que aconteceu no provedor, não por quê. Uma chave enviada para a URL de outro provedor lê como uma chave ruim, e um modelo fora do catálogo do provedor lê como um erro de digitação.

Para onde isso vai a seguir

Modelos recomendados cobre o que torna um modelo adequado para trabalho com agentes e quais foram testados contra este curso. Se você prefere ver como a requisição em si é montada, Chat Completions e Responses compara as duas formas de API.

JunoPara onde isso vai a seguir Escolha um modelo a seguir e coloque seu ID em AI_MODEL.

JunoPara onde isso vai a seguir Todo modelo em sua tabela foi testado para tool calling, então comece ali.

JunoPara onde isso vai a seguir A página de API mostra a requisição que esses três valores configuram.