{
  "endpoint": "vod.intl.tencentcloudapi.com",
  "action": "CreateAigcImageTask",
  "region": "ap-seoul",
  "auth": "TC3-HMAC-SHA256",
  "request": {
    "SubAppId": "150003****",
    "ModelName": "",
    "ModelVersion": "",
    "Prompt": "A clean product-style capybara mascot image, studio lighting",
    "NegativePrompt": "low quality, distorted, blurry",
    "EnhancePrompt": "Enabled",
    "OutputConfig": {
      "StorageMode": "Temporary",
      "AspectRatio": "1:1"
    }
  }
}

{
  "Response": {
    "TaskId": "150003****-AigcImageTask-XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXT",
    "RequestId": "XXXXXXXX-****-XXXXXXXXXXXX"
  }
}

curl -X POST https://vod.intl.tencentcloudapi.com \
  -H "Content-Type: application/json; charset=utf-8" \
  -H "X-TC-Action: CreateAigcVideoTask" \
  -H "X-TC-Version: 2018-07-17" \
  -H "X-TC-Region: ap-seoul" \
  -H "Authorization: TC3-HMAC-SHA256 Credential=$YOUR_SECRET_ID/..." \
  -d '{
    "SubAppId": $SUBAPP_ID,
    "ModelName": "Kling",
    "ModelVersion": "3.0-Omni",
    "Prompt": "A capybara mascot moves gently in a short studio video",
    "OutputConfig": {
      "Duration": 5,
      "Resolution": "720P"
    }
  }'

{
  "endpoint": "vod.intl.tencentcloudapi.com",
  "action": "CreateAigcVideoTask",
  "region": "ap-seoul",
  "auth": "TC3-HMAC-SHA256",
  "request": {
    "SubAppId": "150003****",
    "ModelName": "",
    "ModelVersion": "",
    "Prompt": "A capybara mascot moves gently in a short studio video",
    "NegativePrompt": "low quality, distorted, flicker, blurry",
    "EnhancePrompt": "Enabled",
    "OutputConfig": {
      "StorageMode": "Temporary",
      "Duration": 5,
      "Resolution": "720P",
      "AspectRatio": "16:9",
      "AudioGeneration": "Disabled"
    }
  }
}

{
  "Response": {
    "TaskId": "150003****-AigcVideoTask-XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXT",
    "RequestId": "XXXXXXXX-****-XXXXXXXXXXXX"
  }
}

{
  "SubAppId":     0,
  "ModelName":    "Kling",
  "ModelVersion": "2.1",
  "Prompt":       "smooth bridge between two scenes",
  "FileInfos": [
    { "Type": "Url", "Category": "Image", "Url": "https://example.com/start.png", "Usage": "FirstFrame" }
  ],
  "LastFrameUrl": "https://example.com/end.png",
  "OutputConfig": { "StorageMode": "Temporary", "Resolution": "1080P", "Duration": 5 }
}

{
  "SubAppId":     0,
  "ModelName":    "Kling",
  "ModelVersion": "3.0-Omni",
  "Prompt":       "create a new scene combining the references",
  "FileInfos": [
    { "Type": "Url", "Category": "Image", "Url": "https://example.com/ref-a.png", "Usage": "Reference" },
    { "Type": "Url", "Category": "Image", "Url": "https://example.com/ref-b.png", "Usage": "Reference" }
  ],
  "EnhancePrompt": "Enabled",
  "OutputConfig": { "StorageMode": "Temporary", "Resolution": "1080P", "Duration": 5, "AspectRatio": "16:9", "AudioGeneration": "Enabled" }
}

{
  "SubAppId":           0,
  "ElementName":        "samurai-hero",
  "ElementDescription": "main character of cyberpunk short film",
  "ReferenceType":      "image_refer",
  "ElementImageList":   "{\"frontal_image\":\"https://example.com/face.png\",\"refer_images\":[{\"image_url\":\"https://example.com/a.png\"},{\"image_url\":\"https://example.com/b.png\"}]}",
  "DisableModeration":  "True"
}

{
  "Response": {
    "TotalCount": 3,
    "ElementSet": [
      { "Id": "313829804205144", "Name": "samurai-hero", "Description": "...", "VoiceId": "", "CreateTime": "2026-06-19T08:38:37Z" }
    ],
    "RequestId": "..."
  }
}

{
  "SubAppId":     0,
  "ModelName":    "Kling",
  "ModelVersion": "3.0-Omni",
  "SubjectInfos": [
    { "Id": "313829804205144" },
    { "Id": "313829801220307" }
  ],
  "Prompt": "let <<<element_1>>> hold <<<element_2>>>'s hand on a beach at sunset",
  "OutputConfig": { "StorageMode": "Temporary", "Resolution": "1080P", "Duration": 5 }
}

