WAND wiki
최근 문서

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

↑ ↓ 이동 ↵ 열기전체 결과 보기 →
VOD APILast Updated 2026-10-03

Vega VideoHOT

On this page

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

Vega Video는 텍스트, 이미지, 영상, 오디오 입력으로 영상을 생성합니다. 버전별 입력 한도와 요청 예시는 아래에서 확인합니다.

Vega Pro / 720P
Vega Lite / 1080P

기본 정보

항목 값
ModelName wand-vega-video
ModelVersion 1.5-pro / 1.0-pro / 1.0-pro-fast / 1.0-pro-mini / 1.0-lite
입력 모드 텍스트 / 첫/끝 프레임 / 이미지 / 영상 / 오디오 참조
출력 사운드 지원 (AudioGeneration: Enabled)
가드레일 해제 지원 지원

버전별 지원 규격

버전 해상도 비율 길이
1.5-pro 720P / 1080P / 2K / 4K 21:9 / 16:9 / 4:3 / 1:1 / 3:4 / 9:16 / adaptive 4~30초
1.0-pro 720P / 1080P / 2K / 4K 21:9 / 16:9 / 4:3 / 1:1 / 3:4 / 9:16 / adaptive 4~15초
1.0-lite 480P / 768P / 1080P / 2K / 4K 21:9 / 16:9 / 4:3 / 1:1 / 3:4 / 9:16 / adaptive 4~15초

1.5 Pro

1.5 Pro 참조 이미지

항목 규격
참조 이미지 수 최대 30장
이미지 파일당 용량 30MB 미만
이미지 너비 / 높이 각각 300~6000px
이미지 비율 너비/높이 0.4~2.5
이미지 형식 JPEG / PNG / WEBP / BMP / TIFF / GIF / HEIC / HEIF
첫 / 마지막 프레임 각 1장
혼합 입력 총개수 최대 50개 (이미지 30장 / 영상 10개 / 오디오 10개)

1.5 Pro 참조 영상 / 오디오

항목 규격
참조 영상 수 최대 10개
영상 파일당 용량 200MB 이하
영상 길이 개별 2~30초
영상 너비 / 높이 각각 300~6000px, 너비/높이 비율 0.4~2.5
영상 형식 / 코덱 MP4 / MOV (H.264 / H.265, 내부 오디오 AAC / MP3)
영상 해상도 / 총 픽셀 480P~4K / 409,600~8,295,044픽셀
영상 프레임 레이트 24~60fps
참조 오디오 수 최대 10개
오디오 파일당 용량 15MB 이하
오디오 길이 개별 2~30초, 합계 30초 이하
오디오 형식 WAV / MP3
오디오 입력 조건 이미지 또는 영상 1개 이상과 함께 입력. 오디오 단독 입력 불가

1.0 Pro

1.0 Pro 참조 이미지

항목 규격
참조 이미지 수 최대 9장
이미지 파일당 용량 30MB 미만
이미지 너비 / 높이 각각 300~6000px
이미지 비율 너비/높이 0.4~2.5
이미지 형식 JPEG / PNG / WEBP / BMP / TIFF / GIF / HEIC / HEIF
첫 / 마지막 프레임 각 1장
혼합 입력 총개수 이미지 / 영상 / 오디오 합계 최대 12개

1.0 Pro 참조 영상 / 오디오

항목 규격
참조 영상 수 최대 3개
영상 파일당 용량 50MB 이하
영상 길이 개별 2~15초, 합계 15초 이하
영상 너비 / 높이 각각 300~6000px, 너비/높이 비율 0.4~2.5
영상 형식 / 코덱 MP4 / MOV
영상 해상도 / 총 픽셀 480P / 720P / 1080P, 409,600~2,086,876픽셀
영상 프레임 레이트 24~60fps
참조 오디오 수 최대 3개
오디오 파일당 용량 15MB 이하
오디오 길이 개별 2~15초, 합계 15초 이하
오디오 형식 WAV / MP3
오디오 입력 조건 이미지 또는 영상 1개 이상과 함께 입력. 오디오 단독 입력 불가

1.0 Lite

1.0 Lite 참조 이미지

