РУКОВОДСТВО ПО ПОДКЛЮЧЕНИЮ

Подключите API
к своему приложению.

Для начала понадобятся аккаунт, API-ключ и клиент, который позволяет настроить адрес сервера.

API Base URLhttps://api.umiloai.com/v1

ШАГ 01

Войдите и проверьте баланс

Войдите по почте и паролю или создайте аккаунт. Если вы уже пользуетесь ботом, выберите вход через ту же Telegram-учётную запись: сайт откроет связанный с ней аккаунт. Регистрация по почте создаёт отдельный аккаунт; автоматически объединять их по имени или почте сервис не будет.

Для платных запросов потребуется доступный баланс. Суммы пополнения находятся на странице «Пополнение», а условия использования — на странице «Условия».

ШАГ 02

Создайте ключ с лимитом

В кабинете откройте «API-ключи», укажите название приложения и лимит расходов. Полный ключ появится один раз: скопируйте его и сохраните в настройках своего приложения.

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

Храните ключ на сервере или в защищённых настройках клиента. Не публикуйте его в открытом репозитории или коде веб-страницы. Потерянный или раскрытый ключ отзовите в кабинете.

ШАГ 03

Задайте параметры подключения

Для OpenAI-совместимых клиентов с настраиваемым сервером проверьте три поля. Названия настроек зависят от приложения.

Параметры подключения приложения
ПолеЧто указать
Base URL / API endpointhttps://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 и отсутствие лишних пробелов в ключе.
  • Убедитесь, что ключ активен, его лимит не исчерпан, а на аккаунте есть баланс.
  • Сверьте идентификатор модели и совместимость клиента с опубликованной информацией сервиса.
  • Сохраните время запроса и текст ошибки для поддержки. Полный ключ передавать не нужно.
Открыть помощь