РУКОВОДСТВО ПО ПОДКЛЮЧЕНИЮ
Подключите API
к своему приложению.
Для начала понадобятся аккаунт, API-ключ и клиент, который позволяет настроить адрес сервера.
ШАГ 01
Войдите и проверьте баланс
Войдите по почте и паролю или создайте аккаунт. Если вы уже пользуетесь ботом, выберите вход через ту же Telegram-учётную запись: сайт откроет связанный с ней аккаунт. Регистрация по почте создаёт отдельный аккаунт; автоматически объединять их по имени или почте сервис не будет.
Для платных запросов потребуется доступный баланс. Суммы пополнения находятся на странице «Пополнение», а условия использования — на странице «Условия».
ШАГ 02
Создайте ключ с лимитом
В кабинете откройте «API-ключи», укажите название приложения и лимит расходов. Полный ключ появится один раз: скопируйте его и сохраните в настройках своего приложения.
Лимит ключа ограничивает доступ к общему балансу аккаунта. Создание ключа не добавляет денег на баланс. Для разных приложений удобно создавать отдельные ключи.
ШАГ 03
Задайте параметры подключения
Для OpenAI-совместимых клиентов с настраиваемым сервером проверьте три поля. Названия настроек зависят от приложения.
| Поле | Что указать |
|---|---|
| Base URL / API endpoint | https://api.umiloai.com/v1 |
| API key | Ваш полный ключ, полученный в кабинете |
| Model / Model ID | Доступный идентификатор модели из списка API |
Если клиент требует базовый адрес, не добавляйте к нему путь конкретного запроса. Поддержку модели, интерфейса и ограничений проверьте на странице «Модели и тарифы».
ШАГ 04
Проверьте доступные модели
Запрос списка моделей помогает проверить адрес сервера и авторизацию перед настройкой приложения. Замените YOUR_API_KEY своим ключом.
curl --request GET 'https://api.umiloai.com/v1/models' \
--header 'Authorization: Bearer YOUR_API_KEY'Используйте значение id нужной модели из ответа. Наличие идентификатора в ответе не заменяет проверку опубликованных тарифов и доступного баланса.
ПРОВЕРКА НАСТРОЕК
Если запрос не проходит
- Проверьте адрес API и отсутствие лишних пробелов в ключе.
- Убедитесь, что ключ активен, его лимит не исчерпан, а на аккаунте есть баланс.
- Сверьте идентификатор модели и совместимость клиента с опубликованной информацией сервиса.
- Сохраните время запроса и текст ошибки для поддержки. Полный ключ передавать не нужно.
