跳转到正文MaoMaoToken
控制台

上传图片或文件

接口

POST /v1/media-assets

请求必须使用 multipart/form-data,上传文件字段名必须是 file。

可选字段:

字段类型说明
file文件必填,要上传的图片、视频或音频文件
expires_in正整数可选,素材保存时间,单位为秒;不填写时使用该图床 Key 的默认保存周期


curl 示例

curl -X POST "https://drop.maomaotoken.com/v1/media-assets" \\
  -H "X-Media-Upload-Key: mu_xxxxxxxxxxxx" \\
  -F "file=@/path/to/image.png" \\
  -F "expires_in=259200"

259200 表示保存 3 天。

实际可填写的最长时间以管理员为该图床 Key 配置的上限为准。

也可以使用 Authorization 请求头:

curl -X POST "https://drop.maomaotoken.com/v1/media-assets" \\
  -H "Authorization: Bearer mu_xxxxxxxxxxxx" \\
  -F "file=@/path/to/image.png"


成功响应

{
  "success": true,
  "data": {
    "asset_id": "asset_01jabcxyz",
    "original_name": "image.png",
    "media_type": "image",
    "content_type": "image/png",
    "size": 245678,
    "status": "ready",
    "public_url": "https://drop.maomaotoken.com/media-assets/asset_01jabcxyz",
    "created_at": 1788000000,
    "expires_at": 1788259200
  }
}

上传成功后,保存响应中的 data.public_url 这个地址就是可以给其他系统或网页使用的公网素材地址。

建议同时保存 asset_id 和 expires_at,前者用于查询或删除,后者用于处理过期提醒。


在网页中使用

<img src="https://drop.maomaotoken.com/media-assets/asset_01jabcxyz" alt="上传的图片">

视频可以直接作为播放器地址:

<video controls src="https://drop.maomaotoken.com/media-assets/asset_01jabcxyz"></video>

公网素材地址不需要携带图床 Key。

图床 Key 只应出现在你自己的服务端请求中。

本页内容

On this page