항목 규격
참조 이미지 수 최대 9장
이미지 파일당 용량 30MB 이하
이미지 너비 / 높이 각각 256~5760px
이미지 비율 첫 / 마지막 프레임은 0.4~2.5
이미지 형식 JPEG / PNG / WEBP / HEIC / HEIF
첫 / 마지막 프레임 각 1장
혼합 입력 총개수 이미지 / 영상 / 오디오 합계 최대 12개

1.0 Lite 참조 영상 / 오디오

항목 규격
참조 영상 수 최대 3개
영상 파일당 용량 50MB 이하
영상 길이 개별 2~15초, 합계 15초 이하
영상 너비 / 높이 각각 256~5760px, 너비/높이 비율 0.4~2.5
영상 형식 / 코덱 H.264 / H.265, 내부 오디오 AAC / MP3
영상 해상도 / 총 픽셀 위 너비 / 높이 조건 적용
영상 프레임 레이트 —
참조 오디오 수 최대 3개
오디오 파일당 용량 15MB 이하
오디오 길이 개별 2~15초, 합계 15초 이하
오디오 형식 WAV / MP3
오디오 입력 조건 이미지 또는 영상 1개 이상과 함께 입력. 오디오 단독 입력 불가

Lite의 용량 제한은 파일별로 적용하며 별도의 합산 용량 제한은 없습니다. 프롬프트는 최대 7,000자입니다. 첫 / 마지막 프레임 모드는 입력 이미지 비율을 사용하며, 참조 생성은 adaptive를 지원합니다.

요청 파라미터

Pro 요청 파라미터

파라미터 필수 타입 설명
ModelName 필수 String 고정값 wand-vega-video
ModelVersion 필수 String 1.5-pro / 1.0-pro / 1.0-pro-fast / 1.0-pro-mini
Prompt 조건부 String FileInfos가 비어 있으면 필수
FileInfos.N 선택 Array 참조 입력.
Type : String - 입력 파일 유형 - File : VOD 미디어 파일 - Url : 접근 가능한 URL
Category : String - 파일 분류 - Image, Video, Audio
FileId : String - 미디어 파일 ID, Type이 File일 때 유효
Url : String - 접근 가능한 파일 URL, Type이 Url일 때 유효
Usage는 FirstFrame / LastFrame / Reference.
OutputConfig.Resolution 선택 String 720P / 1080P / 2K / 4K
OutputConfig.Duration 선택 Float 초 단위 숫자. 1.0-pro는 4~15, 1.5-pro는 4~30. -1은 모델이 길이를 자동 결정합니다.
OutputConfig.AspectRatio 선택 String 21:9 / 16:9 / 4:3 / 1:1 / 3:4 / 9:16 / adaptive
OutputConfig.StorageMode 선택 String Temporary / Permanent (스토리지 유형 : 임시 저장 / 영구 저장)
OutputConfig.MediaName 선택 String Permanent일 때 표시되는 미디어명
OutputConfig.AudioGeneration 선택 String Enabled / Disabled
OutputConfig.LogoAdd 선택 String Enabled / Disabled (로고 워터마크 사용 여부)
Seed 선택 Integer 모델 시드. 같은 Seed면 비슷한 결과
ExtInfo 선택 String 2중 JSON 인코딩. AdditionalParameters / WandVegaParameters에 추가 옵션 전달

Pro / 출력 해상도

OutputConfig.Resolution과 AspectRatio로 지정합니다. 16:9 기준 출력 크기는 다음과 같습니다.

Resolution AspectRatio 출력 해상도
720P 16:9 1280x720
1080P 16:9 1920x1080
2K 16:9 2560x1440
4K 16:9 3840x2160

Lite 요청 파라미터

파라미터 필수 타입 설명
ModelName 필수 String 고정값 wand-vega-video
ModelVersion 필수 String 1.0-lite
Prompt 조건부 String 최대 7000자. FileInfos가 비어 있으면 필수
FileInfos.N 선택 Array 참조 입력. Usage는 FirstFrame(첫 프레임) / LastFrame(끝 프레임) / Reference(참조)
OutputConfig.Resolution 선택 String 480P / 768P / 1080P / 2K / 4K
OutputConfig.Duration 선택 Integer 4~15
OutputConfig.AspectRatio 선택 String 21:9 / 16:9 / 4:3 / 1:1 / 3:4 / 9:16 / adaptive
OutputConfig.StorageMode 선택 String Temporary(7일) / Permanent(VOD 미디어 자산 영구 보존)
OutputConfig.MediaName 선택 String StorageMode=Permanent일 때 표시되는 미디어명
OutputConfig.AudioGeneration 선택 String Enabled / Disabled
ExtInfo 선택 String 2중 JSON 인코딩 문자열입니다. 아래 추가 파라미터(WandVegaParameters)를 전달합니다.

