系列「每天一个高质量 API」第 28 篇。搜蚁智选(souyi.net.cn)是一个面向 AI Agent 的 API 发现与统一调用平台。今天聊 ipify 公网 IP 探测(free-ip-ipify)。
一行拿到调用方公网 IP——网络诊断、地理预检、回环判定的零成本探针。
这个 API 能做什么
ipify 的 ?format=json 返回调用方的公网 IPv4:{"ip":"x.x.x.x"}。无参数、无密钥,适合做 Agent 出网前的连通性与地理预检。
为什么 AI Agent 需要它
- 网络诊断 Agent:先确认「我能出网吗、从哪出」。
- 地理预检:拿到 IP 后接 GeoIP 判断大致区域。
- 回环判定:配合其他接口区分本地 / 公网调用。
怎么用
方式一:直连上游(免费、无需 Key)
curl "https://api.ipify.org?format=json"
方式二:经搜蚁智选一键调用(带 Key,统一计费 / 限流 / 可观测)
curl -X POST https://souyi.net.cn/api/v1/ai/request \
-H "X-API-Key: YOUR_AIMALL_KEY" \
-H "Content-Type: application/json" \
-d '{"asset_id":"free-ip-ipify","call_data":{}}'
这些免费 API 的上游本身免密;经搜蚁智选代理后,多个数据源可以聚合到同一个 Agent 工作流里,统一走 X-API-Key + 统一计费、限流与可观测,省去每个上游单独接一遍。
返回示例
{
"ip": "203.0.113.7"
}
价格
免费。ipify 公开端点免密;平台调用仅记录调用量。
怎么拿到 Key
注册 souyi.net.cn → 控制台一键生成 X-API-Key → 即可调用平台全部 API(含本系列 34 个)。
小结
最简单的「我在哪」探针。ipify 零参数零密钥,是 Agent 做网络自检时最先该接的那一个。
下一篇(Day 29):在站宇航员名单(Open Notify)(free-space-astros)。系列持续更新,关注不迷路。