创建任务

POST https://api.quickrouter.ai/tencent-vod/v1/aigc-video 在线调试 →

▼ Authorization

在 Header 添加参数 Authorization，其值为 Bearer 之后拼接 Token

示例： Authorization: Bearer ********************

官方文档:https://cloud.tencent.com/document/product/266/126240

请求参数

Header 参数

Authorization string

可选

示例: Bearer {{YOUR_API_KEY}}

Content-Type string

可选

示例: application/json

Body 参数 application/json

model_name string

必需

模型名称。取值： Hailuo：海螺； Kling：可灵； Vidu；示例值：GV

model_version string

必需

模型版本。取值：当 ModelName 是 Hailuo，可选值为 02、2.3、2.3-fast；当 ModelName 是 Kling，可选值为 1.6、2.0、2.1、2.5、O1、3.0、3.0-Omni；当 ModelName 是 Vidu，可选值为 q2、q2-pro、q2-turbo 、q3-pro、q3-turbo；示例值：2.3

prompt string

必需

提示词

negative_prompt string

可选

要阻止模型生成视频的提示词。示例值：red

enhance_prompt string

可选

是否自动优化提示词。开启时将自动优化传入的 Prompt，以提升生成质量。取值有： Enabled：开启； Disabled：关闭；示例值：Enabled

file_infos array [object]

可选

最多包含三张素材资源图片的列表，用于描述模型在生成视频时要使用的资源图片。支持多图输入的模型： 1. GV，使用多图输入时，不可使用LastFrameFileId和LastFrameUrl。 2. Vidu，支持多图参考生视频。q2模型1-7张图片，可通过FileInfos里面的ObjectId作为主体id来传入。注意： 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

text string

可选

输入图片的描述信息，用于帮助模型理解图片。仅GEM 2.5、GEM 3.0 有效。示例值：任务背景：这是需要翻新的主建筑（图1），不得改变其几何结构。

last_frame_url string

可选

用于作为尾帧画面来生成视频的媒体文件 URL。说明： 1. 只支持模型 GV 、Kling、Vidu，其他模型暂不支持。当 ModelName 为 GV 时，如果指定该参数，则需同时指定 FileInfos 作为待生成视频的首帧。当 ModelName 为 Kling 、ModelVersion 为 2.1 并且指定输出分辨率 Resolution 为 1080P 时，才能指定该参数。当 ModelName 为 Vidu、ModelVersion 为 q2-pro、q2-turbo 时，才能指定该参数。 2. 图片大小需小于5M。 3. 3. 图片格式的取值为：jpeg，jpg, png, webp。示例值：https://test.com/1.png

output_config object

可选

生视频任务的输出媒体文件配置。

storage_mode string

可选

存储模式。取值有： Permanent：永久存储，生成的图片文件将存储到云点播，可在事件通知中获取到 FileId； Temporary：临时存储，生成的图片文件不会存储到云点播，可在事件通知中获取到临时访问的 URL；默认值：Temporary

resolution string

可选

生成视频的分辨率。当 ModelName 是 Kling，可选值为 720P、1080P，默认为 720P；当 ModelName 是 Hailuo，可选值为 768P、1080P，默认为 768P；当 ModelName 是 Vidu，可选值为 720P、1080P，默认为 720P；示例值：720P

aspect_ratio string

可选

指定所生成视频的宽高比。当 ModelName 是 Kling，当文生视频时，则可选值为 16:9、9:16、 1:1，默认为16:9；当 ModelName 是 Vidu，当文生视频时和使用参考图片生成时，则可选值为 16:9、9:16、4:3、3:4、1:1，其中仅版本q2支持4:3、3:4 当 ModelName 是 Hailuo，则暂不支持。示例值：16:9

audio_generation string

可选

是否生成音频。支持的模型包括 GV、OS。取值有： Enabled：开启； Disabled：关闭；默认值：Disabled 示例值：Enabled

duration string

可选

生成视频的时长，单位：秒。当 ModelName 是 Kling，可选值为 5、10，默认为 5；当 ModelName 是 Kling 并且 ModelVersion为3.0或3.0-Omni，可选值为3-15，默认5 当 ModelName 是 Kling 并且 ModelVersion为3.0-Omni传入的文件分类为Video，可选值为3-10，默认5 当 ModelName 是 Hailuo，可选值为 6、10，默认为 6；当 ModelName 是 Vidu，可指定1-10；示例值：8.0

person_generation string

可选

