tenyun/types/vclm.d.ts

Promise based and chained Tencent Cloud OpenAPI client for NodeJS

/// <reference types="node" />

import { AxiosPromise, AxiosRequestConfig } from "axios";

/** 扩展字段。 */
declare interface ExtraParam {
  /** 预签名的上传url，支持把视频直接传到客户指定的地址。 */
  UserDesignatedUrl?: string;
  /** 回调地址需要您在创建任务时主动设置 CallbackUrl，请求方法为 POST，当视频生成结束时，我们将向此地址发送生成结果。数据格式如下：{ "JobId": "1397428070633955328", "Status": "DONE", "ErrorCode": "", "ErrorMessage": "", "ResultVideoUrl": "https://vcg.cos.tencentcos.cn/template_to_video/fa80b846-b933-4981-afad-8a39b46ef2ca.mp4"} */
  CallbackUrl?: string;
}

/** 人脸图片和待被融合的素材模板图的人脸位置信息。 */
declare interface FaceMergeInfo {
  /** 融合图片 */
  MergeFaceImage?: Image;
  /** 上传的图片人脸位置信息（人脸框）Width、Height >= 30。 */
  MergeFaceRect?: FaceRect;
  /** 素材人脸ID，不填默认取上传图片中最大人脸。 */
  TemplateFaceID?: string;
}

/** 人脸框信息。 */
declare interface FaceRect {
  /** 人脸框左上角横坐标。 */
  X?: number;
  /** 人脸框左上角纵坐标。 */
  Y?: number;
  /** 人脸框宽度。 */
  Width?: number;
  /** 人脸框高度。 */
  Height?: number;
}

/** 模板信息 */
declare interface FaceTemplateInfo {
  /** 角色ID。需要与MergeInfos中的TemplateFaceID依次对应。需要填数字，建议填"0"、"1"，依次累加。 */
  TemplateFaceID?: string;
  /** 视频模板中要替换的人脸图片 */
  TemplateFaceImage?: Image;
  /** 视频模板中要替换的人脸图片的人脸框。不填默认取要替换的人脸图片中最大人脸。 */
  TemplateFaceRect?: FaceRect;
}

/** 图片 */
declare interface Image {
  /** 图片Base64 */
  Base64?: string;
  /** 图片Url */
  Url?: string;
}

/** logo参数 */
declare interface LogoParam {
  /** 水印 Url */
  LogoUrl?: string;
  /** 水印 Base64，Url 和 Base64 二选一传入，如果都提供以 Url 为准 */
  LogoImage?: string;
  /** 水印图片位于生成结果图中的坐标及宽高，将按照坐标对标识图片进行位置和大小的拉伸匹配。 */
  LogoRect?: LogoRect;
}

/** 水印图输入框 */
declare interface LogoRect {
  /** 水印图框X坐标值。当值大于0时，坐标轴原点位于原图左侧，方向指右；当值小于0时，坐标轴原点位于原图右侧，方向指左。 */
  X?: number;
  /** 水印图框Y坐标值。当值大于0时，坐标轴原点位于原图上侧，方向指下；当值小于0时，坐标轴原点位于原图下侧，方向指上。 */
  Y?: number;
  /** 水印图框宽度。 */
  Width?: number;
  /** 水印图框高度。 */
  Height?: number;
}

declare interface CheckAnimateImageJobRequest {
  /** 动作模板ID。 */
  TemplateId: string;
  /** 图片格式：支持PNG、JPG、JPEG、BMP、WEBP格式；图片分辨率：长边分辨率范围【192，4096】；图片大小：不超过10M；图片宽高比：【宽：高】数值在 1:2 到 1:1.2 范围内 */
  ImageUrl?: string;
  /** 图片base64数据。图片格式：支持PNG、JPG、JPEG、BMP、WEBP格式；图片分辨率：长边分辨率范围【192，4096】；图片大小：不超过10M；图片宽高比：【宽：高】数值在 1:2 到 1:1.2 范围内 */
  ImageBase64?: string;
  /** 是否对输入图采用加强检测方案。默认不加强检测（false），仅对输入图做必要的基础检测。开启加强检测（true）有助于提升效果稳定性，将根据选择的动作模板提取建议的人体关键点，并判断输入图中是否包含这些人体关键点。加强检测仅对人像输入图生效，对非人输入图不生效。 */
  EnableBodyJoins?: boolean;
  /** 是否开启人脸检测。默认开启人脸检测（true），拦截主体为人像但无人脸、人脸不完整或被遮挡的输入图。可选关闭人脸检测（false）。 */
  EnableFace?: boolean;
}

declare interface CheckAnimateImageJobResponse {
  /** 输入图是否通过校验。 */
  CheckPass?: boolean;
  /** 唯一请求 ID，每次请求都会返回。 */
  RequestId?: string;
}

