跳到主要内容

Shizuku API

Shizuku 图片单词列表 API。服务返回 JSON，不需要登录。

地址​

本机地址：http://127.0.0.1:3001/api/shizuku
公网地址：https://6767.chat/api/shizuku

接口​

接口用途
GET /api/shizuku/health检查 Shizuku API 是否运行，并返回图片总数与已写描述数量。
GET /api/shizuku/image返回图片文件名里的单词列表，不包含扩展名。
GET /api/shizuku/meta返回 Shizuku 图片元数据，包含英文名、短描述、图片地址、原始来源行号和来源 URL。
GET /api/shizuku/meta/<imageName>返回单张图片的元数据。
GET /shizukuShizuku 宣纸风轮播展示页。
GET /api/shizuku/view与 /shizuku 相同的轮播展示页入口。
GET /source/shizuku/<imageName>按单词访问图片，例如 /source/shizuku/Angel。

返回示例​

curl "https://6767.chat/api/shizuku/image"
curl "https://6767.chat/api/shizuku/meta"
[
  {
    "word": "Antler",
    "description": "Tiny antlers crown her blue coat; a soft paw lifts in greeting.",
    "imageUrl": "/source/shizuku/Antler",
    "format": "jpg",
    "sourceLineNumber": 32,
    "sourceUrl": "https://i0.hdslb.com/bfs/article/7f9bb3f79d36bd8d0b960000a60e4d7d562964e5.jpg?px=1080x1920"
  }
]

Python 示例​

import requests

base_url = "https://6767.chat"
words = requests.get(f"{base_url}/api/shizuku/image", timeout=10).json()
catalog = requests.get(f"{base_url}/api/shizuku/meta", timeout=10).json()

print(words[:3])
print(catalog[0]["word"], catalog[0]["description"])

image_name = words[0]
image = requests.get(f"{base_url}/source/shizuku/{image_name}", timeout=10)
image.raise_for_status()
print(image.headers["content-type"])
print(len(image.content))

图片源​

  • 图片文件放在服务目录的 public/source/shizuku
  • 元数据文件放在 data/shizuku-meta.json
  • 本次从旧 playground 迁入的 12 张图片已统一转为 .jpg

展示页​

  • /shizuku 是正式公开展示页。
  • /api/shizuku/view 与 /shizuku 渲染同一页面。
  • 展示页读取完整 Shizuku catalog，不区分旧图、新图、JPG 或 PNG。

更新日志​

2026-05-22 新增宣纸风轮播展示页​

  • 新增 /shizuku 公开展示页。
  • 新增 /api/shizuku/view 同页入口。
  • 展示页使用完整 Shizuku catalog 轮播所有图片。

2026-05-22 迁入 12 张精选图片并补描述元数据​

  • 从旧 playground/shizuku 挑选图片迁入正式 /api/shizuku。
  • 新增 GET /api/shizuku/meta 和 GET /api/shizuku/meta/<imageName>。
  • 为 12 张迁移图片补充短描述、来源行号和来源 URL。

2026-05-20 文档页改为 Markdown 渲染​

  • 新增 docs/shizuku.md 原文文档。
  • /api/shizuku 改为统一 HTML 容器渲染 Markdown。
  • 文档页新增复制 Markdown 按钮。

2026-05-19 文档和调用方式完善​

  • 新增 /api 总入口中的 Shizuku API 卡片。
  • 文档页加入 curl 与 python 示例切换动画。
  • 新增独立日志档 data/api-logs/shizuku.json。

2026-05-19 初始发布​

  • 上线 /api/shizuku/image，返回不带扩展名的图片单词列表。
  • 支持 /source/shizuku/<imageName> 按单词直接获取图片。
  • 图片源文件放在 public/source/shizuku。