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

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

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

1. Использовать официальный OpenAI SDK.
2. Изменить следующее:
   • Обновите базовый URL, чтобы он указывал на Claude API.
   • Замените свой ключ API на ключ Claude API из Claude Console.
   • Если ваш ключ является ключом личной или сервисной учётной записи, не привязанным к рабочему пространству, также отправляйте заголовок 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 напрямую соответствуют параметрам Claude API, но одно явное отличие заключается в обработке системных подсказок и подсказок разработчика. В OpenAI API эти два типа подсказок могут размещаться в любом месте чат-разговора. Уровень совместимости берёт все системные сообщения и сообщения разработчика и объединяет их, разделяя одним символом новой строки (\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, для разработчиков, которым необходимо работать с ними напрямую.