# API-ключи

Создайте ключ, чтобы ваш собственный ИИ-агент или скрипт мог пользоваться SimianX AI, скопируйте его один раз, ограничьте его расходы и отзовите его.

- Все планы. Число ключей зависит от вашего плана.
- Создание ключа бесплатно. Всё, что запускает ключ, расходует очки вашего аккаунта.

API-ключ позволяет ИИ-агенту или скрипту пользоваться SimianX AI от имени вашего аккаунта без вашего пароля. Эта страница посвящена самим ключам.

## Создать ключ

1. Откройте меню аккаунта, выберите **Мой аккаунт** и откройте вкладку **API-ключи**.
2. Нажмите **Создать ключ**. Откроется форма **Новый API-ключ**.
3. В поле **Название** введите название, по которому вы поймёте, где используется ключ.
4. В разделе **Что разрешено этому ключу** выберите, что может делать ключ: читать рыночные данные и новости, запускать анализы, управлять Автопилотами, управлять ключами. Первые три пункта выбраны по умолчанию. Без разрешения на запуск анализов ключ может читать данные, но не может запустить анализ.
5. По желанию: задайте **Дневной бюджет (баллы)**, **Месячный бюджет (баллы)** или **Максимум за один вызов (баллы)**. Пустое поле означает отсутствие лимита.
6. По желанию: заполните поля **Агент**, **Разрешённые IP** (по одному адресу в строке) и **Срок действия**.
7. Нажмите **Создать ключ**.

![Форма «Новый API-ключ» с полем «Название», вариантами разрешений, тремя необязательными полями бюджета в очках, полем «Агент», полем «Разрешённые IP», списком «Срок действия» и кнопкой «Создать ключ».](https://fw.simianx.ai/help/ru/account-api-key-form.light.633ab67e3f.webp)

*Форма нового API-ключа*

## Скопировать ключ

Окно **Ваш новый ключ** показывает ключ полностью. Нажмите **Копировать** и сохраните ключ в своём агенте или в менеджере паролей, затем нажмите **Готово**.

> **Нельзя отменить**
> Полный ключ показывается только в этот единственный раз. SimianX AI хранит только хеш и не может показать ключ снова. Если вы потеряли ключ, отзовите его и создайте новый.

![Окно «Ваш новый ключ». В нём четыре строки, у каждой кнопка «Копировать»: полный ключ, строка для задания его как переменной окружения для агента, фраза, которая поручает агенту настроиться самостоятельно, и команда для проверки ключа. Внизу находится кнопка «Готово».](https://fw.simianx.ai/help/ru/account-api-key-token.light.1672ce5eb1.webp)

*Ключ показывается один раз*

## Чтение списка

Для каждого ключа показаны название, первые символы, очки, потраченные сегодня и в этом месяце, бюджет и время последнего использования.

- **Использование**: запросы и очки за последние 7 дней по эндпоинтам.
- **Изменить**: изменить название, разрешения, бюджеты, агента и список разрешённых IP. Изменения применяются к следующему запросу.
- **Отозвать**: прекратить действие ключа.

## Отозвать ключ

1. Нажмите **Отозвать** в строке ключа.
2. В окне **Отозвать этот ключ?** нажмите **Отозвать**.

> **Нельзя отменить**
> Запросы с отозванным ключом сразу перестают работать, и восстановить ключ нельзя. Автопилоты, которые запустил ключ, продолжают работать в вашем аккаунте. При желании остановите их на странице **Автопилоты**.

## Очки

> **Расходует очки**
> Ключ тратит очки вашего аккаунта по тем же ставкам, что и на сайте. Задайте бюджет для каждого ключа, чтобы один агент не мог потратить больше, чем вы разрешаете. См. [Очки и тарифы](https://www.simianx.ai/ru/points).

## Полезно знать

- Вкладка показывает, сколько у вас ключей и сколько разрешает ваш план. Когда лимит достигнут, кнопка **Создать ключ** неактивна: отзовите ключ или [смените план](https://www.simianx.ai/ru/help/points-and-plans/change-plan.md).
- Агент может и сам запросить ключ: он даёт вам ссылку, а вы подтверждаете или отклоняете запрос. См. [Подключение собственного ИИ-агента](https://www.simianx.ai/ru/help/market-tools/connect-ai-agent.md).
- Ключ не может войти на сайт и не может изменить вашу подписку или платёжные данные.

---

Веб-страница: https://www.simianx.ai/ru/help/account/api-keys
Раздел: [Аккаунт](https://www.simianx.ai/ru/help/account.md)
Полное руководство: https://www.simianx.ai/ru/help/manual.md