Практическое подключение

LLM API: выбор протокола

У CLODEx три текстовых протокола: Chat Completions, Responses и Messages. Выберите тот, который использует ваш клиент, затем сравните модели на одной задаче и по фактическим списаниям.

Какой endpoint нужен вашему приложению

Посмотрите, какой метод вызывает ваш клиент. client.chat.completions.create, client.responses.create и Anthropic Messages используют разные тела запросов и разные структуры ответа. Замена URL не превращает один протокол в другой.

Таблица описывает маршруты CLODEx. Она не означает, что каждая модель поддерживает все три протокола. Отдельно проверяйте tools, изображения, streaming и прочие необязательные функции для выбранного ID.

Клиент / протоколEndpoint и вводЧто читать в ответе
Chat CompletionsPOST /v1/chat/completions · messageschoices[].message; finish_reason; usage
ResponsesPOST /v1/responses · inputoutput items; status; usage. Не choices.
Anthropic-compatible MessagesPOST /v1/messages · messages + max_tokenscontent blocks; stop_reason; usage

Подключение OpenAI SDK · Запрос в Messages API

Как проверить модель до переноса приложения

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

  • Получите /v1/models с ключом своего приложения и выберите точный data[].id. Публичная карточка модели не заменяет эту проверку.
  • Сопоставьте ID с поддерживаемым маршрутом в документации. Не копируйте параметры от другой модели только из-за похожего названия.
  • Отправьте один короткий запрос без tools, вложений и streaming. Он платный; заранее задайте квоту ключа.
  • Проверьте формат ответа и причину завершения. Затем добавляйте функции по одной: так видно, какое изменение ломает интеграцию.

Проверка каталога без генерации · Модели и маршруты

Дешёвый LLM API: сравните реальную стоимость результата

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

Для раздельного тарифа считайте некэшированный вход, кэшированный вход и выход по их ставкам. Если тариф использует Fixed Usage за суммарные токены, не переносите на него эту формулу автоматически: примените опубликованные правила. Не учитывайте одни и те же кэшированные токены дважды.

  • Записывайте ID модели, размер задачи, число попыток, фактический расход и причину отказа от ответа.
  • В total_actual_spend включайте неудачные платные попытки. Если принятых результатов нет, сравнивать стоимость одного успешного результата нельзя.
  • Время и тариф фиксируйте вместе с датой теста. Не выдавайте один удачный запуск за гарантированную скорость.
cost = uncached_input / 1_000_000 * input_rate
     + cached_input   / 1_000_000 * cache_rate
     + output         / 1_000_000 * output_rate

cost_per_accepted_result = total_actual_spend / accepted_results

Публичные цены и единицы расчёта · Справочник расхода

LLM API из России: что проверить в своей среде

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

Ключ CLODEx работает с endpoint CLODEx; он не создаёт аккаунт у владельца модели и не является подпиской на его сайт. Доступные способы оплаты проверяйте в кабинете. Эта страница не обещает обход ограничений, доступность из любой сети или одинаковые условия для каждого пользователя.

Разобрать ошибку подключения

Документация и проверка примера

Адреса и настройки подключения сверены с документацией CLODEx. Примеры предназначены для указанного протокола; они не являются журналом выполненных запросов и не обещают одинаковые функции у всех моделей. Рабочий запрос на генерацию может списать средства.

Подключение клиентов · Протоколы API

Частые вопросы

Какой протокол выбрать для нового бота?

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

Можно переключить модель одним ID?

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

Почему низкая цена за токен не даёт дешёвого результата?

Повторы, длинные ответы и отклонённые результаты тоже расходуют баланс. Сравнивайте фактический расход на принятые ответы при одинаковом задании.

Подключите CLODEX API к своему проекту

Один ключ, единый endpoint и несколько семейств LLM для разработки, приложений и ботов.