管理与支持产品文档捉虫活动邀您参加！> HOT
文档中心>实践教程>云直播>直播增值功能>AI 云端特效

AI 云端特效

最近更新时间：2025-06-24 10:09:42

我的收藏

本页目录：

云直播 AI 云端特效功能结合AI文生视频技术，允许用户通过输入文本描述（Prompt）实时生成个性化视频特效，并通过控制台或API管理已生成特效列表，以及发送视频特效到指定直播流。该功能可提升直播用户互动体验，为主播和观众创造独特的情感表达方式。相比传统固定礼物特效，增加了互动趣味性。

注意事项

使用直播视频特效功能将产生两项计费，生成特效视频的计费和发送视频特效的计费，根据实际使用产生，相关计费说明请参见 文档。
视频特效由大模型生成，具有一定随机性，视频效果会随技术演变及版本迭代逐步提升。
禁止使用包含违禁敏感词的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",
	"Operator": "admin"
}
接口返回：
{
	"Response": {
		"RequestId": "1047d0dc-6dc8-4898-a7f3-03726a822b0e"
	}
}


中国站
目录