Poster Suite

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("<SecretId>", "<SecretKey>")
http_profile = HttpProfile()
http_profile.endpoint = "mps.tencentcloudapi.com"
client = mps_client.MpsClient(cred, "ap-guangzhou", ClientProfile(httpProfile=http_profile))

# auto 모드: 상품 이미지 + Definition + Recipe
params = {
    "InputInfo": {
        "Type": "URL",
        "UrlInputInfo": {"Url": "https://example.com/product.jpg"}
    },
    "OutputStorage": {
        "Type": "COS",
        "CosOutputStorage": {"Bucket": "mybucket-125xxx", "Region": "ap-guangzhou"}
    },
    "OutputDir": "/output/poster_suite_auto/",
    "ImageTask": {
        "AiPosterSuiteConfig": {
            "Mode": "auto",
            "Definition": 50,
            "Recipe": [
                {"Theme": "hero", "Num": 2},
                {"Theme": "detail", "Num": 2}
            ],
            "Language": "zh-CN",
            "PanelRatio": "3:4",
            "PanelResolution": "2K",
            "Model": "WAND-suite-1.0-flash",
            "CustomVariables": [
                {"Type": "MaterialKeyword", "Description": "material keyword"}
            ]
        }
    },
    "AddOnParameter": {
        "ExtPrompt": [
            {"Role": "BrandName", "Prompt": "AURASKIN"},
            {"Role": "Headline", "Prompt": "Keep Revitalizing"},
            {"Role": "UserPrompt", "Prompt": "Bottle is 32cm, emphasize the pump and frosted texture"}
        ]
    }
}

req = models.ProcessImageRequest()
req.from_json_string(json.dumps(params))
resp = client.ProcessImage(req)
print(resp.to_json_string())

# modify 모드: auto 결과의 변수 에코를 9개 전부 다시 전달하고 일부 값만 수정
params["OutputDir"] = "/output/poster_suite_modify/"
params["ImageTask"]["AiPosterSuiteConfig"]["Mode"] = "modify"
params["ImageTask"]["AiPosterSuiteConfig"].pop("CustomVariables")
params["AddOnParameter"] = {
    "ExtPrompt": [
        {"Role": "BrandName", "Prompt": "AURASKIN"},
        {"Role": "Headline", "Prompt": "Gentle yet powerful serum"},
        {"Role": "SellingPointsText", "Prompt": "Hydrating / Firming / Antioxidant"},
        {"Role": "ProductCategory", "Prompt": "Beauty-Skincare"},
        {"Role": "ProductVisualIdentity", "Prompt": "matte glass dropper bottle, amber"},
        {"Role": "TextureDescription", "Prompt": "silky cream"},
        {"Role": "ColorPalette", "Prompt": "#F5C2C7,#A8DADC,#F1FAEE"},
        {"Role": "TargetAudience", "Prompt": "Urban professional women 22-35"},
        {"Role": "SceneContext", "Prompt": "Morning vanity table"},
        {"Role": "UserPrompt", "Prompt": "Make the Headline font one size larger"}
    ]
}

# 태스크 결과 조회
query = models.DescribeImageTaskDetailRequest()
query.from_json_string(json.dumps({"TaskId": "<TaskId>"}))
detail = client.DescribeImageTaskDetail(query)
print(detail.to_json_string())

{
  "Response": {
    "TaskId": "2600007696-WorkflowTask-xxxxxxxx",
    "RequestId": "3c140219-cfe9-470e-b241-907877d6fb03"
  }
}

{
  "TaskId": "2600007696-WorkflowTask-xxxxxxxx",
  "Status": "FINISH",
  "CreateTime": "2026-07-06T10:00:00Z",
  "FinishTime": "2026-07-06T10:05:00Z",
  "VariableEcho": {
    "ExtPrompt": [
      {"Role": "BrandName", "Prompt": "AURASKIN"},
      {"Role": "Headline", "Prompt": "Keep Revitalizing"},
      {"Role": "SellingPointsText", "Prompt": "Hydrating / Firming / Antioxidant"}
    ]
  },
  "Panels": [
    {
      "theme_label": "hero_0",
      "bucket": "mps-bucket-125xxx",
      "region": "ap-guangzhou",
      "path": "/output/poster_suite/hero_0.jpg",
      "cos_uri": "cos://mps-bucket-125xxx/output/poster_suite/hero_0.jpg",
      "url": "https://mps-bucket-125xxx.cos.ap-guangzhou.myqcloud.com/output/poster_suite/hero_0.jpg"
    },
    {
      "theme_label": "hero_1",
      "bucket": "mps-bucket-125xxx",
      "region": "ap-guangzhou",
      "path": "/output/poster_suite/hero_1.jpg",
      "cos_uri": "cos://mps-bucket-125xxx/output/poster_suite/hero_1.jpg",
      "url": "https://mps-bucket-125xxx.cos.ap-guangzhou.myqcloud.com/output/poster_suite/hero_1.jpg"
    }
  ]
}