첫 프레임 권장 표기

첫 프레임은 FileInfos.Usage="FirstFrame", 마지막 프레임은 별도 항목에 Usage="LastFrame"을 지정합니다. LastFrameUrl / LastFrameFileId는 과거 호출 호환을 위해 유지하지만 새 구현에는 Usage="LastFrame"을 권장합니다.

Lite / 출력 해상도

OutputConfig.Resolution과 AspectRatio로 지정합니다. 16:9 기준 출력 크기는 다음과 같습니다.

Resolution AspectRatio 출력 해상도
480P 16:9 864x480
768P 16:9 1344x768
1080P 16:9 1920x1080
2K 16:9 2560x1440
4K 16:9 3840x2160
파라미터 필수 타입 설명
OutputConfig.
InputComplianceCheck		 선택 String Disabled를 명시적으로 전달하면 입력 심사 해제. 사용 전 영업담당자 문의
OutputConfig.
OutputComplianceCheck		 선택 String Disabled를 명시적으로 전달하면 출력 심사 해제. 사용 전 영업담당자 문의

요청 예시

1.5 Pro 요청 예시

LANGUAGE
{
  "SubAppId": 123456789,
  "ModelName": "wand-vega-video",
  "ModelVersion": "1.5-pro",
  "Prompt": "a calico cat sitting on a wooden windowsill, sunlight streaming in, gentle breeze",
  "OutputConfig": {
    "Resolution": "1080P",
    "Duration": 5,
    "AspectRatio": "16:9",
    "StorageMode": "Temporary"
  }
}

1.0 Pro 요청 예시

LANGUAGE
{
  "SubAppId": 123456789,
  "ModelName": "wand-vega-video",
  "ModelVersion": "1.0-pro",
  "Prompt": "a calico cat sitting on a wooden windowsill, sunlight streaming in, gentle breeze",
  "OutputConfig": {
    "Resolution": "1080P",
    "Duration": 5,
    "AspectRatio": "16:9",
    "StorageMode": "Temporary"
  }
}

1.0 Lite 요청 예시

LANGUAGE
{
  "SubAppId": 0,
  "ModelName": "wand-vega-video",
  "ModelVersion": "1.0-lite",
  "Prompt": "a calico cat sitting on a wooden windowsill, sunlight streaming in, gentle breeze",
  "OutputConfig": {
    "Resolution": "1080P",
    "Duration": 5,
    "AspectRatio": "16:9",
    "StorageMode": "Temporary"
  }
}

Pro 요청 예시

Pro / 첫 프레임 생성 (FirstFrame)

LANGUAGE
{
  "SubAppId": 123456789,
  "ModelName": "wand-vega-video",
  "ModelVersion": "1.0-pro",
  "FileInfos": [
    {
      "Type": "Url",
      "Category": "Image",
      "Usage": "FirstFrame",
      "Url": "https://<cdn>/first.png"
    }
  ],
  "Prompt": "subtle camera dolly, calm mood",
  "OutputConfig": {
    "Resolution": "1080P",
    "Duration": 5,
    "AspectRatio": "16:9",
    "StorageMode": "Temporary"
  }
}

Pro / 끝 프레임 생성 (LastFrame)

Usage="LastFrame" 또는 과거 호출 호환을 위한 LastFrameUrl을 사용합니다.

LANGUAGE
{
  "SubAppId": 123456789,
  "ModelName": "wand-vega-video",
  "ModelVersion": "1.0-pro",
  "FileInfos": [
    {
      "Type": "Url",
      "Category": "Image",
      "Usage": "LastFrame",
      "Url": "https://<cdn>/last.png"
    }
  ],
  "Prompt": "the scene settles on a quiet window at dusk",
  "OutputConfig": {
    "Resolution": "1080P",
    "Duration": 5,
    "AspectRatio": "16:9",
    "StorageMode": "Temporary"
  }
}

