Aprender a administrar proyectos en OpenAI te permite organizar claves API, controlar presupuestos y gestionar equipos sin sorpresas en la factura. Esta guía es para quienes empiezan a construir con modelos como GPT-4 y necesitan estructura desde el primer día.

La plataforma cambió hace pocos meses: pasó de un sistema plano de API keys a un esquema de OpenAI Projects que separa cada iniciativa con su propia clave, sus permisos y su límite de gasto. Y créeme, esa diferencia te va a salvar más de un dolor de cabeza.

¿Cómo creo una cuenta en OpenAI Platform?

Antes de generar cualquier clave, necesitas registrarte en la plataforma. Entra a platform.openai.com, haz clic en Start building y luego en Log in [0:30]. Puedes registrarte con tu correo o autenticarte con Google, Microsoft o Apple.

Una vez dentro, tendrás acceso al panel donde se gestionan modelos, claves y configuraciones de equipo.

¿Qué es una API key en OpenAI? Es una cadena de texto que te identifica frente a los modelos. La copias en tu archivo de variables de entorno y con ella accedes a GPT-4, generación de imágenes, audio o moderación.

¿Qué son los OpenAI Projects y para qué sirven?

Los proyectos son la forma moderna de organizar todo lo que haces dentro de OpenAI [1:50]. Cada proyecto tiene su propia API key, sus propios miembros y su propio límite de presupuesto.

Imagina que estás en un hackathon con cinco personas: creas un proyecto, invitas a tu equipo y todos colaboran sin mezclarse con otros desarrollos. Si además tienes un proyecto universitario y otro experimental, puedes asignar 50 dólares de límite al experimental y 150 al productivo, sin que uno afecte al otro.

Las ventajas concretas de usar proyectos son:

• Claves API independientes por iniciativa.
• Gestión de equipos con invitaciones a colaboradores.
• Límites de presupuesto separados por proyecto.
• Permisos granulares por tipo de modelo.

¿Cuál es la diferencia entre API key y service account?

Ambos te entregan un string que pegas en tu entorno de variables, pero el origen cambia [3:50]. La API key está atada a tu usuario personal: si te eliminan del equipo, esa clave deja de operar. El service account, en cambio, funciona como un bot independiente dentro del proyecto.

El service account sobrevive a cambios de equipo porque no depende de una persona. Es ideal para procesos automatizados o producción, donde no quieres que la salida de un colaborador rompa el servicio.

¿Cuándo conviene usar service account en lugar de API key? Cuando el proceso debe seguir corriendo sin depender de un usuario humano, como bots, integraciones en producción o automatizaciones de equipo.

¿Cómo genero mi primera API key paso a paso?

Desde platform.openai.com, ve al ícono de tuerca en la esquina superior derecha y entra a Settings [5:30]. En la sección de organización encuentras API keys.

Haz clic en Create new secret key, ponle un nombre descriptivo (por ejemplo, Platzi Vision) y asígnala a un proyecto. Si aún no tienes uno, puedes dejarla en default project o crear un nuevo proyecto desde el selector superior.

Para crear el proyecto, haz clic en Create project, asígnale nombre y confirma. Dentro del proyecto puedes generar claves específicas con permisos restringidos.

¿Cómo limito los permisos de una API key?

Al crear la clave, OpenAI te muestra un apartado de permisos donde puedes restringir el acceso a tipos específicos de modelos: lenguaje, audio, imágenes, moderación o asistentes [7:30]. Si la clave es privada y solo tú la usas, All funciona. Pero si vas a integrarla en un servicio que solo necesita generar texto, conviene limitarla a ese permiso.

Recuerda: la clave se muestra una sola vez. Cópiala y guárdala en un lugar seguro como un gestor de contraseñas o un archivo .env fuera del repositorio.

¿Cómo creo un service account en OpenAI?

Dentro del proyecto, ve a la pestaña Members [8:40]. Verás tu usuario y dos opciones: invitar a un miembro o crear un service account.

Haz clic en Service account, asígnale un nombre como Platzi Bot y confirma. La plataforma te entrega una API key con los mismos privilegios que una clave de usuario, pero asociada a una identidad robótica que vive dentro del proyecto.

¿Cómo controlo el presupuesto en OpenAI para evitar facturas altas?

Los modelos cobran por consumo, y un servicio masivo puede pasar de centavos a cientos de dólares en días [9:30]. Para evitarlo, OpenAI ofrece dos mecanismos complementarios.

La alerta de presupuesto envía un correo cuando el gasto supera un umbral que tú defines. Si pones la alerta en 10 dólares y tu factura mensual ronda los 5, te avisará apenas la cruces. Es solo un aviso, no detiene nada.

El límite de presupuesto excedido sí corta el servicio. Cuando el gasto pasa ese tope, OpenAI rechaza todas las peticiones nuevas. Es la red de seguridad que te deja dormir tranquilo.

¿Dónde configuro las alertas y los límites de gasto?

Ve a Organization > Limits y haz scroll hasta el final [11:40]. Ahí defines:

1. Set budget alert: el monto que dispara el correo de aviso.
2. Budget limit: el monto en el que se detienen las llamadas.

Por ejemplo, alerta en 100 dólares y límite en 120. Si llegas a 100, recibes el correo. Si llegas a 120, las llamadas se rechazan.

¿Qué pasa si supero el límite de presupuesto en OpenAI? Tu servicio deja de operar de inmediato porque la API rechaza nuevas peticiones. Si es un proyecto crítico, lo recomendable es subir el límite tras recibir la alerta para evitar interrupciones.

Explora la documentación oficial y las demás secciones de la plataforma antes de pasar a construir tus primeras integraciones. ¿Qué tipo de proyecto vas a configurar primero, uno experimental o uno en producción? Cuéntalo en los comentarios.