特效模板创建任务
▼
Authorization
在 Header 添加参数 Authorization，其值为 Bearer 之后拼接 Token
示例：
Authorization: Bearer ********************
官方文档:https://cloud.tencent.com/document/product/266/126240
请求参数
Body 参数 application/json
scene_type
string
必需
取值 template_effect
prompt
string
可选
提示词
file_infos
object
可选
最多包含三张素材资源图片的列表，用于描述模型在生成视频时要使用的资源图片。 注意： 1. 图片大小不超过10M。 2. 支持的图片格式：jpeg、png。
type
string
可选
输入的视频文件类型。取值有： File：点播媒体文件； Url：可访问的 URL； 示例值：File
category
string
可选
文件分类。取值为： Image: 图片； Video: 视频。 示例值：Image
file_id
string
可选
图片文件的媒体文件 ID，即该文件在云点播上的全局唯一标识符，在上传成功后由云点播后台分配。可以在 视频上传完成事件通知 或 云点播控制台 获取该字段。当 Type 取值为 File 时，本参数有效。 说明： 1. 推荐使用小于7M的图片； 2. 图片格式的取值为：jpeg，jpg, png, webp。 示例值：3704211***509819
url
string
可选
可访问的文件 URL。当 Type 取值为 Url 时，本参数有效。 说明： 1. 推荐使用小于7M的图片； 2. 图片格式的取值为：jpeg，jpg, png, webp。 示例值：https://test.com/1.png
ext_info
object
必需
AdditionalParameters
object
必需
示例
{
"scene_type": "template_effect",
"prompt": "视频内容\\n画面开始主体突然爆炸，细碎的颗粒爆炸开来\\n# 要求\\n1.根据用户上传图片确定主体数量,每个主体都要爆炸\\n2.Motion Level 设定为:Middle\\n3.以>我的视频内容为第一要素，背景的描述统一、合理，不要描述两次.",
"file_infos": [
{
"type": "Url",
"category": "Image",
"url": "https://image01.vidu.zone/vidu/example/20241206-175531.jpeg"
}
],
"ext_info": {
"AdditionalParameters": {
"template": "morphlab"
}
}
}请求示例代码
curl --location --request POST 'https://api.quickrouter.ai/tencent-vod/v1/template-effect' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data-raw '{
"scene_type": "template_effect",
"prompt": "视频内容\\n画面开始主体突然爆炸，细碎的颗粒爆炸开来\\n# 要求\\n1.根据用户上传图片确定主体数量,每个主体都要爆炸\\n2.Motion Level 设定为:Middle\\n3.以>我的视频内容为第一要素，背景的描述统一、合理，不要描述两次.",
"file_infos": [
{
"type": "Url",
"category": "Image",
"url": "https://image01.vidu.zone/vidu/example/20241206-175531.jpeg"
}
],
"ext_info": {
"AdditionalParameters": {
"template": "morphlab"
}
}
}'var myHeaders = new Headers();
myHeaders.append("Accept", "application/json");
myHeaders.append("Authorization", "Bearer YOUR_API_KEY");
myHeaders.append("Content-Type", "application/json");
var raw = JSON.stringify({
"scene_type": "template_effect",
"prompt": "视频内容\\n画面开始主体突然爆炸，细碎的颗粒爆炸开来\\n# 要求\\n1.根据用户上传图片确定主体数量,每个主体都要爆炸\\n2.Motion Level 设定为:Middle\\n3.以>我的视频内容为第一要素，背景的描述统一、合理，不要描述两次.",
"file_infos": [
{
"type": "Url",
"category": "Image",
"url": "https://image01.vidu.zone/vidu/example/20241206-175531.jpeg"
}
],
"ext_info": {
"AdditionalParameters": {
"template": "morphlab"
}
}
});
var requestOptions = {
method: 'POST',
headers: myHeaders,
body: raw,
redirect: 'follow'
};
fetch("https://api.quickrouter.ai/tencent-vod/v1/template-effect", requestOptions)
.then(response => response.text())
.then(result => console.log(result))
.catch(error => console.log('error', error));import http.client
import json
conn = http.client.HTTPSConnection("api.quickrouter.ai")
payload = json.dumps({
"scene_type": "template_effect",
"prompt": "视频内容\\n画面开始主体突然爆炸，细碎的颗粒爆炸开来\\n# 要求\\n1.根据用户上传图片确定主体数量,每个主体都要爆炸\\n2.Motion Level 设定为:Middle\\n3.以>我的视频内容为第一要素，背景的描述统一、合理，不要描述两次.",
"file_infos": [
{
"type": "Url",
"category": "Image",
"url": "https://image01.vidu.zone/vidu/example/20241206-175531.jpeg"
}
],
"ext_info": {
"AdditionalParameters": {
"template": "morphlab"
}
}
})
headers = {
'Accept': 'application/json',
'Authorization': 'Bearer YOUR_API_KEY',
'Content-Type': 'application/json'
}
conn.request("POST", "/tencent-vod/v1/template-effect", payload, headers)
res = conn.getresponse()
data = res.read()
print(data.decode("utf-8"))返回响应
响应参数 🟢 200 OK · application/json
object
可选
示例
{
"Response": {
"TaskId": "251007502-AigcImage***2782aff1e896673f1ft",
"RequestId": "f50d7667-72d8-46bb-a7e3-0613588971b6"
}
}