GlymonirHTTP API 文档

面向 cron 任务、Workers 和第三方集成的长期 API 密钥与作用域受限端点。

代理用户身份

每把 key 绑定一个用户。有效权限 = 该用户的账号角色 ∩ key 授予的作用域 —— 与 GitHub PAT、Stripe Restricted Keys 同款模型。

按需最小授予 —— read(浏览 / 搜索 / 下载)、write(上传 + 管理自己的库)、delete。发出后作用域不可变;要改就建新 key、撤旧 key。

明文 token 仅在创建时返回一次,不写日志、不入库。丢失即吊销,重新创建。

每把 key 按持有人套餐限速(图片字节走 CDN,不计费)。官方 glymonir-cli 封装整个上传流程 —— npx glymonir-cli upload *.jpg。

在网站后台(设置 → API 密钥)创建 key,按需勾选作用域(read / write)。明文 gly_live_… 只显示这一次。

把它作为 Bearer token 调任意端点:

bash

# 搜索公开图库(需要 `read`)
curl "https://api.glymonir.com/api/gallery/search?q=cat&size=5" \
  -H "Authorization: Bearer gly_live_..."

上传用官方 CLI —— 它替你跑完本地预处理 + 两段式 R2 上传:

bash

export GLYMONIR_API_KEY=gly_live_...
npx glymonir-cli upload ./*.jpg --library "Travel 2026"

每个端点、作用域、错误码见 API 参考。