是否允许人物或人脸生成。取值有： AllowAdult：允许生成成人； Disallowed：禁止在图片中包含人物或人脸；示例值：AllowAdult

input_compliance_check string

可选

是否开启输入内容的合规性检查。取值有： Enabled：开启； Disabled：关闭；示例值：Enabled

output_compliance_check string

可选

是否开启输出内容的合规性检查。取值有： Enabled：开启； Disabled：关闭；示例值：Enabled

scene_type string

可选

场景类型。取值如下：当 ModelName 为 Kling 时： motion_control 表示动作控制； avatar_i2v 表示数字人； lip_sync 表示对口型；其他 ModelName 暂不支持。示例值：motion_control

session_id string

可选

用于去重的识别码，如果三天内曾有过相同的识别码的请求，则本次的请求会返回错误。最长 50 个字符，不带或者带空字符串表示不做去重。示例值：mysession

session_context string

可选

来源上下文，用于透传用户请求信息，音画质重生完成回调将返回该字段值，最长 1000 个字符。示例值：mySessionContext

tasks_priority string

可选

任务的优先级，数值越大优先级越高，取值范围是 -10 到 10，不填代表 0。示例值：10

ext_info object

可选

保留字段，特殊用途时使用。示例值：myextinfo

AdditionalParameters object

可选

示例

{
    "model_name": "Kling",
    "model_version": "1.6",
    "prompt": "一辆汽车在公路上行驶，阳光明媚",
    "negative_prompt": "模糊、抖动",
    "enhance_prompt": "Enabled",
    "output_config": {
        "storage_mode": "Temporary",
        "media_name": "car-video",
        "duration": 8,
        "resolution": "1080P",
        "aspect_ratio": "16:9",
        "audio_generation": "Enabled",
        "person_generation": "AllowAdult",
        "input_compliance_check": "Enabled",
        "output_compliance_check": "Enabled",
        "enhance_switch": "Enabled"
    }
}

请求示例代码

curl --location --request POST 'https://api.quickrouter.ai/tencent-vod/v1/aigc-video' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data-raw '{
  "model_name": "Kling",
  "model_version": "1.6",
  "prompt": "一辆汽车在公路上行驶，阳光明媚",
  "negative_prompt": "模糊、抖动",
  "enhance_prompt": "Enabled",
  "output_config": {
    "storage_mode": "Temporary",
    "media_name": "car-video",
    "duration": 8,
    "resolution": "1080P",
    "aspect_ratio": "16:9",
    "audio_generation": "Enabled",
    "person_generation": "AllowAdult",
    "input_compliance_check": "Enabled",
    "output_compliance_check": "Enabled",
    "enhance_switch": "Enabled"
  }
}'

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({
  "model_name": "Kling",
  "model_version": "1.6",
  "prompt": "一辆汽车在公路上行驶，阳光明媚",
  "negative_prompt": "模糊、抖动",
  "enhance_prompt": "Enabled",
  "output_config": {
    "storage_mode": "Temporary",
    "media_name": "car-video",
    "duration": 8,
    "resolution": "1080P",
    "aspect_ratio": "16:9",
    "audio_generation": "Enabled",
    "person_generation": "AllowAdult",
    "input_compliance_check": "Enabled",
    "output_compliance_check": "Enabled",
    "enhance_switch": "Enabled"
  }
});

var requestOptions = {
   method: 'POST',
   headers: myHeaders,
   body: raw,
   redirect: 'follow'
};

fetch("https://api.quickrouter.ai/tencent-vod/v1/aigc-video", 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({
  "model_name": "Kling",
  "model_version": "1.6",
  "prompt": "一辆汽车在公路上行驶，阳光明媚",
  "negative_prompt": "模糊、抖动",
  "enhance_prompt": "Enabled",
  "output_config": {
    "storage_mode": "Temporary",
    "media_name": "car-video",
    "duration": 8,
    "resolution": "1080P",
    "aspect_ratio": "16:9",
    "audio_generation": "Enabled",
    "person_generation": "AllowAdult",
    "input_compliance_check": "Enabled",
    "output_compliance_check": "Enabled",
    "enhance_switch": "Enabled"
  }
})
headers = {
   'Accept': 'application/json',
   'Authorization': 'Bearer YOUR_API_KEY',
   'Content-Type': 'application/json'
}
conn.request("POST", "/tencent-vod/v1/aigc-video", 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"
    }
}

创建任务

请求参数

请求示例代码

返回响应

相关文档