OpenAI API: tutorial completo en Python (2026)

Setup inicial

pip install openai
export OPENAI_API_KEY=sk-...

Chat Completions

from openai import OpenAI

client = OpenAI()
response = client.chat.completions.create(
    model="gpt-4o",
    messages=[
        {"role": "system", "content": "Eres un asistente útil."},
        {"role": "user", "content": "Explica que es una API REST."}
    ],
    temperature=0.7,
    max_tokens=500
)
print(response.choices[0].message.content)

Modelos disponibles

GPT-4o: mejor calidad general. $2.50/M input, $10/M output. Para tareas complejas.

GPT-4o-mini: 10x más barato. Suficiente para clasificación, extracción, tareas simples.

o1: modelo de reasoning. Piensa antes de responder. Para matemáticas, lógica, planificación.

Streaming

stream = client.chat.completions.create(
    model="gpt-4o",
    messages=[{"role": "user", "content": "Hola"}],
    stream=True
)
for chunk in stream:
    if chunk.choices[0].delta.content:
        print(chunk.choices[0].delta.content, end="", flush=True)

Function calling

Permite que GPT-4o llame funciones que tú defines. Similar a tool use de Claude. Defines herramientas con JSON Schema, GPT genera la llamada, tú ejecutas y devuelves el resultado.

Vision (imágenes)

GPT-4o puede analizar imágenes. Envía la imagen como URL o base64 en el content del mensaje. Útil para: analizar capturas, OCR, describir diagramas.

Structured Outputs

Fuerza output JSON que cumple un schema específico. Similar a Structured Outputs de Claude. Garantiza tipos, enums y estructura.

OpenAI vs Claude API

Ambas usan el mismo patrón (messages array + roles). Claude tiene Extended Thinking y Prompt Caching nativos. OpenAI tiene o1 para reasoning y DALL-E para imágenes. Los SDKs son intercambiables con cambio de base_url.