GPT API через OpenAI-compatible endpoint CLODEX

Как подключить GPT API

Если приложение уже использует OpenAI SDK, обычно достаточно заменить base_url и API-ключ. Модель задаётся в каждом запросе, поэтому один и тот же клиент можно использовать для разных GPT-конфигураций из каталога CLODEX.

from openai import OpenAI

client = OpenAI(
    api_key="clodex_YOUR_KEY",
    base_url="https://clodex.xyz/v1",
)

result = client.responses.create(
    model="gpt-5.6-terra",
    input="Составь план миграции API без простоя",
)
print(result.output_text)

Chat Completions или Responses API

Новые agent-сценарии удобнее строить на Responses API: он объединяет ввод, streaming, tool calls и события завершения. Chat Completions остаётся востребованным для существующих библиотек и простых чатов. Перед запуском проверьте, какой маршрут поддерживает выбранная модель и клиент.

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

GPT API для Cursor, Codex, Cline и Telegram-ботов

• Codex и coding agents — генерация кода, тестов и анализ репозитория.
• Cursor, Cline и OpenCode — custom provider через CLODEX base URL.
• Telegram-боты — библиотеки aiogram и python-telegram-bot вместе с OpenAI SDK.
• Backend-сервисы — REST-запросы из Python, JavaScript, Go, PHP и других языков.

Стоимость и контроль расхода

Цена зависит от модели и режима биллинга: input, output, cache или Fixed Usage. Не ориентируйтесь только на цену входных токенов — длинный ответ и reasoning могут формировать основную часть расхода. В CLODEX стоимость отображается в каталоге и usage-логах.

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

Жизненный цикл Responses API и корректное завершение stream

Для coding agents и длинных задач важен не только текст, но и финальное состояние ответа. Успешный stream должен завершиться терминальным событием response.completed. Событие response.failed, ошибка scanner или закрытие соединения без terminal event означают незавершённый ответ. Partial text можно показать пользователю, но нельзя автоматически считать итогом операции или основанием для списания за успешно выполненную Fixed Usage-задачу.

Клиенту следует сохранять last_event_type, terminal_event_seen и request ID. Эти поля позволяют отличить сетевой обрыв от ошибки модели и не запускать слепой retry после того, как внешний tool уже мог выполнить действие.

GPT API key, доступные модели и начало работы

После регистрации создайте отдельный API-ключ и откройте авторизованный список /v1/models. Доступность конкретной GPT-модели зависит от группы ключа и активных каналов, поэтому не копируйте случайный slug из чужого примера. Для первого теста используйте короткий input без tools и streaming, затем сравните фактический расход в usage logs с публичной страницей цен.

Если интеграция предназначена для нескольких клиентов, не раздавайте им один общий секрет. Выпускайте отдельные ключи или проксируйте запросы через свой backend с per-user budget, rate limit и журналом действий.

Rate limits, concurrency и безопасные повторные запросы

Повторный запрос безопасен для анализа текста, но может быть опасен для tool call, платежа, публикации или изменения данных. Такие действия требуют собственного idempotency key и проверки результата на стороне приложения.

• На 429 уменьшайте параллельность и используйте exponential backoff с jitter.
• На network EOF повторяйте запрос только после проверки terminal status и идемпотентности.
• Не запускайте неограниченное число параллельных agent-задач одним пользовательским ключом.
• Сохраняйте request ID и фактическую модель для каждого повтора.