VS
Endpoint: POST https://vod.intl.tencentcloudapi.comAction: 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 지정 |
요청 예시
json
{
"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"
}
}응답 예시
json
{
"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 |
json
{
"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
json
{
"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
json
{
"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로 지정하면 고비트레이트로 출력합니다.
json
{
"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일 때 적용됩니다.