使用建议

• 图床 Key 只用于图床接口，不要当作普通模型 API Key 使用。
• 服务端调用时优先使用 X-Media-Upload-Key 请求头。
• 上传成功后立即保存 asset_id 和 public_url，不要自己拼接素材地址。
• 不要把图床 Key 放在浏览器公开代码中；如果必须从浏览器上传，应由自己的服务端代为调用。
• 素材地址会过期，业务方需要根据 expires_at 提前处理长期保存需求。
• 上传失败不代表之前的素材被删除，可以先用列表接口确认状态。

---

一个完整的服务端流程

1. 在服务端接收用户或程序上传的文件。
2. 服务端使用 X-Media-Upload-Key 调用 POST /v1/media-assets。
3. 检查响应中的 success 和 data.status 是否为 ready。
4. 将 data.asset_id、data.public_url 和 data.expires_at 保存到自己的业务记录中。
5. 将 data.public_url 返回给网页或其他业务系统。
6. 根据 expires_at 提前提醒、重新上传或清理业务记录。

---

安全检查清单

• 图床 Key 存放在服务端环境变量或密钥管理系统中；
• 日志中不打印完整的图床 Key；
• 对用户上传的文件大小和类型做自己的前置校验；
• 不把永不过期当作默认假设，始终处理 expires_at；
• 删除素材前确认公网地址没有被其他页面或服务继续引用。

如果需要确认当前 Key 开放的类型、大小、保存周期或访问额度，请联系 MaomaoToken 客服。