ИИ-агенты

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

На этой странице

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

Цикл

  1. Проверить предложения: GET /stock, ключ не нужен.
  2. Пополнить баланс: GET /fund?amountMinor=N отвечает 402 с предложением. Агент подписывает перевод USDC в сети Base, отправляет его со своим ключом и опрашивает statusUrl, пока платёж не станет credited, обычно в течение нескольких минут. От $1 до $500 за пополнение; подробности — в разделе «Пополнение баланса агентом» справочника 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 панели управления создайте ключ с доступом на чтение и запись, сроком 30 или 90 дней и дневным лимитом. Скопируйте ключ: он показывается один раз.
  2. Передайте ключ агенту в переменной окружения IPVOLT_API_KEY и никогда не передавайте его в промпте.
  3. Для пополнений дайте ему кошелёк с USDC в сети Base, закрытый ключ которого тоже хранится в его окружении. Вы также можете сами пополнить баланс в панели управления.

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

Proxy Toolkit MCP

При локальном запуске сервер Proxy Toolkit 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 вместо ключа: вы подтверждаете его 6-значным кодом и выбираете доступ только для просмотра или лимит расходов.

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

Подключите свой первый прокси.

Мобильные — от $9 в день. Резидентные — от $0.60 за ГБ, пакетами от $5.