Módulo 2: OpenAI API - Introducción

Módulo 2: OpenAI API - Introducción

Siguiente →

¿Qué aprenderás en este módulo?

En el Módulo 1 aprendiste a DECIDIR qué proveedor usar. Ahora vas a aprender a IMPLEMENTAR con el proveedor más popular: OpenAI API.

Este módulo cubre todo lo necesario para integrar GPT-3.5/GPT-4 en tu aplicación:

  • Setup de cuenta y API keys
  • SDK de Python (v1.x)
  • Chat Completions API
  • Pricing y rate limits
  • Error handling y retries
  • Best practices

Al finalizar, tendrás un chatbot funcional conectado a OpenAI API con manejo robusto de errores.

🎯 Objetivo del módulo

Dominar OpenAI API: Desde cero hasta producción

Entregables:

  1. Setup completo (cuenta, API key, SDK instalado)
  2. Primer request exitoso (GPT-3.5)
  3. Chatbot conversacional con historial
  4. Error handling robusto (retries, fallbacks)

Proyecto final: Chatbot de soporte técnico con contexto conversacional

📋 Estructura del módulo

Progresión de cápsulas:

Fase 1: Setup y Primer Request (cápsulas 1-3)

  • 01: Introducción al módulo
  • 02: Setup de cuenta y API keys
  • 03: Primer request con SDK Python

Fase 2: Chat Completions API (cápsulas 4-5)

  • 04: Conversaciones con contexto
  • 05: Parameters avanzados (temperature, max_tokens)

Fase 3: Producción (cápsulas 6-7)

  • 06: Pricing, rate limits, y optimización
  • 07: Error handling y retries

Fase 4: Proyecto (cápsula 8)

  • 08: Mini-proyecto - Chatbot de soporte técnico

🔗 Conexiones con otros módulos

Pre-requisito:

  • Módulo 1 (Decision Framework): Decidiste que OpenAI API es la mejor opción para tu proyecto

Conexiones laterales:

  • Módulo 3 (LM Studio): Aprenderás interfaz local compatible con OpenAI
  • Módulo 5 (OpenRouter): API compatible, podrás replicar código

Siguiente paso:

  • Módulo 7 (Comparación Técnica): Compararás OpenAI vs otros proveedores implementados

⏱️ Tiempo estimado

Total módulo: 3-4 horas

Desglose por cápsula:

  • Cápsulas 1-3 (Setup): 45 minutos
  • Cápsulas 4-5 (Chat API): 60 minutos
  • Cápsulas 6-7 (Producción): 45 minutos
  • Cápsula 8 (Proyecto): 60-90 minutos

Ritmo recomendado: 2 sesiones de 2 horas

🛠️ Skills que desarrollarás

Técnicos:

  1. OpenAI SDK Python (v1.x):

    • Instalación y configuración
    • Cliente OpenAI
    • Chat Completions API
    • Streaming responses

  2. API REST fundamentals:

    • Authentication (Bearer token)
    • Request/response format (JSON)
    • Rate limiting
    • Error codes (429, 500, 503)

  3. Error handling:

    • Try/except patterns
    • Exponential backoff
    • Retry strategies
    • Timeout handling

Conceptuales:

  1. LLM parameters:

    • Temperature (creatividad)
    • Max tokens (longitud)
    • Top-p (sampling)

  2. Conversational context:

    • System message (instrucciones)
    • User/assistant messages (historial)
    • Context window management

  3. Cost optimization:

    • Token counting
    • Modelo selection (GPT-3.5 vs GPT-4)
    • Caching strategies

📦 Requisitos previos

Skills obligatorios:

  • ✅ Python básico (variables, funciones, clases)
  • ✅ Pip/virtualenv (gestión de dependencias)
  • ✅ Terminal básico (cd, ls, python)

Skills recomendados (no obligatorios):

  • ⚠️ Requests library (HTTP calls)
  • ⚠️ JSON (lectura/escritura)
  • ⚠️ Environment variables (.env)

Software necesario:

  • Python 3.8+ (verifica: python --version)
  • Pip (verifica: pip --version)
  • Editor de código (VS Code, PyCharm, etc.)
  • Cuenta OpenAI (cápsula 02 te guía en setup)

💰 Costo del módulo

Cuenta OpenAI:

  • Signup: Gratis
  • Credits iniciales: $5 (nuevos usuarios, válidos 3 meses)
  • Costo real del módulo: ~$0.50 ($5 es suficiente)

Cálculo:

  • Ejercicios: ~100 requests × 500 tokens = 50k tokens
  • GPT-3.5: 50k tokens × $0.002/1k = $0.10
  • Proyecto: ~500 requests × 500 tokens = 250k tokens = $0.50
  • Total: $0.60 (muy dentro de $5 credits)

Nota: Si ya gastaste tus $5 credits, necesitarás agregar método de pago. El costo real del módulo es <$1.

🎯 ¿Por qué empezar con OpenAI API?

Razones estratégicas:

  1. Estándar de facto:

    • OpenAI SDK es la referencia que otros imitan
    • LM Studio, Ollama, OpenRouter son "OpenAI-compatible"
    • Aprende OpenAI → 80% del conocimiento se transfiere

  2. Best developer experience:

    • Docs excelentes (mejor en la industria)
    • SDK oficial mantenido (Python, Node, etc.)
    • Comunidad masiva (Stack Overflow, Discord)

  3. Production-ready out of the box:

    • 99.9% uptime SLA
    • Autoscaling (no gestionas infra)
    • Rate limiting inteligente

  4. Calidad máxima (GPT-4):

    • Si tu proyecto requiere máxima accuracy
    • OpenAI tiene los mejores modelos (2024-2026)

