Developer

开放 API 文档

上传图片（POST）、按 ID/文件名查询元数据（GET）。接口风格兼容 img.scdn.io。

鉴权

所有接口调用必须携带 API Key。请先登录后在「我的图库 → API 密钥」中申请。

传入方式三选一：

端点

https://pic.otakupro.icu/api/v1.php

POST 上传图片 — multipart/form-data，文件字段名 image；或用 image_url。

GET 查询 — ?q=图片ID或文件名

上传参数

参数说明
api_key必填。你的 API Key
image文件（与 image_url 二选一）
image_url远程图片 URL
storage_destinationlocal 本站存储 / remote 转发远程 API
outputFormatauto / webp / jpeg / png / gif
visibility可见性：public 公开 / unlisted 不公开 / private 私有。不填默认 public
category_id分类 ID。不填或填 0 为未分类；可在「我的图库」左侧查看分类 ID
cdn_domain仅 remote：指定上游 CDN 域名
remote_storage仅 remote：local / telegram / r2
password_enabledtrue 开启密码（建议仅 local）
image_password密码或答案
password_typeplain / qa
password_question问答模式下的问题

成功响应示例

{
  "success": true,
  "url": "https://pic.otakupro.icu/i/6640c49c7161b_1715519644.webp",
  "data": {
    "url": "https://pic.otakupro.icu/i/6640c49c7161b_1715519644.webp",
    "filename": "6640c49c7161b_1715519644.webp",
    "storage_backend": "local",
    "original_size": 102400,
    "compressed_size": 20480,
    "compression_ratio": 80
  }
}

cURL

# 本地上传（指定可见性和分类）
curl -X POST -F "api_key=pb_你的key" -F "image=@/path/to/a.jpg" \
  -F "storage_destination=local" -F "visibility=public" -F "category_id=0" \
  "https://pic.otakupro.icu/api/v1.php"

# 远程转发
curl -X POST -F "api_key=pb_你的key" -F "image=@/path/to/a.jpg" \
  -F "storage_destination=remote" -F "cdn_domain=img.scdn.io" "https://pic.otakupro.icu/api/v1.php"

# 查询
curl -sG --data-urlencode "api_key=pb_你的key" \
  --data-urlencode "q=6640c49c7161b_1715519644.webp" "https://pic.otakupro.icu/api/v1.php"