快速开始
3 分钟跑通：开通 → 白名单 → 提取 → 在你的程序里使用
IP-SaaS 的使用路径非常固定：开通 → 白名单 → 提取 → 使用。
第一步：在控制台下单
访问 admin.magiccoreai.com，按以下顺序选购：
- 选产品类型
AI 共享出口— LLM / 采集 / 研究类TikTok 独占出口— 出海账号矩阵，承诺出口 IP 不与其他新 TikTok 客户复用静态住宅 ISP— 纯净住宅、长期固定
- 选地区（控制台实时显示当前可用的国家 / 城市）
- 选时长（默认按月，部分资源支持按周）
- 付款——支持支付宝；付款成功后系统自动从可用池中给你分配一条 IP 资源
当前为先付款后分配：付款成功后系统从本地池优先分配；本地池没货时会从上游购买补足后再交付给你（"gap-purchase"）。整个过程不需要你做任何操作。
第二步：配置白名单（强烈建议）
我们的代理默认走"IP 白名单认证"——只有从你登记的出口 IP 发起的请求才被允许使用代理。
- 在控制台 → 我的资源 → 选中一条资源 → 白名单 / 安全设置
- 填入你部署程序所在那台机器的出口公网 IP（不是你浏览器所在 IP）
- 保存后通常几秒内生效
详见 白名单与安全。
第三步：拿到接入信息
每条资源开通后，控制台会展示这条资源的：
| 字段 | 含义 |
|---|---|
host / port | 代理入口，配进你的 HTTP / SOCKS 客户端 |
username / password | 代理认证（如有） |
expires_at | 到期时间 |
| 提取 API URL（如开通了提取能力） | 用于程序化拉取 / 更换出口 |
第四步：在程序里用起来
最常见的两种姿势：
姿势 A：固定入口（最简单）
直接把 host:port + username:password 配进你的 HTTP client / 浏览器自动化 / curl：
curl -x http://USERNAME:PASSWORD@HOST:PORT https://api.ipify.org如果返回的是控制台给你的出口 IP，说明链路打通了。
姿势 B：通过 API 程序化提取
适合需要一次拉一批、或经常更换出口的场景：
curl "https://api.magiccoreai.com/ip-saas/v1/extract?token=$TOKEN&count=10"具体提取 / 更换接口和参数见 API 端点。
提取 API 的具体 Base URL 以控制台为准（不同产品线可能不同）。
续费
资源到期前，控制台会展示续费按钮：
- 自助续费会创建一笔续费订单
- 付款成功后系统会按这条 IP 当前的上游账号尝试自动续上游
- 自动续上游失败也会延长你本地的资源到期时间，不影响你继续用
已经过期的资源无法自助续费——请直接重新下单。
最小自检
拿到资源后做两件事就够了：
- 访问
https://api.ipify.org或https://ifconfig.me，确认出口 IP 是控制台给你的那一条 - 跑一次你目标站点的真实请求，确认连通性与速度符合预期
跑通后再上量。