Configuración del proveedor

Antes de que pueda ejecutarse cualquier código del agente, necesita saber dónde enviar una solicitud, qué clave la autoriza y qué modelo usar. Esta página reúne esos tres valores.

Tu clave API es una credencial

Trátala como tratarías una contraseña. Nunca la pegues en un archivo JavaScript, nunca la hagas commit, nunca la publiques en un mensaje de Discord pidiendo ayuda. Cualquiera que tenga tu clave puede gastar tu crédito.

Por esa razón el curso mantiene cada llamada a la API en un servidor en lugar de en el navegador. El código del navegador es visible para cualquiera que abra las herramientas de desarrollo, así que una clave usada allí es una clave que regalaste.

Revisa qué ya tienes

Si tomaste Intro to AI Engineering, estas variables pueden estar guardadas en tu cuenta de Scrimba.

Abre Settings en el editor de Scrimba, luego selecciona Edit Environment. Busca tres entradas llamadas exactamente AI_URL, AI_KEY y AI_MODEL.

Si las tres están ahí y apuntan a un proveedor con el que aún tienes crédito, probablemente estés listo. Ve directo a modelos recomendados y confirma que el modelo en AI_MODEL soporta tool calling, ya que ese requisito es más estricto en este curso que en el anterior.

Si falta alguna, o quieres cambiar de proveedor, sigue leyendo.

JunoRevisa qué ya tienes Antes de registrarte en algo, mira en Settings, luego Edit Environment. Intro to AI Engineering usó estos tres nombres exactos, así que es posible que ya estén ahí.

Revisar toma unos pocos segundos y puede ahorrarte crear una cuenta que no necesitas.

JunoRevisa qué ya tienes Los nombres vienen de Intro to AI Engineering sin cambios. Lo que debes confirmar en lugar de asumir es que el modelo en AI_MODEL soporta tool calling.

El curso anterior no lo necesitaba, así que un conjunto de valores que funcionó allí puede fallar aquí.

JunoRevisa qué ya tienes Reutilizar los valores está bien. Si perdiste la pista de dónde esa clave fue pegada desde el último curso, este es un buen momento para rotarla: crea una clave nueva, guárdala y revoca la anterior.

Qué proveedor elegir

OpenAI es la opción más segura para este curso. Su API es de donde viene la API de Responses, y usarla requiere crédito de API pagado. Los costos dependen del modelo, el tamaño de la solicitud y cuánto experimentes, así que verifica el precio actual antes de cargar una cantidad con la que te sientas cómodo.

OpenRouter es la alternativa si no puedes o no quieres usar OpenAI. Es una única API que se enruta hacia muchos proveedores, incluyendo modelos gratuitos, y sirve la misma API de Responses compatible con OpenAI que el curso llama, así que el código del curso no cambia.

De cualquier forma, la configuración sigue el mismo patrón: crea una cuenta, genera una clave, luego guarda la URL del proveedor, tu clave y un ID de modelo.

JunoQué proveedor elegir Ambos proveedores funcionan para cada lección. OpenAI es el que las lecciones usan, lo que lo hace más fácil de seguir.

Elige OpenRouter si pagar a OpenAI directamente es incómodo para ti, o si quieres una cuenta que acceda a muchos modelos.

JunoQué proveedor elegir El código del curso no cambia entre los dos, porque usa el cliente de OpenAI con AI_URL como su URL base. Apuntar esa URL a OpenRouter es todo el cambio.

JunoQué proveedor elegir "Compatible con OpenAI" funciona bien para la forma de la solicitud y menos en los bordes, donde vive el trabajo de agentes: argumentos de herramientas estrictos, forzar o deshabilitar el uso de herramientas, salida estructurada. OpenRouter pasa tu solicitud a cualquier proveedor ascendente que sirva ese modelo, así que la compatibilidad es por ruta, no por puerta de enlace.

Configurar OpenAI

Ve a la plataforma de desarrolladores de OpenAI e inicia sesión o crea una cuenta.

ChatGPT Plus no es crédito de API

La plataforma de desarrolladores se factura por separado de una suscripción a ChatGPT. Tener ChatGPT Plus no le da a tu cuenta de API ningún crédito.

Abre Billing en la configuración de la plataforma y añade crédito si tu cuenta lo necesita. No necesitas un modelo costoso para este curso: una pequeña cantidad de crédito con un modelo ligero es suficiente para seguir junto.

Ahora abre API keys en la configuración de la plataforma y selecciona Create new secret key. Dale a la clave un nombre que te ayude a recordar para qué es. Cuando se crea la clave, cópiala inmediatamente, porque el valor completo se muestra solo una vez.

De vuelta en Scrimba, abre Edit Environment y configura:

AI_URL=https://api.openai.com/v1
AI_KEY=tu-clave-api-aqui
AI_MODEL=gpt-5.4-nano

