Как получить доступ
Ключ к API — это JWT вашего аккаунта Aist Ai. Выпустить его можно самому за пару минут, а для компании подключим вместе.
Самостоятельно
- Войдите в Aist Ai — на chat.aist-ai.com по почте, телефону, VK ID или Яндекс ID. Аккаунта ещё нет — зарегистрируйтесь там же.
- Выпустите ключ — «Настройки» → «API-ключи»: назовите ключ (например, по имени проекта) и нажмите «Выпустить». Ссылка «Выпустить ключ» откроет этот раздел сразу, а без входа сначала попросит войти.
-
Сохраните его — ключ показывается один раз, сервер его не хранит. Положите в переменную
окружения или хранилище секретов, например
AIST_AGENT_TOKEN. -
Проверьте — вставьте ключ в панель управления: она
покажет срок действия, лимиты, доступных ассистентов и готовый код первого запроса. Из кода то же самое
отдаёт
GET /api/me.
GET /api/assistants.
Задачи расходуют баланс аккаунта так же, как сообщения в чате; не хватает — задача завершится ошибкой
Insufficient balance.
Отозвать ключ
В том же разделе «API-ключи» — у каждого ключа своя кнопка. Aist Backend перестаёт принимать отозванный
ключ сразу: запросы к ассистентам и файлам получают 401 Token revoked, задачи завершаются
с той же ошибкой. Ключей можно выпустить несколько — например, отдельный на каждый сервис, чтобы
отзывать их по одному.
Для компании
Напишите нам, если нужно:
- ассистент под вашу задачу — со своими инструкциями, базой знаний и инструментами;
- сотрудники и общий баланс в организации;
- работа по договору для юрлиц, ЭДО;
- помощь с интеграцией или вопрос по API.
Ассистента, которого сделали под вас, может не быть в общем каталоге: его assistant_id мы
сообщим сами, и задачи с ним создаются как обычно.
Дальше
Быстрый старт — первая задача за два запроса; Аутентификация — как устроен токен.