# 移动代理IP轮换API：通过链接或API调用更换IP

> 通过链接或API调用更换4G/5G移动代理IP：端点，curl/Python/Node代码，429限制。CellMast，无需 KYC，支持加密货币支付。

- URL: https://cellmast.com/zh/ip-rotation-api/
- 最后更新: 2026-10-13
- Publisher: CellMast (https://cellmast.com)

每个 CellMast 专用端口都配有可直接在浏览器打开的轮换链接、脚本使用的REST端点及自动轮换计时器。本页展示三者及其限制和响应内容。

*先轮换，再检查新IP*

```
# 1. change the IP of your port
$ curl "https://cellmast.com/api/v1/mobile/{port}/rotate?key=API_KEY&format=text"
# 2. send a request through the port
$ curl -x http://USERNAME:PASSWORD@gw.cellmast.com:7777 https://api.ipify.org
```

**快速回答 — 如何通过链接、API或计时器更换移动代理IP？**

使用 **CellMast**，打开您端口的轮换链接 `https://cellmast.com/api/v1/mobile/{port}/rotate?key=API_KEY`，或用POST方法携带Bearer密钥调用相同端点。调制解调器重新连接运营商，获得新的IP。每次轮换都会重新连接端口与运营商，通常耗时 5-15 秒；运营商偶尔会返回相同 IP，遇此情况请再次轮换。。每个专用4G/5G端口均包含此轮换功能，起价 每天$2.63，无需 KYC，支持加密货币支付。

## 轮换一览

| 属性 | 值 |
| --- | --- |
| 轮换链接 | `GET https://cellmast.com/api/v1/mobile/{port}/rotate?key=API_KEY` |
| 脚本调用 | `POST /api/v1/mobile/{portId}/rotate` 搭配 `Authorization: Bearer API_KEY` |
| 定时器 | 使用`PATCH /api/v1/mobile/{portId}`配合`rotation.mode = interval`，最短每2分钟一次，最长每24小时一次 |
| 轮换的作用 | 每次轮换都会重新连接端口与运营商，通常耗时 5-15 秒；运营商偶尔会返回相同 IP，遇此情况请再次轮换。 |
| 最小间隔 | 同一端口两次手动轮换间隔为30秒；过早请求将收到带有`Retry-After`的HTTP 429响应 |
| 响应 | 新IP、之前的IP、轮换时间、下一次允许轮换时间 |
| 会出现相同IP吗？ | 可能：运营商从其地址池中选择该地址 |
| 费用 | 每个住宅代理专用端口包含此功能；无额外的每次轮换费用 |
| 密钥权限范围 | 带有`proxies`权限范围的API密钥 |

## 轮换链接是如何工作的？

轮换链接是一个包含您端口ID的普通URL（形如`mob_2v8k1q`；在客户端区域可查看每个端口的现成链接），并内含API密钥。通过浏览器、书签或脚本打开该链接时，会请求调制解调器断开当前运营商连接并重新连接。运营商随后分配一个通常不同的IP地址。

在链接后添加`&format=text`参数，可以只返回新IP的纯文本格式，适用于Shell脚本。请将此链接视为密码：任何拥有链接的人都能轮换您的端口，同一密钥用于API调用时也能修改端口设置、子用户或IP白名单。建议专门为轮换链接创建独立密钥，避免链接出现在共享文档和聊天预览中，若泄露，可在客户端区域撤销该密钥。

*使用链接轮换（curl）*

```bash
# Replace {port} with your port ID (e.g. mob_2v8k1q, not 7777) and API_KEY with your key
curl "https://cellmast.com/api/v1/mobile/{port}/rotate?key=API_KEY"

# Plain-text answer: just the new IP
curl "https://cellmast.com/api/v1/mobile/{port}/rotate?key=API_KEY&format=text"
```

## 如何通过REST API用脚本进行轮换？

脚本应通过POST方法发送请求，将密钥放入`Authorization`请求头，以防密钥出现在服务器日志或浏览器历史记录中。响应将告知新IP及下一次允许轮换的时间。

*POST /api/v1/mobile/{portId}/rotate*

```bash
curl -X POST "https://cellmast.com/api/v1/mobile/PORT_ID/rotate" \
  -H "Authorization: Bearer API_KEY"
```

*示例响应（200）*

```json
{
  "ip": "203.0.113.24",
  "previousIp": "198.51.100.7",
  "rotatedAt": "2026-10-13T09:41:07Z",
  "nextRotationAvailableAt": "2026-10-13T09:41:37Z"
}
```

示例中的地址和时间仅供参考。`previousIp`让您的代码确认运营商是否真正分配了新地址。

## 如果过于频繁轮换会怎样？

每个端口最多每30秒接受一次手动轮换。若间隔未到，服务器将返回HTTP **429**，错误信息为`rotation_too_soon`，并在`Retry-After`头部告知需等待的秒数。端口不会断开，保持当前IP。

过快轮换通常无益。每次重连期间端口无流量传输，且运营商可能返回相同地址。[轮换策略指南](https://cellmast.com/zh/guides/mobile-ip-rotation-strategy/)建议根据任务设置合理间隔。

*示例响应（429）*

```http
HTTP/1.1 429 Too Many Requests
Retry-After: 22
Content-Type: application/json

{
  "error": {
    "code": "rotation_too_soon",
    "message": "Next rotation available in 22 seconds",
    "details": { "retryAfter": 22 },
    "requestId": "req_2b7c11"
  }
}
```

## 如何设置定时自动轮换？

将端口的轮换模式设置为`interval`，并选择一个2至1440分钟的时间间隔（即每2分钟到每24小时）。定时器将自动执行轮换，无需您的操作。切换回`manual`即可停止。也可在客户端区域设置定时器。

*每10分钟轮换一次*

```bash
curl -X PATCH "https://cellmast.com/api/v1/mobile/PORT_ID" \
  -H "Authorization: Bearer API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"rotation": {"mode": "interval", "intervalMinutes": 10}}'

# back to manual rotation
curl -X PATCH "https://cellmast.com/api/v1/mobile/PORT_ID" \
  -H "Authorization: Bearer API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"rotation": {"mode": "manual", "intervalMinutes": null}}'
```

## 如何用Python或Node.js进行轮换？

两个示例均演示如何轮换端口并打印新IP；Python示例还通过此端口发送请求。[Python指南](https://cellmast.com/zh/guides/python-mobile-proxy/)中包含重试及轮换助手代码。

*Python（requests）*

```python
import requests

API = "https://cellmast.com/api/v1"
KEY = "API_KEY"
PORT_ID = "PORT_ID"
PROXY = "http://USERNAME:PASSWORD@gw.cellmast.com:7777"

r = requests.post(f"{API}/mobile/{PORT_ID}/rotate",
                  headers={"Authorization": f"Bearer {KEY}"}, timeout=60)
if r.status_code == 429:
    print("too soon, retry after", r.headers.get("Retry-After"), "s")
else:
    r.raise_for_status()
    print("new IP:", r.json()["ip"])

print(requests.get("https://api.ipify.org",
                   proxies={"http": PROXY, "https": PROXY}, timeout=30).text)
```

*Node.js 18+（保存为rotate.mjs）*

```javascript
// save as rotate.mjs (ES module), then: node rotate.mjs
const API = "https://cellmast.com/api/v1";
const res = await fetch(`${API}/mobile/PORT_ID/rotate`, {
  method: "POST",
  headers: { Authorization: "Bearer API_KEY" },
  signal: AbortSignal.timeout(60000),
});
if (res.status === 429) {
  console.log("retry after", res.headers.get("retry-after"), "s");
} else if (!res.ok) {
  throw new Error(`HTTP ${res.status}`);
} else {
  const { ip, previousIp } = await res.json();
  console.log(previousIp, "->", ip);
}
```

## 我可以将端口移至其他运营商、城市或国家吗？

请联系支持。需要另一个国家吗？联系客服：如果该地有端口库存，我们将把您剩余的天数转移过去，并通过您的余额结算价格差额（每计费周期限一次转移）。同样适用于同一国家内的其他运营商或城市。移机后，主机、端口和密码可能变更，请在客户端区域重新查看。

## 我能查看我的端口使用过哪些IP吗？

可以。`GET /api/v1/mobile/{portId}/ip-history`列出端口分配过的地址及时间。可用于确认轮换实际产生了新地址，核对自身日志，或验证每个地址确实属于您选择的运营商。`GET /api/v1/mobile/{portId}/usage`展示每日流量信息；专用端口数据不限量。

## 按流量计费的移动池需要这个API吗？

不需要。[旋转移动池](https://cellmast.com/zh/mobile-proxies/rotating/)会自行更换IP：每次新连接都会从池中分配 IP，通常不同；若想每个请求使用新 IP，保持一个请求对应一个连接（关闭 keep-alive）。。您通过用户名控制，例如`USERNAME-country-us-session-abc123-ttl-15`实现15分钟固定会话。轮换API适用于住宅代理专用端口，您拥有一台专属调制解调器，自行决定何时变更IP。

## 轮换相关问题

### 移动代理IP更换需要多长时间？

在CellMast住宅代理专用端口上，通常需要5到15秒：调制解调器断开运营商连接后重新接入，由运营商分配新IP。期间端口无流量通过，请在API返回新IP前暂停请求。

### 轮换次数有限制吗？

轮换不额外收费。API 设定了一个限制：每个端口最多每 30 秒允许一次手动轮换。计时器可设置为每 2 分钟至 24 小时一次。

### 为什么轮换后得到的还是同一个 IP？

因为由运营商决定地址。运营商通过 CGNAT 在多个用户之间共享公共 IPv4 地址，重连时可能会分配到相同地址。检查响应中的 `previousIp` 并在 30 秒后再次轮换，如果需要不同地址。详见 [CGNAT 指南](https://cellmast.com/zh/guides/cgnat-mobile-ips/)]。

### 轮换链接可以安全地分享吗？

只限于可能控制端口的人。链接包含 API 密钥：拥有者可以轮换你的端口，并且用相同密钥的 API 调用还可更改端口设置、子用户或 IP 允许列表。轮换链接建议使用专用密钥，在脚本中优先用带密钥头部的 POST 端点，如链接泄漏请在客户区撤销密钥。

### 我可以选择下一个 IP 或长期保留同一个 IP 吗？

不可以。地址由运营商分配，没人能选择下一个地址，运营商也可能自行更改地址。如需长期保留同一地址，请设置为手动轮换并避免重连；若需固定 IP 用于允许列表，移动代理不是合适产品。

**每个端口包含轮换服务** 来自 每天$2.63 的专用 4G/5G 端口，无限流量，可通过链接、API 或计时器轮换。支持加密货币支付。 [查看端口价格](https://cellmast.com/zh/pricing/) · [移动 API 参考](https://cellmast.com/docs/api/mobile/)

---

CellMast: CellMast 是一家 4G/5G 4G 移动代理提供商：配备专用运营商猫，流量不限，同时提供按 GB 计费的轮换移动代理池，支持加密货币支付，无需上传身份信息。