Обзор

Архитектура для интегратора

Вы работаете с двумя зонами ответственности:

• Портал theta-cloud.ru — только для человека: вход, управление аккаунтом, выпуск и отзыв API-ключей.
• Шлюз API (BASE_GATE в вашей среде) — единственная машинная точка для приложения: заголовки, JSON, ограничения по трафику и авторизации на стороне продукта.

Поток в общих чертах: ключ из портала → ваш сервис кладёт его в конфигурацию → все вызовы к BASE_GATE идут с Authorization: Bearer <ключ>.

Базовый URL шлюза

Значение BASE_GATE задаёт поддержка или среда развёртывания (без завершающего слэша), например https://api.theta-cloud.ru.

Для библиотек в стиле OpenAI обычно указывают base_url с суффиксом /v1, см. раздел быстрого старта в Chat completions.

Публичные эндпоинты шлюза

Подставьте свой BASE_GATE. Все маршруты ниже используют HTTPS и UTF-8; тело запросов и ответов — JSON, если не сказано иное (например, стриминг чата — другой тип контента).

Метод	Путь	Назначение
POST	/v1/chat/completions	Генерация ответов в формате, совместимом с OpenAI Chat Completions
GET	/v1/billing/balance?workspace=<guid>	Доступный баланс рабочей области
GET	/v1/billing/prices	Каталог тарифов моделей

Аналитика и внутренние сервисы в этом руководстве не описываются.

Заголовок авторизации

Для любого метода таблицы требуется:

Authorization: Bearer <полный ключ API>

Других обязательных пользовательских заголовков документ не задаёт — достаточно корректного TLS и Bearer.