Open Service Hub

轻量级开放服务中心,通过统一 API 网关为您提供古诗词名句、IP 定位、Bing 壁纸、K站动漫壁纸、Crontab 计算、弹幕服务及 IPTV 直播源等实用服务接口,另有中转下载、Docker 镜像加速等自托管服务

快速接入 控制台
7
核心 API
12
诗词主题
99.9%
服务可用性
多源
NAS弹幕服务
旧域名 open.saintic.com 已经迁移至此,其中 BingIncludedQuery/BaiduIncludedQuery/CronTime/bingPic 单独重定向至 Hub 对应 Service,但仍然建议参考API服务调整接口。

API 服务列表

开放服务通过 /openservice 前缀访问,收录查询通过 /api 前缀访问

统一响应格式

所有返回 JSON 的接口均使用同一结构,建议以 success 判断成败。

字段类型说明
success bool 请求是否成功true 成功,false 失败;请以此为唯一判断依据,不要依赖 HTTP 状态码
message str 结果描述信息。失败时为具体错误原因(如「请输入待查询的 URL」),可直接展示给用户
data可选 dict / list / str 业务数据,成功时返回,具体字段见各接口文档。注意:内容为空时该字段会被整体省略(不是 null),取用前需判空
其他可选 any 附加信息,如请求参数回显,仅部分接口返回
// 成功
{
  "success": true,
  "message": "",
  "data": { /* 各接口不同 */ }
}

// 失败(data 无内容时被省略)
{
  "success": false,
  "message": "invalid expression"
}

多数错误(参数非法、上游异常等)返回 HTTP 200 + success: false400(参数错误)、403(无权限/命中黑名单)、429(请求过于频繁)、 502(上游服务不可用)等状态码仅用于部分场景。

古诗词名句随机 & 按条件查询 / 支持 SVG 渲染
GETJSONTXTSVG
GEThttps://hub.saintic.com/openservice/sentence/
GEThttps://hub.saintic.com/openservice/sentence/<rule>

涵盖 12 大主题、100+ 分类、100+ 古籍来源的经典名句,可按作者、主题、分类灵活查询。

参数说明
rule查询规则:author.catalog.suffix,如 libai.shuqing.svg
has-urlSVG 输出时是否包含原文链接
font-familySVG 字体,如 KaiTi
fillSVG 文字颜色,如 #333
Bing 每日壁纸多分辨率 / 历史随机 / 移动端适配
GETJSON302 重定向
GEThttps://hub.saintic.com/openservice/bingpic

获取 Bing 每日精选壁纸,支持 720p/1080p/4K 及移动端分辨率,每日 0:30 自动刷新缓存。

参数说明
d日期(yyyymmdd),默认今天;random 随机
p分辨率:720p / 1080p / 4k
mobile存在则返回移动端分辨率图片
json存在则以 JSON 格式返回(否则 302 跳转)
K站动漫壁纸konachan 随机图 / 原图直链
GETJSON302 重定向
GEThttps://hub.saintic.com/openservice/konachanpic

代理 konachan 官方 API 获取随机动漫壁纸(上游请求经代理访问),图片经 sapic 图床上传保存(国内可直接访问),随机返回桌面版尺寸(1080p/2K,宽≥1920、高≥1080)图片;结果缓存 3 小时,同参数重复请求直接返回缓存。

参数说明
random存在则从历史缓存记录中随机返回一张(默认读最新缓存)
json存在则以 JSON 格式返回(否则 302 跳转)
IP 地址查询本机 IP / 地理位置 / 运营商信息
GETJSONTXT
GEThttps://hub.saintic.com/openservice/ip/<module>

基于 ip2region 数据库的 IP 定位服务,精确到城市级,支持国家、省份、城市、运营商查询。

子模块说明
myip返回客户端真实 IP(纯文本)
addr返回地址详情(文本,如"中国 广东 深圳 电信")
rest返回完整 JSON(含国家代码等)
?ip=子模块的查询参数(可选),指定查询的目标 IP,默认是当前客户端IP

