IP 签名档
实时演示
当前访客信息生成中…
图片 API
使用 GET 请求,直接返回 SVG 或 PNG 图片。所有参数均可省略,欢迎语与副标题为固定文案,不接受自定义文本。
GET https://api.llk.hk/ip/signature.svg
GET https://api.llk.hk/ip/signature.png?theme=dark&layout=detail旧版 title、greeting、subtitle 参数已停用,传入也不会生效。
| 参数 | 默认值 | 说明 |
|---|---|---|
theme | light | light / dark,图片的浅色或深色主题。 |
layout | compact | compact 简洁版 / detail 详细版。 |
accent | f02272 | 六位十六进制主题色,不带 #。 |
brand | true | true 显示品牌;false 隐藏图片内的 Logo、流量刊名称与域名。 |
fields | ip,location,isp,asn,device,date | 逗号分隔。简洁版显示 ip / isp;其余字段在详细版显示。传空值只保留欢迎语。 |
tz | UTC | 日期显示时区,支持 UTC、Asia/Shanghai 等 IANA 时区。 |
返回与错误
200 返回图片;422 表示参数不合法;429 表示请求过于频繁;503 表示服务暂不可用。遇到 429 或 503 时按 Retry-After 等待重试。
识别与缓存
只识别当前请求的出口 IP,无 ip 参数。使用 no-store 避免共享访客图片。每 IP 每分钟 120 次,SVG 与 PNG 共用额度。
常见问题
查看我的 IP图片展示谁的 IP?
默认展示加载图片的访客出口 IP,支持 IPv4 和 IPv6。同一张图片链接,不同访客打开时会得到各自的信息,不支持通过参数查询指定 IP。
为什么论坛或邮件里显示的不是我的 IP?
部分平台会代替访客下载图片并缓存,接口接收到的是图片代理的 IP 和 User-Agent,无法还原真实访客。直接在自己的网站通过 img 加载通常能识别访客出口 IP;平台缓存也可能导致内容没有更新。
SVG 和 PNG 怎么选?
SVG 缩放清晰、体积较小,适合自己的网站。部分论坛会拦截 SVG,此时可改用 PNG。PNG 按两倍像素生成,建议按 560px 宽或更小尺寸展示。
可以自定义文字吗?
不支持自定义文字。欢迎语中的地区按访客 IP 生成,定位不可用时显示“远方”。
可以隐藏品牌和 IP 吗?
可以。勾选“隐藏品牌信息”,图片会移除流量刊名称、Logo 和域名;生成的 HTML、Markdown、BBCode 也不再附加品牌跳转链接。图片仍通过 api.llk.hk 提供。取消“IP 地址”可以隐藏图片中的 IP。
有调用限制吗?
同一来源 IP 的 SVG、PNG 合计每分钟最多 120 次,无额外冷却间隔。超过时返回 429 和 Retry-After。图片限额与公开 IP 查询分开,流量统计和“我的 IP”查询不受这一额度影响。
下载后还能自动识别访客吗?
下载得到的是当前图片快照,不会随查看者变化。需要动态展示时,请使用生成的图片 URL 或嵌入代码。服务返回 no-store,仍无法控制第三方平台自行代理或缓存图片。