You need to enable JavaScript to run this app.
导航
veImageX
  • 文档首页
    • /veImageX/API 参考/附录/AI 图像处理模板
AI 图像处理模板
最近更新时间：2025.05.09 18:57:03首次发布时间：2025.03.28 15:37:07
我的收藏
有用
有用
无用
无用

AIGC 图像超分修复

利用 AI 能力，在保证与原图内容一致性的前提下，能够适当地生成一些丢失的细节信息，提升图片整体画面的质感和观感。当原图画质中等或较差时，能够在去噪、去伪影的同时，保持和增加一些自然的纹理细节，显著提升清晰度。功能详细介绍参看 AIGC 图像超分修复。

模板 ID

system_workflow_ai_super_resolution

输入参数

输入参数需要将 JSON 序列化为字符串后作为 AIProcess 或 CreateImageAITask 接口的 WorkflowParameter 参数传入。

参数
说明
Input
输入图像信息。
调用同步处理接口 AIProcess 时需要传入，调用异步处理接口 CreateImageAITask 时无需传入。
ObjectKey
当指定 DataType 为 url 时，传入公网可访问的图像 url 地址。当指定 DataType 为 uri 时，传入 veImageX 对应服务 ID 中的图像对象名（不含 tos-*-i-* 前缀）。
传入图片的短边不小于 256 px，长边不大于 2048 px，大小不超过 10 MB。
DataType
需要提交的图片数据类型，取值为 url 或 uri。
GenDREnhanceParam
AIGC 超分参数。
Multiple
超分倍率，可以为小数，最大不建议超过 30。
若同时指定 Multiple 和 TargetWidth / TargetHeight，则优先使用 Multiple。
TargetWidth
超分目标图片宽度，不能超过 10240 px。
超分目标图片的宽高比率必须与原图保持一致，若不一致则以缩放比例小的边为准，缩放比例指目标长度/原始长度，另一边自动缩放。
若指定一边为 0，则以有数值的一边为准。
TargetHeight
超分目标图片高度，不能超过 10240 px。
ModelId
保留参数，无需填写。

输入参数示例：

{
    "Input":
    {
        "ObjectKey": "8b3f3cc3bfc8a716ffe***eb3b814c3e.webp",
        "DataType": "uri"
    },
    "GenDREnhanceParam":
    {
        "Multiple": 1.2,
        "TargetWidth": 1024,
        "TargetHeight": 1024,
        "ModelId": ""
    }
}

输出参数

veImageX 服务会将输出参数序列化为字符串后作为 AIProcess 接口的 Result.Output 参数、GetImageAIDetails 的 Result.ExecInfo.ExecOutput.Output 参数、或 CreateImageAITask 接口的回调返回。

说明

产出的图像在控制台资源管理页面默认不展示，需要通过文件名搜索。

参数

说明

ObjectKey

产出图像的完整存储路径。

Size

产出图像的大小，单位是字节。

Format

产出图像的格式。

输出参数示例：

{
    "ObjectKey": "veImageX-store/ai_super_resolution/67****/example.webp",
    "Size": 38656,
    "Format": "webp"
}

电商万创

电商万创附加组件利用 AI 能力，通过创意流配置，实现生成图等功能，为电商平台、垂直品牌厂商及电商平台工具提供专业级商品创作能力，提升商品货架素材质量并降低经营成本。功能详细介绍参看电商万创。

模板 ID

system_workflow_product_img

输入参数

输入参数需要将 JSON 序列化为字符串后作为 AIProcess 或 CreateImageAITask 接口的 WorkflowParameter 参数传入。

