Vega Video 1.0 Pro โ
โ Back to the Vega Video overview for version comparison and selection.
Endpoint: POST https://vod.intl.tencentcloudapi.comAction: CreateAigcVideoTask
Vega Video 1.0 Pro (1.0-pro, plus 1.0-pro-fast / 1.0-pro-mini) is for video generation: text-to-video, first-frame / last-frame / first-and-last-frame generation, and multimodal reference generation from up to 9 images, 3 videos and 3 audio clips. It also supports editing and extending a reference video, outputs 480Pโ4K at 4โ15 seconds per clip, and can generate audio.
Basic Information โ
| Item | Value |
|---|---|
| ModelName | wand-vega-video |
| ModelVersion | 1.0-pro / 1.0-pro-fast / 1.0-pro-mini |
| Resolution | 480P / 720P / 1080P / 2K / 4K |
| Aspect ratio | 21:9 / 16:9 / 4:3 / 1:1 / 3:4 / 9:16 / adaptive |
| Duration | 4~15 seconds |
| Output sound | Supported (AudioGeneration: Enabled) |
| Guardrail bypass support | Supported |
Input Specifications โ
1.0 Pro Reference Images โ
| Item | Specification |
|---|---|
| Number of reference images | Up to 9 |
| Size per image file | Less than 30MB |
| Image width / height | 300~6000px each |
| Image aspect ratio | Width/height 0.4~2.5 |
| Image formats | JPEG / PNG / WEBP / BMP / TIFF / GIF / HEIC / HEIF |
| First / last frame | 1 each |
| Total mixed inputs | Up to 12 for images / videos / audio combined |
1.0 Pro Reference Video / Audio โ
| Item | Specification |
|---|---|
| Number of reference videos | Up to 3 |
| Size per video file | 50MB or less |
| Video duration | 2~15 seconds each, 15 seconds or less in total |
| Video width / height | 300~6000px each, width/height ratio 0.4~2.5 |
| Video format / codec | MP4 / MOV |
| Video resolution / total pixels | 480P / 720P / 1080P, 409,600~2,086,876 pixels |
| Video frame rate | 24~60fps |
| Number of reference audio files | Up to 3 |
| Size per audio file | 15MB or less |
| Audio duration | 2~15 seconds each, 15 seconds or less in total |
| Audio formats | WAV / MP3 |
| Audio input condition | Must be submitted together with 1 or more images or videos. Audio cannot be submitted on its own |
Request Parameters โ
| Parameter | Required | Type | Description |
|---|---|---|---|
ModelName | Required | String | Fixed value wand-vega-video |
ModelVersion | Required | String | 1.0-pro / 1.0-pro-fast / 1.0-pro-mini |
Prompt | Conditional | String | Required when FileInfos is empty |
FileInfos.N | Optional | Array | Reference inputs. Type : String - input file type - File : VOD media file - Url : accessible URL Category : String - file category - Image, Video, Audio FileId : String - media file ID, valid when Type is File Url : String - accessible file URL, valid when Type is Url Usage is FirstFrame / LastFrame / Reference. |
OutputConfig.Resolution | Optional | String | 480P / 720P / 1080P / 2K / 4K |
OutputConfig.Duration | Optional | Float | A number in seconds, range 4~15. -1 means the model determines the duration automatically. |
OutputConfig.AspectRatio | Optional | String | 21:9 / 16:9 / 4:3 / 1:1 / 3:4 / 9:16 / adaptive |
OutputConfig.StorageMode | Optional | String | Temporary / Permanent (storage type: temporary storage / permanent storage) |
OutputConfig.MediaName | Optional | String | Media name shown when Permanent |
OutputConfig.AudioGeneration | Optional | String | Enabled / Disabled |
OutputConfig.LogoAdd | Optional | String | Enabled / Disabled (whether to apply the logo watermark) |
Seed | Optional | Integer | Model seed. The same Seed yields similar results |
ExtInfo | Optional | String | JSON encoding within 2. Passes additional options to AdditionalParameters / WandVegaParameters |
Output Resolution โ
Specified via OutputConfig.Resolution and AspectRatio. Output sizes based on 16:9 are as follows.
| Resolution | AspectRatio | Output resolution |
|---|---|---|
480P | 16:9 | 854x480 |
720P | 16:9 | 1280x720 |
1080P | 16:9 | 1920x1080 |
2K | 16:9 | 2560x1440 |
4K | 16:9 | 3840x2160 |
480P is available on 1.0-pro.
Request Examples โ
Text-to-Video โ
{
"SubAppId": 123456789,
"ModelName": "wand-vega-video",
"ModelVersion": "1.0-pro",
"Prompt": "a calico cat sitting on a wooden windowsill, sunlight streaming in, gentle breeze",
"OutputConfig": {
"Resolution": "1080P",
"Duration": 5,
"AspectRatio": "16:9",
"StorageMode": "Temporary"
}
}First Frame Generation (FirstFrame) โ
{
"SubAppId": 123456789,
"ModelName": "wand-vega-video",
"ModelVersion": "1.0-pro",
"FileInfos": [
{
"Type": "Url",
"Category": "Image",
"Usage": "FirstFrame",
"Url": "https://<cdn>/first.png"
}
],
"Prompt": "subtle camera dolly, calm mood",
"OutputConfig": {
"Resolution": "1080P",
"Duration": 5,
"AspectRatio": "16:9",
"StorageMode": "Temporary"
}
}Last Frame Generation (LastFrame) โ
Use Usage="LastFrame", or LastFrameUrl which is kept for compatibility with legacy calls.
{
"SubAppId": 123456789,
"ModelName": "wand-vega-video",
"ModelVersion": "1.0-pro",
"FileInfos": [
{
"Type": "Url",
"Category": "Image",
"Usage": "LastFrame",
"Url": "https://<cdn>/last.png"
}
],
"Prompt": "the scene settles on a quiet window at dusk",
"OutputConfig": {
"Resolution": "1080P",
"Duration": 5,
"AspectRatio": "16:9",
"StorageMode": "Temporary"
}
}First & Last Frame Generation (FirstFrame + LastFrame) โ
{
"SubAppId": 123456789,
"ModelName": "wand-vega-video",
"ModelVersion": "1.0-pro",
"FileInfos": [
{
"Type": "Url",
"Category": "Image",
"Usage": "FirstFrame",
"Url": "https://<cdn>/first.png"
},
{
"Type": "Url",
"Category": "Image",
"Usage": "LastFrame",
"Url": "https://<cdn>/last.png"
}
],
"Prompt": "smooth transition between the two scenes",
"OutputConfig": {
"Resolution": "1080P",
"Duration": 5,
"AspectRatio": "16:9",
"StorageMode": "Temporary"
}
}Responses and Result Query โ
Task Acceptance Response โ
{
"TaskId": "<task-id>",
"RequestId": "<request-id>"
}Result Query โ
{
"SubAppId": 123456789,
"TaskId": "<task-id>"
}Completion Response โ
{
"AigcVideoTask": {
"Status": "FINISH",
"ErrCode": 0,
"Progress": 100,
"Output": {
"FileInfos": [
{
"FileUrl": "http://<host>.vod2.myqcloud.com/.../aigcVideoGenFile.mp4",
"ExpireTime": "2026-09-15T10:29:48Z",
"MetaData": {
"Width": 1920,
"Height": 1080,
"Duration": 5.07,
"Container": "mov,mp4,m4a",
"Bitrate": 9494850
}
}
]
}
}
}Special Settings โ
ExtInfo (AdditionalParameters) โ
Pro's ExtInfo uses either the AdditionalParameters or WandVegaParameters key depending on the option. It is JSON-encoded within 2, and the inner object is wrapped as a string once more.
- return_last_frame : also returns the last frame image in the result.
- bitrate_mode : high-quality mode
import json
ext_inner = {
# "return_last_frame": True, # also return the last frame image in the result
# "bitrate_mode": "high", # high quality mode
}
ext_info = json.dumps({"AdditionalParameters": json.dumps(ext_inner)}, ensure_ascii=False)Example payload (retrieving the last frame):
{
"SubAppId": 123456789,
"ModelName": "wand-vega-video",
"ModelVersion": "1.0-pro",
"FileInfos": [
{
"Type": "Url",
"Category": "Image",
"Usage": "Reference",
"Url": "https://<cdn>/ref.png"
}
],
"Prompt": "natural motion, cinematic",
"OutputConfig": {
"Resolution": "1080P",
"Duration": 5,
"AspectRatio": "16:9",
"StorageMode": "Temporary"
},
"ExtInfo": "{\"AdditionalParameters\":\"{\\\"return_last_frame\\\":true}\"}"
}When called with return_last_frame=true, Output.FileInfos contains both the video and the last frame image. The UsageType of the last frame is last_frame_url.
Task Type Selection โ
Specify omni_reference_task_type in AdditionalParameters inside ExtInfo.
| Value | Behavior | Input and output conditions |
|---|---|---|
auto | Determines the task type automatically from the input material and the prompt | The input and output specifications of each version apply |
reference | Generates a new video by referencing images / video / audio | No additional aspect ratio / duration constraints are imposed by task type. The base specifications of each version still apply |
edit | Edits the picture or audio of the source video | 1 or more reference videos, video duration 4~30 seconds. OutputConfig.AspectRatio=adaptive, OutputConfig.Duration=-1 |
extend | Extends the source video forward or backward | 1 or more reference videos. OutputConfig.AspectRatio=adaptive |
Reference videos are passed via Category=Video and Usage=Reference of FileInfos. The video input duration and file limits of each version also apply.
import json
ext_info = json.dumps({
"AdditionalParameters": json.dumps({
"omni_reference_task_type": "extend"
})
})Model Options (WandVegaParameters) โ
| Parameter | Type | Value / behavior |
|---|---|---|
EnhancePromptMode | String | auto / enable / disable. When omitted or set to auto, Pro treats it as disable. enable enables optimization, and disable uses the original prompt |
ModerationMode | String | Moderation_L1: basic moderation, the default. Moderation_L2: enhanced moderation |
ReturnVegaUsage | Boolean | Default false. When true, usage is returned in the result |
Pro and Lite differ in the default behavior of EnhancePromptMode. ModerationMode is an option for choosing the moderation level, not a guardrail bypass option.
import json
ext_info = json.dumps({
"WandVegaParameters": json.dumps({
"EnhancePromptMode": "enable",
"ModerationMode": "Moderation_L2",
"ReturnVegaUsage": True
})
})Pass the ext_info string in ExtInfo of the generation request. When using AdditionalParameters and WandVegaParameters together, turn each into a JSON string first, then put them into a single ExtInfo object and serialize it again.
In the usage response, Usage.CompletionTokens is the number of output tokens and Usage.TotalTokens is the total number of tokens including the input.
Seed โ
Supplying the same Seed value produces similar results. Pin Seed when you need stable result comparison across regenerations.
{
"SubAppId": 123456789,
"ModelName": "wand-vega-video",
"ModelVersion": "1.0-pro",
"Prompt": "a calico cat on a wooden windowsill",
"Seed": 12345,
"OutputConfig": {
"Resolution": "1080P",
"Duration": 5,
"AspectRatio": "16:9",
"StorageMode": "Temporary"
}
}Live-Action Person Reference โ
Live-action person reference can be integrated in two ways. Both are supported on Pro only, not on Lite:
- Register as a material, then reference it (recommended): register the image with
CreateAigcMaterial, get itsAssetId, and reference it inFileInfosasasset://<AssetId>. Real-person materials on the China site require a liveness check first. See Real-Person Material Integration for the full procedure, and Non-Real-Person and International Site Materials for other materials. - Direct material group referencing: skip material registration and pass
asset_group_idin the video generation request, as shown below.
Put the image URL into FileInfos of CreateAigcVideoTask, and pass asset_group_id to ExtInfo.AdditionalParameters. A group name used for the first time is generated automatically.
{
"SubAppId": 123456789,
"ModelName": "wand-vega-video",
"ModelVersion": "1.0-pro",
"Prompt": "natural motion, soft light",
"FileInfos": [
{
"Type": "Url",
"Category": "Image",
"Usage": "Reference",
"Url": "https://<cdn>/person.jpg"
}
],
"OutputConfig": {
"Resolution": "720P",
"Duration": 5,
"AspectRatio": "16:9",
"StorageMode": "Temporary"
},
"ExtInfo": "{\"AdditionalParameters\":\"{\\\"asset_group_id\\\":\\\"<your-group-id>\\\"}\"}"
}Direct material group referencing is handled with a single CreateAigcVideoTask.
Permanent Storage โ
{
"OutputConfig": {
"StorageMode": "Permanent",
"MediaName": "wand-vega-video-pro-sample"
}
}Integration Settings โ
| Item | Configuration basis | How to apply |
|---|---|---|
| Live-action person reference | Register as a material and reference via asset://, or reference a material group directly | Real-person materials on the China site require a liveness check first. See Real-Person Material Integration |
| Audio | Audio sources you own or have secured usage rights for | Submit it as reference audio, or generate the video only and combine them in the editing stage |
Guardrail Bypass โ
Input and output moderation can be configured separately.
Before using the guardrail bypass parameters, you must contact your sales representative to confirm your usage permissions. Even on supported engines, guardrails are bypassed only when the corresponding parameter is passed explicitly. Omitting the parameter leaves them in place.
| Parameter | Bypass value | Applies to |
|---|---|---|
OutputConfig.InputComplianceCheck | Disabled | Bypasses input moderation |
OutputConfig.OutputComplianceCheck | Disabled | Bypasses output moderation |
Merge the following settings into your existing generation request. To bypass both input and output moderation, pass both fields together.
{
"OutputConfig": {
"InputComplianceCheck": "Disabled",
"OutputComplianceCheck": "Disabled"
}
}