Pro / 첫/끝 프레임 생성 (FirstFrame + LastFrame)

LANGUAGE
{
  "SubAppId": 123456789,
  "ModelName": "wand-vega-video",
  "ModelVersion": "1.0-pro",
  "FileInfos": [
    {
      "Type": "Url",
      "Category": "Image",
      "Usage": "FirstFrame",
      "Url": "https://<cdn>/first.png"
    },
    {
      "Type": "Url",
      "Category": "Image",
      "Usage": "LastFrame",
      "Url": "https://<cdn>/last.png"
    }
  ],
  "Prompt": "smooth transition between the two scenes",
  "OutputConfig": {
    "Resolution": "1080P",
    "Duration": 5,
    "AspectRatio": "16:9",
    "StorageMode": "Temporary"
  }
}

Lite 요청 예시

Lite / 첫 프레임 생성 (FirstFrame)

이미지 한 장을 첫 프레임으로 고정하고 그 이후를 생성합니다.

LANGUAGE
{
  "SubAppId": 0,
  "ModelName": "wand-vega-video",
  "ModelVersion": "1.0-lite",
  "FileInfos": [
    {
      "Type": "Url",
      "Category": "Image",
      "Usage": "FirstFrame",
      "Url": "https://<cdn>/first.png"
    }
  ],
  "Prompt": "she slowly opens her eyes and looks into the distance",
  "OutputConfig": {
    "Resolution": "1080P",
    "Duration": 5,
    "AspectRatio": "16:9",
    "StorageMode": "Temporary"
  }
}

Lite / 끝 프레임 생성 (LastFrame)

Usage="LastFrame"을 지정하면 끝 프레임만 고정합니다. 시작점은 모델이 자유롭게 잡습니다.

LANGUAGE
{
  "SubAppId": 0,
  "ModelName": "wand-vega-video",
  "ModelVersion": "1.0-lite",
  "FileInfos": [
    {
      "Type": "Url",
      "Category": "Image",
      "Usage": "LastFrame",
      "Url": "https://<cdn>/last.png"
    }
  ],
  "Prompt": "the scene settles on a quiet window at dusk",
  "OutputConfig": {
    "Resolution": "1080P",
    "Duration": 5,
    "AspectRatio": "16:9",
    "StorageMode": "Temporary"
  }
}

Lite / 첫/끝 프레임 생성 (FirstFrame + LastFrame)

FileInfos에 FirstFrame과 LastFrame을 한꺼번에 넣으면 두 프레임을 자연스럽게 잇습니다.

LANGUAGE
{
  "SubAppId": 0,
  "ModelName": "wand-vega-video",
  "ModelVersion": "1.0-lite",
  "FileInfos": [
    {
      "Type": "Url",
      "Category": "Image",
      "Usage": "FirstFrame",
      "Url": "https://<cdn>/first.png"
    },
    {
      "Type": "Url",
      "Category": "Image",
      "Usage": "LastFrame",
      "Url": "https://<cdn>/last.png"
    }
  ],
  "Prompt": "smooth transition between the two scenes",
  "OutputConfig": {
    "Resolution": "1080P",
    "Duration": 5,
    "AspectRatio": "16:9",
    "StorageMode": "Temporary"
  }
}

Lite / 멀티모달 참조 (Reference)

이미지, 영상, 오디오를 한꺼번에 넣어 참조 영상을 만듭니다. 이미지는 Usage="Reference"로 지정합니다.

LANGUAGE
{
  "SubAppId": 0,
  "ModelName": "wand-vega-video",
  "ModelVersion": "1.0-lite",
  "FileInfos": [
    {
      "Type": "Url",
      "Category": "Image",
      "Usage": "Reference",
      "Url": "https://<cdn>/ref1.png"
    },
    {
      "Type": "Url",
      "Category": "Image",
      "Usage": "Reference",
      "Url": "https://<cdn>/ref2.png"
    },
    {
      "Type": "Url",
      "Category": "Video",
      "Usage": "Reference",
      "Url": "https://<cdn>/ref.mp4"
    }
  ],
  "Prompt": "blend the subjects naturally into the reference video environment",
  "OutputConfig": {
    "Resolution": "1080P",
    "Duration": 5,
    "AspectRatio": "16:9",
    "StorageMode": "Temporary"
  }
}

