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.
Visión (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.