---
title: 视频主体突出方案 - API
summary: 视频主体突出方案的 API 接口列表，包括视频文件导入导出（chooseMedia 导入、clipVideo 预标准化、saveVideoToPhotosAlbum 导出）、音频交互（backgroundMusicList 获取背景音乐、backgroundMusicDownload 下载、createInnerAudioContext 播放控制）及 AI 视频流处理（objectDetectCreate/objectDetectDestroy 实例管理、objectDetectForVideo 主体突出与背景音乐编辑、objectDetectForVideoCancel 取消、onVideoObjectDetectProgress/offVideoObjectDetectProgress 进度监听）。
---

## 视频文件导入导出能力

### 导入本地视频资源

- **功能**：主要支持 C 端用户通过以下两种途径进行视频素材的导入：

- 1.直接唤醒手机相机录制视频素材。
- 2.导入手机相册内已有视频素材。

- **接口详情**：[chooseMedia](https://developer.tuya.com/cn/miniapp/develop/ray/api/media/image/chooseMedia#choosemedia)

### 视频预标准化处理

- **功能**：主要用于格式化源视频资源分辨率与角度，避免不同分辨率与角度造成后续AI处理流程中出现异常情况。

- **接口详情**：[clipVideo](/cn/miniapp/develop/ray/api/media/video/clipVideo)

### 视频 AI 生成后导出

- **功能**：主要用于支持 C 端用户完成视频素材编辑后将视频转存至手机相册。

- **接口详情**：[saveVideoToPhotosAlbum](https://developer.tuya.com/cn/miniapp/develop/ray/api/media/video/saveVideoToPhotosAlbum#savevideotophotosalbum)

## 音频交互相关能力

### 获取涂鸦默认背景音乐

- **功能**：目前模板提供部分默认背景音乐供开发者获取、使用，后续音乐内容将进行扩充。

- **接口详情**：[backgroundMusicList](/cn/miniapp/develop/ray/api/ai/aiKit/backgroundMusicList)

### 下载涂鸦默认背景音乐

- **功能**：下载涂鸦在线背景音乐至app本地沙盒。

- **接口详情**：[backgroundMusicDownload](/cn/miniapp/develop/ray/api/ai/aiKit/backgroundMusicDownload)

### 音乐资源控制实例

- **功能**：主要用于播放、暂停背景音乐，用于用户试听体验。

- **接口详情**：[createInnerAudioContext](https://developer.tuya.com/cn/miniapp/develop/ray/api/media/audio/createInnerAudioContext)

## AI 视频流处理功能

<h3 id="创建 AI 视频流处理实例">创建 AI 视频流处理实例 <span className="tag_h2">On-App AI</span></h3>

- **功能**：初始化AI 视频流处理实例

- **接口详情**：[objectDetectCreate](/cn/miniapp/develop/ray/api/ai/aiKit/objectDetectCreate)

<h3 id="销毁 AI 视频流处理实例">销毁 AI 视频流处理实例 <span className="tag_h2">On-App AI</span></h3>

- **功能**：销毁AI 视频流处理实例，避免内存泄漏

- **接口详情**：[objectDetectDestroy](/cn/miniapp/develop/ray/api/ai/aiKit/objectDetectDestroy)

<h3 id="宠物\人像主体突出、视频流背景音乐编辑">宠物\人像主体突出、视频流背景音乐编辑 <span className="tag_h2">On-App AI</span></h3>

- **功能**：
  - 1.根据入参，对视频流中相应主体进行突出处理。
  - 2.根据背景音乐素材以及混音比例，为视频新增自定义背景音乐。

- **接口详情**：[objectDetectForVideo](/cn/miniapp/develop/ray/api/ai/aiKit/objectDetectForVideo)

<h3 id="取消视频流编辑操作">取消视频流编辑操作 <span className="tag_h2">On-App AI</span></h3>

- **功能**：中断正在进行中的AI 视频流处理操作

- **接口详情**：[objectDetectForVideoCancel](/cn/miniapp/develop/ray/api/ai/aiKit/objectDetectForVideoCancel)

<h3 id="AI 处理进度监听函数">AI 处理进度监听函数 <span className="tag_h2">On-App AI</span></h3>

- **功能**：监听目前AI 视频流的生成进度

- **接口详情**：[onVideoObjectDetectProgress](/cn/miniapp/develop/ray/api/ai/aiKit/onVideoObjectDetectProgress)

<h3 id="取消 AI 处理进度监听函数">取消 AI 处理进度监听函数 <span className="tag_h2">On-App AI</span></h3>

- **功能**：取消AI 视频流生成进度监听函数

- **接口详情**：[offVideoObjectDetectProgress](/cn/miniapp/develop/ray/api/ai/aiKit/offVideoObjectDetectProgress)