参数
说明
Input
输入图像信息。
调用同步处理接口 AIProcess 时需要传入，调用异步处理接口 CreateImageAITask 时无需传入。
ObjectKey
当指定 DataType 为 url 时，传入公网可访问的图像 url 地址。当指定 DataType 为 uri 时，传入 veImageX 对应服务 ID 中的图像对象名（不含 tos-*-i-* 前缀）。
传入图片的宽高、大小等要求请参看对应的附加组件使用限制。
DataType
需要提交的图片数据类型，取值为 url 或 uri。
CreativeFlowId
创意流 ID，从控制台获取。
ComprehensiveEnhance
画质增强参数。
Enable
是否使用画质增强，取值为 true 或 false。
Mode
画质增强模式。
  • 0：（推荐）通用画质提升，适用于通用场景的图像，平衡码率与画质。
  • 1：显著画质提升，适用于重点优化画质的场景，但存在码率的浮动上升。
    • ProductAIGC
    生成图片参数。
    Scene
    商品图的使用场景，使用场景决定了最终生成商品图的效果。
  • general：通用。选择通用场景时，需要您填写 PositivePrompt，即用于生图的提示词。
  • natural_pasture：乡村牧场。
  • exhibit_home：家居桌面。
  • exhibit_simple：极简展台。
  • exhibit_kitchen：厨房餐桌。
  • exhibit_bathroom：洗漱桌面。
  • water_reflect：水面光影。
  • water_plants：水面植物。
  • exhibit_light：纯色光影。
  • water_ripples：水面波纹。
  • exhibit_luxury：奢华展台。
  • exhibit_modern：现代风景台。
  • exhibit_stone：植物岩石展台。
  • exhibit_forest：森林植物。
  • exhibit_floor：家居地面。
  • exhibit_toy：玩具展台。
  • exhibit_liquor：洋酒展台。
  • exhibit_wine：葡萄酒展台。
  • exhibit_beer：其他酒类展台。
    • PositivePrompt
    创意场景提示词，仅支持使用英文，包括英文字母、英文标点、数字、空格。提示词建议包括商品放置主体、整体场景、其他物体、光线、色调、图片风格。
    当使用场景选择通用时，必填。选择其他场景时无需填写。
    OutputHeight
    输出图片高度，取值范围为 [512, 1024] px。
    OutputWidth
    输出图片宽度，取值范围为 [512, 1024] px。
    BatchSize
    生成图片的张数，取值范围为 1～4 张。
    ProductRatio
    商品比例，即商品图的大小与结果图输出大小的比例上限。默认值为 0.6，取值范围为 (0,1)，支持一位小数。

    输入参数示例：

    {
    "Input":
    {
        "ObjectKey": "aigc_input.png",
        "DataType": "uri"
    },
    "CreativeFlowId": "6803aa651f57***ee5a6980f",
    "ComprehensiveEnhance":
    {
        "Enable": true,
        "Mode": 1
    },
    "ProductAIGC":
    {
        "Scene": "general",
        "PositivePrompt": "on a empty white table, kitchen, close to window, bright background, background blur, bright light, soft lighting, high quality",
        "OutputHeight": 512,
        "OutputWidth": 512,
        "BatchSize": 2,
        "ProductRatio": 0.6
    }
}

    输出参数

    veImageX 服务会将输出参数序列化为字符串后作为 AIProcess 接口的 Result.Output 参数、GetImageAIDetails 的 Result.ExecInfo.ExecOutput.Output 参数、或 CreateImageAITask 接口的回调返回。

    说明

    产出的图像在控制台资源管理页面默认不展示，需要通过文件名搜索。

    参数
    说明
    GenImgs
    生成的商品图，数组。
    ObjectKey
    产出图像的完整存储路径。
    Size
    产出图像的大小，单位是字节。
    Format
    产出图像的格式。
    DownloadObjectKey
    原图存储路径。当输入图片的 DataType 为 url 时，原图会被存储到创意流绑定的服务下，并通过本参数返回存储路径。

    输出参数示例：

    {
    "GenImgs":
    [
        {
            "ObjectKey": "veImageX-store/6803aa651f57***ee5a6980f/生成图/217a5554-a557-4f8a-970b-1b171d27ed95/83a976bc52afe4ec27d5b74b7e433a***1eaaa6da0be53dd2088ff9986b4cce3.png",
            "Size": 454305,
            "Format": "png"
        },
        {
            "ObjectKey": "veImageX-store/6803aa651f57***ee5a6980f/生成图/217a5554-a557-4f8a-970b-1b171d27ed95/aed7479a166e5fdc253eb8dc23b2de9***4059e1329931ebc4a06bfbcb058846.png",
            "Size": 549069,
            "Format": "png"
        }
    ],
    "DownloadObjectKey": "veImageX-store/6803aa651f57***ee5a6980f/原始图/217a5554-a557-4f8a-970b-1b171d27ed95/79ba1fc8b2922dd2d973a32b83cb3615***2910ed4da4d12f10fddafb6e672f2.png"
}