短域名快捷链接(跳转域名 https://satic.cn 下的保留路径):

Linux Crontab 计算执行时间推算 / 正向 & 反向查询
GETJSON
GEThttps://hub.saintic.com/openservice/crontab

基于 croniter 的 Cron 表达式计算工具,可推算接下来或将来的执行时间点。

参数说明
expressionCron 表达式,如 */5 * * * *
query_times查询次数(1-32,默认 1)
query_typenext(之后)/ prev(之前)
format_time时间格式,默认 %Y-%m-%d %H:%M:%S

以服务器当前时间为基准推算。

IPTV 直播源M3U8 / 智能过滤 / 高清源 / 自用
GETM3U8
GEThttps://hub.saintic.com/openservice/iptv.m3u8

自动拉取并过滤高质量 IPTV 直播源,筛选规则:响应时间 ≤ 100ms 且分辨率为 1080p 或 1920。

参数说明
直接返回过滤后的 .m3u8 直播源列表
过滤条件:响应时间 ≤ 100ms,分辨率 1080p+
弹幕服务自托管弹幕聚合 · 兼容 弹弹play API
GETAPI Token
GEThttps://danmu.satic.cn/api/v1/<token>

为家庭影音场景准备的弹幕服务:将上面的地址填入播放器即可自动匹配弹幕,不用再手动找字幕、对时间轴。基于开源项目 misaka_danmu_server 自托管,兼容 弹弹play API 规范,支持弹幕库管理、搜索导入与任务追踪。

适用场景
群晖 / 威联通 / 极空间 / 飞牛 NAS Emby / Jellyfin / Plex / 家庭影音库
支持播放器
Yamby Hills 小幻影视 SenPlayer Afusekt 弹弹play
参数说明
token弹幕 Token,在 控制台 创建获取
弹幕合并输出,支持后备搜索,支持关键词搜索和自动导入
搜索引擎收录查询百度 / 必应 · URL 收录状态检测
GETJSON限速
GEThttps://hub.saintic.com/api/sec/baidu
GEThttps://hub.saintic.com/api/sec/bing

检测指定 URL 是否被百度、必应收录,常用于新站上线后确认收录进度、排查内容未被索引的问题。结果默认缓存,可用 force 强制实时查询。

参数说明
url必需,待查询的完整 URL(需带 http/https)
method百度支持 json/html,必应支持 rss/html;留空按默认方式
force1/true/yes 强制实时查询(忽略缓存)
限速:登录 20 次/天(按 uid),匿名 5 次/天(按 IP)
响应字段
Included:是否被收录 url:实际查询的 URL deduct:是否消耗配额

公开外部服务

分享自托管、直接通过域名访问的在线工具与加速服务。

中转下载服务d.tcw.im · down2local 远程中转下载
DOWNLOAD外部服务
LINKhttps://d.tcw.im

基于开源项目 down2local 自托管的中转下载服务:在服务器上替您下载网络资源(GitHub Release、直链文件等)再本地取回,解决本地直接下载缓慢或受限的问题。

Docker 镜像加速registry.tcw.im · 自建 Registry Mirror
MIRROR外部服务
LINKhttps://registry.tcw.im

自建 Docker Registry Mirror,国内加速拉取 Docker Hub 官方镜像,仅需在 Docker / containerd 中配置镜像加速地址。

查看配置说明

Docker Engine(Linux):

sudo tee /etc/docker/daemon.json <<'EOF'
{
  "registry-mirrors": ["https://registry.tcw.im"]
}
EOF
sudo systemctl restart docker

Docker Desktop(macOS / Windows):打开 Settings → Docker Engine,在 JSON 中加入 "registry-mirrors": ["https://registry.tcw.im"] 后 Apply & Restart。

临时拉取(无需改配置):

docker pull registry.tcw.im/library/nginx:latest
docker tag registry.tcw.im/library/nginx:latest nginx:latest

containerd(Kubernetes 节点,追加到 /etc/containerd/config.toml):

[plugins."io.containerd.grpc.v1.cri".registry.mirrors."docker.io"]
  endpoint = ["https://registry.tcw.im"]

验证:docker info | grep -i mirrors

快速开始

选择您常用的方式接入 OpenHub API

curl -s "https://hub.saintic.com/openservice/sentence/" | python -m json.tool
curl -s "https://hub.saintic.com/openservice/ip/rest"
curl -s "https://hub.saintic.com/openservice/bingpic?p=1080p&json=1"
curl -s "https://hub.saintic.com/openservice/konachanpic?json=1"
curl -s "https://hub.saintic.com/openservice/crontab?expression=0%209%20*%20*%201-5&query_times=3"
curl -s "https://hub.saintic.com/openservice/iptv.m3u8" | head -20
curl -s "https://danmu.satic.cn/api/v1/YOUR_TOKEN"

在线调试