Configuración del proveedor

Antes de que cualquier código de agente pueda ejecutarse, necesita saber a dónde enviar una solicitud, qué clave la autoriza y qué modelo pedir. Esta página deja esos tres valores listos.

Tu clave de API es una credencial

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

Esa regla es también la razón por la que el curso mantiene todas las llamadas a la API en un servidor y no en el navegador. El código del navegador es visible para cualquiera que abra las herramientas de desarrollador de su navegador, así que una clave usada ahí es una clave que has regalado.

Revisa lo que ya tienes

Si ya tomaste Intro a la Ingeniería de IA, estas variables podrían seguir guardadas en tu cuenta de Scrimba.

Abre Settings en el editor de Scrimba y luego selecciona Edit Environment. Busca tres entradas con los nombres exactos AI_URL, AI_KEY y AI_MODEL.

Si las tres están ahí y apuntan a un proveedor con el que todavía tienes crédito, es muy probable que ya estés listo. Salta 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 lo que ya tienes Antes de registrarte en cualquier lado, revisa Settings y luego Edit Environment. Intro a la Ingeniería de IA usó exactamente estos tres nombres, así que puede que ya estén ahí esperándote.

¡Revisar toma diez segundos y puede ahorrarte crear una segunda cuenta que no necesitas!

JunoRevisa lo que ya tienes Revisa los valores existentes antes de crear algo nuevo. Los nombres se mantienen igual desde Intro a la Ingeniería de IA.

Hay algo que debes confirmar, no asumir: que el modelo en AI_MODEL soporte tool calling. El curso anterior no lo requería, así que un conjunto de variables que funcionaba perfecto ahí puede fallar en la lección tres de este curso.

JunoRevisa lo que ya tienes Reutilizar los valores es una buena decisión, con una salvedad sobre la clave misma. Si esa clave ha estado en una cuenta compartida o de larga duración desde el curso anterior, este es un buen momento para rotarla, porque no tienes registro de dónde se ha pegado desde entonces.

Rotarla cuesta un minuto y reinicia lo que sabes sobre su exposición. Reutilizar una clave antigua de aprendizaje está bien; reutilizar una de la que perdiste el rastro es el hábito que vale la pena no formar.

Qué proveedor elegir

OpenAI es el proveedor predeterminado que usa este curso. Su API es de donde proviene la Responses API, y usarla requiere crédito de API. Los costos dependen del modelo, el tamaño de la solicitud y cuánto experimentes, así que revisa los precios actuales antes de cargar un monto con el que te sientas cómodo.

OpenRouter es la alternativa si no puedes o no quieres usar OpenAI. Es una sola API que enruta a muchos proveedores, incluyendo modelos de nivel gratuito, y habla el mismo formato compatible con OpenAI, así que el código del curso no cambia.

De cualquier forma, la configuración tiene la misma estructura: crear una cuenta, generar una clave y luego guardar la URL del proveedor, tu clave y un ID de modelo.

JunoQué proveedor elegir Ambos proveedores funcionan para todas las lecciones, así que aquí no hay una respuesta incorrecta. OpenAI es con el que se grabaron las lecciones, lo que lo hace el más fácil de seguir.

Elige OpenRouter si pagarle directamente a OpenAI es complicado donde vives, o si quieres probar primero un modelo gratuito.

JunoQué proveedor elegir El código del curso no cambia entre uno y otro, porque OpenRouter habla el mismo formato de solicitud compatible con OpenAI. Esa es la razón completa por la que se ofrece como alternativa.

División práctica: OpenAI si quieres seguir las grabaciones exactamente, OpenRouter si quieres una sola cuenta que llegue a muchos proveedores o necesitas un nivel gratuito para empezar.

JunoQué proveedor elegir "Compatible con OpenAI" es una afirmación fuerte que se sostiene bien para la estructura de la solicitud y menos bien en los detalles finos, y ahí es donde vive el trabajo con agentes. El tipado estricto de argumentos, forzar tool-choice y la validación de salida estructurada son los tres aspectos que varían según el proveedor subyacente, y OpenRouter pasa tu solicitud a quien sea que esté sirviendo ese modelo.

Funciona para este curso en las rutas mencionadas en la página de modelos. Ten en cuenta esta salvedad cuando lleves el patrón a otro lado: la compatibilidad es por ruta, no por gateway.

Configurando 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 cobra por separado de una suscripción a ChatGPT. Tener ChatGPT Plus no le da ningún crédito a tu cuenta de API, y esto sorprende a casi todos al menos una vez.

Abre Billing en la configuración de la plataforma y agrega crédito si tu cuenta no tiene nada. Revisa los precios actuales del modelo y define un presupuesto que se ajuste a tu propio uso.

Ahora abre API keys en la configuración de la plataforma y selecciona Create new secret key. Dale un nombre que todavía tenga sentido para ti en tres meses. Cuando se cree la clave, cópiala de inmediato, porque el valor completo se muestra solo una vez y no se puede recuperar después.

De vuelta en Scrimba, abre Edit Environment y define:

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

Consulta modelos recomendados si quieres algo distinto al predeterminado. Guarda las variables de entorno una vez que las tres estén en su lugar.

JunoConfigurando OpenAI La clave secreta aparece una vez y nunca vuelve a mostrarse, así que cópiala en Scrimba mientras el diálogo sigue abierto. Si lo cierras demasiado pronto, tendrás que eliminar esa clave y crear una nueva, lo cual es molesto pero no grave.