응답 및 결과 조회

Pro / 태스크 접수 응답

LANGUAGE
{
  "TaskId": "<task-id>",
  "RequestId": "<request-id>"
}

Pro / 결과 조회

LANGUAGE
{
  "SubAppId": 123456789,
  "TaskId": "<task-id>"
}

Pro / 완료 응답

LANGUAGE
{
  "AigcVideoTask": {
    "Status": "FINISH",
    "ErrCode": 0,
    "Progress": 100,
    "Output": {
      "FileInfos": [
        {
          "FileUrl": "http://<host>.vod2.myqcloud.com/.../aigcVideoGenFile.mp4",
          "ExpireTime": "2026-09-15T10:29:48Z",
          "MetaData": {
            "Width": 1920,
            "Height": 1080,
            "Duration": 5.07,
            "Container": "mov,mp4,m4a",
            "Bitrate": 9494850
          }
        }
      ]
    }
  }
}

Lite / 태스크 접수 응답

생성 요청 접수 시 TaskId를 반환합니다. 해당 ID로 완료 상태와 결과물을 조회합니다.

LANGUAGE
{
  "TaskId": "<task-id>",
  "RequestId": "<request-id>"
}

Lite / 결과 조회

DescribeTaskDetail을 3초 간격으로 폴링합니다. Status가 PROCESSING이면 계속 조회하고, FINISH이면서 ErrCode=0이면 성공, FAIL이면 Message로 원인을 확인합니다.

LANGUAGE
{
  "SubAppId": 0,
  "TaskId": "<task-id>"
}

Lite / 완료 응답

기본 저장 방식은 7일간 유효한 임시 URL입니다. 해당 기간에 다운로드하거나 StorageMode=Permanent로 보관합니다.

LANGUAGE
{
  "AigcVideoTask": {
    "Status": "FINISH",
    "ErrCode": 0,
    "Progress": 100,
    "Output": {
      "FileInfos": [
        {
          "FileUrl": "http://<host>.vod2.myqcloud.com/.../aigcVideoGenFile.mp4",
          "ExpireTime": "2026-09-15T10:29:48Z",
          "MetaData": {
            "Width": 1920,
            "Height": 1080,
            "Duration": 5.07,
            "Container": "mov,mp4,m4a",
            "Bitrate": 9494850
          }
        }
      ]
    }
  }
}

특수 설정

Pro / ExtInfo (AdditionalParameters)

Pro의 ExtInfo는 옵션에 따라 AdditionalParameters 또는 WandVegaParameters 키를 사용합니다. 2중 JSON 인코딩이며 안쪽 객체는 한 번 더 문자열로 감쌉니다.

  • return_last_frame : 결과에 마지막 프레임 이미지를 함께 반환합니다.
  • bitrate_mode : 고화질 모드
LANGUAGE
import json
ext_inner = {
    # "return_last_frame": True,   # 결과에 마지막 프레임 이미지를 함께 반환합니다
    # "bitrate_mode": "high",      # 고화질 모드
}
ext_info = json.dumps({"AdditionalParameters": json.dumps(ext_inner)}, ensure_ascii=False)

전달 예시 (마지막 프레임 받기):

LANGUAGE
{
  "SubAppId": 123456789,
  "ModelName": "wand-vega-video",
  "ModelVersion": "1.0-pro",
  "FileInfos": [
    {
      "Type": "Url",
      "Category": "Image",
      "Usage": "Reference",
      "Url": "https://<cdn>/ref.png"
    }
  ],
  "Prompt": "natural motion, cinematic",
  "OutputConfig": {
    "Resolution": "1080P",
    "Duration": 5,
    "AspectRatio": "16:9",
    "StorageMode": "Temporary"
  },
  "ExtInfo": "{\"AdditionalParameters\":\"{\\\"return_last_frame\\\":true}\"}"
}