declare interface DescribeHumanActorJobRequest {
  /** 任务ID。 */
  JobId: string;
}

declare interface DescribeHumanActorJobResponse {
  /** 任务状态。 WAIT：等待中，RUN：执行中，FAIL：任务失败，DONE：任务成功 */
  Status?: string;
  /** 结果视频URL。有效期 24 小时。 */
  ResultVideoUrl?: string;
  /** 任务执行错误码。当任务状态不为 FAIL 时，该值为""。 */
  ErrorCode?: string;
  /** 任务执行错误信息。当任务状态不为 FAIL 时，该值为""。 */
  ErrorMessage?: string;
  /** 唯一请求 ID，每次请求都会返回。 */
  RequestId?: string;
}

declare interface DescribeHunyuanToVideoJobRequest {
  /** 任务ID */
  JobId: string;
}

declare interface DescribeHunyuanToVideoJobResponse {
  /** 任务状态。WAIT：等待中，RUN：执行中，FAIL：任务失败，DONE：任务成功 */
  Status?: string;
  /** 任务执行错误码。当任务状态不为 FAIL 时，该值为""。 */
  ErrorCode?: string;
  /** 任务执行错误信息。当任务状态不为 FAIL 时，该值为""。 */
  ErrorMessage?: string;
  /** 结果视频 URL。有效期 24 小时。 */
  ResultVideoUrl?: string;
  /** 唯一请求 ID，每次请求都会返回。 */
  RequestId?: string;
}

declare interface DescribeImageAnimateJobRequest {
  /** 任务ID。 */
  JobId?: string;
}

declare interface DescribeImageAnimateJobResponse {
  /** 任务状态。WAIT：等待中，RUN：执行中，FAIL：任务失败，DONE：任务成功 */
  Status?: string;
  /** 错误码。 */
  ErrorCode?: string;
  /** 错误信息。 */
  ErrorMessage?: string;
  /** 结果视频URL。有效期 24 小时。 */
  ResultVideoUrl?: string;
  /** 掩码视频链接 */
  MaskVideoUrl?: string;
  /** 唯一请求 ID，每次请求都会返回。 */
  RequestId?: string;
}

declare interface DescribeImageToVideoGeneralJobRequest {
  /** 任务ID */
  JobId: string;
}

declare interface DescribeImageToVideoGeneralJobResponse {
  /** 任务状态。WAIT：等待中，RUN：执行中，FAIL：任务失败，DONE：任务成功 */
  Status?: string;
  /** 任务执行错误码。当任务状态不为 FAIL 时，该值为""。 */
  ErrorCode?: string;
  /** 任务执行错误信息。当任务状态不为 FAIL 时，该值为""。 */
  ErrorMessage?: string;
  /** 结果视频 URL。有效期 24 小时。 */
  ResultVideoUrl?: string;
  /** 唯一请求 ID，每次请求都会返回。 */
  RequestId?: string;
}

declare interface DescribePortraitSingJobRequest {
  /** 任务ID */
  JobId: string;
}

declare interface DescribePortraitSingJobResponse {
  /** 任务ID */
  JobId?: string;
  /** 任务状态码—RUN：处理中—FAIL：处理失败—STOP：处理终止—DONE：处理完成 */
  StatusCode?: string;
  /** 任务状态信息 */
  StatusMsg?: string;
  /** 任务执行错误码。当任务状态不为FAIL时，该值为""。 */
  ErrorCode?: string;
  /** 任务执行错误信息。当任务状态不为FAIL时，该值为""。 */
  ErrorMessage?: string;
  /** 生成视频的URL地址。有效期24小时。 */
  ResultVideoUrl?: string;
  /** 唯一请求 ID，每次请求都会返回。 */
  RequestId?: string;
}

declare interface DescribeTemplateToVideoJobRequest {
  /** 任务ID。 */
  JobId: string;
}

declare interface DescribeTemplateToVideoJobResponse {
  /** 任务状态。WAIT：等待中，RUN：执行中，FAIL：任务失败，DONE：任务成功 */
  Status?: string;
  /** 任务执行错误码。当任务状态不为 FAIL 时，该值为""。 */
  ErrorCode?: string;
  /** 任务执行错误信息。当任务状态不为 FAIL 时，该值为""。 */
  ErrorMessage?: string;
  /** 结果视频 URL。有效期 24 小时。 */
  ResultVideoUrl?: string;
  /** 唯一请求 ID，每次请求都会返回。 */
  RequestId?: string;
}

declare interface DescribeVideoEditJobRequest {
  /** 任务ID。 */
  JobId: string;
}

