# AI 智能体

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

[首页](https://ipvolt.com/zh.md) / [文档（英文）](https://ipvolt.com/docs.md) / AI 智能体

分类：API
更新于：2026-11-22
作者：ipvolt

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

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

- API 基础地址：`https://ipvolt.com/beta/api/v1`
- 充值付款地址：`https://ipvolt.com/api/v1`
- [API 参考](/zh/docs/api)、[OpenAPI 描述](https://ipvolt.com/beta/api/v1/openapi.json)和 [Proxy Toolkit MCP 设置（英文）](/mcp)

## 完整流程

1. **查看可租方案**：`GET /stock`，无需密钥。
2. **充值**：`GET /fund?amountMinor=N` 返回 `402` 和一份报价。智能体签署一笔 Base 上的 USDC 转账，连同自己的密钥一起发送，然后轮询 `statusUrl`，直到付款变为 `credited`，通常在几分钟内。每笔 $1 到 $500；详见 [API 参考](/zh/docs/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. 在[控制台](https://ipvolt.com/dashboard)的 **Account settings → API keys** 中创建一个读写密钥，有效期 30 或 90 天，并设置每日限额。复制密钥：它只显示一次。
2. 通过环境变量 `IPVOLT_API_KEY` 把密钥交给智能体，绝不要写进提示词。
3. 如需充值，给它一个持有 Base 上 USDC 的钱包，私钥同样放在它的环境中。你也可以自己在控制台中充值。

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

## Proxy Toolkit MCP

在本地运行时，如果环境中设置了 `IPVOLT_API_KEY`，[Proxy Toolkit MCP（英文）](/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](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)
