无需 KYC — 无需身份证、自拍、文件。加密货币支付：BTC, USDT, USDC, ETH, SOL, LTC。
语言: 简体中文
租用端口

API · 轮换链接，POST，计时器

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

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

租用端口完整API参考

最后更新: 

# 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:[email protected]: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）
# 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
curl -X POST "https://cellmast.com/api/v1/mobile/PORT_ID/rotate" \
  -H "Authorization: Bearer API_KEY"
示例响应（200）
{
  "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。

过快轮换通常无益。每次重连期间端口无流量传输，且运营商可能返回相同地址。轮换策略指南建议根据任务设置合理间隔。

示例响应（429）
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分钟轮换一次
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指南中包含重试及轮换助手代码。

Python（requests）
import requests

API = "https://cellmast.com/api/v1"
KEY = "API_KEY"
PORT_ID = "PORT_ID"
PROXY = "http://USERNAME:[email protected]: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）
// 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吗？

不需要。旋转移动池会自行更换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 指南]。

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

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

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

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

每个端口包含轮换服务

来自 每天$2.63 的专用 4G/5G 端口，无限流量，可通过链接、API 或计时器轮换。支持加密货币支付。

查看端口价格移动 API 参考

无限流量

租用端口