数据与高级能力

接入图片和视频上传

选择了文件、出现了预览图,并不代表上传成功。正确流程是上传文件、拿到在线地址,再把地址保存到对应内容里。

先区分两种上传

给 HTML 配图片:使用 图片转链接,拿到图片地址后替换代码里的本地路径;多文件项目也可以把静态图片放进站点资源目录,一起发布。

让网页中的人选文件上传:需要在作品中接入媒体上传能力,并配置该作品的高级能力余额。只画一个上传按钮或调用文件预览,不会自动把文件存到服务器。

接入访客媒体上传

  1. 打开原作品编辑页,在高级能力管理中找到“媒体上传”,检查是否开启。
  2. 在高级能力余额里补充额度,或了解规则后开启自动补充。账户有积分,不等于作品已经分配了额度。
  3. 打开能力接入指南,选择“媒体上传”;需要保存图片列表、标题等信息时,再选择适合的云端数据方式。
  4. 把生成的提示词和当前代码发给 AI,要求实现选文件、上传进度或等待提示、失败重试,以及成功后的内容保存。
  5. 更新原作品,用正式链接上传一个小文件,刷新页面并换设备检查。

上传成功后,还要保存地址

上传接口返回在线媒体地址。页面需要把这个地址连同标题、分类等内容一起保存,进入页面时重新读取并渲染。否则当前窗口虽然能看到预览,刷新后仍可能找不到。

blob: 地址是临时预览,Base64 是文件内容本身,都不适合直接当成长期共享的媒体地址。应该保存实际上传返回的 URL。

发布者维护的站点内容应按 内容管理指南 使用发布者上传入口。不要为了只有站长能上传的需求,直接向所有访客开放共享写入。

文件和费用要检查什么

当前访客媒体能力支持图片和 MP4 视频:图片最大 5MB,MP4 最大 10MB;具体支持格式、审核和额度限制以上传面板及实际提示为准。这与 ZIP 站点中可包含的静态资源格式是两套规则。

媒体上传与 AI、文字转语音共用该作品的高级能力余额,按实际用量计费,由作品发布者承担。自动补充也会消耗账户积分,使用前检查每日限制和开启范围。

上传后看不到,按这个顺序检查

  • 是否真的完成上传,而不是只生成本地预览?
  • 是否把返回地址写入了云端记录,并在打开页面时读取?
  • 能力是否暂停、余额是否不足,文件是否超限或审核未通过?
  • 换设备看不到时,是否仍把记录存在本地?参考 云端保存指南。