Introducción y entorno

OpenAI representa una de las plataformas más influyentes en el desarrollo de inteligencia artificial moderna. Esta empresa de investigación se ha consolidado como líder en la creación de modelos de lenguaje avanzados que pueden comprender y generar texto de manera natural, revolucionando la forma en que interactuamos con las máquinas.

La plataforma OpenAI ofrece acceso a través de una API REST que permite integrar capacidades de inteligencia artificial en aplicaciones, sitios web y sistemas empresariales. Esta interfaz de programación facilita el desarrollo de soluciones que pueden procesar lenguaje natural, generar contenido, analizar texto y realizar tareas cognitivas complejas.

¿Qué es OpenAI?

OpenAI es una organización de investigación en inteligencia artificial fundada con el objetivo de desarrollar IA general artificial de forma segura y beneficiosa para la humanidad. La empresa ha creado algunos de los modelos de lenguaje más avanzados del mundo, incluyendo las series GPT (Generative Pre-trained Transformer) y otros sistemas especializados.

La misión principal de OpenAI se centra en garantizar que la inteligencia artificial general beneficie a toda la humanidad. Para lograr esto, la organización combina investigación de vanguardia con un enfoque responsable hacia el desarrollo y despliegue de tecnologías de IA.

Los productos principales de OpenAI incluyen modelos de texto, imagen, audio y código que pueden realizar tareas como:

• Generación y edición de texto
• Traducción entre idiomas
• Análisis y resumen de documentos
• Creación de código de programación
• Procesamiento de imágenes y audio

La API de OpenAI

La API de OpenAI funciona como un puente entre los desarrolladores y los modelos de inteligencia artificial de la plataforma. Esta interfaz permite enviar solicitudes HTTP a los servidores de OpenAI y recibir respuestas procesadas por sus modelos avanzados.

El modelo de funcionamiento se basa en un sistema de petición-respuesta donde el desarrollador envía datos de entrada (como texto o imágenes) junto con parámetros de configuración, y recibe una respuesta generada por el modelo correspondiente.

La plataforma utiliza un sistema de tokens para medir y facturar el uso. Los tokens representan unidades de texto procesado, donde aproximadamente 4 caracteres equivalen a 1 token en inglés. Este sistema permite un control preciso del consumo y costos asociados.

Configuración del entorno de desarrollo

Para comenzar a trabajar con la API de OpenAI, necesitamos configurar nuestro entorno de desarrollo con las herramientas y credenciales necesarias.

Instalación del SDK de Python

El SDK oficial de Python para OpenAI proporciona una interfaz simplificada para interactuar con la API. La instalación se realiza mediante pip:

pip install openai

Es recomendable trabajar en un entorno virtual para mantener las dependencias organizadas:

python -m venv openai_env
source openai_env/bin/activate  # En Windows: openai_env\Scripts\activate
pip install openai

Obtención de credenciales de OpenAI

Para utilizar la API de OpenAI, necesitas obtener una clave de API desde la plataforma oficial:

1. Registro en la plataforma:

• Visita platform.openai.com
• Crea una cuenta o inicia sesión
• Completa el proceso de verificación

2. Generación de API Key:

• Accede a la sección "API Keys" en tu dashboard
• Haz clic en "Create new secret key"
• Asigna un nombre descriptivo a tu clave
• Copia y guarda la clave de forma segura

3. Configuración de facturación:

• Configura un método de pago en "Billing"
• Establece límites de uso si es necesario
• Revisa los precios por modelo y tipo de operación

Configuración con Azure OpenAI

Azure OpenAI Service ofrece una alternativa empresarial para acceder a los modelos de OpenAI a través de la infraestructura de Microsoft Azure. Esta opción proporciona mayor control, cumplimiento normativo y integración con servicios empresariales.

Ventajas de Azure OpenAI:

• Cumplimiento con estándares empresariales
• Integración con Azure Active Directory
• Control de datos y residencia regional
• SLA empresarial y soporte técnico

Proceso de configuración:

1. Solicitud de acceso:

• Completa el formulario de solicitud en Azure
• Espera la aprobación (puede tomar varios días)
• Recibe confirmación de acceso

2. Creación del recurso:

• Accede al portal de Azure
• Crea un nuevo recurso "Azure OpenAI"
• Selecciona la región y plan de precios
• Configura las opciones de red y seguridad

3. Obtención de credenciales:

• Navega a "Keys and Endpoint" en tu recurso
• Copia la clave de API y el endpoint
• Anota el nombre de tu despliegue de modelo

Configuración de variables de entorno

La gestión segura de credenciales de API es fundamental para mantener la seguridad de nuestras aplicaciones. El SDK moderno de OpenAI detecta automáticamente las variables de entorno, simplificando la configuración.

Para OpenAI estándar

Configura la variable de entorno con tu clave de API:

# En sistemas Unix/Linux/macOS
export OPENAI_API_KEY="tu-clave-de-api-aqui"

# En Windows (Command Prompt)
set OPENAI_API_KEY=tu-clave-de-api-aqui

# En Windows (PowerShell)
$env:OPENAI_API_KEY="tu-clave-de-api-aqui"

Para Azure OpenAI

Azure requiere configuración adicional para el endpoint y versión de API:

# Configuración para Azure OpenAI
export AZURE_OPENAI_API_KEY="tu-clave-azure"
export AZURE_OPENAI_ENDPOINT="https://tu-recurso.openai.azure.com/"
export AZURE_OPENAI_API_VERSION="2024-02-15-preview"

Verificación de la configuración

Una vez configurado el entorno, podemos verificar que todo funciona correctamente con un script de prueba básico:

from openai import OpenAI

# El cliente detecta automáticamente OPENAI_API_KEY
client = OpenAI()

try:
    # Verificación simple de conectividad
    response = client.responses.create(
        model="gpt-4.1-mini",
        input="Hola, ¿funciona la conexión?"
    )
    
    print("✅ Configuración exitosa")
    print(f"Respuesta: {response.output_text}")
    
except Exception as e:
    print(f"❌ Error de configuración: {e}")

Para Azure OpenAI, la configuración del cliente requiere parámetros adicionales:

from openai import AzureOpenAI

client = AzureOpenAI(
    api_key=os.getenv("AZURE_OPENAI_API_KEY"),
    api_version="2024-02-15-preview",
    azure_endpoint=os.getenv("AZURE_OPENAI_ENDPOINT")
)

# Verificación con Azure
try:
    response = client.responses.create(
        model="tu-deployment-name",  # Nombre de tu despliegue
        input="Prueba de conexión con Azure"
    )
    
    print("✅ Azure OpenAI configurado correctamente")
    
except Exception as e:
    print(f"❌ Error con Azure: {e}")

Consideraciones de seguridad

El manejo adecuado de credenciales de API es crucial para proteger tu cuenta y evitar uso no autorizado:

• Nunca hardcodees las claves de API directamente en el código
• Utiliza variables de entorno o servicios de gestión de secretos
• Implementa rotación regular de claves de API
• Configura límites de uso para controlar costos
• Monitorea el uso de la API regularmente

La configuración correcta del entorno establece las bases para un desarrollo seguro y eficiente con la plataforma OpenAI, preparando el terreno para explorar las capacidades avanzadas de los modelos de inteligencia artificial en los módulos posteriores del curso.