Тестовый режим без оплаты
Как проверить интеграцию с Hubris, ничего не потратив — бесплатные модели без пополнения, песочница на странице модели, ключи только для чтения и лимит расхода.
Отдельного тестового адреса у Hubris нет: интеграция проверяется на том же API, что обслуживает рабочие запросы, — https://api.hubris.pw/v1. Денег при этом можно не тратить вовсе или ограничить расход заранее. Ниже — четыре способа, от «ничего не нужно» до «ключ, который не потратит больше заданной суммы».
Без регистрации: песочница на странице модели
На карточке модели с текстовым или картиночным ответом в каталоге есть вкладка песочницы. Гостю она отвечает бесплатной моделью — можно написать несколько сообщений и увидеть, как модель отвечает, не создавая аккаунт.
Для проверки кода регистрация тоже не нужна на первом шаге: список моделей с ценами отдаётся без ключа.
curl https://api.hubris.pw/v1/modelsБез пополнения: бесплатные модели
Модели с флагом pricing.is_free работают на аккаунте с нулевым балансом: запрос проходит, с баланса ничего не списывается. У них есть суточный лимит запросов — он и актуальный список моделей на странице Бесплатные модели.
-
Зарегистрируйтесь на hubris.pw и создайте ключ на странице Ключи.
-
Найдите бесплатную модель:
curl -s https://api.hubris.pw/v1/models \ | jq -r '.data[] | select(.pricing.is_free) | .id' -
Отправьте запрос тем же кодом, что пойдёт в работу, — поменяется только имя модели:
curl https://api.hubris.pw/v1/chat/completions \ -H "Authorization: Bearer $HUBRIS_API_KEY" \ -H "Content-Type: application/json" \ -d '{"model": "<id бесплатной модели>", "messages": [{"role": "user", "content": "Привет"}]}'
Формат запроса, ответа, стриминга и ошибок у бесплатных моделей тот же, что у платных, поэтому перейти на платную модель после проверки — значит поменять одну строку.
Ключ, который ничего не тратит
Ключ только для чтения видит каталог моделей, баланс и статистику, а любой запрос, который тратит деньги, получает 403 key_read_only. Подходит для дашбордов, мониторинга и проверки авторизации: утечка такого ключа ничего не стоит. Включается галочкой при создании ключа на странице Ключи или полем read_only в Management API.
Ключ с потолком расхода
Для тестов на платных моделях задайте ключу лимит расхода — например, 100 ₽ на весь срок ключа. Когда лимит исчерпан, запросы получают 429 и деньги больше не списываются. Периоды сброса и коды ошибок — на странице Rate limits.
Что дальше
- Быстрый старт — первый запрос за минуту.
- Спецификация API в формате OpenAPI — все эндпоинты и схемы.
- Коды ошибок — что делать с каждым ответом.
Обновлено: