Vega Video HOT โ
Endpoint: POST https://mps.intl.tencentcloudapi.comAction: CreateAigcVideoTask
Vega Video is WAND's in-house video generation model. It supports text-to-video, first-frame / last-frame / first-and-last-frame video generation, and multimodal reference generation that mixes images, video, and audio, and can generate audio at the same time. Three versions are available โ 1.5-pro, 1.0-pro, and 1.0-lite; set resolution and aspect ratio in ExtraParameters and the length in Duration.
Basic Information โ
| Item | Value |
|---|---|
| ModelName | wand-vega-video |
| ModelVersion | 1.5-pro / 1.0-pro / 1.0-lite |
| Input | Text / First and last frame / Reference image / Video |
| Result query | DescribeAigcVideoTask |
| Result storage | COS bucket specified in StoreCosParam |
| Guardrail release support | Supported |
Supported Specifications by Version โ
| Version | Resolution | Aspect Ratio | Length |
|---|---|---|---|
1.5-pro | 720P / 1080P / 2K | 16:9 / 9:16 | 4 seconds / 8 seconds |
1.0-pro | 720P / 1080P | 16:9 / 1:1 | 4 seconds / 8 seconds |
1.0-lite | 480P / 768P / 1080P | 16:9 / 9:16 / 1:1 | 4 seconds / 8 seconds |
The table shows the output configuration of the request examples below. Landscape output is 1280ร720 for Pro 720P, 1920ร1080 for Pro 1080P, and 864ร480 for Lite 480P. The square first-frame example of Lite is output at 1080ร1080. Duration is the requested length, and the playback duration of the result file may vary slightly depending on the encoding unit.
Resolution is the output grade. 2K / 9:16 may be output as 1440ร2560, 1080P / 1:1 as 1440ร1440, and 768P / 9:16 as 768ร1344. Check the actual pixel size according to the input method and encoding alignment. For the resolution value of Lite, use 768P instead of 720P.
1.5 Pro โ
1.5 Pro Reference Images โ
| Item | Specification |
|---|---|
| Number of reference images | 9 images or fewer recommended |
| Size per image file | Less than 30MB |
| Image width / height | 300~6000px each |
| Image aspect ratio | Width/height 0.4~2.5 |
| Image format | JPEG / PNG |
| First / last frame | 1 image each |
| Reference image field | ImageInfos.N.ImageUrl |
1.0 Pro โ
1.0 Pro Reference Images โ
| Item | Specification |
|---|---|
| Number of reference images | Maximum 9 images |
| Size per image file | Less than 30MB |
| Image width / height | 300~6000px each |
| Image aspect ratio | Width/height 0.4~2.5 |
| Image format | JPEG / PNG |
| First / last frame | 1 image each |
| Reference image field | ImageInfos.N.ImageUrl |
1.0 Lite โ
Direct reference of material groups is not supported in Lite.
1.0 Lite Reference Images โ
| Item | Specification |
|---|---|
| Number of reference images | Maximum 9 images |
| Size per image file | 30MB or less |
| Image width / height | 256~5760px each |
| Image aspect ratio | First / last frame is 0.4~2.5 |
| Image format | JPEG / PNG |
| First / last frame | 1 image each |
| Reference image field | ImageInfos.N.ImageUrl |
The recommended number of images for 1.5-pro is based on the MPS integration configuration and does not mean the maximum number supported by the model. For configurations that use image 30 images, follow the FileInfos input specification of VOD WAND-Vega-Video.
For private COS objects, use a valid signed URL. The validity period of the signed URL must be maintained until the input download is complete.
Request Parameters โ
| Parameter | Required | Type | Description |
|---|---|---|---|
ModelName | Required | String | wand-vega-video |
ModelVersion | Required | String | 1.5-pro / 1.0-pro / 1.0-lite |
Prompt | Required | String | Instruction describing the scene, the motion, and the role of the reference media |
EnhancePrompt | Optional | Boolean | Automatic prompt correction. The example uses false |
Duration | Optional | Integer | Length of the video to generate (seconds). Specify a value that matches the version and input method |
ImageUrl | Optional | String | First frame image URL |
LastImageUrl | Optional | String | Last frame image URL. Used together with ImageUrl |
ImageInfos.N.ImageUrl | Optional | String | Reference image URL |
VideoInfos.N.VideoUrl | Optional | String | Reference video URL |
ExtraParameters.Resolution | Optional | String | Output resolution |
ExtraParameters.AspectRatio | Optional | String | Output aspect ratio |
ExtraParameters.EnableAudio | Optional | Boolean | Video audio generation setting. The example uses true |
StoreCosParam | Optional | Object | Result storage location. CosBucketName / CosBucketRegion / CosBucketPath |
ExtraParameters.EnablelnputComplianceCheck | Optional | Boolean | If false is explicitly passed, input moderation is released. Contact your sales representative before use |
ExtraParameters.EnableOutputComplianceCheck | Optional | Boolean | If false is explicitly passed, output moderation is released. Contact your sales representative before use |
Request Example โ
1.5 Pro Request Example โ
{
"ModelName": "wand-vega-video",
"ModelVersion": "1.5-pro",
"Prompt": "Photorealistic live-action epic science-fiction film, one continuous eight-second shot. An adult female pilot with dark hair tied back, wearing a weathered ivory flight suit, strides onto a vast spaceport observation deck at blue hour. Begin close beside her face, capturing her quiet awe and loose hair moving in the wind. The camera smoothly arcs around her shoulder and pulls back to reveal a colossal starship rising from the launch pad beyond the railing. Brilliant amber engine plumes illuminate rolling white vapor, tiny service vehicles and the glass towers of a futuristic coastal city. She raises one hand to shield her eyes as the ship climbs, warm engine light sweeping naturally across her face. Physical human performance, realistic scale, textured skin and fabric, volumetric light, elegant anamorphic cinematography, deep blue shadows and gold highlights. No cartoon, no illustration, no text overlays, no logos.",
"EnhancePrompt": false,
"Duration": 8,
"ExtraParameters": {
"Resolution": "1080P",
"AspectRatio": "16:9",
"EnableAudio": true
},
"StoreCosParam": {
"CosBucketName": "example-1250000000",
"CosBucketRegion": "ap-seoul",
"CosBucketPath": "/justin/aigc-video/"
}
}1.0 Pro Request Example โ
{
"ModelName": "wand-vega-video",
"ModelVersion": "1.0-pro",
"Prompt": "Start with the red bottle in the first image and smoothly transform it into the blue bottle in the last image, white studio background, locked camera.",
"EnhancePrompt": false,
"Duration": 4,
"ExtraParameters": {
"Resolution": "1080P",
"AspectRatio": "16:9",
"EnableAudio": true
},
"StoreCosParam": {
"CosBucketName": "example-1250000000",
"CosBucketRegion": "ap-singapore",
"CosBucketPath": "/vega/"
},
"ImageUrl": "",
"LastImageUrl": ""
}1.0 Lite Request Example โ
{
"ModelName": "wand-vega-video",
"ModelVersion": "1.0-lite",
"Prompt": "A red bottle standing on a white studio table, camera slowly moves forward, soft product lighting.",
"EnhancePrompt": false,
"Duration": 4,
"ExtraParameters": {
"Resolution": "1080P",
"AspectRatio": "16:9",
"EnableAudio": true
},
"StoreCosParam": {
"CosBucketName": "example-1250000000",
"CosBucketRegion": "ap-singapore",
"CosBucketPath": "/vega/"
},
"ImageUrl": ""
}Text-Based Generation โ
The 1.5 Pro Request Example above specifies the scene, the person's actions, camera movement, and lighting as text, without any reference image or video.
Response and Result Query โ
A generation request returns TaskId. Pass the same value to DescribeAigcVideoTask.
{
"Response": {
"TaskId": "2600012260-AigcVideo-ca6bb6b1d81d4294b838d8258781a46c",
"RequestId": "7128d22f-f3d2-4add-b306-1c9647b75831"
}
}{
"TaskId": "2600012260-AigcVideo-ca6bb6b1d81d4294b838d8258781a46c"
}Status=DONE, and once an address is returned in VideoUrls, the result is available for use.
{
"Response": {
"Status": "DONE",
"ErrCode": "",
"Message": "ok",
"Resolution": "1280x720",
"VideoUrls": [
"https://example-1250000000.cos.ap-singapore.myqcloud.com/vega/result.mp4"
],
"RequestId": "7128d22f-f3d2-4add-b306-1c9647b75831"
}
}Special Configuration โ
Guardrail Release โ
Input and output moderation can be configured separately.
To use the guardrail release parameters, you must first contact your sales representative to confirm usage permission. Guardrail release is applied only when the parameter is explicitly passed, even on supported engines. If the parameter is omitted, the guardrail is not released.
| Parameter | Release Value | Scope |
|---|---|---|
ExtraParameters.EnablelnputComplianceCheck | false | Input moderation release |
ExtraParameters.EnableOutputComplianceCheck | false | Output moderation release |
Merge the following settings into your existing generation request. To release both input and output moderation, pass both fields together.
{
"ExtraParameters": {
"EnablelnputComplianceCheck": false,
"EnableOutputComplianceCheck": false
}
}First Frame / Last Frame โ
Specify ImageUrl and LastImageUrl together. In the prompt, describe the motion or transition between the two scenes.
Image / Video Reference โ
Pass images to ImageInfos and video to VideoInfos. In the prompt, describe specifically which elements of each reference to use, such as the product, background, and motion.
Result Storage โ
Specify the bucket name, region, and storage path in StoreCosParam. Download results in a private bucket using a COS SDK or a signed URL. For authentication, request execution, and common storage specifications, refer to API Reference.
Audio Output โ
Configure audio generation with ExtraParameters.EnableAudio. If a silent file is required in 1.5-pro, do not assume that specifying false alone removes the audio track. Check the tracks of the result file and, if needed, remove the audio through post-processing.