Технические гайды

Responses, Chat Completions и Messages: какой протокол выбрать

Проверено 6 ноября 2026 г.3 мин чтения

Один аккаунт CLODEx может использоваться для разных API-маршрутов. Но протоколы отличаются адресами, телом запроса, ответами и инструментальным циклом. Ключ решает вопрос авторизации, а не преобразования любого запроса в любой другой.

Главная таблица

Протокол	Base URL в соответствующем SDK	Метод	Основной ввод
Responses	`https://clodex.xyz/v1`	`POST /v1/responses`	`input`
Chat Completions	`https://clodex.xyz/v1`	`POST /v1/chat/completions`	`messages`
Anthropic Messages	`https://clodex.xyz`	`POST /v1/messages`	`messages`, другие поля по спецификации

В Base URL не нужно дописывать полный путь метода: SDK добавляет его сам. Для raw HTTP, напротив, требуется полный URL endpoint.

Responses

Это маршрут, используемый в инструкции Codex через CLODEx. Минимальный запрос содержит модель и input:

{
  "model": "gpt-5.6-sol",
  "input": "Кратко объясни эту функцию"
}

Ответ содержит выходные элементы. В официальных SDK для простого текстового результата предусмотрен output_text, но для инструментов необходимо обрабатывать соответствующие элементы, а не только этот текст.

Для Codex App, VS Code Codex и CLI используйте мастер подключения. Не заменяйте wire_api="responses" на другой протокол ради случайного успешного текстового теста.

Chat Completions

Подходит для клиентов и приложений, использующих совместимую схему сообщений:

{
  "model": "gpt-5.6-sol",
  "messages": [
    {"role":"user","content":"Объясни назначение API"}
  ]
}

Обычный ответ читается из choices, но результат может содержать tool calls вместо готового пользовательского текста. Проверяйте причины завершения и формат, нужный вашему сценарию.

Для Cursor, Cline, Roo Code и других редакторов следуйте инструкции конкретного клиента. Версия приложения и режим провайдера определяют, какой метод оно вызывает.

Anthropic Messages

Для Claude Code и Anthropic SDK в CLODEx используется корневой base URL без /v1. Итоговый endpoint — https://clodex.xyz/v1/messages.

Тело и ответ соответствуют Messages-формату. В частности, ответ организован в content blocks; инструментальные вызовы и их результаты нельзя механически заменить choices или output_text.

Настройки ключа и заголовков зависят от клиента. Для Claude Code смотрите отдельный гайд, для прямой интеграции — документацию Messages.

Выбор за минуту

Готовый клиент: сначала выясните, какой протокол он поддерживает.
Модель: проверьте доступность точного ID для ключа и необходимые функции.
Задача: отдельно подтвердите streaming, изображения, tools или структурированный вывод, если они нужны.
Кабинет: сделайте короткий тест и сверьте запись в журнале расходов.

Авторизованный /v1/models полезен для проверки доступа, но не гарантирует полную матрицу возможностей каждой модели.

Частые ошибки миграции

Двойной /v1 или полный endpoint вместо Base URL в SDK.
messages в примере, рассчитанном на input, без проверки схемы.
Один парсер ответа для всех трёх протоколов.
Подмена tool calls обычным текстом.
Принятие HTTP 200 за доказательство полного завершения streaming-ответа.
Бесконечные повторы при ошибке авторизации или баланса.

Для потока учитывайте финальное событие используемого протокола. Обрыв соединения без завершения не следует показывать как гарантированно полный ответ. Аргументы инструментов проверяйте до исполнения, а действия ограничивайте разрешениями приложения.

Полная документация · Python и JavaScript SDK · API-ключи.