一、注意事项
·使用直播视频特效功能将产生两项计费，生成特效视频的计费和发送视频特效的计费，根据实际使用产生，相关计费说明请参见 文档。
·视频特效由大模型生成，具有一定随机性，视频效果会随技术演变及版本迭代逐步提升。
·禁止使用包含违禁敏感词的Prompt（如暴力、违法违规敏感词等）。
二、视频特效类型
| 特效视频类型 | 特效视频来源 |
| 用户特效视频库 | 系统预设特效视频，系统持续推出精品 AI 特效视频。用户AI生成特效视频 ，支持通过文本描述（Prompt）生成高质量特效视频。（入口待放出）。用户上传已有特效视频，支持用户上传已有特效视频集中管理，此处有合规审核。（入口待放出）。通过调用 API 发送特效视频时入参为预设特效视频 ID。 |
| 特效视频库 | 由云直播 AI 生成，持续丰富特效视频库。不用等待生成，可直接使用库中 Prompt 匹配度高的已有特效视频。通过调用 API 发送特效视频时入参为 Prompt 提示词。 |
用户特效视频库：
两种不同特效类型的使用方式为：
·用户特效视频库，运营人员可提前生成特效视频，将查询及发送的云 API 集成到业务客户端，供观众选择特效进行发送。
·特效视频库，集成发送特效视频的云 API 到业务客户端，供观众输入 Prompt 提示词触发库匹配特效视频进行发送。
发送效果：
| 关键词：鹦鹉 | 关键词：狗狗 |
| 关键词：小猫咪 | 关键词：丛林精灵 |
| 关键词：独角兽 | 关键词：蝴蝶 |
三、控制台 – AI 云端特效
·可查看特效视频列表，列表中展示该特效视频生成使用的 Prompt ，以及特效视频类型等信息。
·在列表中，运营人员可单击发送特效，输入流名称匹配在线流，触发视频特效的发送。
四、云 API – 特效视频相关 API
·可通过查询接口 DescribeLiveCloudEffectList 查询到全部特效视频列表。
发送请求 Body：
注意：GiftType 不传入时，则返回全部特效视频。可选择传入：PGC-系统预设，UCG-用户上传，AIGC-用户 AI 生成。
{ "Action": "DescribeLiveCloudEffectList", "GiftType": "PGC", "Region": "ap-guangzhou", "RequestId": "1047d0dc-6dc8-4898-a7f3-03726a822b0e", "RequestSource": "API", "Operator": "admin"}
接口返回：
{ "Response": { "GiftInfoList": [{ "CreateTime": "2025-05-19T00:00:00Z", "GiftId": "gift_1", "GiftTag": "animals", "GiftType": "PGC", "PreviewImageUrl": "https://vinson-1258442684.cos.ap-nanjing.myqcloud.com/texiao_image/parrot_v3.png", "Prompt": "鹦鹉", "UpdateTime": "2025-05-19T00:00:00Z" }, { "CreateTime": "2025-05-19T00:00:00Z", "GiftId": "gift_2", "GiftTag": "animals", "GiftType": "PGC", "PreviewImageUrl": "https://vinson-1258442684.cos.ap-nanjing.myqcloud.com/texiao_image/dog_v7.png", "Prompt": "小狗", "UpdateTime": "2025-05-19T00:00:00Z" }], "RequestId": "1047d0dc-6dc8-4898-a7f3-03726a822b0e" }}
·通过发送接口 SendLiveCloudEffect 发送指定视频特效到直播流，发送时支持指定特效缩放比例，以及特效位于直播画面的相对位置，还可指定特效循环次数。
发送请求 Body：
注意：接口会对传入的直播流进行活跃性检测，以及对传入的 GiftId 进行存在性检测，请传入正确参数。
{ "Action": "SendLiveCloudEffect", "GiftId": "gift_1", "PushDomainName": "5000.livepush.com", "AppName": "live", "StreamName": "mystream", "Region": "ap-guangzhou", "RequestId": "1047d0dc-6dc8-4898-a7f3-03726a822b0e", "RequestSource": "API", "LoopTimes": 3, "ZoomFactor": 2, "XPosition": 50, "YPosition": 50, "Operator": "admin"}
接口返回：
{ "Response": { "RequestId": "1047d0dc-6dc8-4898-a7f3-03726a822b0e" }}