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

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

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

1. Использовать официальный OpenAI SDK
2. Изменить следующее:
   • Обновить базовый URL, чтобы он указывал на Claude API
   • Заменить ваш ключ API на ключ API Claude
   • Обновить имя модели, чтобы использовать модель 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-4-8",  # 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 Console в качестве хорошей отправной точки.

Подъём системных сообщений и сообщений разработчика

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

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

Вы можете включить возможности расширенного мышления, добавив параметр 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.

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

Поля запроса

Простые поля

Поля tools / functions

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

Поля ответа

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

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

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

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