API Reference

MioPic API Docs

使用 API Key 将图片上传接入脚本、自动化流程或第三方客户端。当前开放上传接口，采用 Bearer Token 鉴权与 FormData 请求体。

管理 API Key 前台上传

Endpointv1

POST https://pic.dearlicy.com/api/v1/upload

Authorization: Bearer mp_xxx

Content-Type: multipart/form-data

Upload

上传图片

POST /api/v1/upload

鉴权

Authorization: Bearer mp_xxx

权限

images:upload

请求体

multipart/form-data

FieldTypeRequiredDescription

fileFile必填图片文件，支持站点上传策略允许的 MIME 类型。

categoryIdString必填已启用的分类 ID。

albumIdString可选当前用户名下的相册 ID。

titleString可选图片标题。

descriptionString可选图片介绍；不传时按空值处理。

cURL 示例

curl -X POST https://pic.dearlicy.com/api/v1/upload \
  -H "Authorization: Bearer mp_xxx" \
  -F "file=@demo.jpg" \
  -F "categoryId=category_id" \
  -F "albumId=album_id" \
  -F "title=图片标题"

成功响应

{
  "ok": true,
  "data": {
    "id": "image_id",
    "url": "https://pic.dearlicy.com/upload/2026/05/demo.webp",
    "pageUrl": "https://pic.dearlicy.com/image/image_id",
    "formats": {
      "url": "...",
      "markdown": "![alt](...)"
    }
  }
}

响应字段

data.id图片资源 ID

data.url图片直链

data.pageUrl图片详情页地址

data.formats复制格式集合，例如 URL、Markdown

data.deduped命中去重时返回 true

错误处理

401缺少 Bearer Token、Token 无效或已过期。

403Token 缺少 images:upload 权限。

400缺少图片、缺少分类、分类不可用、相册无权使用或格式/大小不符合策略。

500下游存储或上传链路失败。