Compatibilidad con el SDK de OpenAI

​

Comenzando con el SDK de OpenAI

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

1. Usar un SDK oficial de OpenAI
2. Cambiar lo siguiente
   • Actualizar tu URL base para que apunte a la API de Anthropic
   • Reemplazar tu clave API con una clave API de Anthropic
   • Actualizar el nombre de tu modelo para usar un modelo Claude
3. Revisar la documentación a continuación para ver qué características están soportadas

​

Ejemplo de inicio rápido

from openai import OpenAI

client = OpenAI(
    api_key="ANTHROPIC_API_KEY",  # Tu clave API de Anthropic
    base_url="https://api.anthropic.com/v1/"  # Endpoint de la API de Anthropic
)

response = client.chat.completions.create(
    model="claude-opus-4-20250514", # Nombre del modelo de Anthropic
    messages=[
        {"role": "system", "content": "Eres un asistente útil."},
        {"role": "user", "content": "¿Quién eres?"}
    ],
)

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

​

Limitaciones importantes de compatibilidad con OpenAI

​

Comportamiento de la API

Aquí están las diferencias más sustanciales de usar OpenAI:

• El parámetro strict para llamadas de función es ignorado, lo que significa que el JSON de uso de herramientas no está garantizado que siga el esquema proporcionado.
• La entrada de audio no está soportada; simplemente será ignorada y eliminada de la entrada
• El caché de prompts no está soportado, pero sí está soportado en el SDK de Anthropic
• Los mensajes de sistema/desarrollador son elevados y concatenados al inicio de la conversación, ya que Anthropic solo soporta un único mensaje de sistema inicial.

La mayoría de campos no soportados son ignorados silenciosamente en lugar de producir errores. Todos estos están documentados a continuación.

​

Consideraciones de calidad de salida

Si has hecho muchos ajustes a tu prompt, es probable que esté bien sintonizado específicamente para OpenAI. Considera usar nuestro mejorador de prompts en la Consola de Anthropic como un buen punto de partida.

​

Elevación de mensajes de Sistema / Desarrollador

La mayoría de las entradas al SDK de OpenAI se mapean claramente y directamente a los parámetros de la API de Anthropic, pero una diferencia distintiva es el manejo de los prompts de sistema / desarrollador. Estos dos prompts pueden ser colocados a lo largo de una conversación de chat a través de OpenAI. Dado que Anthropic solo soporta un mensaje de sistema inicial, tomamos todos los mensajes de sistema/desarrollador y los concatenamos juntos con una sola nueva línea (\n) entre ellos. Esta cadena completa es entonces proporcionada como un único mensaje de sistema al inicio de los mensajes.

​

Soporte de pensamiento extendido

Puedes habilitar las capacidades de pensamiento extendido agregando el parámetro thinking. Aunque esto mejorará el razonamiento de Claude para tareas complejas, el SDK de OpenAI no devolverá el proceso de pensamiento detallado de Claude. Para las características completas de pensamiento extendido, incluyendo acceso a la salida de razonamiento paso a paso de Claude, usa la API nativa de Anthropic.

response = client.chat.completions.create(
    model="claude-opus-4-20250514",
    messages=...,
    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 API Compatible con OpenAI

​

Campos de solicitud

​

Campos simples

​

Campos tools / functions

​

Campos del array 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. Recomendamos usar solo los mensajes de error para registro y depuración.

​

Compatibilidad de encabezados

Aunque el SDK de OpenAI maneja automáticamente los encabezados, aquí está la lista completa de encabezados soportados por la API de Anthropic para desarrolladores que necesiten trabajar con ellos directamente.