Files

T

viktor 428cff8c54 Клиент к ИИ-платформе REG.RU

Обёртка над ai.reg.cloud. Протокол совместим с OpenAI, но у платформы свои
особенности: ключ бывает открыт не ко всем моделям, отказ приходит отдельным
кодом, картинки и речь доступны не всем.

Что внутри:
- синхронный и асинхронный клиенты
- каскад моделей на случай, если часть закрыта или занята
- ремонт оборванного json из ответов
- чистка типографики и отлов иероглифов в русском тексте

Claude-Session: https://claude.ai/code/session_01Loz5stgQZH6ofBdMqTxiJu

2026-08-23 16:58:07 +09:00

3.7 KiB

Исходник Ответственный История

regcloud-ai

Клиент к ИИ-платформе REG.RU, домен ai.reg.cloud.

Протокол там совместим с OpenAI, но есть особенности, ради которых и написана обёртка. Ключ бывает открыт не ко всем моделям, отказ приходит отдельным кодом, а список доступного удобно спрашивать заранее. Плюс тут же лежат мелочи, которые всё равно приходится писать в каждом проекте: ремонт оборванного json, чистка типографики и отлов иероглифов, которые модели иногда роняют в русский текст.

Установка

pip install httpx
# дальше просто положить пакет рядом или поставить из этого репозитория
pip install git+https://git.stackworks.ru/viktor/regcloud-ai.git

Как пользоваться

from regcloud_ai import RegCloudAI

ai = RegCloudAI()                      # ключ берётся из REGCLOUD_AI_KEY
print(ai.ask("Объясни в двух словах, что такое трансформер"))

Ответ приходит объектом, где кроме текста лежит расход токенов и время.

answer = ai.chat("Напиши заголовок ролика про нейросети", model="qwen3.7-max")
print(answer.text, answer.usage.total_tokens, answer.seconds)

Каскад на случай, если модель закрыта для ключа или занята.

answer = ai.cascade("Твой запрос", models=["claude-5-sonnet", "gpt-5.5", "qwen3.7-max"])

Асинхронно всё то же самое.

from regcloud_ai import AsyncRegCloudAI

async with AsyncRegCloudAI() as ai:
    print(await ai.ask("Привет"))

Что доступно на платформе

На август 2026 платформа отдаёт двадцать девять моделей, среди них claude-5-sonnet, gpt-5.5, gemini-3.1-pro, grok-4.3, семейства qwen, glm, deepseek, kimi и minimax. Точный список всегда спрашивайте у самой платформы.

print(RegCloudAI().models())

Замечание про доступы. Ключ может быть выдан только на часть моделей. Тогда обращение к остальным вернёт ModelAccessError. Картинки, синтез и распознавание речи на платформе есть, но открываются отдельно, обычному текстовому ключу они недоступны.

Мелочи, которые обычно нужны

from regcloud_ai.client import extract_json, normalize, foreign_chars

data = extract_json(answer.text)          # вытащит json даже из оборванного ответа
text = normalize(answer.text)             # длинные тире и ёлочки станут обычными
bad = foreign_chars(text)                 # иероглифы, если модель их насыпала

Замеры

Проверено на живых запросах 23.08.2026, время до полного ответа на коротком запросе.

Модель	Время
qwen3.7-max	2.9 с
deepseek-v4-flash	4.5 с
gpt-5.5	5.3 с
claude-5-sonnet	5.5 с
gemini-3.5-flash	5.6 с
glm-5.2	7.1 с

3.7 KiB Исходник Ответственный История