Kling

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

기본 정보

항목	값
ModelName	Kling
ModelVersion	3.0-Omni / 3.0 / O1 / 2.1
기본값	ModelVersion=3.0 / AspectRatio=1:1
가드레일 해제 지원	미지원

버전별 지원 규격

버전	출력 규격	입력 및 조건
공통	비율: 1:1 / 16:9 / 9:16 / 4:3 / 3:4 출력 장수: VOD OutputImageCount: 1–9	—

요청 파라미터

파라미터	필수	타입	설명
ModelName	필수	String	고정값 Kling
ModelVersion	선택	String	3.0-Omni / 3.0 / O1 / 2.1
Prompt	필수	String	생성 프롬프트
FileInfos.N	선택	Array	참조 이미지(image-to-image). Category는 Image
OutputConfig.AspectRatio	선택	String	1:1 / 16:9 / 9:16 / 4:3 / 3:4 등
OutputConfig.OutputImageCount	선택	Integer	생성 장수 (모델별 상한 상이)

요청 예시

{
  "SubAppId": 123456789,
  "ModelName": "Kling",
  "ModelVersion": "3.0",
  "Prompt": "a serene japanese garden, soft morning light",
  "OutputConfig": {
    "AspectRatio": "1:1",
    "OutputImageCount": 1,
    "StorageMode": "Temporary"
  },
  "SessionContext": "job-001"
}

참조 이미지 요청

{
  "SubAppId": 123456789,
  "ModelName": "Kling",
  "ModelVersion": "3.0",
  "Prompt": "Change the background to a quiet garden; preserve the subject.",
  "OutputConfig": {
    "AspectRatio": "1:1",
    "OutputImageCount": 1,
    "StorageMode": "Temporary"
  },
  "SessionContext": "job-001",
  "FileInfos": [
    {
      "Type": "Url",
      "Category": "Image",
      "Url": "https://<host>/reference.jpg"
    }
  ]
}

응답 예시

{
  "AigcImageTask": {
    "Status": "FINISH",
    "ErrCode": 0,
    "Progress": 100,
    "Output": {
      "FileInfos": [
        {
          "FileUrl": "http://<host>.vod2.myqcloud.com/.../aigcImageGenFile.png",
          "ExpireTime": "2026-08-01T10:29:48Z",
          "MetaData": {
            "Width": 1024,
            "Height": 1024,
            "Container": "png"
          }
        }
      ]
    }
  }
}