gpt-5.4-nano es el modelo predeterminado del curso. Ve a modelos recomendados si quieres algo diferente. Guarda las variables de entorno una vez que las tres estén en su lugar.

JunoConfigurar OpenAI La clave secreta se muestra una sola vez, así que cópiala a Scrimba mientras el diálogo aún esté abierto. Si lo cierras demasiado pronto, elimina esa clave y crea una nueva.

JunoConfigurar OpenAI Haz dos cosas en la misma sesión: copia la clave directamente a Scrimba mientras es visible, y configura un límite de gasto en Billing antes de irte.

Un nombre que reconocerás más tarde importa una vez que tengas varias claves y necesites revocar una.

JunoConfigurar OpenAI Una clave nombrada por uso es lo que te permite revocar con precisión. Si no puedes saber qué clave se filtró, tienes que revocar todas y actualizar todo lo que las usó.

Configurar OpenRouter

Crea una cuenta en OpenRouter, abre la página API Keys, y crea una clave para Scrimba.

OpenRouter tiene modelos gratuitos, pero no siempre estarán disponibles o se comportarán de la misma manera de una ejecución a la otra, lo que hace difícil saber si un resultado extraño vino de tu código o del modelo. Así que la opción más segura es la misma que con OpenAI: carga una pequeña cantidad de crédito y elige un modelo pagado ligero si quieres resultados consistentes.

Si planeas usar endpoints gratuitos, abre la configuración de Privacy y revisa las opciones de política de datos antes de habilitarlas. Los endpoints gratuitos pueden enrutar tus solicitudes a proveedores con diferentes políticas de datos, así que toma una decisión deliberada antes de enviarles algo real.

En Scrimba, configura:

AI_URL=https://openrouter.ai/api/v1
AI_KEY=tu-clave-api-aqui
AI_MODEL=mistralai/ministral-3b-2512

mistralai/ministral-3b-2512 es uno de los modelos recomendados para OpenRouter. Guarda las variables de entorno.

JunoConfigurar OpenRouter Cuida el formato del ID del modelo. En OpenRouter comienza con el proveedor, así que es mistralai/ministral-3b-2512, no solo el nombre corto.

JunoConfigurar OpenRouter El prefijo del proveedor es parte del ID, que es lo que debes cuidar cuando copias un nombre de modelo de cualquier otro lugar.

Si habilitas modelos gratuitos, abre Privacy primero. Controla cuáles proveedores ascendentes pueden recibir tus solicitudes.

JunoConfigurar OpenRouter La configuración de Privacy decide si tus prompts pueden ir a endpoints que los retienen o entrenan con ellos, y los términos varían por proveedor ascendente.

Para ejercicios de curso eso tiene bajo riesgo, pero la configuración se mantiene en la cuenta para lo que envíes después.

Los tres valores van juntos

El fallo de configuración más común es un conjunto no coincidente en lugar de un valor individual incorrecto. Una clave válida con la URL incorrecta del proveedor falla, y una configuración de proveedor válida con un ID de modelo que ese proveedor no ofrece también falla. Ambos producen errores de autenticación o modelo no encontrado que parecen que algo está roto en el código del curso.

Así que siempre que cambies de proveedor, cambia AI_URL, AI_KEY y AI_MODEL como un conjunto, y guárdalos juntos.

¿Ejecutando el código en tu propia máquina?

Scrimba almacena estos como variables de entorno a nivel de cuenta, por lo que no hay un archivo .env en el proyecto del navegador. En tu propia máquina pondrás los mismos tres valores en un archivo .env en su lugar. Ejecutar el código localmente cubre eso.

JunoLos tres valores van juntos Si ves un error de autenticación o modelo no encontrado, revisa estos tres valores antes que nada que hayas escrito. Usualmente uno de ellos fue dejado de una configuración anterior.

JunoLos tres valores van juntos Lee los tres valores de arriba a abajo antes de abrir ningún código. Si coinciden y el error dice autenticación, la clave misma puede ser inválida o revocada, así que crea una nueva.

JunoLos tres valores van juntos Ambos fallos describen qué salió mal en el proveedor, no por qué. Una clave enviada a la URL de otro proveedor se lee como una clave mala, y un modelo fuera del catálogo del proveedor se lee como un error tipográfico.

Qué sigue

Modelos recomendados cubre qué hace que un modelo sea apropiado para trabajo de agentes y cuáles han sido probados contra este curso. Si prefieres ver cómo se arma la solicitud misma, Chat Completions y Responses compara las dos formas de API.

JunoQué sigue Elige un modelo siguiente y pon su ID en AI_MODEL.

JunoQué sigue Cada modelo en su tabla ha sido probado para tool calling, así que comienza allí.

JunoQué sigue La página de API muestra la solicitud que estos tres valores configuran.