特效模板创建任务

POST /tencent-vod/v1/template-effect

MethodPOST
Path/tencent-vod/v1/template-effect
Typehttp
Status1
Module2102810
Folder75127538

说明

概览

MethodPOST
Path/tencent-vod/v1/template-effect
Typehttp
Status1
Module2102810
Folder75127538

请求体

{
  "type": "application/json",
  "parameters": [],
  "jsonSchema": {
    "type": "object",
    "properties": {
      "prompt": {
        "type": "string",
        "description": "提示词"
      },
      "file_infos": {
        "type": "object",
        "properties": {
          "type": {
            "type": "string",
            "description": "输入的视频文件类型。取值有:\nFile:点播媒体文件;\nUrl:可访问的 URL;\n\n示例值:File"
          },
          "category": {
            "type": "string",
            "description": "文件分类。取值为:\nImage: 图片;\nVideo: 视频。\n示例值:Image"
          },
          "file_id": {
            "type": "string",
            "description": "图片文件的媒体文件 ID,即该文件在云点播上的全局唯一标识符,在上传成功后由云点播后台分配。可以在 视频上传完成事件通知 或 云点播控制台 获取该字段。当 Type 取值为 File 时,本参数有效。\n说明:\n\n1.\n推荐使用小于7M的图片;\n\n2.\n图片格式的取值为:jpeg,jpg, png, webp。\n示例值:3704211***509819"
          },
          "url": {
            "type": "string",
            "description": "可访问的文件 URL。当 Type 取值为 Url 时,本参数有效。\n说明:\n\n1.\n推荐使用小于7M的图片;\n\n2.\n图片格式的取值为:jpeg,jpg, png, webp。\n示例值:https://test.com/1.png"
          }
        },
        "x-apifox-orders": [
          "type",
          "category",
          "file_id",
          "url"
        ],
        "description": "最多包含三张素材资源图片的列表,用于描述模型在生成视频时要使用的资源图片。\n注意:\n\n1.\n图片大小不超过10M。\n\n2.\n支持的图片格式:jpeg、png。"
      },
      "scene_type": {
        "type": "string",
        "description": "取值 template_effect"
      },
      "ext_info": {
        "type": "object",
        "properties": {
          "AdditionalParameters": {
            "type": "object",
            "properties": {
              "template": {
                "type": "string",
                "description": "场景模版参数\n不同的场景模板,对应的调用参数不同,我们提供两种查看方式:\n●官方示例中心:https://platform.vidu.cn/docs/templates \n●在线文档文档(支持按上线时间查询):https://shengshu.feishu.cn/wiki/L2Dbwi7QeilCAgkdJKjcrj2Lnrg?from=from_copylink \n\n注意:特效模板暂时只支持视频类型生成的模板"
              }
            },
            "x-apifox-orders": [
              "template"
            ],
            "required": [
              "template"
            ]
          }
        },
        "x-apifox-orders": [
          "AdditionalParameters"
        ],
        "required": [
          "AdditionalParameters"
        ]
      }
    },
    "x-apifox-orders": [
      "scene_type",
      "prompt",
      "file_infos",
      "ext_info"
    ],
    "required": [
      "scene_type",
      "ext_info"
    ]
  },
  "required": true,
  "mediaType": "",
  "examples": [
    {
      "name": "示例 1",
      "value": "{\r\n    \"scene_type\": \"template_effect\",\r\n    \"prompt\": \"视频内容\\\\n画面开始主体突然爆炸,细碎的颗粒爆炸开来\\\\n# 要求\\\\n1.根据用户上传图片确定主体数量,每个主体都要爆炸\\\\n2.Motion Level 设定为:Middle\\\\n3.以>我的视频内容为第一要素,背景的描述统一、合理,不要描述两次.\",\r\n    \"file_infos\": [\r\n        {\r\n            \"type\": \"Url\",\r\n            \"category\": \"Image\",\r\n            \"url\": \"https://image01.vidu.zone/vidu/example/20241206-175531.jpeg\"\r\n        }\r\n    ],\r\n    \"ext_info\": {\r\n        \"AdditionalParameters\": {\r\n            \"template\": \"morphlab\"\r\n        }\r\n    }\r\n}",
      "mediaType": "application/json"
    }
  ],
  "oasExtensions": ""
}

响应

[
  {
    "id": 157014108,
    "name": "成功",
    "code": 200,
    "contentType": "json",
    "jsonSchema": {
      "type": "object",
      "properties": {}
    },
    "itemSchema": {},
    "description": "",
    "mediaType": "",
    "headers": []
  }
]

响应示例

[
  {
    "name": "示例 1",
    "responseId": 157014108,
    "data": "{\r\n    \"Response\": {\r\n        \"TaskId\": \"251007502-AigcImage***2782aff1e896673f1ft\",\r\n        \"RequestId\": \"f50d7667-72d8-46bb-a7e3-0613588971b6\"\r\n    }\r\n}",
    "id": "019cb188-90bc-73dd-b685-d137d1689ea9"
  }
]