API 文档

获取 Token

1. 登录后进入控制台 → 开放接口；
2. 复制以 sk- 开头的 Token，接口请求里带上它就能用了。

页面上的「更换Token」会立刻作废旧 Token，换完记得同步更新脚本或客户端的配置。

鉴权方式

所有接口都在请求头里带 Token，格式固定为 Bearer <token>：

curl --location 'https://www.imgurl.org/api/v3/album_list' \
--header 'Authorization: Bearer sk-xxx'

基础地址

本站的接口地址是 https://www.imgurl.org，各接口文档里的 /api/v3/... 都拼在它后面。例如上传接口：

https://www.imgurl.org/api/v3/upload

交给 AI 写代码（llms.txt）

如果想让 AI 编程助手直接帮你接入，把这份文档的索引丢给它即可：

https://www.imgurl.org/docs/llms.txt

这是纯文本文件，列出全部接口的标题、链接和一句话说明，模型一次读完就知道该看哪一篇，比让它逐页翻文档省事。Claude Code、Codex、OpenCode 等支持自定义上下文的工具都能用。

文档本身是普通网页，模型也能直接抓取；llms.txt 只是省掉逐篇查找的步骤。

统一响应

所有接口返回 JSON，结构固定：

{
  "code": 200,
  "msg": "success",
  "data": {}
}

注意 HTTP 状态码是 200 时，code 也可能不为 200，请以 code 判断结果。

限流与配额

配额和限流都由账号的套餐决定，可以在个人中心查看当前额度。

错误码