Для более прямого руководства по миграции кода, смотрите наше руководство по миграции API.

По мере того, как мы продолжаем улучшать и расширять наши возможности ИИ, мы рады представить наш новый Messages API, который предлагает несколько преимуществ по сравнению с нашим устаревшим Text Completions API.

Это руководство поможет вам перенести ваши существующие приложения с Text Completions API на Messages API, обеспечивая плавный переход и открывая доступ к нашим последним функциям и улучшениям.

​
Почему стоит перейти на Messages API?

Messages API предлагает несколько ключевых преимуществ:

  1. Обработка изображений: Messages API - это единственный способ обработки изображений с помощью Claude, позволяющий использовать наши передовые возможности компьютерного зрения для таких задач, как классификация изображений, обнаружение объектов и многое другое.
  2. Создание с моделями Claude 3: Наши новейшие и самые мощные модели Claude 3 (Haiku, Sonnet и Opus) могут быть вызваны только через Messages API. Обновившись, вы сможете воспользоваться их улучшенной производительностью и возможностями.
  3. Улучшенная обработка ошибок: Messages API позволяет нам возвращать более информативные и полезные сообщения об ошибках, что облегчает диагностику и устранение проблем в ваших запросах.
  4. Улучшенная валидация запросов: С помощью Messages API мы можем более эффективно проверять ваши API-запросы, гарантируя, что вы получите результаты наивысшего качества и наилучшую возможную производительность от наших моделей.

​
Как перейти на Messages API

Самый простой способ перейти с Text Completions API на Messages API - использовать нашу веб-консоль для преобразования ваших промптов. Используя консоль, вы можете быстро и легко перенести ваши промпты и запросы в Messages API без необходимости вручную переписывать ваш код.

Просто выполните следующие шаги:

​
1. Перейдите в консоль и выберите модель, которую хотите использовать

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

Здесь же вы можете при необходимости настроить любые дополнительные параметры, такие как температура и максимальное количество токенов для сэмплирования. Для получения дополнительной информации о наших параметрах см. документацию по Messages API.

​
2. Перенесите ваш промпт в соответствующие поля сообщений консоли

Промпты Text Completions API - это многострочные строки, которые охватывают все части промпта, такие как системный промпт и пользовательский ход. Messages API разделяет различные части промпта, такие как системный промпт и пользовательский ход, на отдельные поля.

Например, давайте возьмем этот промпт Text Completions API:

Text
Today is March 4, 2024.

H: What are 3 ways to cook apples?

A:

Без использования консоли, переход этого промпта потребовал бы полного переписывания вашего кода в Messages API. Однако, перенос отдельных частей вашего промпта (системный промпт и пользовательский промпт) в соответствующие поля консоли позволяет извлечь правильный предварительно отформатированный код из коробки.

В консоли приведенный выше промпт будет выглядеть так:

Обратите внимание, что нет текста Human: или Assistant:, и что системный промпт и пользовательский промпт находятся в разных полях сообщений.

​
3. Скопируйте предварительно отформатированный код

После того, как все части вашего промпта будут на месте, а параметры настроены, нажмите кнопку </> Get Code в правом верхнем углу, чтобы просмотреть и скопировать соответствующий фрагмент кода Messages API для Python и TypeScript.

Для нашего примера промпта автоматический вывод Python из меню </> Get Code будет выглядеть так:

Python
import anthropic

client = anthropic.Anthropic(
    # defaults to os.environ.get("ANTHROPIC_API_KEY")
    api_key="my_api_key",
)
message = client.messages.create(
    model="claude-3-opus-20240229",
    max_tokens=1000,
    temperature=0,
    system="Today is March 4, 2024.",
    messages=[
        {
            "role": "user",
            "content": [
                {
                    "type": "text",
                    "text": "What are 3 ways to cook apples?"
                }
            ]
        }
    ]
)
print(message.content)

Примечание: Консоль пока не позволяет предварительно заполнять ответ Claude (т.е. предварительно заполнять текст в ходе Assistant), но базовый Messages API позволяет это делать. Смотрите наше руководство по предварительному заполнению ответа Claude для примеров того, как отформатировать запрос Messages API с помощью этой техники.

​
Миграция с других моделей

Если вы в настоящее время используете другую платформу или модель ИИ и хотите перейти на Claude с Messages API, мы создали всеобъемлющее руководство, которое поможет вам в этом процессе. Смотрите миграцию с других моделей для получения подробных инструкций о том, как адаптировать ваши промпты и код к нашей платформе.

​
Документация по API

Для получения дополнительной информации о Messages API и его возможностях, пожалуйста, обратитесь к нашей документации по API:

Если у вас есть какие-либо вопросы или вам нужна дополнительная помощь в переходе на Messages API, пожалуйста, не стесняйтесь обращаться в нашу службу поддержки. Мы здесь, чтобы помочь вам максимально эффективно использовать наши возможности ИИ и обеспечить плавный переход на Claude.

Миграция с других моделейОбзор