return_last_frame=true로 호출하면 Output.FileInfos에 영상과 마지막 프레임 이미지가 함께 들어옵니다. 마지막 프레임의 UsageType은 last_frame_url입니다.

Pro / 작업 유형 선택

ExtInfo 안의 AdditionalParameters에 omni_reference_task_type을 지정합니다.

값 동작 입력 및 출력 조건
auto 입력 소재와 프롬프트로 작업 유형을 자동 판단 버전별 입력 및 출력 규격 적용
reference 이미지 / 영상 / 오디오를 참조하여 새 영상 생성 작업 유형에 따른 추가 비율 / 길이 제약 없음. 버전별 기본 규격은 적용
edit 원본 영상의 화면 또는 오디오 편집 참조 영상 1개 이상, 영상 길이 4~30초. OutputConfig.AspectRatio=adaptive, OutputConfig.Duration=-1
extend 원본 영상을 앞 또는 뒤로 연장 참조 영상 1개 이상. OutputConfig.AspectRatio=adaptive

참조 영상은 FileInfos의 Category=Video, Usage=Reference로 전달합니다. 버전별 영상 입력 길이와 파일 제한도 함께 적용됩니다.

LANGUAGE
import json

ext_info = json.dumps({
    "AdditionalParameters": json.dumps({
        "omni_reference_task_type": "extend"
    })
})

Pro / 모델 옵션 (WandVegaParameters)

파라미터 타입 값 / 동작
EnhancePromptMode String auto / enable / disable. Pro는 생략 또는 auto일 때 disable로 처리합니다. enable은 최적화 사용, disable은 원본 프롬프트 사용
ModerationMode String Moderation_L1: 기본 심사, 기본값. Moderation_L2: 강화 심사
ReturnVegaUsage Boolean 기본값 false. true이면 결과에 사용량 반환

Pro와 Lite는 EnhancePromptMode의 기본 동작이 다릅니다. ModerationMode는 심사 수준을 선택하는 옵션이며 가드레일 해제 옵션이 아닙니다.

LANGUAGE
import json

ext_info = json.dumps({
    "WandVegaParameters": json.dumps({
        "EnhancePromptMode": "enable",
        "ModerationMode": "Moderation_L2",
        "ReturnVegaUsage": True
    })
})

생성 요청의 ExtInfo에 ext_info 문자열을 전달합니다. AdditionalParameters와 WandVegaParameters를 함께 사용할 때는 각각을 JSON 문자열로 만든 뒤 하나의 ExtInfo 객체에 넣고 다시 직렬화합니다.

사용량 응답의 Usage.CompletionTokens는 출력 토큰 수, Usage.TotalTokens는 입력을 포함한 총 토큰 수입니다.

Pro / Seed

같은 Seed 값을 주면 비슷한 결과가 생성됩니다. 재생성 시 안정적인 결과 비교가 필요하면 Seed를 고정합니다.

LANGUAGE
{
  "SubAppId": 123456789,
  "ModelName": "wand-vega-video",
  "ModelVersion": "1.0-pro",
  "Prompt": "a calico cat on a wooden windowsill",
  "Seed": 12345,
  "OutputConfig": {
    "Resolution": "1080P",
    "Duration": 5,
    "AspectRatio": "16:9",
    "StorageMode": "Temporary"
  }
}

Pro / 실사 인물 참조

실사 인물 참조는 소재 그룹 직접 참조 방식을 사용합니다. 이 방식은 Pro에서 지원하며, Lite에서는 지원하지 않습니다.

CreateAigcVideoTask의 FileInfos에 이미지 URL을 넣고, ExtInfo.AdditionalParameters에 asset_group_id를 전달합니다. 처음 사용하는 그룹 이름은 자동 생성됩니다.

LANGUAGE
{
  "SubAppId": 123456789,
  "ModelName": "wand-vega-video",
  "ModelVersion": "1.0-pro",
  "Prompt": "natural motion, soft light",
  "FileInfos": [
    {
      "Type": "Url",
      "Category": "Image",
      "Usage": "Reference",
      "Url": "https://<cdn>/person.jpg"
    }
  ],
  "OutputConfig": {
    "Resolution": "720P",
    "Duration": 5,
    "AspectRatio": "16:9",
    "StorageMode": "Temporary"
  },
  "ExtInfo": "{\"AdditionalParameters\":\"{\\\"asset_group_id\\\":\\\"<your-group-id>\\\"}\"}"
}

