Документация для разработчиков

Руководство описывает, как приложению безопасно обращаться к API-шлюзу THETA-CLOUD и где получить учётные данные в личном кабинете.

Что понадобится

1. API-ключ — выпускается вручную на портале после входа (Аутентификация и ключи).
2. Базовый URL шлюза — точка входа вашей среды; в примерах ниже это плейсхолдер BASE_GATE (часто отдельный хост вида https://api.theta-cloud.ru).

Раздел Chat completions рассчитан на совместимость с клиентской моделью OpenAI: можно вызывать POST .../v1/chat/completions через официальный пакет openai (параметр base_url) или обычным HTTP-клиентом.

Карта документации

Раздел	Содержание
Обзор	Назначение шлюза и портала, перечень публичных эндпоинтов
Аутентификация и ключи	Заголовок Authorization: Bearer …, ошибки доступа
Chat completions	OpenAI-совместимый чат, SDK и примеры без стриминга и со стримингом
Баланс и тарифы	Как узнать остаток средств и посмотреть цены моделей

Советуйте ключи только из переменных окружения или секрет-хранилища; не включайте их в код репозитория.