declare interface DescribeVideoEditJobResponse {
  /** 任务状态。 WAIT：等待中，RUN：执行中，FAIL：任务失败，DONE：任务成功 */
  Status?: string;
  /** 结果视频URL。有效期 24 小时。 */
  ResultVideoUrl?: string;
  /** 任务执行错误码。当任务状态不为 FAIL 时，该值为""。 */
  ErrorCode?: string;
  /** 任务执行错误信息。当任务状态不为 FAIL 时，该值为""。 */
  ErrorMessage?: string;
  /** 唯一请求 ID，每次请求都会返回。 */
  RequestId?: string;
}

declare interface DescribeVideoFaceFusionJobRequest {
  /** 任务ID */
  JobId?: string;
}

declare interface DescribeVideoFaceFusionJobResponse {
  /** 任务状态。WAIT：等待中，RUN：执行中，FAIL：任务失败，DONE：任务成功 */
  Status?: string;
  /** 任务执行错误码。当任务状态不为 FAIL 时，该值为""。 */
  ErrorCode?: string;
  /** 任务执行错误信息。当任务状态不为 FAIL 时，该值为""。 */
  ErrorMessage?: string;
  /** 结果视频 URL。有效期 24 小时。 */
  ResultVideoUrl?: string;
  /** 唯一请求 ID，每次请求都会返回。 */
  RequestId?: string;
}

declare interface DescribeVideoStylizationJobRequest {
  /** 任务ID */
  JobId: string;
}

declare interface DescribeVideoStylizationJobResponse {
  /** 任务ID。 */
  JobId?: string;
  /** 任务状态码。取值说明：JobInit: "初始化中"；JobModerationFailed: "审核失败"；JobRunning: "处理中"；JobFailed: "处理失败"；JobSuccess: "处理完成"。 */
  StatusCode?: string;
  /** 任务状态描述。取值说明：JobInit: "初始化中"；JobModerationFailed: "审核失败"；JobRunning: "处理中"；JobFailed: "处理失败"；JobSuccess: "处理完成"。 */
  StatusMsg?: string;
  /** 处理结果视频Url。URL有效期为24小时。 */
  ResultVideoUrl?: string;
  /** 唯一请求 ID，每次请求都会返回。 */
  RequestId?: string;
}

declare interface DescribeVideoVoiceJobRequest {
  /** 任务ID。 */
  JobId?: string;
}

declare interface DescribeVideoVoiceJobResponse {
  /** 任务状态。 WAIT：等待中，RUN：执行中，FAIL：任务失败，DONE：任务成功 */
  Status?: string;
  /** 结果视频URL。有效期 24 小时。 */
  ResultVideoUrl?: string;
  /** 任务执行错误码。当任务状态不为 FAIL 时，该值为""。 */
  ErrorCode?: string;
  /** 任务执行错误信息。当任务状态不为 FAIL 时，该值为""。 */
  ErrorMessage?: string;
  /** 唯一请求 ID，每次请求都会返回。 */
  RequestId?: string;
}

declare interface SubmitHumanActorJobRequest {
  /** 文本提示词，不能超过5000字符。提示词支持全局和局部控制：- 全局控制：正常输入提示词即可- 局部控制：可用双井号进行特定时间的提示词约束，例如： "画面中的人物正在对着镜头讲话，偶尔做些手势匹配说话的内容。镜头保持固定。#3"（意思是第三秒的时候让人物做出左方引导手势） -- 局部控制时间建议整数，最大可读小数点后两位。 */
  Prompt: string;
  /** 传入音频URL地址，音频要求：- 音频时长：2秒 - 60秒- 音频格式：mp3、wav- 音频大小：10M以内 */
  AudioUrl: string;
  /** 传入图片URL地址，图片要求：- 图片格式：jpg、jpeg、png、bmp、webp- 图片分辨率：192～4096- 图片大小：不超过10M- 图片宽高比：图片【宽：高】在1:4到4:1范围内- 图片内容：避免上传无人脸、无宠物脸或脸部过小、不完整、不清晰、偏转角度过大、嘴部被遮挡的图片。 */
  ImageUrl?: string;
  /** 传入图片Base64编码，编码后请求体大小不超过10M。图片Base64编码与URL地址必传其一，如果都传以ImageUrl为准。 */
  ImageBase64?: string;
  /** 生成视频分辨率枚举值：720p，1080p默认1080p */
  Resolution?: string;
  /** 生成视频帧数，单位fps。枚举值：25，50默认50帧 */
  FrameRate?: number;
  /** 为生成视频添加标识的开关，默认为1。 1：添加标识。 0：不添加标识。 其他数值：默认按1处理。 建议您使用显著标识来提示，该视频是 AI 生成的视频。 */
  LogoAdd?: number;
  /** 标识内容设置。 默认在生成视频的右下角添加“视频由 AI 生成”字样，您可根据自身需要替换为其他的标识图片。 */
  LogoParam?: LogoParam;
}

declare interface SubmitHumanActorJobResponse {
  /** 任务ID。 */
  JobId?: string;
  /** 唯一请求 ID，每次请求都会返回。 */
  RequestId?: string;
}

declare interface SubmitHunyuanToVideoJobRequest {
  /** 视频内容的描述，中文正向提示词。最多支持200个 utf-8 字符（首尾空格不计入字符数）。 示例值：一只猫在草原上奔跑，写实风格 */
  Prompt: string;
  /** 输入图片上传图url大小不超过 10M，base64不超过8M。支持jpg，png，jpeg，webp，bmp，tiff 格式单边分辨率不超过5000，不小于50，长宽限制1:4 ~ 4:1 */
  Image?: Image;
  /** 目前仅支持720p视频分辨率，默认720p。 */
  Resolution?: string;
  /** 为生成视频添加标识的开关，默认为1，0 需前往 控制台 申请开启显示标识自主完成方可生效。 1：添加标识； 0：不添加标识； 其他数值：默认按1处理。 */
  LogoAdd?: number;
  /** 默认在生成视频的右下角添加“ AI 生成”字样，如需替换为其他的标识图片，需前往 控制台 申请开启显示标识自主完成。 */
  LogoParam?: LogoParam;
}

declare interface SubmitHunyuanToVideoJobResponse {
  /** 任务ID */
  JobId?: string;
  /** 唯一请求 ID，每次请求都会返回。 */
  RequestId?: string;
}

declare interface SubmitImageAnimateJobRequest {
  /** 图片格式：支持PNG、JPG、JPEG、BMP、WEBP格式；图片分辨率：长边分辨率范围【192，4096】；图片大小：不超过10M；图片宽高比：【宽：高】数值在 1:2 到 1:1.2 范围内 */
  ImageUrl?: string;
  /** 图片base64数据。图片格式：支持PNG、JPG、JPEG、BMP、WEBP格式；图片分辨率：长边分辨率范围【192，4096】；图片大小：不超过10M；图片宽高比：【宽：高】数值在 1:2 到 1:1.2 范围内 */
  ImageBase64?: string;
  /** 动作模板ID。取值说明：ke3 科目三；tuziwu 兔子舞；huajiangwu 划桨舞。 */
  TemplateId?: string;
  /** 结果视频是否保留模板音频。默认为true */
  EnableAudio?: boolean;
  /** 是否对输入图采用加强检测方案。默认不加强检测（false），仅对输入图做必要的基础检测。开启加强检测（true）有助于提升效果稳定性，将根据选择的动作模板提取建议的人体关键点，并判断输入图中是否包含这些人体关键点。加强检测仅对人像输入图生效，对非人输入图不生效。 */
  EnableBodyJoins?: boolean;
  /** 是否对结果视频背景进行分割，默认值为false。true：分割结果视频，结果视频（ResultVideoUrl）将为去除背景的绿幕视频，并返回掩码视频（MaskVideoUrl）；false：不分割结果视频，结果视频（ResultVideoUrl）为带背景的视频，掩码视频（MaskVideoUrl）为空字符串。 */
  EnableSegment?: boolean;
  /** 为生成视频添加标识的开关，默认为0。1：添加标识。0：不添加标识。其他数值：默认按1处理。建议您使用显著标识来提示，该视频是 AI 生成的视频。 */
  LogoAdd?: number;
  /** 标识内容设置。默认在生成视频的右下角添加“视频由 AI 生成”字样，您可根据自身需要替换为其他的标识图片。 */
  LogoParam?: LogoParam;
  /** 是否开启人脸检测。默认开启人脸检测（true），拦截主体为人像但无人脸、人脸不完整或被遮挡的输入图。可选关闭人脸检测（false）。 */
  EnableFace?: boolean;
}

declare interface SubmitImageAnimateJobResponse {
  /** 图片跳舞任务ID。 */
  JobId?: string;
  /** 唯一请求 ID，每次请求都会返回。 */
  RequestId?: string;
}

declare interface SubmitImageToVideoGeneralJobRequest {
  /** 输入图片Base64 和 Url 必须提供一个，如果都提供以ImageUrl为准。上传图url大小不超过 8M支持jpg，png，jpeg，webp，bmp，tiff 格式单边分辨率不超过5000，不小于50，长宽限制1:4 ~ 4:1 */
  Image: Image;
  /** 视频内容的描述，中文正向提示词。最多支持200个 utf-8 字符（首尾空格不计入字符数）。 */
  Prompt?: string;
  /** 输出视频分辨率。可选择：480p、720p、1080p。 */
  Resolution?: string;
  /** 为生成视频添加标识的开关，默认为1，0 需前往 控制台 申请开启显示标识自主完成方可生效。 1：添加标识； 0：不添加标识； 其他数值：默认按1处理。 */
  LogoAdd?: number;
  /** 默认在生成视频的右下角添加“ AI 生成”字样，如需替换为其他的标识图片，需前往 控制台 申请开启显示标识自主完成。 */
  LogoParam?: LogoParam;
}