Define un presupuesto de facturación mientras estás ahí. ¡Toma un minuto y hace que un ciclo descontrolado nunca se convierta en una sorpresa!

JunoConfigurando OpenAI Dos cosas que debes hacer en el mismo momento: copiar la clave directamente a Scrimba mientras es visible, y definir un límite de gasto en Billing antes de salir.

Ponle a la clave un nombre que reconozcas en tres meses. Cuando eventualmente tengas varias y necesites revocar una, una lista de claves llamadas "key1" y "test" se convierte en su propio pequeño problema.

JunoConfigurando OpenAI Un presupuesto por clave y un nombre sensato son lo que te permite revocar con precisión más adelante. El problema del que te protegen no es gastar de más, es no poder identificar qué clave se filtró, y terminas revocando todo y reconstruyendo cada integración que tienes.

Para una cuenta de aprendizaje eso es un inconveniente menor. Vale la pena formar el hábito aquí, porque la primera vez que realmente importe, lo estarás haciendo bajo presión de tiempo.

Configurando OpenRouter

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

OpenRouter sí ofrece modelos gratuitos, y son útiles para aprender. Ten en cuenta dos cosas antes de depender de uno.

No hay garantía de que los endpoints gratuitos estén disponibles, y su comportamiento puede diferir de una ejecución a otra, lo que hace difícil saber si un resultado extraño vino de tu código o del modelo. Los endpoints gratuitos también pueden enrutar tus solicitudes a proveedores con distintas políticas de datos, así que abre la configuración de Privacy y toma una decisión consciente antes de habilitarlos.

Si quieres resultados consistentes, aplica el mismo consejo que con OpenAI: carga una pequeña cantidad de crédito y elige un modelo de pago liviano.

En Scrimba, define:

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

Guarda las variables de entorno.

JunoConfigurando OpenRouter Una cuenta y una clave, que llegan a muchos proveedores. El código del curso no cambia en absoluto para usarlo.

Fíjate en el formato del ID del modelo: incluye el proveedor al principio, así que es mistralai/ministral-3b-2512 y no el nombre corto por sí solo. ¡Ese prefijo confunde a la gente todo el tiempo!

JunoConfigurando OpenRouter El prefijo del proveedor es parte del ID en OpenRouter, y esa es la diferencia a tener en cuenta cuando copias el nombre de un modelo desde cualquier otro lado.

Abre la configuración de Privacy antes de habilitar modelos gratuitos. Esa página controla a qué proveedores subyacentes pueden llegar tus solicitudes, y es el ajuste que la gente se salta en su camino al nivel gratuito.

JunoConfigurando OpenRouter La página de Privacy importa más de lo que su ubicación sugiere. Las rutas gratuitas son subsidiadas por alguien, y los términos asociados a eso varían según el proveedor subyacente, incluyendo si tus prompts pueden retenerse o usarse para entrenamiento.

Para los ejercicios del curso, esa es una decisión de bajo riesgo. Tómala de forma consciente igual, porque la misma cuenta y el mismo valor predeterminado seguirán ahí el día que pegues algo del trabajo.

Los tres valores van juntos

El fallo de configuración más común no es un solo valor incorrecto, sino un conjunto desalineado. Una clave válida de OpenAI contra la URL de OpenRouter falla. Una configuración válida de OpenRouter con un ID de modelo exclusivo de OpenAI falla. Ambos casos producen errores de autenticación o de modelo no encontrado que parecen indicar que algo está roto en el código del curso.

Por eso, cada vez que cambies de proveedor, cambia AI_URL, AI_KEY y AI_MODEL como un solo conjunto, y guárdalos juntos.

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

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

JunoLos tres valores van juntos Si ves un error de autenticación o de modelo no encontrado, revisa estos tres antes de revisar cualquier cosa que hayas escrito. Nueve de cada diez veces, uno de ellos quedó de una configuración anterior.

Los mensajes de error no ayudan mucho aquí, porque describen lo que salió mal en el proveedor, así que parece que el código del curso está roto. ¡Por lo general no lo está!

JunoLos tres valores van juntos Trata un cambio de proveedor como una sola edición con tres partes, guardadas juntas. Cambiar dos de tres es exactamente el error que esta sección busca prevenir.

Cuando aparezca un error, lee los tres valores de arriba a abajo antes de abrir cualquier código. Es más rápido que depurar, y es la causa con mucha más frecuencia que cualquier cosa que hayas escrito.

JunoLos tres valores van juntos Ambos fallos producen mensajes de error que apuntan a algo distinto del verdadero problema. Una clave enviada a la URL base equivocada devuelve un 401, que parece indicar una clave inválida. Un modelo que el proveedor no sirve devuelve un 404 sobre el nombre del modelo, que parece un error de tipeo.

En ambos casos, el problema de fondo es que el conjunto es inconsistente, y ninguno de los mensajes lo dice. Esa discrepancia entre el síntoma y la causa es la razón por la que esto merece su propia sección y no solo una nota al pie.

Hacia dónde ir después

Modelos recomendados cubre qué hace que un modelo sea adecuado para el trabajo con agentes y cuáles se han probado con este curso. Si prefieres ver cómo se construye la solicitud en sí, Chat Completions y Responses compara las dos estructuras de API.