{ "SubAppId": 0, "ElementId": "313829804205144" }

{
  "SubAppId":     0,
  "ModelName":    "Vidu",
  "ModelVersion": "q2-pro",
  "SubjectInfos": [
    {
      "Name": "Princess",
      "ImageUrls": [ "https://example.com/princess-1.png", "https://example.com/princess-2.png" ]
    }
  ],
  "Prompt": "[@Princess] sits on a throne and smiles",
  "OutputConfig": { "StorageMode": "Temporary", "Resolution": "1080P", "Duration": 4 }
}

import json

inner = {
    "multi_shot":  True,
    "shot_type":   "customize",   # 또는 "intelligence"
    "multi_prompt": [
        { "index": 1, "prompt": "wide shot, robot enters alley", "duration": 2 },
        { "index": 2, "prompt": "close-up, robot eyes glow",     "duration": 3 }
    ]
}
ext_info = json.dumps({
    "AdditionalParameters": json.dumps(inner, ensure_ascii=False)
}, ensure_ascii=False)

import os, json, time
from tencentcloud.common import credential
from tencentcloud.common.profile.client_profile import ClientProfile
from tencentcloud.common.profile.http_profile import HttpProfile
from tencentcloud.common.common_client import CommonClient

cred = credential.Credential(
    os.environ["TENCENTCLOUD_SECRET_ID"],
    os.environ["TENCENTCLOUD_SECRET_KEY"],
)
hp = HttpProfile(); hp.endpoint = "vod.intl.tencentcloudapi.com"
cp = ClientProfile(); cp.httpProfile = hp
client = CommonClient("vod", "2018-07-17", cred, "ap-seoul", profile=cp)

# 1) 캐릭터 등록
elem_image_list = json.dumps({
    "frontal_image": "https://example.com/face.png",
    "refer_images": [
        {"image_url": "https://example.com/a.png"},
        {"image_url": "https://example.com/b.png"},
    ],
}, ensure_ascii=False)

resp = client.call_json("CreateAigcAdvancedCustomElement", {
    "SubAppId":           0,
    "ElementName":        "samurai-hero",
    "ElementDescription": "main character",
    "ReferenceType":      "image_refer",
    "ElementImageList":   elem_image_list,
    "DisableModeration":  "True",
})
register_task_id = resp["Response"]["TaskId"]

# 2) 약 30초 후 등록 목록 조회로 진짜 ID 회수
time.sleep(30)
list_resp = client.call_json("DescribeAigcAdvancedCustomElements", {"SubAppId": 0, "Limit": 50})
elem_id = next(
    e["Id"] for e in list_resp["Response"]["ElementSet"]
    if e["Name"] == "samurai-hero"
)

# 3) 캐릭터를 사용해 영상 생성
resp = client.call_json("CreateAigcVideoTask", {
    "SubAppId":     0,
    "ModelName":    "Kling",
    "ModelVersion": "3.0-Omni",
    "SubjectInfos": [{"Id": elem_id}],
    "Prompt":       "<<<element_1>>> walks through a misty bamboo forest at dawn",
    "OutputConfig": {"StorageMode": "Temporary", "Resolution": "1080P", "Duration": 5, "AspectRatio": "16:9"},
})
video_task_id = resp["Response"]["TaskId"]

# 4) 폴링 (DescribeTaskDetail → Response.AigcVideoTask)
while True:
    detail = client.call_json("DescribeTaskDetail", {"SubAppId": 0, "TaskId": video_task_id})
    avt = detail["Response"]["AigcVideoTask"]
    status = avt["Status"]                      # PROCESSING / FINISH / FAIL
    if status == "FINISH":
        print("done:", avt["Output"]["FileInfoSet"][0]["FileUrl"]); break
    if status == "FAIL":
        print("failed:", avt.get("Message")); break
    time.sleep(6)

{
    "ModelName": "Kling",
    "SceneType": "sfx",
    "Prompt": "Fireworks sound during celebration",
    "OutputConfig": {
        "StorageMode": "Temporary",
        "Duration": 6
    }
}

{
    "ModelName": "MiniMaxMusic",
    "ModelVersion": "2.0",
    "SceneType": "music",
    "Prompt": "A cheerful pop song",
    "AdditionalParameters": "{\"lyrics\": \"Hello world, this is my song\"}",
    "OutputConfig": {
        "StorageMode": "Temporary",
        "OutputAudioFormat": "mp3"
    }
}

{
    "SubAppId": 0,
    "ModelName": "GL",
    "ModelVersion": "3.0-clip",
    "SceneType": "music",
    "Prompt": "Cinematic orchestral build-up, hopeful, 30-second clip",
    "OutputConfig": {
        "StorageMode": "Temporary",
        "OutputAudioFormat": "mp3"
    }
}