declare interface SubmitImageToVideoGeneralJobResponse {
  /** 任务ID */
  JobId?: string;
  /** 唯一请求 ID，每次请求都会返回。 */
  RequestId?: string;
}

declare interface SubmitPortraitSingJobRequest {
  /** 传入音频URL地址，音频要求：- 音频时长：2秒 - 60秒- 音频格式：mp3、wav、m4a */
  AudioUrl: string;
  /** 传入图片URL地址，图片要求：- 图片格式：jpg、jpeg、png、bmp、webp- 图片分辨率：192～4096- 图片大小：不超过10M- 图片宽高比：图片【宽：高】在1:2到2:1范围内- 图片内容：避免上传无人脸、无宠物脸或脸部过小、不完整、不清晰、偏转角度过大、嘴部被遮挡的图片。 */
  ImageUrl?: string;
  /** 传入图片Base64编码，编码后请求体大小不超过10M。图片Base64编码与URL地址必传其一，如果都传以ImageBase64为准。 */
  ImageBase64?: string;
  /** 唱演模式，默认使用人像模式。Person：人像模式，仅支持上传人像图片，人像生成效果更好，如果图中未检测到有效人脸将被拦截，生成时会将视频短边分辨率放缩至512。Pet：宠物模式，支持宠物等非人像图片，固定生成512:512分辨率视频。 */
  Mode?: string;
  /** 生成视频尺寸。可选取值："512:512"。人像模式下，如果不传该参数，默认生成视频的短边分辨率为512，长边分辨率不固定、由模型根据生成效果自动适配得到。如需固定生成分辨率可传入512:512。宠物模式下，如果不传该参数，默认将脸部唱演视频回贴原图，生成视频分辨率与原图一致。如不需要脸部回贴，仅保留脸部唱演视频，可传入512:512。 */
  Resolution?: string;
  /** 为生成视频添加标识的开关，默认为1。 1：添加标识； 0：不添加标识；其他数值：默认按1处理。 建议您使用显著标识来提示，该视频是 AI 生成的视频。 */
  LogoAdd?: number;
  /** 标识内容设置。 默认在生成视频的右下角添加“视频由 AI 生成”字样，您可根据自身需要替换为其他的标识图片。 */
  LogoParam?: LogoParam;
}

declare interface SubmitPortraitSingJobResponse {
  /** 任务ID。任务有效期为48小时。 */
  JobId?: string;
  /** 唯一请求 ID，每次请求都会返回。 */
  RequestId?: string;
}

declare interface SubmitTemplateToVideoJobRequest {
  /** 特效模板名称。请在 [视频特效模板列表](https://cloud.tencent.com/document/product/1616/119194) 中选择想要生成的特效对应的 template 名称。 */
  Template: string;
  /** 参考图像，不同特效输入图片的数量详见： [视频特效模板-图片要求说明](https://cloud.tencent.com/document/product/1616/119194)- 支持传入图片Base64编码或图片URL（确保可访问）- 图片格式：支持png、jpg、jpeg、webp、bmp、tiff- 图片文件：大小不能超过10MB（base64后），图片分辨率不小于300*300px，不大于4096*4096，图片宽高比应在1:4 ~ 4:1之间 */
  Images: Image[];
  /** 为生成视频添加标识的开关，默认为1。传0 需前往 [控制台](https://console.cloud.tencent.com/vtc/setting) 申请开启显式标识自主完成后方可生效。1：添加标识；0：不添加标识；其他数值：默认按1处理。建议您使用显著标识来提示，该视频是 AI 生成的视频。 */
  LogoAdd?: number;
  /** 标识内容设置。默认在生成视频的右下角添加“ AI 生成”或“视频由 AI 生成”字样，如需替换为其他的标识图片，需前往 [控制台](https://console.cloud.tencent.com/vtc/setting) 申请开启显式标识自主完成。 */
  LogoParam?: LogoParam;
  /** 视频输出分辨率，默认值：360p 。不同特效支持的清晰度及消耗积分数详见：[视频特效模板-单次调用消耗积分数列](https://cloud.tencent.com/document/product/1616/119194 ) */
  Resolution?: string;
  /** 是否为生成的视频添加背景音乐。默认：false， 传 true 时系统将从预设 BGM 库中自动挑选合适的音乐并添加；不传或为 false 则不添加 BGM。 */
  BGM?: boolean;
  /** 扩展字段。 */
  ExtraParam?: ExtraParam;
}

declare interface SubmitTemplateToVideoJobResponse {
  /** 任务ID。 */
  JobId?: string;
  /** 唯一请求 ID，每次请求都会返回。 */
  RequestId?: string;
}