소재 그룹 직접 참조는 CreateAigcVideoTask 한 번으로 처리합니다.

Pro / 영구 저장

LANGUAGE
{
  "OutputConfig": {
    "StorageMode": "Permanent",
    "MediaName": "wand-vega-video-pro-sample"
  }
}

Pro 연동 설정

항목 설정 기준 적용 방법
실사 인물 참조 소재 그룹 직접 참조 위 실사 인물 참조 절차 사용
오디오 자체 보유 / 이용 권한을 확보한 음원 참조 오디오로 입력하거나 영상만 생성한 뒤 편집 단계에서 결합

Lite / ExtInfo (WandVegaParameters)

Lite는 ExtInfo의 WandVegaParameters 키로 모델 전용 옵션을 받습니다. 2중 JSON 인코딩이며, 안쪽 객체는 한 번 더 문자열로 감쌉니다.

파라미터 타입 값 / 동작
EnhancePromptMode String auto / enable / disable. 생략 또는 auto는 프롬프트 최적화 사용
ReturnVegaUsage Boolean 사용량 반환 요청. 기본값 false
ModerationMode String Moderation_L1: 기본 심사, 기본값. Moderation_L2: 강화 심사. 가드레일 해제와 별개
GenerateMode String Standard / Fast / StandardMovie
VideoQualityMode String Standard / Fast / SuperFast. OutputConfig.Resolution을 함께 지정

Standard는 일반 생성, Fast는 빠른 생성, StandardMovie는 자연스러운 영화 질감에 사용하는 모드입니다.

LANGUAGE
import json

ext_inner = {
    "EnhancePromptMode": "disable",
    "ReturnVegaUsage": True,
    "GenerateMode": "Standard",
    "VideoQualityMode": "Standard",
}
ext_info = json.dumps({
    "WandVegaParameters": json.dumps(ext_inner)
})

프롬프트 최적화를 끄고 사용량 반환을 요청하는 예시입니다.

LANGUAGE
{
  "SubAppId": 123456789,
  "ModelName": "wand-vega-video",
  "ModelVersion": "1.0-lite",
  "Prompt": "A blue ceramic cup on a wooden table. A slow camera dolly forward, soft natural light.",
  "OutputConfig": {
    "StorageMode": "Temporary",
    "Resolution": "480P",
    "AspectRatio": "16:9",
    "Duration": 4,
    "AudioGeneration": "Disabled"
  },
  "ExtInfo": "{\"WandVegaParameters\":\"{\\\"EnhancePromptMode\\\":\\\"disable\\\",\\\"ReturnVegaUsage\\\":true}\"}"
}

사용량이 반환되면 AigcVideoTask.Output.Usage.CompletionTokens는 출력 토큰 수, AigcVideoTask.Output.Usage.TotalTokens는 입력을 포함한 총 토큰 수입니다.

Lite / 영구 저장

결과를 VOD 미디어 자산으로 남기려면 OutputConfig.StorageMode를 Permanent로 지정합니다. 이후에는 일반 VOD 미디어와 동일하게 관리할 수 있습니다.

LANGUAGE
{
  "OutputConfig": {
    "StorageMode": "Permanent",
    "MediaName": "wand-vega-video-lite-sample"
  }
}

가드레일 해제

입력과 출력 심사를 각각 설정할 수 있습니다.

가드레일 해제 파라미터를 사용하려면 먼저 영업담당자에게 연락해 사용 권한을 확인해야 합니다. 지원 엔진에서도 해당 파라미터를 명시적으로 전달하는 경우에만 가드레일 해제가 적용됩니다. 파라미터를 생략하면 해제되지 않습니다.

파라미터 해제 값 적용 대상
OutputConfig.InputComplianceCheck Disabled 입력 심사 해제
OutputConfig.OutputComplianceCheck Disabled 출력 심사 해제

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

LANGUAGE
{
  "OutputConfig": {
    "InputComplianceCheck": "Disabled",
    "OutputComplianceCheck": "Disabled"
  }
}

Contact us about WAND