{
    "TaskType": "AigcAudioTask",
    "Status": "FINISH",
    "CreateTime":      "2026-06-07T15:24:05Z",
    "BeginProcessTime":"2026-06-07T15:24:05Z",
    "FinishTime":      "2026-06-07T15:24:23Z",
    "AigcAudioTask": {
        "TaskId":   "***-AigcAudioTask-***t",
        "Status":   "FINISH",
        "ErrCode":  0,
        "Progress": 100,
        "Input": {
            "ModelName":     "GL",
            "ModelVersion":  "3.0-clip",
            "SceneType":     "music",
            "Prompt":        "Cinematic orchestral build-up, hopeful, 30-second clip",
            "OutputConfig":  { "StorageMode": "Temporary", "OutputAudioFormat": "mp3" }
        },
        "Output": {
            "AudioInfos": [{
                "StorageMode": "Temporary",
                "FileUrl":     "http://***.vod2.myqcloud.com/.../aigcAudioGenFile.mp3",
                "ExpireTime":  "2026-06-14T15:24:25Z",
                "MetaData": {
                    "Size":          744610,
                    "Container":     "mp3",
                    "Bitrate":       193580,
                    "Duration":      30.772,
                    "AudioStreamSet": [{ "Bitrate": 192000, "SamplingRate": 44100, "Codec": "mp3" }],
                    "AudioDuration": 30.772
                }
            }]
        }
    }
}

{
    "SubAppId": 0,
    "ModelName": "GL",
    "ModelVersion": "3.0-pro",
    "SceneType": "music",
    "Prompt": "Energetic synth-pop instrumental with retro 80s vibes, driving drum machine, bright lead synth, full song structure",
    "OutputConfig": {
        "StorageMode": "Temporary",
        "OutputAudioFormat": "mp3"
    }
}

{
    "TaskType": "AigcAudioTask",
    "Status": "FINISH",
    "CreateTime":      "2026-06-07T17:08:36Z",
    "BeginProcessTime":"2026-06-07T17:08:36Z",
    "FinishTime":      "2026-06-07T17:09:26Z",
    "AigcAudioTask": {
        "TaskId":   "***-AigcAudioTask-***t",
        "Status":   "FINISH",
        "ErrCode":  0,
        "Progress": 100,
        "Input": {
            "ModelName":     "GL",
            "ModelVersion":  "3.0-pro",
            "SceneType":     "music",
            "Prompt":        "Energetic synth-pop instrumental with retro 80s vibes, driving drum machine, bright lead synth, full song structure",
            "OutputConfig":  { "StorageMode": "Temporary", "OutputAudioFormat": "mp3" }
        },
        "Output": {
            "AudioInfos": [{
                "StorageMode": "Temporary",
                "FileUrl":     "http://***.vod2.myqcloud.com/.../aigcAudioGenFile.mp3",
                "ExpireTime":  "2026-06-14T17:09:26Z",
                "MetaData": {
                    "Size":          3748900,
                    "Container":     "mp3",
                    "Bitrate":       192311,
                    "Duration":      155.95,
                    "AudioStreamSet": [{ "Bitrate": 192000, "SamplingRate": 44100, "Codec": "mp3" }],
                    "AudioDuration": 155.951
                }
            }]
        }
    }
}

{
    "SubAppId": 1500044236,
    "ModelName": "Hunyuan",
    "ModelVersion": "3d_2.0",
    "Prompt": "A futuristic cyberpunk city at night with neon lights",
    "OutputConfig": {
        "StorageMode": "Permanent"
    },
    "SceneType": "3d_panorama"
}

{
    "SubAppId": 1500044236,
    "ModelName": "Hunyuan",
    "ModelVersion": "3d_2.0",
    "Prompt": "A traditional Korean hanok village surrounded by autumn foliage, photorealistic rendering, 8K resolution",
    "OutputConfig": {
        "StorageMode": "Temporary",
        "Duration": 16,
        "Resolution": "1080P",
        "AudioGeneration": "Enabled"
    },
    "SceneType": "3d_scene"
}

{
    "Response": {
        "RequestId": "c3cef9a9-66af-4735-a6eb-ef03019b75f4",
        "TaskId": "2600012260-AigcImage-743691911ecf4003a5ed2f25343fc38f"
    }
}

import json
from tencentcloud.common import credential
from tencentcloud.common.profile.client_profile import ClientProfile
from tencentcloud.common.profile.http_profile import HttpProfile
from tencentcloud.mps.v20190612 import mps_client, models

