IP 签名档

图片 API

实时演示

当前访客信息

生成中…

嵌入代码

HTML
<a href="https://llk.hk/ip/signature" target="_blank" rel="noopener noreferrer">
<img src="https://api.llk.hk/ip/signature.svg?theme=light&amp;layout=compact&amp;accent=f02272&amp;brand=true&amp;fields=ip%2Clocation%2Cisp%2Casn%2Cdevice%2Cdate&amp;tz=UTC"
     alt="访客欢迎卡片" width="560"
     style="max-width:100%;height:auto;border:0"
     referrerpolicy="no-referrer" />
</a>

自定义卡片

外观
主题
布局
主题色
品牌信息

隐藏 Logo、名称、域名及嵌入代码中的品牌链接。

显示信息

切换详细版可设置更多信息。

图片 API

无需 Token

使用 GET 请求,直接返回 SVG 或 PNG 图片。所有参数均可省略,欢迎语与副标题为固定文案,不接受自定义文本。

HTTP
GET https://api.llk.hk/ip/signature.svg
GET https://api.llk.hk/ip/signature.png?theme=dark&layout=detail

旧版 title、greeting、subtitle 参数已停用,传入也不会生效。

参数默认值说明
themelightlight / dark,图片的浅色或深色主题。
layoutcompactcompact 简洁版 / detail 详细版。
accentf02272六位十六进制主题色,不带 #。
brandtruetrue 显示品牌;false 隐藏图片内的 Logo、流量刊名称与域名。
fieldsip,location,isp,asn,device,date逗号分隔。简洁版显示 ip / isp;其余字段在详细版显示。传空值只保留欢迎语。
tzUTC日期显示时区,支持 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,仍无法控制第三方平台自行代理或缓存图片。