Compatibilidad con el SDK de OpenAI



Primeros pasos con el SDK de OpenAI

Para usar la función de compatibilidad con el SDK de OpenAI, necesitarás:

1. Usar un SDK oficial de OpenAI
2. Cambiar lo siguiente
   • Actualiza tu URL base para que apunte a la API de Claude
   • Reemplaza tu clave de API con una clave de API de Claude
   • Actualiza el nombre de tu modelo para usar un modelo de Claude
3. Revisar las siguientes secciones para saber qué funciones son compatibles



Ejemplo de inicio rápido

import os

from openai import OpenAI

client = OpenAI(
    api_key=os.environ.get("ANTHROPIC_API_KEY"),  # Your Claude API key
    base_url="https://api.anthropic.com/v1/",  # the Claude API endpoint
)

response = client.chat.completions.create(
    model="claude-opus-5",  # Claude model name
    messages=[
        {"role": "system", "content": "You are a helpful assistant."},
        {"role": "user", "content": "Who are you?"},
    ],
)

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



Limitaciones importantes de compatibilidad con OpenAI



Comportamiento de la API

Estas son las diferencias más sustanciales con respecto al uso de OpenAI:

• El parámetro strict para la llamada a funciones se ignora, lo que significa que no se garantiza que el JSON de tool use siga el esquema proporcionado. Para garantizar la conformidad con el esquema, usa la API de Claude nativa con Structured Outputs.
• La entrada de audio no es compatible; se ignorará y se eliminará de la entrada
• El almacenamiento en caché de prompts no es compatible, pero sí lo es en los SDK de Anthropic
• Los mensajes de system/developer se elevan y concatenan al inicio de la conversación, ya que Anthropic solo admite un único mensaje de sistema inicial.

La mayoría de los campos no compatibles se ignoran silenciosamente en lugar de producir errores. Todos ellos están documentados en las siguientes secciones.



Consideraciones sobre la calidad de la salida

Si has hecho muchos ajustes a tu prompt, es probable que esté bien afinado específicamente para OpenAI. Considera reelaborarlo para Claude usando la guía de mejores prácticas de prompting.



Elevación de mensajes de system / developer

La mayoría de las entradas del SDK de OpenAI se asignan claramente de forma directa a los parámetros de la API de Anthropic, pero una diferencia notable es el manejo de los prompts de system / developer. Estos dos prompts se pueden colocar a lo largo de una conversación de chat a través de OpenAI. Dado que Anthropic solo admite un mensaje de sistema inicial, la API toma todos los mensajes de system/developer y los concatena con un único salto de línea (\n) entre ellos. Esta cadena completa se proporciona luego como un único mensaje de sistema al inicio de los mensajes.



Soporte de pensamiento

Puedes habilitar el pensamiento agregando el parámetro thinking. En los modelos actuales el pensamiento es adaptativo, con Claude decidiendo cuándo y con qué profundidad pensar, y en los modelos Claude 5 está activado de forma predeterminada; el pensamiento extendido configurado manualmente es un modo heredado. Si bien el pensamiento mejora el razonamiento de Claude para tareas complejas, el SDK de OpenAI no devuelve el proceso de pensamiento detallado de Claude. Para obtener todas las funciones de pensamiento, incluido el acceso a la salida de razonamiento paso a paso de Claude, usa la API de Claude nativa.

response = client.chat.completions.create(
    model="claude-sonnet-4-6",
    messages=[{"role": "user", "content": "Who are you?"}],
    extra_body={"thinking": {"type": "enabled", "budget_tokens": 2000}},
)



Límites de velocidad

Los límites de velocidad siguen los límites estándar de Anthropic para el endpoint /v1/messages.



Soporte detallado de la API compatible con OpenAI



Campos de solicitud



Campos simples



Campos de tools / functions



Campos del arreglo messages



Campos de respuesta



Compatibilidad de mensajes de error

La capa de compatibilidad mantiene formatos de error consistentes con la API de OpenAI. Sin embargo, los mensajes de error detallados no serán equivalentes. Usa los mensajes de error solo para registro y depuración.



Compatibilidad de encabezados

Si bien el SDK de OpenAI gestiona automáticamente los encabezados, aquí está la lista completa de encabezados compatibles con la API de Claude para los desarrolladores que necesiten trabajar con ellos directamente.