Совместимость с OpenAI SDK



Начало работы с OpenAI SDK

Чтобы использовать функцию совместимости с OpenAI SDK, вам необходимо:

1. Использовать официальный OpenAI SDK
2. Изменить следующее
   • Обновить ваш базовый URL, чтобы он указывал на Claude API
   • Заменить ваш ключ API на ключ Claude API
   • Обновить имя модели, чтобы использовать модель Claude
3. Ознакомиться со следующими разделами, чтобы узнать, какие функции поддерживаются



Пример быстрого старта

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)



Важные ограничения совместимости с OpenAI



Поведение API

Вот наиболее существенные отличия от использования OpenAI:

• Параметр strict для вызова функций игнорируется, что означает, что JSON использования инструментов не гарантированно соответствует предоставленной схеме. Для гарантированного соответствия схеме используйте нативный Claude API со Structured Outputs.
• Аудиовход не поддерживается; он будет проигнорирован и удалён из входных данных
• Кэширование подсказок не поддерживается, но оно поддерживается в Anthropic SDK
• Сообщения system/developer поднимаются и объединяются в начале разговора, так как Anthropic поддерживает только одно начальное системное сообщение.

Большинство неподдерживаемых полей молча игнорируются, а не вызывают ошибки. Все они задокументированы в следующих разделах.



Соображения о качестве вывода

Если вы много настраивали вашу подсказку, она, вероятно, хорошо оптимизирована именно под OpenAI. Рассмотрите возможность её переработки для Claude, используя руководство по лучшим практикам создания подсказок.



Поднятие сообщений system / developer

Большинство входных данных OpenAI SDK явно напрямую соответствуют параметрам API Anthropic, но одно заметное отличие — это обработка подсказок system / developer. Эти две подсказки могут размещаться по всему ходу чат-разговора через OpenAI. Поскольку Anthropic поддерживает только начальное системное сообщение, API берёт все сообщения system/developer и объединяет их вместе с одним переводом строки (\n) между ними. Эта полная строка затем предоставляется как единое системное сообщение в начале сообщений.



Поддержка мышления

Вы можете включить мышление, добавив параметр thinking. В текущих моделях мышление является адаптивным, и Claude сам решает, когда и насколько глубоко думать, а в моделях Claude 5 оно включено по умолчанию; вручную настроенное расширенное мышление является устаревшим режимом. Хотя мышление улучшает рассуждения Claude для сложных задач, OpenAI SDK не возвращает подробный процесс размышлений Claude. Для полного набора функций мышления, включая доступ к пошаговому выводу рассуждений Claude, используйте нативный Claude API.

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}},
)



Ограничения скорости

Ограничения скорости следуют стандартным лимитам Anthropic для конечной точки /v1/messages.



Подробная поддержка API, совместимого с OpenAI



Поля запроса



Простые поля



Поля tools / functions



Поля массива messages



Поля ответа



Совместимость сообщений об ошибках

Слой совместимости поддерживает согласованные форматы ошибок с OpenAI API. Однако подробные сообщения об ошибках не будут эквивалентными. Используйте сообщения об ошибках только для логирования и отладки.



Совместимость заголовков

Хотя OpenAI SDK автоматически управляет заголовками, вот полный список заголовков, поддерживаемых Claude API, для разработчиков, которым нужно работать с ними напрямую.