Какой endpoint нужен вашему приложению
Посмотрите, какой метод вызывает ваш клиент. client.chat.completions.create, client.responses.create и Anthropic Messages используют разные тела запросов и разные структуры ответа. Замена URL не превращает один протокол в другой.
Таблица описывает маршруты CLODEx. Она не означает, что каждая модель поддерживает все три протокола. Отдельно проверяйте tools, изображения, streaming и прочие необязательные функции для выбранного ID.
| Клиент / протокол | Endpoint и ввод | Что читать в ответе |
|---|---|---|
| Chat Completions | POST /v1/chat/completions · messages | choices[].message; finish_reason; usage |
| Responses | POST /v1/responses · input | output items; status; usage. Не choices. |
| Anthropic-compatible Messages | POST /v1/messages · messages + max_tokens | content blocks; stop_reason; usage |
Как проверить модель до переноса приложения
Успешный ответ без 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. Примеры предназначены для указанного протокола; они не являются журналом выполненных запросов и не обещают одинаковые функции у всех моделей. Рабочий запрос на генерацию может списать средства.
Частые вопросы
Какой протокол выбрать для нового бота?
Выберите тот, который поддерживают ваш клиент и нужная модель. Для простого текстового бота сначала проверьте один непотоковый запрос; не внедряйте сразу несколько протоколов.
Можно переключить модель одним ID?
Только если совпадают нужный протокол и функции. Проверьте параметры, формат ответа, ограничения и тарификацию до переключения рабочего приложения.
Почему низкая цена за токен не даёт дешёвого результата?
Повторы, длинные ответы и отклонённые результаты тоже расходуют баланс. Сравнивайте фактический расход на принятые ответы при одинаковом задании.