WAND-Vega-VideoHOT

Endpoint: POST https://vod.intl.tencentcloudapi.comAction: CreateAigcVideoTask

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

WAND-Vega-Video Pro / 720P

WAND-Vega-Video 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 요청 예시

json

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

json

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

json

{
  "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)

json

{
  "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을 사용합니다.

json

{
  "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)

json

{
  "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)

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

json

{
  "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"을 지정하면 끝 프레임만 고정합니다. 시작점은 모델이 자유롭게 잡습니다.

json

{
  "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을 한꺼번에 넣으면 두 프레임을 자연스럽게 잇습니다.

json

{
  "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"로 지정합니다.

json

{
  "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 / 태스크 접수 응답

json

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

Pro / 결과 조회

json

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

Pro / 완료 응답

json

{
  "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로 완료 상태와 결과물을 조회합니다.

json

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

Lite / 결과 조회

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

json

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

Lite / 완료 응답

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

json

{
  "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 : 고화질 모드

python

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

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

json

{
  "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로 전달합니다. 버전별 영상 입력 길이와 파일 제한도 함께 적용됩니다.

python

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는 심사 수준을 선택하는 옵션이며 가드레일 해제 옵션이 아닙니다.

python

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를 고정합니다.

json

{
  "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를 전달합니다. 처음 사용하는 그룹 이름은 자동 생성됩니다.

json

{
  "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 / 영구 저장

json

{
  "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는 자연스러운 영화 질감에 사용하는 모드입니다.

python

import json

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

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

json

{
  "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 미디어와 동일하게 관리할 수 있습니다.

json

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

가드레일 해제

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

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

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

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

json

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

WAND-Vega-VideoHOT ​

기본 정보 ​

버전별 지원 규격 ​

1.5 Pro ​

1.5 Pro 참조 이미지 ​

1.5 Pro 참조 영상 / 오디오 ​

1.0 Pro ​

1.0 Pro 참조 이미지 ​

1.0 Pro 참조 영상 / 오디오 ​

1.0 Lite ​

1.0 Lite 참조 이미지 ​

1.0 Lite 참조 영상 / 오디오 ​

요청 파라미터 ​

Pro 요청 파라미터 ​

Pro / 출력 해상도 ​

Lite 요청 파라미터 ​

Lite / 출력 해상도 ​

요청 예시 ​

1.5 Pro 요청 예시 ​

1.0 Pro 요청 예시 ​

1.0 Lite 요청 예시 ​

Pro 요청 예시 ​

Pro / 첫 프레임 생성 (FirstFrame) ​

Pro / 끝 프레임 생성 (LastFrame) ​

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

Lite 요청 예시 ​

Lite / 첫 프레임 생성 (FirstFrame) ​

Lite / 끝 프레임 생성 (LastFrame) ​

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

Lite / 멀티모달 참조 (Reference) ​

응답 및 결과 조회 ​

Pro / 태스크 접수 응답 ​

Pro / 결과 조회 ​

Pro / 완료 응답 ​

Lite / 태스크 접수 응답 ​

Lite / 결과 조회 ​

Lite / 완료 응답 ​

특수 설정 ​

Pro / ExtInfo (AdditionalParameters) ​

Pro / 작업 유형 선택 ​

Pro / 모델 옵션 (WandVegaParameters) ​

Pro / Seed ​

Pro / 실사 인물 참조 ​

Pro / 영구 저장 ​

Pro 연동 설정 ​

Lite / ExtInfo (WandVegaParameters) ​

Lite / 영구 저장 ​

가드레일 해제 ​

WAND-Vega-VideoHOT

기본 정보

버전별 지원 규격

1.5 Pro

1.5 Pro 참조 이미지

1.5 Pro 참조 영상 / 오디오

1.0 Pro

1.0 Pro 참조 이미지

1.0 Pro 참조 영상 / 오디오

1.0 Lite

1.0 Lite 참조 이미지

1.0 Lite 참조 영상 / 오디오

요청 파라미터

Pro 요청 파라미터

Pro / 출력 해상도

Lite 요청 파라미터

Lite / 출력 해상도

요청 예시

1.5 Pro 요청 예시

1.0 Pro 요청 예시

1.0 Lite 요청 예시

Pro 요청 예시

Pro / 첫 프레임 생성 (FirstFrame)

Pro / 끝 프레임 생성 (LastFrame)

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

Lite 요청 예시

Lite / 첫 프레임 생성 (FirstFrame)

Lite / 끝 프레임 생성 (LastFrame)

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

Lite / 멀티모달 참조 (Reference)

응답 및 결과 조회

Pro / 태스크 접수 응답

Pro / 결과 조회

Pro / 완료 응답

Lite / 태스크 접수 응답

Lite / 결과 조회

Lite / 완료 응답

특수 설정

Pro / ExtInfo (AdditionalParameters)

Pro / 작업 유형 선택

Pro / 모델 옵션 (WandVegaParameters)

Pro / Seed

Pro / 실사 인물 참조

Pro / 영구 저장

Pro 연동 설정

Lite / ExtInfo (WandVegaParameters)

Lite / 영구 저장

가드레일 해제