Conecta con una API real de IA (OpenAI o Anthropic) desde Python

Hasta aquí has trabajado con datos en local. En esta lección conectas con una IA de verdad a través de su API. Vas a usar Anthropic (Claude) u OpenAI — elige la que prefieras. Ambas tienen tier gratuito de prueba.

Qué es una API y por qué importa

Una API (Application Programming Interface) es una puerta de entrada a un servicio externo: tú envías una petición HTTP, ellos responden con un resultado. Para la IA: tú envías un texto (prompt), ellos devuelven la respuesta del modelo.

Ventajas:

• No descargas modelos de 50 GB en tu portátil.
• Tienes acceso al último modelo siempre que el proveedor lo actualice.
• Pagas por uso real (cents por miles de tokens). Sin pago inicial.

Paso 1: obtener la API key

Opción A — Anthropic (Claude)

1. Crea cuenta en console.anthropic.com.
2. Ve a Settings → API Keys → Create Key.
3. Copia la clave (empieza por sk-ant-...). Guárdala en sitio seguro: no la verás de nuevo.
4. Anthropic da créditos de prueba gratis al registrarse. Suficiente para todo este curso.

Opción B — OpenAI

1. Crea cuenta en platform.openai.com.
2. Ve a API Keys → Create new secret key.
3. Copia la clave (empieza por sk-...).
4. Añade un método de pago (es necesario para usar la API, pero los costes son céntimos).

Paso 2: guardar la API key como variable de entorno

Nunca pegues la API key en el código y la subas a git. Es como dejar tu contraseña en público.

macOS/Linux (terminal)

export ANTHROPIC_API_KEY="sk-ant-tu-clave-aqui"
# o
export OPENAI_API_KEY="sk-tu-clave-aqui"

Para que persista entre sesiones, añade esa línea a ~/.zshrc (Mac) o ~/.bashrc (Linux) y recarga con source ~/.zshrc.

Windows (PowerShell)

setx ANTHROPIC_API_KEY "sk-ant-tu-clave-aqui"
# Cierra y reabre PowerShell para que tome efecto.

Paso 3: instalar el SDK

# Para Claude
pip install anthropic

# Para OpenAI
pip install openai

Paso 4: tu primer prompt programático

Crea primera_llamada_ia.py:

Versión Claude

import anthropic

client = anthropic.Anthropic()  # Lee ANTHROPIC_API_KEY del entorno

mensaje = client.messages.create(
    model="claude-haiku-4-5-20251001",  # rápido y barato
    max_tokens=300,
    messages=[
        {"role": "user", "content": "Resume en 3 puntos qué es Python para alguien que no ha programado nunca."}
    ]
)

print(mensaje.content[0].text)

Versión OpenAI

from openai import OpenAI

client = OpenAI()  # Lee OPENAI_API_KEY del entorno

respuesta = client.chat.completions.create(
    model="gpt-4o-mini",  # rápido y barato
    messages=[
        {"role": "user", "content": "Resume en 3 puntos qué es Python para alguien que no ha programado nunca."}
    ],
    max_tokens=300,
)

print(respuesta.choices[0].message.content)

Ejecuta el que hayas elegido. En 1-2 segundos verás la respuesta generada por el modelo.

Mini-proyecto: generador de descripciones para productos

Una pyme tiene 50 productos en su tienda online y necesita una descripción para cada uno. Lo hacemos en 15 líneas:

import anthropic

client = anthropic.Anthropic()

productos = [
    "Camiseta de algodón orgánico, talla M, color negro",
    "Maceta de cerámica artesana hecha a mano, 15cm",
    "Auriculares Bluetooth con cancelación de ruido",
]

for producto in productos:
    respuesta = client.messages.create(
        model="claude-haiku-4-5-20251001",
        max_tokens=200,
        messages=[{
            "role": "user",
            "content": f"Escribe una descripción de producto persuasiva pero honesta (60 palabras max) para: {producto}"
        }]
    )
    print(f"\n📦 {producto}\n")
    print(respuesta.content[0].text)
    print("─" * 60)

Resultado: 3 descripciones bien redactadas en menos de 5 segundos. Coste total: unos 0,001 €.

Manejar errores y costes

• Captura excepciones: las APIs pueden fallar (rate limit, sin conexión). Usa try/except.
• Controla tokens: max_tokens limita el tamaño de la respuesta y por tanto el coste.
• Modelos baratos primero: empieza con haiku o 4o-mini. Solo sube de modelo si la calidad no llega.
• Revisa el dashboard: Anthropic y OpenAI te muestran consumo en tiempo real.

Checklist antes de marcar completada

• Tienes una API key de Anthropic u OpenAI guardada como variable de entorno.
• Has instalado el SDK con pip.
• Has ejecutado tu primera llamada y has recibido respuesta de la IA.
• Has corrido el generador de descripciones de productos.
• Entiendes que nunca debes subir la API key a un repositorio público.

Ya puedes orquestar IA real desde Python. En la próxima lección damos un paso más: procesamos texto (reseñas, comentarios) para extraer información útil sin depender solo de la API.