declare interface SubmitVideoEditJobRequest {
  /** 参考视频URL。默认为待编辑视频。- 视频格式：支持MP4- 视频时长：输入视频时长≤5秒- 视频大小：不超过200M- 视频文件：输入的视频帧率及分辨率不做限制（建议输入16：9或9：16的视频；分辨率建议在2160px内，帧率建议在60fps内）；输出视频是帧率会≥16fps，分辨率为720p */
  VideoUrl: string;
  /** 视频内容的描述，中文正向提示词。支持视频内容增加、删除、修改等能力- 最多支持200个 utf-8 字符（首尾空格不计入字符数）- 不传prompt的时候，Images.N参考图列表必须要传图，且传的图片是经过图片编辑之后的结果图 */
  Prompt?: string;
  /** 参考图列表。用于对视频内容做风格迁移、内容替换、内容删减、内容增加做参考。- 支持传入图片Base64编码或图片URL- 图片格式：支持jpg，png，jpeg，webp，bmp，tiff 格式- 图片文件：大小不能超过10MB（base64后）。单边分辨率不超过5000px，不小于50px，图片长宽限制1:4 ~ 4:1。示例值：[{ "Url": "https://console.cloud.tencent.com/cos/image.png"}] */
  Images?: Image[];
  /** 图片base64或者图片url- Base64 和 Url 必须提供一个，如果都提供以Url为准。- 上传图url大小不超过 8M- 支持jpg，png，jpeg，webp，bmp，tiff 格式- 单边分辨率不超过5000，不小于50，长宽限制1:4 ~ 4:1 */
  Image?: Image;
  /** 为生成视频添加标识的开关，默认为1。传0 需前往 [控制台](https://console.cloud.tencent.com/vtc/setting) 申请开启显式标识自主完成后方可生效。1：添加标识；0：不添加标识；其他数值：默认按1处理。建议您使用显著标识来提示，该视频是 AI 生成的视频。 */
  LogoAdd?: number;
  /** 标识内容设置。默认在生成视频的右下角添加“ AI 生成”或“视频由 AI 生成”字样，如需替换为其他的标识图片，需前往 [控制台](https://console.cloud.tencent.com/vtc/setting) 申请开启显式标识自主完成。 */
  LogoParam?: LogoParam;
}

declare interface SubmitVideoEditJobResponse {
  /** 任务ID。 */
  JobId?: string;
  /** 唯一请求 ID，每次请求都会返回。 */
  RequestId?: string;
}

declare interface SubmitVideoFaceFusionJobRequest {
  /** 视频素材下载地址。用户自定义模版视频下载地址，使用前需要先调用视频审核接口进行内容审核。视频限制：分辨率≤4k，fps≤25，视频大小≤1G，时长≤20 秒，支持格式mp4。输入视频建议：姿态：人脸相对镜头水平方向角度转动不超过 90°,垂直方向角度转动不超过 20°。遮挡：脸部遮挡面积不超过 50%，不要完全遮挡五官，不要有半透明遮挡（强光，玻璃，透明眼镜等）、以及细碎离散的脸部遮挡（如飘落的花瓣）。妆容及光照：避免浓妆、复杂妆容，避免复杂光照、闪烁，这些属性无法完全恢复，并对稳定性有影响。针对特殊表情和微表情，针对局部肌肉控制下的微表情，以及过于夸张的特殊表情等不保证表情效果完全恢复。 */
  VideoUrl?: string;
  /** 视频素材模板的人脸位置信息。目前最多支持融合视频素材中的 6 张人脸 输入图片要求： 1、用户图限制大小不超过 10MB 2、图片最大分辨率不超过 4k，建议最小为 128， 人脸框最小为 683、支持格式 jpg，png 4、如果用户图中未指定人脸且有多张人脸， 默认融合最大人脸 输入图片建议： 包含上述视频中出现的人物的单人照，并且正面、清晰、无遮挡 */
  TemplateInfos?: FaceTemplateInfo[];
  /** 用户人脸图片位置信息。输入图片要求：1、用户图限制大小不超过 10MB2、图片最大分辨率不超过 4k，建议最小为 128，人脸框最小为 683、支持格式 jpg，png4、如果未指定人脸且用户图中有多张人脸，默认融合最大人脸输入图建议：正脸无遮挡 */
  MergeInfos?: FaceMergeInfo[];
  /** 为生成视频添加标识的开关，默认为1。 1：添加标识。 0：不添加标识。 其他数值：默认按1处理。 建议您使用显著标识来提示，该视频是 AI 生成的视频。 */
  LogoAdd?: number;
  /** 视频水印Logo参数标识内容设置。 默认在融合结果图右下角添加“AI生成”类似字样，您可根据自身需要替换为其他的Logo图片。 输入建议：输入水印图片宽高需小于视频宽高 */
  LogoParam?: LogoParam;
}

