AI 智能体

AI 智能体如何通过 ipvolt API 用你的预付余额租用一台独享移动代理(1 天或 30 天)、轮换 IP 并续租:从创建带每日限额的 API 密钥到第一次租用的步骤,Proxy Toolkit MCP 的本地设置,以及通过 auth.md 获得的智能体令牌。

本页内容

AI 智能体可以通过 API 独立完成整个流程:查看可租方案、用自己的 USDC 充值、租用一台独享移动代理(1 天或 30 天)、获取连接信息、轮换 IP 并续租。你只需用 API 密钥设置一次,之后它不再需要控制台。

完整流程

  1. 查看可租方案:GET /stock,无需密钥。
  2. 充值:GET /fund?amountMinor=N 返回 402 和一份报价。智能体签署一笔 Base 上的 USDC 转账,连同自己的密钥一起发送,然后轮询 statusUrl,直到付款变为 credited,通常在几分钟内。每笔 $1 到 $500;详见 API 参考中的“由智能体充值”。
  3. 租用:POST /rentals,带上 Idempotency-Key 和每台设备愿付的最高价 maxPriceMinor,然后在订单为 paid 时轮询 GET /orders/{orderId}。
  4. 获取连接信息:订单变为 fulfilled 后,GET /rentals/{id} 给出代理的主机、端口、用户名和密码。
  5. 轮换:POST /rentals/{id}/rotate 请求新的 IP。
  6. 续租:先 GET /rentals/{id}/extension-price,再带上 Idempotency-Key 和 maxPriceMinor 调用 POST /rentals/{id}/extend。

租用和续租从余额扣费,并计入密钥的每日限额。充值花的是智能体自己的 USDC,绝不是客户的钱,并且不会在链上退回:它会留在余额中。

只需设置一次

  1. 在控制台的 Account settings → API keys 中创建一个读写密钥,有效期 30 或 90 天,并设置每日限额。复制密钥:它只显示一次。
  2. 通过环境变量 IPVOLT_API_KEY 把密钥交给智能体,绝不要写进提示词。
  3. 如需充值,给它一个持有 Base 上 USDC 的钱包,私钥同样放在它的环境中。你也可以自己在控制台中充值。

只读密钥可以让智能体只查看、不花钱。API 参考包含所有端点、错误说明,以及 cURL、Python 和 Node.js 示例,其中一个是先充值再租用。

Proxy Toolkit MCP

在本地运行时,如果环境中设置了 IPVOLT_API_KEY,Proxy Toolkit MCP(英文)服务器会增加账户工具,它们用这个密钥调用 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 创建订单并接受条款,订单只返回一次发票 ID(invoice ID)。它用自己的 USDC 向上面的付款地址付款,并在 Authorization 请求头中发送发票 ID,然后通过 POST /rentals 租用。GET /guest 说明步骤、条款版本和限制。发票 ID 是回到订单的唯一方式:智能体必须妥善保密保存。流量包也是一样:订单中写明它的 packId,再用 POST /traffic/purchase 以订单余额购买。

智能体令牌

智能体也可以不用密钥,而是通过 auth.md 获得访问权限:你用 6 位验证码确认,并选择仅查看权限或支出上限。

智能体通过 API 进行的一切操作均适用可接受使用政策(英文)。

接入你的第一个代理。

移动代理每天 $9 起。住宅代理每 GB $0.60 起,流量包 $5 起。