Skip to content

Vega Video HOT โ€‹

Updated

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 โ€‹

ItemValue
ModelNamewand-vega-video
ModelVersion1.5-pro / 1.0-pro / 1.0-lite
InputText / First and last frame / Reference image / Video
Result queryDescribeAigcVideoTask
Result storageCOS bucket specified in StoreCosParam
Guardrail release supportSupported

Supported Specifications by Version โ€‹

VersionResolutionAspect RatioLength
1.5-pro720P / 1080P / 2K16:9 / 9:164 seconds / 8 seconds
1.0-pro720P / 1080P16:9 / 1:14 seconds / 8 seconds
1.0-lite480P / 768P / 1080P16:9 / 9:16 / 1:14 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 โ€‹

ItemSpecification
Number of reference images9 images or fewer recommended
Size per image fileLess than 30MB
Image width / height300~6000px each
Image aspect ratioWidth/height 0.4~2.5
Image formatJPEG / PNG
First / last frame1 image each
Reference image fieldImageInfos.N.ImageUrl

1.0 Pro โ€‹

1.0 Pro Reference Images โ€‹

ItemSpecification
Number of reference imagesMaximum 9 images
Size per image fileLess than 30MB
Image width / height300~6000px each
Image aspect ratioWidth/height 0.4~2.5
Image formatJPEG / PNG
First / last frame1 image each
Reference image fieldImageInfos.N.ImageUrl

1.0 Lite โ€‹

Direct reference of material groups is not supported in Lite.

1.0 Lite Reference Images โ€‹

ItemSpecification
Number of reference imagesMaximum 9 images
Size per image file30MB or less
Image width / height256~5760px each
Image aspect ratioFirst / last frame is 0.4~2.5
Image formatJPEG / PNG
First / last frame1 image each
Reference image fieldImageInfos.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 โ€‹

ParameterRequiredTypeDescription
ModelNameRequiredStringwand-vega-video
ModelVersionRequiredString1.5-pro / 1.0-pro / 1.0-lite
PromptRequiredStringInstruction describing the scene, the motion, and the role of the reference media
EnhancePromptOptionalBooleanAutomatic prompt correction. The example uses false
DurationOptionalIntegerLength of the video to generate (seconds). Specify a value that matches the version and input method
ImageUrlOptionalStringFirst frame image URL
LastImageUrlOptionalStringLast frame image URL. Used together with ImageUrl
ImageInfos.N.ImageUrlOptionalStringReference image URL
VideoInfos.N.VideoUrlOptionalStringReference video URL
ExtraParameters.
Resolution
OptionalStringOutput resolution
ExtraParameters.
AspectRatio
OptionalStringOutput aspect ratio
ExtraParameters.
EnableAudio
OptionalBooleanVideo audio generation setting. The example uses true
StoreCosParamOptionalObjectResult storage location. CosBucketName / CosBucketRegion / CosBucketPath
ExtraParameters.
EnablelnputComplianceCheck
OptionalBooleanIf false is explicitly passed, input moderation is released. Contact your sales representative before use
ExtraParameters.
EnableOutputComplianceCheck
OptionalBooleanIf false is explicitly passed, output moderation is released. Contact your sales representative before use

Request Example โ€‹

1.5 Pro Request Example โ€‹

json
{
  "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 โ€‹

json
{
  "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 โ€‹

json
{
  "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.

json
{
  "Response": {
    "TaskId": "2600012260-AigcVideo-ca6bb6b1d81d4294b838d8258781a46c",
    "RequestId": "7128d22f-f3d2-4add-b306-1c9647b75831"
  }
}
json
{
  "TaskId": "2600012260-AigcVideo-ca6bb6b1d81d4294b838d8258781a46c"
}

Status=DONE, and once an address is returned in VideoUrls, the result is available for use.

json
{
  "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.

ParameterRelease ValueScope
ExtraParameters.EnablelnputComplianceCheckfalseInput moderation release
ExtraParameters.EnableOutputComplianceCheckfalseOutput moderation release

Merge the following settings into your existing generation request. To release both input and output moderation, pass both fields together.

json
{
  "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.

Built with VitePress ยท Deployed on Tencent EdgeOne Pages