declare interface SubmitVideoFaceFusionJobResponse {
  /** 视频人脸融合任务的job id（job有效期24小时） */
  JobId?: string;
  /** 唯一请求 ID，每次请求都会返回。 */
  RequestId?: string;
}

declare interface SubmitVideoStylizationJobRequest {
  /** 风格ID。取值说明：2d_anime：2D动漫；3d_cartoon：3D卡通；3d_china：3D国潮；pixel_art：像素风。 */
  StyleId: string;
  /** 输入视频URL。视频要求：- 视频格式：mp4、mov；- 视频时长：1～60秒；- 视频分辨率：540P~2056P，即长宽像素数均在540px～2056px范围内；- 视频大小：不超过200M；- 视频FPS：15～60fps。 */
  VideoUrl: string;
  /** 风格化强度。取值说明：low：风格化强度弱；medium：风格化强度中等；high：风格化强度强。默认值为medium。 */
  StyleStrength?: string;
}

declare interface SubmitVideoStylizationJobResponse {
  /** 任务ID。任务有效期为48小时。 */
  JobId?: string;
  /** 唯一请求 ID，每次请求都会返回。 */
  RequestId?: string;
}

declare interface SubmitVideoVoiceJobRequest {
  /** 输入视频的Url 上传视频时长限制：1-15s 视频格式：MP4，MOV 视频大小：不超过1 GB URL地址中不能包含中文字符。 */
  VideoUrl?: string;
  /** 描述音效内容的正向提示词。输入上限50个字符。 */
  Prompt?: string;
  /** 音效内容的原始负向提示词。输入上限50个字符。 */
  NegativePrompt?: string;
  /** 为生成视频添加标识的开关，默认为1。 1：添加标识。 0：不添加标识。 其他数值：默认按1处理。 建议您使用显著标识来提示，该视频是 AI 生成的视频。 */
  LogoAdd?: number;
  /** 标识内容设置。 默认在生成视频的右下角添加“视频由 AI 生成”字样，您可根据自身需要替换为其他的标识图片。 */
  LogoParam?: LogoParam;
}

declare interface SubmitVideoVoiceJobResponse {
  /** 任务ID。 */
  JobId?: string;
  /** 唯一请求 ID，每次请求都会返回。 */
  RequestId?: string;
}

