WAND wiki
최근 문서

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

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

VS

On this page

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

기본 정보

항목 값
ModelName VS
ModelVersion 2.5 / 2.0 / 2.0-fast / 2.0-mini
기본값 ModelVersion=2.0 / Resolution=1080P
가드레일 해제 지원 미지원

버전별 지원 규격

버전 해상도 비율 길이
2.5 480P / 720P / 1080P / 2K / 4K 21:9 / 16:9 / 4:3 / 1:1 / 3:4 / 9:16 / adaptive 4~30초
2.0 / 2.0-fast / 2.0-mini 480P / 720P / 1080P / 2K / 4K 21:9 / 16:9 / 4:3 / 1:1 / 3:4 / 9:16 / adaptive 4~15초

요청 파라미터

파라미터 필수 타입 설명
ModelName 필수 String 고정값 VS
ModelVersion 선택 String 2.5 / 2.0 / 2.0-fast / 2.0-mini
Prompt 필수 String 생성 프롬프트. 텍스트 입력 모드에서는 반드시 필요
FileInfos.N 선택 Array 참조 입력. Usage는 FirstFrame(첫 프레임), LastFrame(끝 프레임), Reference(참조) 중 하나
FileInfos.N.Type 선택 String File(VOD 미디어 파일) 또는 Url(외부 URL)
FileInfos.N.Category 선택 String Image / Video / Audio
FileInfos.N.Url 선택 String Type이 Url일 때의 파일 주소
FileInfos.N.FileId 선택 String Type이 File일 때의 VOD 미디어 ID
OutputConfig.Resolution 선택 String 480P / 720P / 1080P / 2K / 4K
OutputConfig.Duration 선택 Integer 영상 길이(초). 2.0 계열은 4~15, 2.5는 4~30. -1이면 모델이 길이를 정함
OutputConfig.AspectRatio 선택 String 21:9 / 16:9 / 4:3 / 1:1 / 3:4 / 9:16 / adaptive
OutputConfig.AudioGeneration 선택 String Enabled 시 음향과 화면 동시 출력
OutputConfig.Seed 선택 Integer 난수 시드. 같은 시드와 입력으로 재현 가능
ExtInfo 선택 String AdditionalParameters에 소재 그룹 asset_group_id 또는 고비트레이트 옵션 bitrate_mode 지정

요청 예시

LANGUAGE
{
  "SubAppId": 123456789,
  "ModelName": "VS",
  "ModelVersion": "2.5",
  "Prompt": "A red car moves slowly along a quiet street, smooth camera movement.",
  "OutputConfig": {
    "Resolution": "720P",
    "Duration": 5,
    "AspectRatio": "16:9",
    "StorageMode": "Temporary",
    "AudioGeneration": "Disabled"
  }
}

응답 예시

LANGUAGE
{
  "Response": {
    "AigcVideoTask": {
      "Status": "FINISH",
      "ErrCode": 0,
      "Output": {
        "FileInfos": [
          {
            "StorageMode": "Temporary",
            "MediaName": "",
            "ClassId": 0,
            "ExpireTime": "2026-10-03T10:47:29Z",
            "FileType": "",
            "FileId": "",
            "FileUrl": "https://example.com/output/vs.mp4",
            "FileContent": "",
            "UsageType": "",
            "MetaData": {
              "AudioDuration": 0,
              "AudioStreamSet": [],
              "Bitrate": 15209378,
              "Container": "mov,mp4,m4a,3gp,3g2,mj2",
              "Duration": 5.042,
              "Height": 720,
              "Md5": "",
              "Rotate": 0,
              "Size": 9585711,
              "VideoDuration": 5.042,
              "VideoStreamSet": [
                {
                  "Bitrate": 15170194,
                  "Codec": "h264",
                  "CodecTag": "",
                  "Codecs": "",
                  "DynamicRangeInfo": {
                    "HDRType": "",
                    "Type": "Unknown"
                  },
                  "Fps": 24,
                  "Height": 720,
                  "Width": 1280
                }
              ],
              "Width": 1280
            }
          }
        ]
      }
    },
    "RequestId": "12d90f03-a231-4a6f-9ff8-d2a0f864a6ba"
  }
}

특수 설정

캐릭터 참조 소재

