访问公网素材

获取素材

GET /media-assets/{asset_id}

这个接口不需要携带图床 Key。上传接口返回的 public_url 已经是完整地址，通常直接使用即可。

curl -L "https://drop.maomaotoken.com/media-assets/asset_01jabcxyz" \\
  -o image.png

网页中可以直接引用：

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

也可以将视频作为播放器地址：

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

检查素材是否可访问

也支持：

HEAD /media-assets/{asset_id}

HEAD 只检查素材是否存在和是否可访问，不返回文件正文，适合做健康检查或过期检测。

访问规则

素材是否能访问会受到以下规则影响：

• 素材已经被删除时不能访问；
• 超过保存周期后不能访问；
• 超过管理员配置的访问频率或并发限制时，会暂时被限流；
• 只有状态为 ready 的素材才会正常返回。

因此，业务方应保存上传响应中的 status、public_url 和 expires_at，不要自己拼接或猜测素材地址。

图床 Key 的使用边界

公网读取接口不需要 Key，但上传、查询和删除接口仍然需要 Key。

不要为了让网页直接上传而把图床 Key 写进公开前端代码；如需浏览器上传，请由自己的服务端代为调用上传接口。