# ИИ-агенты

Source: https://ipvolt.com/ru/docs/ai-agents
Markdown: https://ipvolt.com/ru/docs/ai-agents.md
Language: ru

[Главная](https://ipvolt.com/ru.md) / [Документация (на английском)](https://ipvolt.com/docs.md) / ИИ-агенты

Раздел: API
Обновлено: 2026-11-22
Автор: ipvolt

Как ИИ-агент арендует мобильный прокси на день или 30 дней, меняет его IP и продлевает аренду с предоплаченного баланса, с API-ключом и дневным лимитом.

ИИ-агент может сам пройти весь цикл через [API](/ru/docs/api): проверить предложения, пополнить баланс своими USDC, арендовать выделенный мобильный прокси на 1 или 30 дней, получить данные подключения, менять IP и продлевать аренду. Вы один раз настраиваете его с API-ключом; дальше панель управления ему не нужна.

- Базовый адрес API: `https://ipvolt.com/beta/api/v1`
- Адрес оплаты для пополнений: `https://ipvolt.com/api/v1`
- [Справочник API](/ru/docs/api), [описание OpenAPI](https://ipvolt.com/beta/api/v1/openapi.json) и [настройка Proxy Toolkit MCP (на английском)](/mcp)

## Цикл

1. **Проверить предложения:** `GET /stock`, ключ не нужен.
2. **Пополнить баланс:** `GET /fund?amountMinor=N` отвечает `402` с предложением. Агент подписывает перевод USDC в сети Base, отправляет его со своим ключом и опрашивает `statusUrl`, пока платёж не станет `credited`, обычно в течение нескольких минут. От $1 до $500 за пополнение; подробности — в разделе «Пополнение баланса агентом» [справочника API](/ru/docs/api).
3. **Арендовать:** `POST /rentals` с `Idempotency-Key` и максимальной ценой за устройство в `maxPriceMinor`, затем `GET /orders/{orderId}`, пока заказ в статусе `paid`.
4. **Получить данные подключения:** когда заказ `fulfilled`, `GET /rentals/{id}` даёт хост, порты, логин и пароль прокси.
5. **Сменить IP:** `POST /rentals/{id}/rotate` запрашивает новый IP.
6. **Продлить:** `GET /rentals/{id}/extension-price`, затем `POST /rentals/{id}/extend` с `Idempotency-Key` и `maxPriceMinor`.

Аренда и продление оплачиваются с баланса и учитываются в дневном лимите ключа. Пополнение тратит собственные USDC агента, никогда не деньги клиента, и не возвращается в блокчейне: оно остаётся на балансе.

## Разовая настройка

1. В разделе **Account settings → API keys** [панели управления](https://ipvolt.com/dashboard) создайте ключ с доступом на чтение и запись, сроком 30 или 90 дней и дневным лимитом. Скопируйте ключ: он показывается один раз.
2. Передайте ключ агенту в переменной окружения `IPVOLT_API_KEY` и никогда не передавайте его в промпте.
3. Для пополнений дайте ему кошелёк с USDC в сети Base, закрытый ключ которого тоже хранится в его окружении. Вы также можете сами пополнить баланс в панели управления.

Ключ только для чтения позволяет агенту смотреть, ничего не тратя. В [справочнике API](/ru/docs/api) есть все эндпоинты, ошибки и примеры на cURL, Python и Node.js, в том числе пополнение баланса с последующей арендой.

## Proxy Toolkit MCP

При локальном запуске сервер [Proxy Toolkit MCP (на английском)](/mcp) добавляет инструменты для работы с аккаунтом, если в его окружении задана `IPVOLT_API_KEY`; они обращаются к API с этим ключом. Без этой переменной у локального сервера нет инструментов аккаунта, а у размещённого сервера `https://mcp.ipvolt.com/mcp` остаются его четыре инструмента, которым ключ не нужен.

```json
{
  "mcpServers": {
    "ipvolt-proxy-toolkit": {
      "command": "npx",
      "args": [
        "--yes",
        "@ipvolt/proxy-toolkit-mcp@0.3.0"
      ],
      "env": {
        "IPVOLT_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}
```

В конфигурации хранится ключ, поэтому держите файл в закрытом доступе. Чтобы попробовать инструменты до создания аккаунта, задайте вместо ключа `IPVOLT_SANDBOX` со значением `1`: тогда они работают с имитацией аккаунта внутри локального сервера, не отправляют запросов в ipvolt и ничего не списывают.

## Без аккаунта

Агент может арендовать выделенный мобильный прокси и без аккаунта ipvolt. Он создаёт заказ запросом `POST /guest/orders`, принимая Условия, и один раз получает идентификатор счёта (invoice ID). Он платит своими USDC по адресу оплаты, указанному выше, отправляя идентификатор счёта в заголовке `Authorization`, а затем арендует через `POST /rentals`. `GET /guest` описывает шаги, версию Условий и лимиты. Идентификатор счёта — единственный способ вернуться к заказу: агент должен хранить его в секрете и не потерять. Пакет трафика покупается так же: в заказе указывается его `packId`, а `POST /traffic/purchase` оплачивает его с баланса заказа.

## Токены агентов

Агент может получить доступ и через [auth.md](https://ipvolt.com/auth.md) вместо ключа: вы подтверждаете его 6-значным кодом и выбираете доступ только для просмотра или лимит расходов.

Ко всему, что агент делает через API, применяются [Правила допустимого использования (на английском)](/acceptable-use).

## Ещё документация

- Далее: [Оплата и продление (на английском)](https://ipvolt.com/docs/billing.md)
- [Вся документация (на английском)](https://ipvolt.com/docs.md)
- [Читать оригинал на английском](https://ipvolt.com/docs/ai-agents.md)
