API-токены
API-токен — это ключ для бота или скрипта. С ним программа делает то же, что вы в панели: смотрит серверы, перезапускает их, шлёт команды в консоль, продлевает аренду. Ваш пароль при этом никуда не передаётся.
Как создать токен
Меню аккаунта → «Настройки» → вкладка «API-токены».
- «Подключить к AI» — токен с готовым набором прав для AI-ассистента, см. «AI-ассистенты (MCP)».
- «Создать токен» — новый токен с нуля.
- Карточка токена: права, проекты, срок действия, когда последний раз использовался и сколько потрачено.
- «Изменить» права и ограничения или отозвать токен (корзина).
Токен создаётся в два шага.
Шаг 1. Название и доступ
- Шаги формы — между ними можно переключаться.
- Название — понятное, например «Discord-бот» или «Деплой из CI».
- Срок действия — 30, 90, 365 дней или бессрочно.
- Проекты — все или только выбранные. У выбранного проекта можно нажать «Выбрать услуги» и пустить токен только к конкретным серверам.
- Разрешённые IP — по одному на строку, можно диапазоны (CIDR). Пусто — с любого адреса.
Нажмите «Далее».
Шаг 2. Права
- Переключатель группы включает её основные права.
- «Настроить» раскрывает отдельные права группы.
- Опасные права — траты с баланса, удаление проектов и услуг — подсвечены красным и не включаются переключателем группы: их отмечают вручную.
- Лимит трат — появляется, когда отмечено
billing:spend. - «Создать».
После создания скопируйте токен кнопкой «Скопировать».
Токен показывается один раз. Мы храним только его отпечаток и не сможем показать токен снова. Потеряли — отзовите и создайте новый.
О каждом новом токене приходит письмо, а если подключён Telegram — ещё и сообщение. Если токен создавали не вы, отзовите его и смените пароль.
Права
| Группа | Право | Что разрешает |
|---|---|---|
| Аккаунт | account:read | Профиль, баланс, сводка, реферальная программа |
account:write | Изменение профиля, языка и настроек уведомлений | |
| Финансы | billing:read | История платежей и покупок |
billing:topup | Создание ссылок на пополнение (оплачиваете их вы сами) | |
billing:spend | Траты с баланса: аренда, продление, смена тарифа | |
| Проекты | projects:read | Список проектов |
projects:write | Создание и переименование проектов | |
projects:delete | Удаление проектов | |
projects:members | Добавление и удаление участников | |
| Серверы | servers:read | Список услуг, статус, нагрузка, параметры, бэкапы, задачи |
servers:power | Старт, стоп, рестарт | |
servers:manage | Переименование, переустановка, порт, IP, параметры запуска | |
servers:console | Подключение к консоли и отправка команд | |
servers:files | Чтение и запись файлов сервера (конфиги, плагины) | |
servers:access | Доступы к серверу и данные SFTP | |
servers:cron | Задачи по расписанию | |
servers:backups | Создание, восстановление и удаление бэкапов | |
servers:delete | Удаление услуг | |
| FastDL | fastdl:read / fastdl:write | Просмотр FastDL / сжатие файлов |
| Поддержка | support:read / support:write | Чтение обращений / новые обращения и ответы |
Токен никогда не может больше, чем вы сами. Если вас убрали из проекта, токен тоже теряет к нему доступ.
Лимит трат
Право billing:spend выдаётся только вместе с лимитом: за 24 часа, за 30 дней или оба сразу. Покупка, которая вывела бы токен за лимит, отклоняется, деньги не списываются. Сколько уже потрачено, видно в списке токенов.
Проекты, IP и срок
- Проекты. Токен, ограниченный проектами, не видит остальные и не может создавать новые. Если в проекте выбраны отдельные услуги, токен видит только их и не меняет ничего на уровне проекта.
- IP-адреса. Адреса или диапазоны (CIDR) по одному на строку. С других адресов токен не примут.
- Срок. 30, 90 или 365 дней либо бессрочно. Просроченный токен перестаёт работать сам.
Что через токен сделать нельзя
Вход и выход, сессии, смена пароля и почты, двухфакторная защита, passkey, привязка Telegram, удаление аккаунта и управление самими токенами — всё это доступно только вам в браузере.
Дальше: обзор API, ошибки и коды ответа и справочник методов.