OpenAI-compatible API через CLODEx

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

Для OpenAI-совместимых клиентов базовый адрес — https://clodex.xyz/v1. На него можно настроить SDK, приложение или поддерживаемую IDE.

Начните с личного кабинета

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

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

Подключение без написания кода

Если нужен AI в редакторе, сначала откройте мастер подключения. CLODEx даёт инструкции для Codex App, VS Code Codex, Cursor, Cline, JetBrains и Zed. Терминал не является обязательным интерфейсом.

В подходящем режиме клиента задайте Base URL, API-ключ и точный ID модели. Проверьте ограничения клиента: собственный ключ может поддерживаться не во всех функциях редактора.

Подключение в своём приложении

Для backend выберите поддерживаемый маршрут:

• /v1/responses: запрос с input, ответ с типизированными выходными элементами.
• /v1/chat/completions: запрос с messages, ответ с choices.

Выбор зависит от клиента, модели и нужных функций. Не переносите параметры одного протокола в другой механически.

Сначала получите список доступных ключу моделей. Команда предполагает, что ключ уже безопасно задан в окружении:

curl --fail-with-body 'https://clodex.xyz/v1/models' \
  -H "Authorization: Bearer $CLODEX_API_KEY"

Пример короткого Responses-запроса:

curl --fail-with-body 'https://clodex.xyz/v1/responses' \
  -H "Authorization: Bearer $CLODEX_API_KEY" \
  -H 'Content-Type: application/json' \
  --data '{"model":"gpt-5.6-sol","input":"Ответь одним словом: готово"}'

Модель в примере проверяйте для своего ключа. Генерация оплачивается по действующим условиям. Для Python и Node.js есть отдельный гайд по SDK.

Проверка и запуск в работу

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

В production задайте тайм-ауты, ограничения бюджета и контролируемые повторные попытки. Не повторяйте запрос бесконечно при ошибке ключа, недостатке средств или неверном формате. После сетевого тайм-аута учитывайте риск повторного выполнения оплачиваемой операции.

Ключ должен оставаться на backend или в защищённом хранилище клиента. Не помещайте его в публичный JavaScript, переменные NEXT_PUBLIC_* или VITE_*, Git и логи.

Что не входит в это подключение

Ключ CLODEx не пополняет аккаунт OpenAI, не оформляет ChatGPT Plus и не гарантирует поддержку каждого endpoint OpenAI. В частности, список моделей не является универсальной спецификацией файловых, поисковых или облачных функций.

Документация API · API-ключи · Сравнение Responses, Chat Completions и Messages.