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

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

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

1. Использовать официальный OpenAI SDK
2. Изменить следующее
   • Обновите базовый URL, чтобы он указывал на Claude API
   • Замените ваш ключ API на ключ API Claude
   • Если ваш ключ является персональным ключом или ключом сервисного аккаунта с доступом к нескольким рабочим пространствам, также отправляйте заголовок anthropic-workspace-id с каждым запросом (например, default_headers в Python SDK или defaultHeaders в TypeScript); см. раздел Выбор рабочего пространства
   • Обновите название модели, чтобы использовать модель 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 со структурированными выводами.
• Аудиовход не поддерживается; он будет проигнорирован и удалён из входных данных
• Кэширование подсказок не поддерживается, но оно поддерживается в Anthropic SDK
• Системные сообщения и сообщения разработчика поднимаются и объединяются в начале разговора, поскольку Anthropic поддерживает только одно начальное системное сообщение.

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

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

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

Поднятие системных сообщений / сообщений разработчика

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

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

Вы можете включить мышление, добавив параметр thinking. В текущих моделях мышление является адаптивным: Claude сам решает, когда и насколько глубоко думать, а в моделях Claude 5 оно включено по умолчанию; вручную настраиваемое «extended thinking» (расширенное мышление) является устаревшим режимом. Хотя мышление улучшает рассуждения 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.

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

Поля запроса

Простые поля

Поля tools / functions

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

Поля ответа

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

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

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

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