VS 2.5에서 참조 이미지를 소재 그룹으로 관리할 수 있습니다. 이미지 URL과 그룹을 함께 전달하거나, 미리 등록한 소재의 AssetId를 재사용합니다.

소재 그룹 직접 참조

FileInfos에 이미지 URL을 지정하고 ExtInfo.AdditionalParameters에 asset_group_id를 전달합니다. 참조 이미지와 소재 그룹을 하나의 생성 요청에 지정하는 방식입니다.

파라미터 타입 설명
FileInfos.N.Usage String 참조 이미지에 Reference 지정
FileInfos.N.Url String 참조 이미지 URL
asset_group_id String AdditionalParameters에 전달하는 소재 그룹 ID
LANGUAGE
{
  "SubAppId": 123456789,
  "ModelName": "VS",
  "ModelVersion": "2.5",
  "Prompt": "The character in the reference image smiles gently and takes a slow step forward. Preserve the clothing and candy-world background. Static camera.",
  "FileInfos": [
    {
      "Type": "Url",
      "Category": "Image",
      "Usage": "Reference",
      "Url": "https://mpstestmodel-1315536146.cos.ap-singapore.myqcloud.com/justin/wiki-examples/person-reference.jpg"
    }
  ],
  "OutputConfig": {
    "Resolution": "720P",
    "Duration": 5,
    "AspectRatio": "16:9",
    "StorageMode": "Temporary"
  },
  "ExtInfo": "{\"AdditionalParameters\": \"{\\\"asset_group_id\\\": \\\"wiki-vs-reference-20260927\\\"}\"}"
}

등록한 소재 재사용

CreateAigcMaterial로 이미지를 등록한 뒤 반환된 작업 ID를 DescribeTaskDetail로 조회합니다. 등록이 완료되면 결과의 AssetId를 asset:// 주소로 지정합니다.

등록 파라미터 타입 설명
FileInfo Object 등록할 이미지의 입력 방식과 URL
AssetType String 이미지 소재는 Image
GroupId String 소재를 관리할 그룹 ID
AssetName String 소재 이름
IsRealPerson String 실사 인물은 True, 그 외 이미지는 False. True는 기존 그룹 지정 필요
GroupName String 소재 그룹 이름

소재 등록 — CreateAigcMaterial

LANGUAGE
{
  "SubAppId": 123456789,
  "FileInfo": {
    "Type": "Url",
    "Url": "https://mpstestmodel-1315536146.cos.ap-singapore.myqcloud.com/justin/wiki-examples/person-reference.jpg"
  },
  "AssetType": "Image",
  "GroupId": "wiki-vs-reference-20260927",
  "AssetName": "character-reference",
  "IsRealPerson": "False",
  "GroupName": "character-demo"
}

등록한 소재로 영상 생성 — CreateAigcVideoTask

LANGUAGE
{
  "SubAppId": 123456789,
  "ModelName": "VS",
  "ModelVersion": "2.5",
  "Prompt": "The character in the reference image smiles gently and takes a slow step forward. Preserve the clothing and candy-world background. Static camera.",
  "FileInfos": [
    {
      "Type": "Url",
      "Category": "Image",
      "Usage": "Reference",
      "Url": "asset://asset-20260927003512-c9z18"
    }
  ],
  "OutputConfig": {
    "Resolution": "720P",
    "Duration": 5,
    "AspectRatio": "16:9",
    "StorageMode": "Temporary"
  }
}

고비트레이트 출력

ExtInfo에 bitrate_mode를 high로 지정하면 고비트레이트로 출력합니다.

LANGUAGE
{
  "SubAppId": 123456789,
  "ModelName": "VS",
  "ModelVersion": "2.5",
  "Prompt": "a calm sunset over the ocean, cinematic",
  "ExtInfo": "{\"AdditionalParameters\":\"{\\\"bitrate_mode\\\":\\\"high\\\"}\"}",
  "OutputConfig": {
    "Resolution": "1080P",
    "Duration": 5,
    "AspectRatio": "16:9",
    "StorageMode": "Temporary"
  },
  "SessionContext": "job-001"
}

추가 옵션

참조 입력 개수

FileInfos로 넣을 수 있는 참조는 최대 50개입니다. 이미지 30개, 영상 10개, 오디오 10개까지이며 ModelVersion이 2.5일 때 적용됩니다.

Contact us about WAND