公告
AI 云端特效
云直播 AI 云端特效功能结合 AI 文生视频技术，允许用户通过输入文本描述（Prompt）实时生成个性化视频特效，并通过控制台或 API 管理已生成的特效列表，以及发送视频特效到指定直播流。该功能可提升直播用户互动体验，为主播和观众创造独特的情感表达方式。相比传统固定礼物特效，增加了互动趣味性。
注意事项
使用直播AI 云端特效功能将产生两项计费，生成特效视频的计费和发送视频特效的计费。具体费用根据实际使用产生，相关计费说明请参见 文档。
视频特效由大模型生成，具有一定随机性，视频效果会随技术演变及版本迭代逐步提升。
禁止使用包含违禁敏感词的 Prompt 提示词（如暴力、违法违规敏感词等）。
视频特效类型
特效视频类型 | 特效视频来源 |
用户特效视频库 | 系统预设特效视频，系统持续推出精品 AI 特效视频。 用户 AI 生成特效视频 ，支持通过文本描述（Prompt）生成高质量特效视频。（入口待放出）。 用户上传已有特效视频，支持用户上传已有特效视频集中管理，此处有合规审核。（入口待放出）。 通过调用 API 发送特效视频时入参为预设特效视频 ID。 |
官方特效视频库 | 由云直播官方 AI 生成，持续丰富特效视频库。不用等待生成，可直接使用官方库中 Prompt 匹配度高的已有特效视频。 通过调用 API 发送特效视频时入参为 Prompt 提示词。 |
用户特效视频库：
两种不同特效类型的使用方式为：
用户特效视频库，运营人员可提前生成特效视频，将查询及发送的云 API 集成到业务客户端，供观众选择特效进行发送。
官方特效视频库，集成发送特效视频的云 API 到业务客户端，供观众输入 Prompt 提示词触发官方库匹配特效视频进行发送。
发送效果：
 |  |
 |  |
 |  |
使用指引
控制台 - AI 云端特效
a. 可查看特效视频列表，列表中展示该特效视频生成使用的 Prompt ，以及特效视频类型等信息。
b. 在列表中，运营人员可单击发送特效，输入流名称以匹配在线流，触发视频特效的发送。
云 API - 特效视频相关 API
a. 可通过查询接口 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"}}
b. 通过发送接口 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"}}
文档反馈