AI 智能体可以通过 API 独立完成整个流程:查看可租方案、用自己的 USDC 充值、租用一台独享移动代理(1 天或 30 天)、获取连接信息、轮换 IP 并续租。你只需用 API 密钥设置一次,之后它不再需要控制台。
- API 基础地址:
https://ipvolt.com/beta/api/v1 - 充值付款地址:
https://ipvolt.com/api/v1 - API 参考、OpenAPI 描述和 Proxy Toolkit MCP 设置(英文)
完整流程
- 查看可租方案:
GET /stock,无需密钥。 - 充值:
GET /fund?amountMinor=N返回402和一份报价。智能体签署一笔 Base 上的 USDC 转账,连同自己的密钥一起发送,然后轮询statusUrl,直到付款变为credited,通常在几分钟内。每笔 $1 到 $500;详见 API 参考中的“由智能体充值”。 - 租用:
POST /rentals,带上Idempotency-Key和每台设备愿付的最高价maxPriceMinor,然后在订单为paid时轮询GET /orders/{orderId}。 - 获取连接信息:订单变为
fulfilled后,GET /rentals/{id}给出代理的主机、端口、用户名和密码。 - 轮换:
POST /rentals/{id}/rotate请求新的 IP。 - 续租:先
GET /rentals/{id}/extension-price,再带上Idempotency-Key和maxPriceMinor调用POST /rentals/{id}/extend。
租用和续租从余额扣费,并计入密钥的每日限额。充值花的是智能体自己的 USDC,绝不是客户的钱,并且不会在链上退回:它会留在余额中。
只需设置一次
- 在控制台的 Account settings → API keys 中创建一个读写密钥,有效期 30 或 90 天,并设置每日限额。复制密钥:它只显示一次。
- 通过环境变量
IPVOLT_API_KEY把密钥交给智能体,绝不要写进提示词。 - 如需充值,给它一个持有 Base 上 USDC 的钱包,私钥同样放在它的环境中。你也可以自己在控制台中充值。
只读密钥可以让智能体只查看、不花钱。API 参考包含所有端点、错误说明,以及 cURL、Python 和 Node.js 示例,其中一个是先充值再租用。
Proxy Toolkit MCP
在本地运行时,如果环境中设置了 IPVOLT_API_KEY,Proxy Toolkit MCP(英文)服务器会增加账户工具,它们用这个密钥调用 API。没有该变量时,本地服务器没有账户工具;托管服务器 https://mcp.ipvolt.com/mcp 保留其四个工具,无需密钥。
{
"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 进行的一切操作均适用可接受使用政策(英文)。