Vega VideoHOT
On this page
Endpoint: POST https://mps.intl.tencentcloudapi.com
Action: CreateAigcVideoTask
Vega Video는 텍스트와 참조 미디어를 바탕으로 영상을 생성합니다. 생성할 장면을 프롬프트에 설명하고, 출력 해상도와 비율은 ExtraParameters, 길이는 Duration에 지정합니다.
기본 정보
| 항목 | 값 |
|---|---|
| ModelName | wand-vega-video |
| ModelVersion | 1.5-pro / 1.0-pro / 1.0-lite |
| 입력 | 텍스트 / 첫/끝 프레임 / 참조 이미지 / 영상 |
| 결과 조회 | DescribeAigcVideoTask |
| 결과 보관 | StoreCosParam에 지정한 COS 버킷 |
| 가드레일 해제 지원 | 지원 |
버전별 지원 규격
| 버전 | 해상도 | 비율 | 길이 |
|---|---|---|---|
1.5-pro |
720P / 1080P / 2K |
16:9 / 9:16 |
4초 / 8초 |
1.0-pro |
720P / 1080P |
16:9 / 1:1 |
4초 / 8초 |
1.0-lite |
480P / 768P / 1080P |
16:9 / 9:16 / 1:1 |
4초 / 8초 |
표는 아래 요청 예제의 출력 구성입니다. 가로형 출력은 Pro 720P에서 1280×720, Pro 1080P에서 1920×1080, Lite 480P에서 864×480입니다. Lite의 정사각형 첫 프레임 예제는 1080×1080으로 출력됩니다. Duration은 요청 길이이며 결과 파일의 재생 시간은 인코딩 단위에 따라 소폭 달라질 수 있습니다.
해상도는 출력 등급입니다. 2K / 9:16은 1440×2560, 1080P / 1:1은 1440×1440, 768P / 9:16은 768×1344로 출력될 수 있습니다. 입력 방식과 인코딩 정렬에 따라 실제 픽셀 크기를 확인하십시오. Lite의 해상도 값에는 720P 대신 768P를 사용합니다.
1.5 Pro
1.5 Pro 참조 이미지
| 항목 | 규격 |
|---|---|
| 참조 이미지 수 | 9장 이하 권장 |
| 이미지 파일당 용량 | 30MB 미만 |
| 이미지 너비 / 높이 | 각각 300~6000px |
| 이미지 비율 | 너비/높이 0.4~2.5 |
| 이미지 형식 | JPEG / PNG |
| 첫 / 마지막 프레임 | 각 1장 |
| 참조 이미지 필드 | ImageInfos.N.ImageUrl |
1.0 Pro
1.0 Pro 참조 이미지
| 항목 | 규격 |
|---|---|
| 참조 이미지 수 | 최대 9장 |
| 이미지 파일당 용량 | 30MB 미만 |
| 이미지 너비 / 높이 | 각각 300~6000px |
| 이미지 비율 | 너비/높이 0.4~2.5 |
| 이미지 형식 | JPEG / PNG |
| 첫 / 마지막 프레임 | 각 1장 |
| 참조 이미지 필드 | ImageInfos.N.ImageUrl |
1.0 Lite
소재 그룹 직접 참조 방식은 Lite에서 지원하지 않습니다.
1.0 Lite 참조 이미지
| 항목 | 규격 |
|---|---|
| 참조 이미지 수 | 최대 9장 |
| 이미지 파일당 용량 | 30MB 이하 |
| 이미지 너비 / 높이 | 각각 256~5760px |
| 이미지 비율 | 첫 / 마지막 프레임은 0.4~2.5 |
| 이미지 형식 | JPEG / PNG |
| 첫 / 마지막 프레임 | 각 1장 |
| 참조 이미지 필드 | ImageInfos.N.ImageUrl |
1.5-pro의 권장 장수는 MPS 연동 구성 기준이며 모델의 최대 장수를 의미하지 않습니다. 이미지 30장을 사용하는 구성은 VOD Vega Video의 FileInfos 입력 규격을 따르십시오.
비공개 COS 객체는 유효한 서명 URL을 사용하십시오. 서명 URL의 유효기간은 입력 다운로드가 완료될 때까지 유지해야 합니다.
요청 파라미터
| 파라미터 | 필수 | 타입 | 설명 |
|---|---|---|---|
ModelName |
필수 | String | wand-vega-video |
ModelVersion |
필수 | String | 1.5-pro / 1.0-pro / 1.0-lite |
Prompt |
필수 | String | 장면, 움직임, 참조 미디어의 역할을 설명하는 지시문 |
EnhancePrompt |
선택 | Boolean | 프롬프트 자동 보정. 예시는 false 사용 |
Duration |
선택 | Integer | 생성할 영상 길이(초). 버전 및 입력 방식에 맞는 값을 지정 |
ImageUrl |
선택 | String | 첫 프레임 이미지 URL |
LastImageUrl |
선택 | String | 마지막 프레임 이미지 URL. ImageUrl과 함께 사용 |
ImageInfos.N.ImageUrl |
선택 | String | 참조 이미지 URL |
VideoInfos.N.VideoUrl |
선택 | String | 참조 영상 URL |
ExtraParameters.Resolution |
선택 | String | 출력 해상도 |
ExtraParameters.AspectRatio |
선택 | String | 출력 비율 |
ExtraParameters.EnableAudio |
선택 | Boolean | 영상 오디오 생성 설정. 예시는 true 사용 |
StoreCosParam |
선택 | Object | 결과 저장 위치. CosBucketName / CosBucketRegion / CosBucketPath |
ExtraParameters.EnablelnputComplianceCheck |
선택 | Boolean | false를 명시적으로 전달하면 입력 심사 해제. 사용 전 영업담당자 문의 |
ExtraParameters.EnableOutputComplianceCheck |
선택 | Boolean | false를 명시적으로 전달하면 출력 심사 해제. 사용 전 영업담당자 문의 |
요청 예시
1.5 Pro 요청 예시
{
"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 요청 예시
{
"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": "https://wand.tencentpoc.com/uploads/vega/mps/ref1.png",
"LastImageUrl": "https://wand.tencentpoc.com/uploads/vega/mps/ref2.png"
}1.0 Lite 요청 예시
{
"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": "https://wand.tencentpoc.com/uploads/vega/mps/ref1.png"
}텍스트 기반 생성
위 1.5 Pro 요청 예시는 참조 이미지나 영상 없이 장면, 인물의 행동, 카메라 이동, 조명을 텍스트로 지정합니다.
응답 및 결과 조회
생성 요청은 TaskId를 반환합니다. DescribeAigcVideoTask에 같은 값을 전달합니다.
{
"Response": {
"TaskId": "2600012260-AigcVideo-ca6bb6b1d81d4294b838d8258781a46c",
"RequestId": "7128d22f-f3d2-4add-b306-1c9647b75831"
}
}{
"TaskId": "2600012260-AigcVideo-ca6bb6b1d81d4294b838d8258781a46c"
}Status=DONE이며 VideoUrls에 주소가 반환되면 결과를 사용할 수 있습니다.
{
"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"
}
}특수 설정
가드레일 해제
입력과 출력 심사를 각각 설정할 수 있습니다.
가드레일 해제 파라미터를 사용하려면 먼저 영업담당자에게 연락해 사용 권한을 확인해야 합니다. 지원 엔진에서도 해당 파라미터를 명시적으로 전달하는 경우에만 가드레일 해제가 적용됩니다. 파라미터를 생략하면 해제되지 않습니다.
| 파라미터 | 해제 값 | 적용 대상 |
|---|---|---|
ExtraParameters.EnablelnputComplianceCheck |
false |
입력 심사 해제 |
ExtraParameters.EnableOutputComplianceCheck |
false |
출력 심사 해제 |
다음 설정을 기존 생성 요청에 병합합니다. 입력과 출력 심사를 모두 해제하려면 두 필드를 함께 전달합니다.
{
"ExtraParameters": {
"EnablelnputComplianceCheck": false,
"EnableOutputComplianceCheck": false
}
}첫 프레임 / 마지막 프레임
ImageUrl과 LastImageUrl을 함께 지정합니다. 프롬프트에는 두 장면 사이의 움직임이나 전환을 설명합니다.
이미지 / 영상 참조
이미지는 ImageInfos, 영상은 VideoInfos에 전달합니다. 프롬프트에서 각 참조의 제품, 배경, 움직임 등 사용할 요소를 구체적으로 설명합니다.
결과 보관
StoreCosParam에 버킷 이름, 리전과 저장 경로를 지정합니다. 비공개 버킷의 결과는 COS SDK 또는 서명 URL로 내려받습니다. 인증, 요청 실행과 저장 공통 규격은 API Reference를 참조하세요.
오디오 출력
ExtraParameters.EnableAudio로 오디오 생성을 설정합니다. 1.5-pro에서 무음 파일이 필요한 경우 false 지정만으로 오디오 트랙 제거를 가정하지 마십시오. 결과 파일의 트랙을 확인하고 필요한 경우 후처리로 오디오를 제거하십시오.
