Skip to main content
媒体是可复用的文件——视频背景、静态图片、Logo,以及片头/片尾片段——你可以在预设或项目设置中引用它们。上传一次,即可跨项目重复使用。

媒体类型

client.media.list(options?)

列出已认证账号拥有的所有可复用媒体项。

client.media.get(mediaId, options?)

获取单个媒体项。

client.media.create(body, options?)

从本地路径、字节数据或已上传的 inputFileId 创建新的媒体项。对于本地路径和字节数据,SDK 会准备上传、将文件字节发送到上传 URL,并把已上传文件注册为可复用媒体。
'video' | 'image' | 'logo' | 'intro-video' | 'outro-video'
required
该媒体项在渲染中承担的角色。
object
文件来源。本地文件使用 { type: "path", path }BlobFileArrayBuffer 或类型化数组数据使用 { type: "bytes", data, filename };当你已经有上传 ID 时,使用 { type: "inputFile", inputFileId }
string
高级底层选项:传入 client.uploads.create(...) 返回的 ID 来代替 source

client.media.delete(mediaId, options?)

删除一个媒体项。
删除媒体不会影响此前使用该媒体渲染过的项目或导出内容。未来引用已删除媒体的渲染将回退到默认背景。

端到端示例

应用背景

从预设中引用已上传媒体,或直接在项目设置中引用:
如需了解 background 下可接受的完整字段集合,请将项目设置 schema 转换为 JSON:

接下来