---
title: IPC 精彩时刻通用方案 - 精彩时刻 AI 编辑
summary: IPC 精彩时刻通用方案的视频 AI 编辑模块，包含云端视频下载、视频主体突出 AI 编辑（objectDetectForVideo）、视频隐私保护 AI 编辑（privacyProtectDetectForVideo）、背景音乐自定义。提供完整交互时序图涵盖视频选择下载→AI 服务选择→并行处理（进度通知+中断监听）→预览保存流程。
---

<h2 id="精彩时刻视频 AI 编辑">精彩时刻视频 AI 编辑 <span className="tag_h2">On-App AI</span></h2>

### 功能介绍

<div style="marginTop: 20px;">
<img alt="精彩时刻智能相册" src="https://images.tuyacn.com/rms-static/b83b71f0-0f71-11f0-9fb9-e1834df84344-1743564154511.jpeg?tyName=video_ch.jpeg" width="250">
</div>

1. 精彩时刻视频 AI 编辑主要包含以下内容：

- 视频云端下载至本地；
- 视频主体突出 AI 编辑；
- 视频隐私保护 AI 编辑；
- 视频背景音乐自定义；

2. 精彩时刻视频 AI 编辑，主要依赖下述关键能力：

- **下载云端视频**  
   开发者可通过 [startDownloadMessageVideoForComposition](/cn/miniapp/develop/ray/api/ai/aiKit/startDownloadMessageVideoForComposition) API 将需要编辑的云端视频下载到本地。

- **获取精彩时刻服务配置信息**  
   开发者可通过 [objectDetectForVideo](/cn/miniapp/develop/ray/api/ai/aiKit/objectDetectForVideo) API 将待编辑视频进行主体突出 AI 编辑。

- **获取精彩时刻服务配置信息**  
   开发者可通过 [privacyProtectDetectForVideo](/cn/miniapp/develop/ray/api/ai/aiKit/privacyProtectDetectForVideo) API 将待编辑视频进行隐私保护 AI 编辑。

### 交互流程

```mermaid
sequenceDiagram
    participant 用户
    participant 面板
    participant 云端
    participant AI服务

    rect rgb(227, 242, 253)
        用户 ->> 面板: 1. 批量选择视频文件
        面板 ->> 云端: 2. startDownloadMessageVideoForComposition-api
        云端 -->> 面板: 3. 返回合成视频地址
        面板 ->> 用户: 4. 跳转AI编辑页
    end

    rect rgb(255, 243, 224)
        用户 ->> 面板: 5. 选择AI服务+背景音乐
        alt 主体突出
            面板 ->> AI服务: 6. objectDetectForVideo-api
        else 隐私保护
            面板 ->> AI服务: 6. privacyProtectDetectForVideo-api
        end

        par 并行处理
            AI服务 ->> AI服务: 7. 视频处理
            AI服务 ->> 面板: 8. 进度通知(每秒)
            面板 ->> 用户: 9. 更新进度条
        and 中断监听
            用户 ->> 面板: 10. 点击取消按钮
            面板 ->> AI服务: 11. 立即终止请求
            AI服务 -->> AI服务: 12. 清理临时资源
            AI服务 -->> 面板: 13. 终止确认(无数据返回)
            面板 ->> 用户: 14. 显示"操作已取消"
        end

        alt 正常完成
            AI服务 -->> 面板: 15. 返回最终视频
            面板 ->> 用户: 16. 显示预览界面
        end
    end

    rect rgb(230, 245, 230)
        用户 ->> 面板: 17. 点击保存
        面板 ->> 云端: 18. 上传到相册
        云端 -->> 面板: 19. 保存成功确认
        面板 ->> 用户: 20. 显示保存结果
    end
```