跳转到正文MaoMaoToken
控制台

MaoMaoDrop API 概览

概述和用途

MaoMaoDrop 是 MaomaoToken 提供的图片、视频和音频素材即抛型图床托管服务。

你可以通过 API 上传素材,获得公网地址,并在网页、Markdown、应用或自动化脚本中使用。

特别是在一些图片编辑或者支持参考素材的视频模型需要公网 URL 参考素材的场景使用。

申请方式

图床接口不能直接使用普通的模型 API Key。

请先联系 MaomaoToken 客服,申请开通一个用户专属的图床 Key。

客服开通后会提供以 mu_ 开头的图床 Key。

请妥善保管图床 Key,不要把它写入公开网页、浏览器前端代码或公开代码仓库。

开通资格

仅支持 MaomaoToken 老用户申请,并非所有申请都会得到通过,需要详细说明您的用途。

一旦申请通过我们不增加其他额外费用,免费提供MaoMaoDrop服务。

资格差异化

同一个图床 Key 只能使用我们为申请者开放的文件类型、大小、保存周期和访问额度。

我们会根据您的实际需求,匹配支持的文件类型、保存周期和空间配额。

硬件集群支持

MaoMaoDrop采用我们的位于美西、亚太的G口物理机提供服务,

无论是存储空间配额(最多给予 1T 空间配额)亦或者带宽支持都是裸金属物理机级别的存储支持。

并且无需您支付额外费用!


基本信息

Base URL

具体的Base URL 会在您申请通过后告知

请求头

图床 Key 支持以下两种传递方式,推荐使用专用请求头:

X-Media-Upload-Key: mu_xxxxxxxxxxxx
Authorization: Bearer mu_xxxxxxxxxxxx

接口速查

能力请求方式端点是否需要图床 Key
上传图片或文件POST/v1/media-assets是
查看本 Key 上传的素材GET/v1/media-assets是
查看本 Key 的单个素材GET/v1/media-assets/{asset_id}是
删除本 Key 的素材DELETE/v1/media-assets/{asset_id}是
访问公网素材地址GET/media-assets/{asset_id}否

推荐使用流程

  1. 联系 MaomaoToken 客服,申请并确认图床 Key 的权限、大小和保存周期。
  2. 在服务端使用图床 Key 调用上传接口。
  3. 保存响应中的 asset_id、public_url 和 expires_at。
  4. 将 public_url 提供给网页、应用或其他系统使用。
  5. 需要提前清理时,调用删除接口;长期保存则在过期前重新处理素材。

下一步可以阅读 上传图片或文件 或 访问公网素材。

本页内容

On this page