SV
On this page
Endpoint: POST https://vod.intl.tencentcloudapi.com
Action: CreateAigcVideoTask
기본 정보
| 항목 | 값 |
|---|---|
| ModelName | Seedance |
| ModelVersion | 1.5-pro / 1.0-pro / 1.0-pro-fast / 1.0-lite-i2v |
| 기본값 | ModelVersion=1.5-pro / Resolution=1080P |
| 가드레일 해제 지원 | 미지원 |
버전별 지원 규격
| 버전 | 해상도 | 비율 | 길이 |
|---|---|---|---|
1.5-pro / 1.0-pro / 1.0-pro-fast / 1.0-lite-i2v |
480P / 720P / 1080P / 2K / 4K |
16:9 / 9:16 / 1:1 |
OutputConfig.Duration로 초 단위 지정. 요청 예시 5초 |
요청 파라미터
| 파라미터 | 필수 | 타입 | 설명 |
|---|---|---|---|
ModelName |
필수 | String | 고정값 Seedance |
ModelVersion |
선택 | String | 1.5-pro / 1.0-pro / 1.0-pro-fast / 1.0-lite-i2v |
Prompt |
필수 | String | 생성 프롬프트 |
FileInfos.N |
선택 | Array | 참조 입력. Usage는 FirstFrame(첫 프레임) 또는 Reference(참조) |
OutputConfig.Resolution |
선택 | String | 480P / 720P / 1080P / 2K / 4K |
OutputConfig.Duration |
선택 | Integer | 영상 길이(초) |
OutputConfig.AspectRatio |
선택 | String | 16:9 / 9:16 / 1:1 등 |
요청 예시
LANGUAGE
{
"SubAppId": 123456789,
"ModelName": "Seedance",
"ModelVersion": "1.5-pro",
"Prompt": "a calm sunset over the ocean, cinematic",
"OutputConfig": {
"Resolution": "1080P",
"Duration": 5,
"AspectRatio": "16:9",
"StorageMode": "Temporary"
},
"SessionContext": "job-001"
}응답 예시
LANGUAGE
{
"AigcVideoTask": {
"Status": "FINISH",
"ErrCode": 0,
"Progress": 100,
"Output": {
"FileInfos": [
{
"FileUrl": "http://<host>.vod2.myqcloud.com/.../aigcVideoGenFile.mp4",
"ExpireTime": "2026-08-01T10:29:48Z",
"MetaData": {
"Width": 1920,
"Height": 1080,
"Duration": 5.07,
"Container": "mov,mp4,m4a",
"Bitrate": 9494850
}
}
]
}
}
}특수 설정
캐릭터 참조 소재
캐릭터 이미지는 소재 그룹 직접 참조 또는 소재 등록 방식으로 사용합니다.
소재 그룹 직접 참조
CreateAigcVideoTask 요청으로 처리합니다. FileInfos에 이미지 URL을 지정하고, ExtInfo의 AdditionalParameters에 asset_group_id를 함께 전달합니다. 새 그룹 ID를 지정하면 그룹이 자동 생성됩니다.
LANGUAGE
{
"SubAppId": 123456789,
"ModelName": "Seedance",
"ModelVersion": "1.5-pro",
"Prompt": "the person slowly walks forward",
"FileInfos": [
{
"Type": "Url",
"Category": "Image",
"Usage": "Reference",
"Url": "https://<cdn>/person.jpg"
}
],
"OutputConfig": {
"Resolution": "1080P",
"Duration": 5,
"AspectRatio": "16:9",
"StorageMode": "Temporary"
},
"ExtInfo": "{\"AdditionalParameters\":\"{\\\"asset_group_id\\\":\\\"<your-group-id>\\\"}\"}",
"SessionContext": "job-001"
}등록한 소재 재사용
같은 캐릭터를 여러 작업에서 재사용하려면 CreateAigcMaterial로 등록하고 FileInfos.Url에 asset://<asset-id>를 지정합니다. GroupId는 필수이며, IsRealPerson="False"면 새 그룹도 자동 생성됩니다. IsRealPerson="True"는 기존 그룹을 지정해야 합니다.
소재 등록 결과의 AssetUrl은 서명된 원본 파일 URL입니다. 생성 요청에는 AssetId를 사용합니다.