WAND wiki
최근 문서

검색 결과가 없습니다. 모델명이나 다른 키워드로 검색해 보세요.

MPS APILast Updated 2026-10-03

Vega VideoHOT

On this page

Endpoint: POST https://mps.intl.tencentcloudapi.com
Action: CreateAigcVideoTask

Vega Video는 텍스트와 참조 미디어를 바탕으로 영상을 생성합니다. 생성할 장면을 프롬프트에 설명하고, 출력 해상도와 비율은 ExtraParameters, 길이는 Duration에 지정합니다.

Vega 1.5 Pro / 1080P
VS 2.5 / 1080P

기본 정보

항목 값
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 요청 예시

LANGUAGE
{
  "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 요청 예시

LANGUAGE
{
  "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 요청 예시

LANGUAGE
{
  "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에 같은 값을 전달합니다.

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

Status=DONE이며 VideoUrls에 주소가 반환되면 결과를 사용할 수 있습니다.

LANGUAGE
{
  "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 출력 심사 해제

다음 설정을 기존 생성 요청에 병합합니다. 입력과 출력 심사를 모두 해제하려면 두 필드를 함께 전달합니다.

LANGUAGE
{
  "ExtraParameters": {
    "EnablelnputComplianceCheck": false,
    "EnableOutputComplianceCheck": false
  }
}

첫 프레임 / 마지막 프레임

ImageUrl과 LastImageUrl을 함께 지정합니다. 프롬프트에는 두 장면 사이의 움직임이나 전환을 설명합니다.

이미지 / 영상 참조

이미지는 ImageInfos, 영상은 VideoInfos에 전달합니다. 프롬프트에서 각 참조의 제품, 배경, 움직임 등 사용할 요소를 구체적으로 설명합니다.

결과 보관

StoreCosParam에 버킷 이름, 리전과 저장 경로를 지정합니다. 비공개 버킷의 결과는 COS SDK 또는 서명 URL로 내려받습니다. 인증, 요청 실행과 저장 공통 규격은 API Reference를 참조하세요.

오디오 출력

ExtraParameters.EnableAudio로 오디오 생성을 설정합니다. 1.5-pro에서 무음 파일이 필요한 경우 false 지정만으로 오디오 트랙 제거를 가정하지 마십시오. 결과 파일의 트랙을 확인하고 필요한 경우 후처리로 오디오를 제거하십시오.