/** {@link Vclm 腾讯混元生视频} */
declare interface Vclm {
  (): Versions;
  /** 校验图片跳舞输入图 {@link CheckAnimateImageJobRequest} {@link CheckAnimateImageJobResponse} */
  CheckAnimateImageJob(data: CheckAnimateImageJobRequest, config?: AxiosRequestConfig): AxiosPromise<CheckAnimateImageJobResponse>;
  /** 查询人像驱动任务 {@link DescribeHumanActorJobRequest} {@link DescribeHumanActorJobResponse} */
  DescribeHumanActorJob(data: DescribeHumanActorJobRequest, config?: AxiosRequestConfig): AxiosPromise<DescribeHumanActorJobResponse>;
  /** 查询混元生视频任务 {@link DescribeHunyuanToVideoJobRequest} {@link DescribeHunyuanToVideoJobResponse} */
  DescribeHunyuanToVideoJob(data: DescribeHunyuanToVideoJobRequest, config?: AxiosRequestConfig): AxiosPromise<DescribeHunyuanToVideoJobResponse>;
  /** 查询图片跳舞任务 {@link DescribeImageAnimateJobRequest} {@link DescribeImageAnimateJobResponse} */
  DescribeImageAnimateJob(data?: DescribeImageAnimateJobRequest, config?: AxiosRequestConfig): AxiosPromise<DescribeImageAnimateJobResponse>;
  /** 查询图生视频通用能力任务 {@link DescribeImageToVideoGeneralJobRequest} {@link DescribeImageToVideoGeneralJobResponse} */
  DescribeImageToVideoGeneralJob(data: DescribeImageToVideoGeneralJobRequest, config?: AxiosRequestConfig): AxiosPromise<DescribeImageToVideoGeneralJobResponse>;
  /** 查询图片唱演任务 {@link DescribePortraitSingJobRequest} {@link DescribePortraitSingJobResponse} */
  DescribePortraitSingJob(data: DescribePortraitSingJobRequest, config?: AxiosRequestConfig): AxiosPromise<DescribePortraitSingJobResponse>;
  /** 查询视频特效任务 {@link DescribeTemplateToVideoJobRequest} {@link DescribeTemplateToVideoJobResponse} */
  DescribeTemplateToVideoJob(data: DescribeTemplateToVideoJobRequest, config?: AxiosRequestConfig): AxiosPromise<DescribeTemplateToVideoJobResponse>;
  /** 查询视频编辑任务 {@link DescribeVideoEditJobRequest} {@link DescribeVideoEditJobResponse} */
  DescribeVideoEditJob(data: DescribeVideoEditJobRequest, config?: AxiosRequestConfig): AxiosPromise<DescribeVideoEditJobResponse>;
  /** 查询视频人脸融合任务 {@link DescribeVideoFaceFusionJobRequest} {@link DescribeVideoFaceFusionJobResponse} */
  DescribeVideoFaceFusionJob(data?: DescribeVideoFaceFusionJobRequest, config?: AxiosRequestConfig): AxiosPromise<DescribeVideoFaceFusionJobResponse>;
  /** 查询视频风格化任务 {@link DescribeVideoStylizationJobRequest} {@link DescribeVideoStylizationJobResponse} */
  DescribeVideoStylizationJob(data: DescribeVideoStylizationJobRequest, config?: AxiosRequestConfig): AxiosPromise<DescribeVideoStylizationJobResponse>;
  /** 查询视频配音效任务 {@link DescribeVideoVoiceJobRequest} {@link DescribeVideoVoiceJobResponse} */
  DescribeVideoVoiceJob(data?: DescribeVideoVoiceJobRequest, config?: AxiosRequestConfig): AxiosPromise<DescribeVideoVoiceJobResponse>;
  /** 提交人像驱动任务 {@link SubmitHumanActorJobRequest} {@link SubmitHumanActorJobResponse} */
  SubmitHumanActorJob(data: SubmitHumanActorJobRequest, config?: AxiosRequestConfig): AxiosPromise<SubmitHumanActorJobResponse>;
  /** 提交混元生视频任务 {@link SubmitHunyuanToVideoJobRequest} {@link SubmitHunyuanToVideoJobResponse} */
  SubmitHunyuanToVideoJob(data: SubmitHunyuanToVideoJobRequest, config?: AxiosRequestConfig): AxiosPromise<SubmitHunyuanToVideoJobResponse>;
  /** 提交图片跳舞任务 {@link SubmitImageAnimateJobRequest} {@link SubmitImageAnimateJobResponse} */
  SubmitImageAnimateJob(data?: SubmitImageAnimateJobRequest, config?: AxiosRequestConfig): AxiosPromise<SubmitImageAnimateJobResponse>;
  /** 提交图生视频通用能力任务 {@link SubmitImageToVideoGeneralJobRequest} {@link SubmitImageToVideoGeneralJobResponse} */
  SubmitImageToVideoGeneralJob(data: SubmitImageToVideoGeneralJobRequest, config?: AxiosRequestConfig): AxiosPromise<SubmitImageToVideoGeneralJobResponse>;
  /** 提交图片唱演任务 {@link SubmitPortraitSingJobRequest} {@link SubmitPortraitSingJobResponse} */
  SubmitPortraitSingJob(data: SubmitPortraitSingJobRequest, config?: AxiosRequestConfig): AxiosPromise<SubmitPortraitSingJobResponse>;
  /** 提交视频特效任务 {@link SubmitTemplateToVideoJobRequest} {@link SubmitTemplateToVideoJobResponse} */
  SubmitTemplateToVideoJob(data: SubmitTemplateToVideoJobRequest, config?: AxiosRequestConfig): AxiosPromise<SubmitTemplateToVideoJobResponse>;
  /** 提交视频编辑任务 {@link SubmitVideoEditJobRequest} {@link SubmitVideoEditJobResponse} */
  SubmitVideoEditJob(data: SubmitVideoEditJobRequest, config?: AxiosRequestConfig): AxiosPromise<SubmitVideoEditJobResponse>;
  /** 提交视频人脸融合任务 {@link SubmitVideoFaceFusionJobRequest} {@link SubmitVideoFaceFusionJobResponse} */
  SubmitVideoFaceFusionJob(data?: SubmitVideoFaceFusionJobRequest, config?: AxiosRequestConfig): AxiosPromise<SubmitVideoFaceFusionJobResponse>;
  /** 提交视频风格化任务 {@link SubmitVideoStylizationJobRequest} {@link SubmitVideoStylizationJobResponse} */
  SubmitVideoStylizationJob(data: SubmitVideoStylizationJobRequest, config?: AxiosRequestConfig): AxiosPromise<SubmitVideoStylizationJobResponse>;
  /** 提交视频配音效任务 {@link SubmitVideoVoiceJobRequest} {@link SubmitVideoVoiceJobResponse} */
  SubmitVideoVoiceJob(data?: SubmitVideoVoiceJobRequest, config?: AxiosRequestConfig): AxiosPromise<SubmitVideoVoiceJobResponse>;
}

export declare type Versions = ["2024-05-23"];

export default Vclm;