cred = credential.Credential("YOUR_SECRET_ID", "YOUR_SECRET_KEY")
httpProfile = HttpProfile()
httpProfile.endpoint = "mps.intl.tencentcloudapi.com"
clientProfile = ClientProfile()
clientProfile.httpProfile = httpProfile
client = mps_client.MpsClient(cred, "ap-seoul", clientProfile)

req = models.CreateAigcVideoTaskRequest()
params = {
    "ModelName": "Kling",
    "ModelVersion": "3.0-turbo",
    "Prompt": "A cat walking gracefully on a sunny windowsill, cinematic",
    "ImageInfos": [{
        "ImageUrl": "https://example.com/cat-photo.jpg"
    }],
    "AdditionalParameters": json.dumps({
        "duration": 5,
        "resolution": "1080P",
        "aspect_ratio": "16:9"
    })
}
req.from_json_string(json.dumps(params))
resp = client.CreateAigcVideoTask(req)
print(resp.to_json_string())
# {"TaskId": "2600012260-AigcVideo-xxxx", "RequestId": "..."}

tccli mps CreateAigcVideoTask \
  --endpoint mps.intl.tencentcloudapi.com \
  --region ap-seoul \
  --ModelName "Kling" \
  --ModelVersion "3.0-turbo" \
  --Prompt "Ocean waves crashing on rocks at sunset, cinematic" \
  --AdditionalParameters '{"duration":5,"resolution":"1080P","aspect_ratio":"16:9"}'

{
    "Response": {
        "RequestId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
        "TaskId": "2600012260-AigcVideo-9f8e7d6c5b4a39281706f5e4d3c2b1a0"
    }
}

{
    "Response": {
        "Status": "DONE",
        "ImageUrls": [
            "https://aigc-output-image-***.cos.ap-guangzhou.myqcloud.com/.../2600012260-AigcImage-***_0.jpg?q-sign-algorithm=sha1&q-ak=***&q-sign-time=***"
        ],
        "Message": "ok",
        "RequestId": "bf66c45d-2324-417f-a545-d3b60bde2645"
    }
}

{
    "Response": {
        "Status": "DONE",
        "VideoUrls": [
            "https://aigc-output-video-***.cos.ap-guangzhou.myqcloud.com/.../2600012260-AigcVideo-***_0.mp4?q-sign-algorithm=sha1&q-ak=***&q-sign-time=***"
        ],
        "Resolution": "1920x1088",
        "Message": "ok",
        "RequestId": "7e6d5c4b-3a29-1807-f6e5-d4c3b2a10987"
    }
}

tccli mps DescribeUsageData \
  --endpoint mps.intl.tencentcloudapi.com \
  --region ap-seoul \
  --StartTime "2026-06-01T00:00:00+09:00" \
  --EndTime "2026-06-01T23:59:59+09:00"

{
    "Response": {
        "Data": [
            {
                "TaskType": "Transcode",
                "Summary": [
                    {"Time": "2026-06-01T00:00:00+09:00", "Count": 12, "Usage": 12}
                ]
            }
        ],
        "RequestId": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
    }
}

import time, json
from tencentcloud.mps.v20190612 import mps_client, models

# ... client setup omitted (see above) ...

# After CreateAigcImageTask / CreateAigcVideoTask:
task_id = "your-task-id-here"

while True:
    # For Image:
    req = models.DescribeAigcImageTaskRequest()
    # For Video: req = models.DescribeAigcVideoTaskRequest()
    req.from_json_string(json.dumps({"TaskId": task_id}))
    resp = json.loads(client.DescribeAigcImageTask(req).to_json_string())
    # For Video: resp = json.loads(client.DescribeAigcVideoTask(req).to_json_string())

    status = resp.get("Status", "")

    if status == "DONE":
        # Success - extract URLs
        urls = resp.get("ImageUrls", [])      # For Video: resp.get("VideoUrls", [])
        print(f"Result: {urls[0]}")
        break
    elif status == "FAIL":
        raise RuntimeError(f"Task failed: {resp.get('Message')}")
    else:  # WAIT / RUN
        print(f"Status: {status} ...")
        time.sleep(6)

# 서브 애플리케이션 생성
tccli vod CreateSubAppId \
  --region ap-seoul \
  --Name "my-vod-app" \
  --Description "Demo VOD application"

# 생성된 SubAppId 목록 조회
tccli vod DescribeSubAppIds --region ap-seoul

tccli vod PullUpload \
  --region ap-seoul \
  --SubAppId 1500000000 \
  --MediaUrl "https://example.com/sample.mp4" \
  --MediaName "sample-video"

tccli vod ProcessMedia \
  --region ap-seoul \
  --SubAppId 1500000000 \
  --FileId "5285890799710174442" \
  --MediaProcessTask '{"TranscodeTaskSet":[{"Definition":100}]}'