MÓDULO 2 · PRIMEROS PASOS CON OPENAI · 20 MIN

Introducción a OpenAI y configuración de API

20 min Básico OpenAI API Python
La seguridad es lo primero: nunca hardcodees (escribas directamente) tu API Key en el código. Usá siempre variables de entorno — un archivo .env que el programa lee al ejecutarse, separado del código que subís a un repositorio.
01 —
El problema

Para integrar inteligencia artificial generativa en procesos de negocio o aplicaciones, las empresas necesitan acceso a modelos potentes sin la carga de entrenarlos o alojarlos (lo cual requiere infraestructura masiva). Sin embargo, el acceso a estos servicios en la nube conlleva un riesgo de seguridad crítico: la gestión de credenciales.

Situación típica: un desarrollador quiere probar GPT-4 para resumir correos. Pega su API Key directamente en el código (key = "sk-...") y sube el archivo a GitHub. En minutos, bots escanean la clave y consumen miles de dólares en crédito antes de que pueda ser revocada.

Por qué es importante: entender el ecosistema te permite elegir la herramienta correcta (no usar DALL-E para texto), y una configuración segura es el paso cero obligatorio para evitar pérdidas financieras y brechas de seguridad.

02 —
La solución: OpenAI API y gestión de secretos

OpenAI ofrece sus modelos como servicio (MaaS — Model as a Service) a través de una API REST. Esto te permite "alquilar" la inteligencia de GPT-4o o la capacidad auditiva de Whisper pagando solo por lo que usás (tokens).

Cómo funciona:

  1. Selección de modelo: elegís el "cerebro" adecuado (ej: gpt-4o para razonamiento complejo, tts-1 para voz).
  2. Autenticación: usás una API Key (como una contraseña larga) que se envía en el encabezado de cada petición.
  3. Gestión de entorno: en lugar de escribir la clave en el código, se guarda en un archivo oculto .env que el programa lee al ejecutarse.
03 —
Cuándo aplicarlo
Usá OpenAI API cuando...NO lo uses cuando...
Necesitás razonamiento avanzado, creatividad o conocimientos generales "out of the box"Tenés datos extremadamente sensibles que por regulación no pueden salir de tu infraestructura local (on-premise)
Querés prototipar rápido y validar valor de negocioNecesitás un modelo ultra-ligero que corra en un dispositivo sin internet
Requerís multimodalidad (ver, escuchar y hablar) en una sola plataformaEl costo por volumen masivo de transacciones simples hace prohibitivo el pago por token
04 —
Ejercicio práctico

Objetivo: configurar tu entorno de desarrollo local y ejecutar tu primer script de Python para autenticarte con OpenAI y listar los modelos disponibles, verificando que tu API Key funciona.

Contexto inicial: asumimos que tenés Python instalado. Usaremos la librería oficial openai y python-dotenv para seguridad.

Paso 1 — Obtención de la API Key (en el navegador)
  1. Andá a OpenAI API Keys (platform.openai.com).
  2. Hacé clic en "Create new secret key".
  3. Dale un nombre descriptivo (ej. Curso_B2B_Test).
  4. Copiá la clave inmediatamente — no podrás verla de nuevo.
Paso 2 — Configuración del entorno
bash# Instalamos la librería oficial y el gestor de variables de entorno pip install openai python-dotenv # Creamos el archivo de variables de entorno (Mac/Linux) touch .env # En Windows podés crearlo manualmente con el bloc de notas

Abrí el archivo .env con tu editor de código y añadí la siguiente línea (pegando tu clave real):

.envOPENAI_API_KEY=sk-proj-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

// Asegurate de que este archivo .env esté incluido en tu .gitignore si usás Git.

Paso 3 — Script de conexión y validación

Creá un script test_openai.py para verificar la conexión:

pythonimport os from dotenv import load_dotenv from openai import OpenAI # 1. Cargar variables de entorno desde .env load_dotenv() # 2. Obtener la clave del sistema api_key = os.getenv("OPENAI_API_KEY") # Validación preventiva if not api_key: print("❌ Error: No se encontró la variable OPENAI_API_KEY.") else: print(f"✅ API Key encontrada (termina en ...{api_key[-4:]})") # 3. Inicializar el cliente client = OpenAI(api_key=api_key) try: # 4. Llamada ligera: recuperar un modelo para verificar acceso # (Esto no consume tokens de generación, solo verifica autenticación) response = client.models.retrieve("gpt-3.5-turbo") print("\n✅ Conexión exitosa con OpenAI.") print(f"Modelo verificado: {response.id}") print(f"Creado por: {response.owned_by}") except Exception as e: print(f"\n❌ Fallo en la conexión: {e}")
Paso 4 — Validación

Ejecutá el script en tu terminal:

bashpython test_openai.py

Output esperado:

salida✅ API Key encontrada (termina en ...AbCd) ✅ Conexión exitosa con OpenAI. Modelo verificado: gpt-3.5-turbo Creado por: openai
Auditoría

Guardar la key en .env es mucho mejor que hardcodearla, pero no es "seguro" en un sentido absoluto: el archivo sigue siendo texto plano en tu disco, legible por cualquier proceso con acceso a esa carpeta. Alcanza perfectamente para desarrollo local — para producción real, herramientas como un gestor de secretos (AWS Secrets Manager, variables de entorno encriptadas en Vercel/GitHub Actions) van un paso más allá. No confundas .env con una solución de secretos de nivel productivo.

05 —
Troubleshooting rápido
Si ves esto...CausaSolución
ModuleNotFoundError: No module named 'openai'No instalaste las libreríasEjecutá pip install openai python-dotenv
openai.AuthenticationError: Incorrect API key...La clave en el .env está mal copiada o tiene espacios extraRevisá el archivo .env; sin comillas ni espacios alrededor de la clave
openai.RateLimitError: You exceeded your current quotaNo tenés créditos o método de pago en OpenAIAndá a Billing en la plataforma de OpenAI y añadí crédito (la API no es gratis como ChatGPT web)
06 —
Puntos clave

Concepto central: la seguridad es lo primero: nunca hardcodees tu API Key en el código. Usá siempre variables de entorno.

Para recordar: