Совместимость с 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-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
• Системные сообщения и сообщения разработчика поднимаются и объединяются в поле верхнего уровня system, где бы они ни находились в разговоре. Чтобы добавить системные инструкции в середине разговора, используйте системные сообщения в середине разговора в нативном Claude API.

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

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

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

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

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

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

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