SV

Endpoint: POST https://vod.intl.tencentcloudapi.comAction: 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 등

요청 예시

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

응답 예시

{
  "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를 지정하면 그룹이 자동 생성됩니다.

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