媒体与资产

网站使用的每一张图片、视频和文件都存放在媒体库中。内容通过资产 ID 引用文件，API 响应会将 ID 解析为 URL、尺寸、替代文本和占位符。

核心对象

• 资产 (Assets)： 包含文件的可见性、标签、替代文本、焦点和处理状态。公开文件通过 CDN 提供服务。受保护的文件（如课程视频）仅能通过短效签名 URL 访问。
• 图片变体 (Image variants)： 按需调整大小的版本，以及每张图片的微型模糊占位符。
• 视频流 (Video streaming)： 视频会被转换为自适应流，受保护的视频则使用签名片段。

API 如何运作

• 通过 Management API 使用 URL 或文件上传、请求大文件的直接上传 URL、创建客户端上传链接，以及导入库存照片。
• 每个引用媒体的 Content Delivery API 响应都包含 assets 映射表。
• 使用 <kanorio-media> 和 <kanorio-lightbox> 播放媒体并显示图片。
• Webhooks 会报告资产处理完成或失败的状态。