AI POSE GALLERY

API 文档

为 AI Agent 和自动化客户端提供的只读姿势数据库接口。

认证

所有数据 API 和图片使用 Bearer Token。网页登录使用独立账号密码。

Authorization: Bearer <API_TOKEN>

推荐流程

  1. GET /api/meta 发现系统、分类和角度。
  2. GET /api/poses 搜索并分页获取姿势。
  3. GET /api/pose/{id} 获取某姿势全部角度。
  4. 使用相同认证请求 thumb_url 或 original_url。

端点

GET/api/health公开健康检查
GET/api/meta系统、分类、角度、总量
GET/api/poses按姿势聚合搜索
GET/api/images逐张图片搜索
GET/api/pose/{id}姿势详情与全部角度
GET/thumb/{filename}300×400 JPEG 缩略图
GET/img/{filename}900×1200 PNG 原图

筛选参数

system、category、angle、q、page、limit。分页从 1 开始,limit 最大 200。

角度筛选值:正面、上から、下から、横、斜め。展示时使用响应中的 angle_zh。

示例

curl -H "Authorization: Bearer $POSE_API_TOKEN" \
  "https://pose.51proxy.org/api/poses?q=侧卧&limit=20"

完整规范

字段、类型、响应模型和错误格式请读取 OpenAPI 3.1 规范。Agent 应优先读取 llms.txt 与 Agent 使用指南。