Cuándo NO usar OpenAI API:

Revisa Módulo 1 - Cápsula 04 (Matriz de Decisión) si:

  • Privacidad crítica (HIPAA, on-premise obligatorio)
  • Costo prohibitivo (millones queries/mes)
  • Requisitos específicos que otros cumplen mejor

Si Módulo 1 te llevó a OpenAI, este módulo es tu siguiente paso.

📊 Qué construirás

Mini-proyecto final (cápsula 08):

Chatbot de Soporte Técnico

Características:

  • Responde preguntas frecuentes (FAQs)
  • Mantiene contexto conversacional
  • Maneja errores gracefully
  • Logs de conversaciones
  • Cost tracking

Tecnologías:

  • Python 3.8+
  • OpenAI SDK v1.x
  • Python-dotenv (env vars)
  • JSON (persistence)

Ejemplo de interacción:

User: ¿Cómo reseteo mi contraseña?
Bot: Para resetear tu contraseña:
     1. Ve a Settings > Security
     2. Click "Reset Password"
     3. Recibirás email con link
     
     ¿Necesitas ayuda con algún paso?

User: No recibo el email
Bot: Entiendo, no llegó el email de reset. Verifica:
     - Folder de Spam/Junk
     - Email registrado correcto: user@example.com
     
     Si sigue sin llegar en 5 minutos, puedo escalar
     a soporte humano. ¿Quieres que lo haga?

Métricas de éxito:

  • ✅ Responde coherentemente (no respuestas random)
  • ✅ Recuerda contexto (referencias a mensajes previos)
  • ✅ Maneja errores sin crashear (rate limits, timeouts)
  • ✅ Costo <$0.10 para 100 conversaciones (eficiente)

🔄 Metodología del módulo

Aprendizaje incremental:

Patrón: Teoría mínima → Código inmediato → Iteración

  1. Explico concepto (5 minutos):

    • Qué es
    • Por qué importa
    • Cuándo usarlo

  2. Muestras código mínimo (10 minutos):

    • Ejemplo más simple posible
    • Ejecutas y ves output
    • Funciona en TU máquina

  3. Iteras con ejercicios (15 minutos):

    • Modifica parámetros
    • Observa cambios
    • Solidificas entendimiento

No hay teoría sin código. No hay código sin ejecutar.

✅ Criterios de éxito del módulo

Completaste exitosamente cuando:

Skills técnicos:

  • Instalaste OpenAI SDK sin errores
  • Hiciste request exitoso a GPT-3.5
  • Creaste conversación con contexto (3+ mensajes)
  • Implementaste retry con exponential backoff
  • Calculaste costo de requests manualmente

Entregable:

  • Chatbot funcionando con 5+ intercambios consecutivos
  • Error handling para 3 casos (timeout, rate limit, API error)
  • Logs guardados en archivo JSON

Comprensión conceptual:

  • Explicas diferencia GPT-3.5 vs GPT-4 (costo/calidad)
  • Entiendes cómo temperature afecta respuestas
  • Sabes calcular tokens y estimar costo

Si cumples todos los criterios: ✅ Módulo 2 aprobado

Estarás listo para:

  • Módulos 3-6 (otros proveedores)
  • Módulo 7 (comparación técnica)
  • Módulo 8 (unified client)

🔗 Recursos del módulo

Documentación oficial:

  1. OpenAI Platform Docs - Referencia completa
  2. Python SDK GitHub - Código fuente
  3. API Reference - Endpoints
  4. Pricing - Costos actualizados

Herramientas:

  1. Tokenizer - Cuenta tokens
  2. Playground - Test sin código
  3. Status Page - Uptime monitoring

Comunidad:

  1. OpenAI Community Forum
  2. r/OpenAI - Subreddit
  3. Discord - Chat tiempo real

🚀 Comenzar

Siguiente paso: 02-setup-cuenta-api-keys.md

En la próxima cápsula:

  • Crearás cuenta OpenAI
  • Obtendrás API key
  • Configurarás environment variables
  • Instalarás SDK Python

Tiempo: 15 minutos
Dificultad: Baja

📝 Notas importantes

⚠️ Advertencias:

  1. API keys son secretos:

    • NUNCA commitees a Git
    • Usa .env + .gitignore
    • Si leakeas: Regenera inmediatamente

  2. Billing puede sorprender:

    • Configura spending limits en dashboard
    • Monitorea usage diariamente
    • Para ejecución si llegas al límite

  3. Rate limits existen:

    • Free tier: 3 requests/min (GPT-4)
    • Paid tier: 500 requests/min (GPT-3.5)
    • Implementa retries (cápsula 07)

✅ Tips para el éxito:

  1. Ejecuta TODO el código:

    • No solo leas ejemplos
    • Copia, ejecuta, modifica
    • Debugging es parte del aprendizaje

  2. Experimenta con parameters:

    • Temperature 0 vs 1 (determinismo vs creatividad)
    • Max tokens (costo vs completeness)
    • System message (tone and behavior)

  3. Usa el módulo como referencia:

    • Después de completar, vuelve cuando necesites
    • Código es reutilizable (copy-paste friendly)
    • Patrones aplican a proyectos reales

Tiempo estimado total: 3-4 horas
Siguiente: 02-setup-cuenta-api-keys.md

← AnteriorMini-Proyecto: Evaluación de Requisitos - E-commerce ChatbotSiguiente →Setup de Cuenta OpenAI y API Keys