Vega Video 1.5 Lite โ
โ Back to the Vega Video overview for version comparison and selection.
Endpoint: POST https://vod.intl.tencentcloudapi.comAction: CreateAigcVideoTaskInternational API documentation: CreateAigcVideoTask
Vega Video 1.5 Lite (1.5-lite) is the new Vega Lite release, balancing generation quality, speed and cost. It supports text-to-video, first-frame / last-frame / first-and-last-frame generation, and multimodal reference generation from mixed image, video and audio inputs. It outputs up to 4K at 2โ30 seconds per clip, also accepts -1 for model-selected duration, and can generate audio with the video.
Basic Information โ
| Item | Value |
|---|---|
| ModelName | wand-vega-video |
| ModelVersion | 1.5-lite |
| Resolution | 480P / 720P / 1080P / 2K / 4K |
| Aspect ratio | 21:9 / 16:9 / 4:3 / 1:1 / 3:4 / 9:16 / adaptive |
| Duration | 2โ30 seconds, or -1 for model-selected duration |
| Output sound | Supported (AudioGeneration: Enabled) |
Input Specifications โ
| Input type | Count and duration | Per-file size |
|---|---|---|
| First / last frame image | 1 each | Up to 20MB |
| Reference images | Up to 10 | Up to 20MB each |
| Reference videos | Up to 5, no more than 15 seconds in total | Up to 100MB each |
| Reference audio clips | Up to 5, no more than 15 seconds in total | Up to 15MB each |
Reference inputs are passed through FileInfos, with Usage set to FirstFrame, LastFrame or Reference. Submit audio reference together with image or video material.
Request Parameters โ
| Parameter | Required | Type | Description |
|---|---|---|---|
SubAppId | Required | Integer | VOD application ID |
ModelName | Required | String | Fixed value wand-vega-video |
ModelVersion | Required | String | Fixed value 1.5-lite |
Prompt | Conditional | String | Generation or editing instruction; required when FileInfos is empty |
FileInfos.N | Optional | Array | Image, video or audio reference material; Usage is FirstFrame / LastFrame / Reference |
OutputConfig.Resolution | Optional | String | 480P / 720P / 1080P / 2K / 4K |
OutputConfig.Duration | Optional | Float | 2โ30, or -1 for model-selected duration |
OutputConfig.AspectRatio | Optional | String | 21:9 / 16:9 / 4:3 / 1:1 / 3:4 / 9:16 / adaptive |
OutputConfig.StorageMode | Optional | String | Temporary / Permanent |
OutputConfig.MediaName | Optional | String | Media name shown when Permanent |
OutputConfig.AudioGeneration | Optional | String | Enabled / Disabled |
ExtInfo | Optional | String | JSON-encoded string for passing WandVegaParameters |
Request Examples โ
Text-to-Video โ
{
"SubAppId": 123456789,
"ModelName": "wand-vega-video",
"ModelVersion": "1.5-lite",
"Prompt": "A woman walks through a rain-soaked neon street, cinematic camera movement and natural motion.",
"OutputConfig": {
"Resolution": "1080P",
"Duration": 10,
"AspectRatio": "16:9",
"AudioGeneration": "Enabled",
"StorageMode": "Temporary"
}
}First and Last Frame Generation โ
{
"SubAppId": 123456789,
"ModelName": "wand-vega-video",
"ModelVersion": "1.5-lite",
"Prompt": "Create a smooth, cinematic transition between the two scenes.",
"FileInfos": [
{
"Type": "Url",
"Category": "Image",
"Usage": "FirstFrame",
"Url": "https://<cdn>/first.png"
},
{
"Type": "Url",
"Category": "Image",
"Usage": "LastFrame",
"Url": "https://<cdn>/last.png"
}
],
"OutputConfig": {
"Resolution": "1080P",
"Duration": 8,
"AspectRatio": "16:9",
"StorageMode": "Temporary"
}
}Multimodal Reference Generation โ
{
"SubAppId": 123456789,
"ModelName": "wand-vega-video",
"ModelVersion": "1.5-lite",
"Prompt": "Keep the character identity and follow the reference video's camera rhythm.",
"FileInfos": [
{
"Type": "Url",
"Category": "Image",
"Usage": "Reference",
"Url": "https://<cdn>/character.png"
},
{
"Type": "Url",
"Category": "Video",
"Usage": "Reference",
"Url": "https://<cdn>/camera-reference.mp4"
},
{
"Type": "Url",
"Category": "Audio",
"Usage": "Reference",
"Url": "https://<cdn>/music-reference.mp3"
}
],
"OutputConfig": {
"Resolution": "2K",
"Duration": -1,
"AspectRatio": "adaptive",
"AudioGeneration": "Enabled",
"StorageMode": "Temporary"
}
}Responses and Result Query โ
The generation request returns a TaskId. Query the task with DescribeTaskDetail. Generation succeeds when AigcVideoTask.Status=FINISH and ErrCode=0; the video URL is returned in AigcVideoTask.Output.FileInfos.FileUrl.
{
"SubAppId": 123456789,
"TaskId": "<task-id>"
}Special Settings โ
ExtInfo (WandVegaParameters) โ
Lite accepts model-specific options through the WandVegaParameters key in ExtInfo. Serialize the inner parameters object as a JSON string, place it inside ExtInfo, and serialize the outer object again.
| Parameter | Type | Value / behavior |
|---|---|---|
EnhancePromptMode | String | auto / enable / disable. Omission or auto is treated as enable |
ReturnVegaUsage | Boolean | Whether to return Vega usage in the result; default false |
ModerationMode | String | Moderation_L1 / Moderation_L2 |
Difference from 1.0 Lite
1.5-lite does not support GenerateMode or VideoQualityMode. Those two parameters are available only on 1.0 Lite.
import json
ext_info = json.dumps({
"WandVegaParameters": json.dumps({
"EnhancePromptMode": "enable",
"ReturnVegaUsage": True,
"ModerationMode": "Moderation_L1",
})
})Permanent Storage โ
Set OutputConfig.StorageMode to Permanent to keep the output as a VOD media asset. You can also specify MediaName.