{ "name": "aiart", "display_name": "腾讯混元生图", "description": "结合输入的文本或图片智能创作出与输入相关的图像内容。", "domain": "ai", "api_version": "2022-12-29", "endpoint": "aiart.tencentcloudapi.com", "actions": [ { "name": "ChangeClothes", "description": "上传正面全身模特照和服装平铺图，生成模特换装后的图片。 生成的换装图片分辨率和模特照分辨率一致。 模特换装默认提供1个并发任务数，代表最多能同时处理1个已提交的任务，上一个任务处理完毕后才能开始处理下一个任务。", "status": "online", "parameters": [ { "name": "ModelUrl", "type": "string", "required": true, "description": "模特图片 Url。 图片限制：单边分辨率小于3000，且大于512，转成 Base64 字符串后小于 8MB。 输入要求： 1、建议上传正面模特图片，至少完整露出应穿着输入指定服装的身体部位（全身、上半身或下半身），无大角度身体偏转或异常姿势。 2、建议上传3:4比例的图片，生成效果更佳。 3、建议模特图片中的原始服装和更换后的服装类别一致，或原始服装在身体上的覆盖范围小于等\ufffd...", "example": "https://cos.ap-guangzhou.myqcloud.com/model.jpg" }, { "name": "ClothesUrl", "type": "string", "required": true, "description": "服装图片 Url。 图片限制：单边分辨率小于3000，大于512，转成 Base64 字符串后小于 8MB。 输入要求： 建议上传服装完整的正面平铺图片，仅包含1个服装主体，服装类型支持上衣、下装、连衣裙，三选一。算法将根据输入的图片，结合服装图片给模特换装。", "example": "https://cos.ap-guangzhou.myqcloud.com/cloth.jpg" }, { "name": "ClothesType", "type": "string", "required": true, "description": "服装类型，需要和服装图片保持一致。 取值： Upper-body：上衣 Lower-body：下装 Dress：连衣裙", "example": "Upper-body" }, { "name": "LogoAdd", "type": "integer", "required": false, "description": "为生成结果图添加标识的开关，默认为1。 1：添加标识。 0：不添加标识。 其他数值：默认按1处理。 建议您使用显著标识来提示结果图使用了 AI 绘画技术，是 AI 生成的图片。", "example": "1" }, { "name": "LogoParam", "type": "object", "required": false, "description": "标识内容设置。 默认在生成结果图右下角添加“图片由 AI 生成”字样，您可根据自身需要替换为其他的标识图片。", "example": "{\"LogoUrl\": \"https://cos.ap-guangzhou.myqcloud.com/logo.jpg\", \"LogoRect\": {\"X\": 10, \"Y\": 10, \"Width\": 20, \"Height\": 20}}", "children": [ { "name": "LogoUrl", "type": "string", "required": false, "description": "水印 Url 注意：此字段可能返回 null，表示取不到有效值。", "example": "https://cos.ap-guangzhou.myqcloud.com/logo.jpg" }, { "name": "LogoImage", "type": "string", "required": false, "description": "水印 Base64，Url 和 Base64 二选一传入，如果都提供以 Url 为准 注意：此字段可能返回 null，表示取不到有效值。", "example": "/9j/4QlQaHR0c...N6a2M5ZCI" }, { "name": "LogoRect", "type": "object", "required": false, "description": "水印图片位于生成结果图中的坐标，将按照坐标对标识图片进行位置和大小的拉伸匹配 注意：此字段可能返回 null，表示取不到有效值。", "example": "{\"X\": 10, \"Y\": 10, \"Width\": 10, \"Height\": 10}", "children": [ { "name": "X", "type": "integer", "required": false, "description": "左上角X坐标 注意：此字段可能返回 null，表示取不到有效值。", "example": "10" }, { "name": "Y", "type": "integer", "required": false, "description": "左上角Y坐标 注意：此字段可能返回 null，表示取不到有效值。", "example": "10" }, { "name": "Width", "type": "integer", "required": false, "description": "方框宽度 注意：此字段可能返回 null，表示取不到有效值。", "example": "10" }, { "name": "Height", "type": "integer", "required": false, "description": "方框高度 注意：此字段可能返回 null，表示取不到有效值。", "example": "10" } ] } ] }, { "name": "RspImgType", "type": "string", "required": false, "description": "返回图像方式（base64 或 url) ，二选一，默认为 base64。url 有效期为1小时。 生成图分辨率较大时建议选择 url，使用 base64 可能因图片过大导致返回失败。", "example": "url" } ], "required": [ "ModelUrl", "ClothesUrl", "ClothesType" ] }, { "name": "GenerateAvatar", "description": "百变头像接口将根据输入的人像照片，生成风格百变的头像。 百变头像默认提供1个并发任务数，代表最多能同时处理1个已提交的任务，上一个任务处理完毕后才能开始处理下一个任务。", "status": "online", "parameters": [ { "name": "Type", "type": "string", "required": false, "description": "图像类型，默认为人像。 human：人像头像，仅支持人像图片输入，建议避免上传无人、多人、人像过小的图片。 pet：萌宠贴纸，仅支持动物图片输入，建议避免上传无动物、多动物、动物过小的图片。", "example": "human" }, { "name": "Style", "type": "string", "required": false, "description": "头像风格，仅在人像模式下生效。 若使用人像模式，请在 [百变头像风格列表](https://cloud.tencent.com/document/product/1668/107741) 中选择期望的风格，传入风格编号，不传默认使用 flower 风格。 若使用萌宠贴纸模式，无需选择风格，该参数不生效。", "example": "flower" }, { "name": "InputImage", "type": "string", "required": false, "description": "输入图 Base64 数据。 Base64 和 Url 必须提供一个，如果都提供以 Url 为准。 图片限制：单边分辨率小于5000，转成 Base64 字符串后小于 6MB，格式支持 jpg、jpeg、png、bmp、tiff、webp。", "example": "/9j/4AAQSkZJRgABAQAAAQABAAD/4gIo...lftXF/DjFZNXoSP5V2U0HMt/1FQf/Z" }, { "name": "InputUrl", "type": "string", "required": false, "description": "输入图 Url。 Base64 和 Url 必须提供一个，如果都提供以 Url 为准。 图片限制：单边分辨率小于5000，转成 Base64 字符串后小于 6MB，格式支持 jpg、jpeg、png、bmp、tiff、webp。", "example": "https://cos.ap-guangzhou.myqcloud.com/image.jpg" }, { "name": "Filter", "type": "integer", "required": false, "description": "输入人像图的质量检测开关，默认开启，仅在人像模式下生效。 1：开启 0：关闭 建议开启检测，可提升生成效果，关闭检测可能因输入图像质量较差导致生成效果受损。 开启后，将增强对输入图像的质量要求，如果输入图像单边分辨率\u003c500、图像中人脸占比较小、存在多人、没有检测到人脸、人脸不完整、人脸遮挡等，将被拦截。 关闭后，将降低对输入图像的质量要求，如果...", "example": "1" }, { "name": "LogoAdd", "type": "integer", "required": false, "description": "为生成结果图添加标识的开关，默认为1。 1：添加标识。 0：不添加标识。 其他数值：默认按1处理。 建议您使用显著标识来提示结果图是 AI 生成的图片。", "example": "1" }, { "name": "LogoParam", "type": "object", "required": false, "description": "标识内容设置。 默认在生成结果图右下角添加“图片由 AI 生成”字样，您可根据自身需要替换为其他的标识图片。", "example": "{\"LogoUrl\": \"https://cos.ap-guangzhou.myqcloud.com/logo.jpg\", \"LogoRect\": {\"X\": 10, \"Y\": 10, \"Width\": 20, \"Height\": 20}}", "children": [ { "name": "LogoUrl", "type": "string", "required": false, "description": "水印 Url 注意：此字段可能返回 null，表示取不到有效值。", "example": "https://cos.ap-guangzhou.myqcloud.com/logo.jpg" }, { "name": "LogoImage", "type": "string", "required": false, "description": "水印 Base64，Url 和 Base64 二选一传入，如果都提供以 Url 为准 注意：此字段可能返回 null，表示取不到有效值。", "example": "/9j/4QlQaHR0c...N6a2M5ZCI" }, { "name": "LogoRect", "type": "object", "required": false, "description": "水印图片位于生成结果图中的坐标，将按照坐标对标识图片进行位置和大小的拉伸匹配 注意：此字段可能返回 null，表示取不到有效值。", "example": "{\"X\": 10, \"Y\": 10, \"Width\": 10, \"Height\": 10}", "children": [ { "name": "X", "type": "integer", "required": false, "description": "左上角X坐标 注意：此字段可能返回 null，表示取不到有效值。", "example": "10" }, { "name": "Y", "type": "integer", "required": false, "description": "左上角Y坐标 注意：此字段可能返回 null，表示取不到有效值。", "example": "10" }, { "name": "Width", "type": "integer", "required": false, "description": "方框宽度 注意：此字段可能返回 null，表示取不到有效值。", "example": "10" }, { "name": "Height", "type": "integer", "required": false, "description": "方框高度 注意：此字段可能返回 null，表示取不到有效值。", "example": "10" } ] } ] }, { "name": "RspImgType", "type": "string", "required": false, "description": "返回图像方式（base64 或 url) ，二选一，默认为 base64。url 有效期为1小时。", "example": "url" } ], "required": [] }, { "name": "ImageInpaintingRemoval", "description": "局部消除接口通过图像 mask 指定需要消除的人、物、文字等区域，在选定区域对图像内容进行消除与重绘补全。 默认提供1个并发，代表最多能同时处理1个已提交的任务。", "status": "online", "parameters": [ { "name": "InputImage", "type": "string", "required": false, "description": "输入图 Base64 数据。 Base64 和 Url 必须提供一个，如果都提供以 Url 为准。 图片限制：单边分辨率小于5000，转成 Base64 字符串后小于 6MB，格式支持 jpg、jpeg、png、bmp、tiff、webp。", "example": "9j/4QlQaHR0c...N6a2M5ZCI" }, { "name": "InputUrl", "type": "string", "required": false, "description": "输入图 Url。 Base64 和 Url 必须提供一个，如果都提供以 Url 为准。 图片限制：单边分辨率小于5000，转成 Base64 字符串后小于 6MB，格式支持 jpg、jpeg、png、bmp、tiff、webp。", "example": "https://cos.ap-guangzhou.myqcloud.com/image.jpg" }, { "name": "Mask", "type": "string", "required": false, "description": "消除区域 Mask 图 Base64 数据。 Mask 为单通道灰度图，待消除部分呈白色区域，原图保持部分呈黑色区域。 Mask 的 Base64 和 Url 必须提供一个，如果都提供以 Url 为准。 图片限制：Mask 分辨率需要和输入原图保持一致，转成 Base64 字符串后小于 6MB。", "example": "9j/4QlQaHR0c...N6a2M5ZCI" }, { "name": "MaskUrl", "type": "string", "required": false, "description": "消除区域 Mask 图 Url。 Mask 为单通道灰度图，待消除部分呈白色区域，原图保持部分呈黑色区域。 Mask 的 Base64 和 Url 必须提供一个，如果都提供以 Url 为准。 图片限制：Mask 分辨率需要和输入原图保持一致，转成 Base64 字符串后小于 6MB。", "example": "https://cos.ap-guangzhou.myqcloud.com/mask.png" }, { "name": "RspImgType", "type": "string", "required": false, "description": "返回图像方式（base64 或 url），二选一，默认为 base64。url 有效期为1小时。", "example": "url" }, { "name": "LogoAdd", "type": "integer", "required": false, "description": "为生成结果图添加标识的开关，默认为1。 1：添加标识。 0：不添加标识。 其他数值：默认按1处理。 建议您使用显著标识来提示结果图使用了 AI 绘画技术，是 AI 生成的图片。", "example": "1" }, { "name": "LogoParam", "type": "object", "required": false, "description": "标识内容设置。 默认在生成结果图右下角添加“图片由 AI 生成”字样，您可根据自身需要替换为其他的标识图片。", "example": "无", "children": [ { "name": "LogoUrl", "type": "string", "required": false, "description": "水印 Url 注意：此字段可能返回 null，表示取不到有效值。", "example": "https://cos.ap-guangzhou.myqcloud.com/logo.jpg" }, { "name": "LogoImage", "type": "string", "required": false, "description": "水印 Base64，Url 和 Base64 二选一传入，如果都提供以 Url 为准 注意：此字段可能返回 null，表示取不到有效值。", "example": "/9j/4QlQaHR0c...N6a2M5ZCI" }, { "name": "LogoRect", "type": "object", "required": false, "description": "水印图片位于生成结果图中的坐标，将按照坐标对标识图片进行位置和大小的拉伸匹配 注意：此字段可能返回 null，表示取不到有效值。", "example": "{\"X\": 10, \"Y\": 10, \"Width\": 10, \"Height\": 10}", "children": [ { "name": "X", "type": "integer", "required": false, "description": "左上角X坐标 注意：此字段可能返回 null，表示取不到有效值。", "example": "10" }, { "name": "Y", "type": "integer", "required": false, "description": "左上角Y坐标 注意：此字段可能返回 null，表示取不到有效值。", "example": "10" }, { "name": "Width", "type": "integer", "required": false, "description": "方框宽度 注意：此字段可能返回 null，表示取不到有效值。", "example": "10" }, { "name": "Height", "type": "integer", "required": false, "description": "方框高度 注意：此字段可能返回 null，表示取不到有效值。", "example": "10" } ] } ] } ], "required": [] }, { "name": "ImageOutpainting", "description": "扩图接口支持对输入图像按指定宽高比实现智能扩图。 默认提供1个并发，代表最多能同时处理1个已提交的任务。", "status": "online", "parameters": [ { "name": "Ratio", "type": "string", "required": true, "description": "扩展后的比例（宽:高），需要不等于原图比例。 支持：1:1、4:3、3:4、16:9、9:16", "example": "4:3" }, { "name": "InputImage", "type": "string", "required": false, "description": "输入图 Base64 数据。 Base64 和 Url 必须提供一个，如果都提供以 Url 为准。 图片限制：单边分辨率小于5000，转成 Base64 字符串后小于 6MB，格式支持 jpg、jpeg、png、bmp、tiff、webp。", "example": "9j/4QlQaHR0c...N6a2M5ZCI" }, { "name": "InputUrl", "type": "string", "required": false, "description": "输入图 Url。 Base64 和 Url 必须提供一个，如果都提供以 Url 为准。 图片限制：单边分辨率小于5000，转成 Base64 字符串后小于 6MB，格式支持 jpg、jpeg、png、bmp、tiff、webp。", "example": "https://cos.ap-guangzhou.myqcloud.com/image.jpg" }, { "name": "RspImgType", "type": "string", "required": false, "description": "返回图像方式（base64 或 url），二选一，默认为 base64。url 有效期为1小时。", "example": "url" }, { "name": "LogoAdd", "type": "integer", "required": false, "description": "为生成结果图添加标识的开关，默认为1。 1：添加标识。 0：不添加标识。 其他数值：默认按1处理。 建议您使用显著标识来提示结果图使用了 AI 绘画技术，是 AI 生成的图片。", "example": "1" }, { "name": "LogoParam", "type": "object", "required": false, "description": "标识内容设置。 默认在生成结果图右下角添加“图片由 AI 生成”字样，您可根据自身需要替换为其他的标识图片。", "example": "无", "children": [ { "name": "LogoUrl", "type": "string", "required": false, "description": "水印 Url 注意：此字段可能返回 null，表示取不到有效值。", "example": "https://cos.ap-guangzhou.myqcloud.com/logo.jpg" }, { "name": "LogoImage", "type": "string", "required": false, "description": "水印 Base64，Url 和 Base64 二选一传入，如果都提供以 Url 为准 注意：此字段可能返回 null，表示取不到有效值。", "example": "/9j/4QlQaHR0c...N6a2M5ZCI" }, { "name": "LogoRect", "type": "object", "required": false, "description": "水印图片位于生成结果图中的坐标，将按照坐标对标识图片进行位置和大小的拉伸匹配 注意：此字段可能返回 null，表示取不到有效值。", "example": "{\"X\": 10, \"Y\": 10, \"Width\": 10, \"Height\": 10}", "children": [ { "name": "X", "type": "integer", "required": false, "description": "左上角X坐标 注意：此字段可能返回 null，表示取不到有效值。", "example": "10" }, { "name": "Y", "type": "integer", "required": false, "description": "左上角Y坐标 注意：此字段可能返回 null，表示取不到有效值。", "example": "10" }, { "name": "Width", "type": "integer", "required": false, "description": "方框宽度 注意：此字段可能返回 null，表示取不到有效值。", "example": "10" }, { "name": "Height", "type": "integer", "required": false, "description": "方框高度 注意：此字段可能返回 null，表示取不到有效值。", "example": "10" } ] } ] } ], "required": [ "Ratio" ] }, { "name": "ImageToImage", "description": "图像风格化（图生图）接口提供生成式的图生图风格转化能力，将根据输入的图像及文本描述，智能生成风格转化后的图像。建议避免输入人像过小、姿势复杂、人数较多的人像图片。 图像风格化（图生图）默认提供3个并发任务数，代表最多能同时处理3个已提交的任务，上一个任务处理完毕后才能开始处理下一个任务。", "status": "online", "parameters": [ { "name": "InputImage", "type": "string", "required": false, "description": "输入图 Base64 数据。 算法将根据输入的图片，结合文本描述智能生成与之相关的图像。 Base64 和 Url 必须提供一个，如果都提供以 Url 为准。 图片限制：单边分辨率小于5000且大于50，转成 Base64 字符串后小于 8MB，格式支持 jpg、jpeg、png、bmp、tiff、webp。", "example": "/9j/4QlQaHR0c...N6a2M5ZCI" }, { "name": "InputUrl", "type": "string", "required": false, "description": "输入图 Url。 算法将根据输入的图片，结合文本描述智能生成与之相关的图像。 Base64 和 Url 必须提供一个，如果都提供以 Url 为准。 图片限制：单边分辨率小于5000且大于50，转成 Base64 字符串后小于 8MB，格式支持 jpg、jpeg、png、bmp、tiff、webp。", "example": "https://cos.ap-guangzhou.myqcloud.com/image.jpg" }, { "name": "Prompt", "type": "string", "required": false, "description": "文本描述。 用于在输入图的基础上引导生成图效果，增加生成结果中出现描述内容的可能。 推荐使用中文。最多支持256个 utf-8 字符。", "example": "清新自然" }, { "name": "NegativePrompt", "type": "string", "required": false, "description": "反向文本描述。 用于一定程度上从反面引导模型生成的走向，减少生成结果中出现描述内容的可能，但不能完全杜绝。 推荐使用中文。最多可传256个 utf-8 字符。", "example": "黑色" }, { "name": "Styles", "type": "array", "required": false, "description": "绘画风格。 请在 [图像风格化风格列表](https://cloud.tencent.com/document/product/1668/86250) 中选择期望的风格，传入风格编号。 推荐使用且只使用一种风格。不传默认使用201（日系动漫风格）。", "example": "[\"201\"]", "item_type": "string" }, { "name": "ResultConfig", "type": "object", "required": false, "description": "生成图结果的配置，包括输出图片分辨率和尺寸等。 支持生成以下分辨率的图片：origin（与输入图分辨率一致，长边最高为2000，超出将做等比例缩小）、768:768（1:1）、768:1024（3:4）、1024:768（4:3）。 不传默认使用origin。", "example": "768:768", "children": [ { "name": "Resolution", "type": "string", "required": false, "description": "生成图分辨率 图像风格化（图生图）支持生成以下分辨率的图片：origin（与输入图分辨率一致，长边最高为2000，超出将做等比例缩小）、768:768（1:1）、768:1024（3:4）、1024:768（4:3），不传默认使用origin，如果指定生成的长宽比与输入图长宽比差异过大可能导致图片内容被裁剪。 注意：此字段可能返回 null，表示取不到有效值。", "example": "768:768" } ] }, { "name": "LogoAdd", "type": "integer", "required": false, "description": "为生成结果图添加标识的开关，默认为1。 1：添加标识。 0：不添加标识。 其他数值：默认按1处理。 建议您使用显著标识来提示结果图使用了 AI 绘画技术，是 AI 生成的图片。", "example": "1" }, { "name": "LogoParam", "type": "object", "required": false, "description": "标识内容设置。 默认在生成结果图右下角添加“图片由 AI 生成”字样，您可根据自身需要替换为其他的标识图片。", "example": "{\"LogoUrl\": \"https://cos.ap-guangzhou.myqcloud.com/logo.jpg\", \"LogoRect\": {\"X\": 10, \"Y\": 10, \"Width\": 20, \"Height\": 20}}", "children": [ { "name": "LogoUrl", "type": "string", "required": false, "description": "水印 Url 注意：此字段可能返回 null，表示取不到有效值。", "example": "https://cos.ap-guangzhou.myqcloud.com/logo.jpg" }, { "name": "LogoImage", "type": "string", "required": false, "description": "水印 Base64，Url 和 Base64 二选一传入，如果都提供以 Url 为准 注意：此字段可能返回 null，表示取不到有效值。", "example": "/9j/4QlQaHR0c...N6a2M5ZCI" }, { "name": "LogoRect", "type": "object", "required": false, "description": "水印图片位于生成结果图中的坐标，将按照坐标对标识图片进行位置和大小的拉伸匹配 注意：此字段可能返回 null，表示取不到有效值。", "example": "{\"X\": 10, \"Y\": 10, \"Width\": 10, \"Height\": 10}", "children": [ { "name": "X", "type": "integer", "required": false, "description": "左上角X坐标 注意：此字段可能返回 null，表示取不到有效值。", "example": "10" }, { "name": "Y", "type": "integer", "required": false, "description": "左上角Y坐标 注意：此字段可能返回 null，表示取不到有效值。", "example": "10" }, { "name": "Width", "type": "integer", "required": false, "description": "方框宽度 注意：此字段可能返回 null，表示取不到有效值。", "example": "10" }, { "name": "Height", "type": "integer", "required": false, "description": "方框高度 注意：此字段可能返回 null，表示取不到有效值。", "example": "10" } ] } ] }, { "name": "Strength", "type": "float", "required": false, "description": "生成自由度。 Strength 值越小，生成图和原图越接近，取值范围(0, 1]，不传使用模型内置的默认值。 推荐的取值范围为0.6 - 0.8。", "example": "0.5" }, { "name": "RspImgType", "type": "string", "required": false, "description": "返回图像方式（base64 或 url) ，二选一，默认为 base64。url 有效期为1小时。", "example": "url" }, { "name": "EnhanceImage", "type": "integer", "required": false, "description": "画质增强开关，默认关闭。 1：开启 0：关闭 开启后将增强图像的画质清晰度，生成耗时有所增加。", "example": "1" }, { "name": "RestoreFace", "type": "integer", "required": false, "description": "细节优化的面部数量上限，支持0 ~ 6，默认为0。 若上传大于0的值，将以此为上限对每张图片中面积占比较小的面部进行细节修复，生成耗时根据实际优化的面部个数有所增加。", "example": "1" } ], "required": [] }, { "name": "QueryDrawPortraitJob", "description": "AI 写真分为上传训练图片、训练写真模型（可选跳过）、生成写真图片3个环节，需要依次调用对应接口。 生成图片分为提交任务和查询任务2个接口： - 提交生成写真图片任务：选择风格模板，提交一个生成写真图片异步任务，根据写真模型 ID 生成写真图片，获得任务 ID。 - 查询生成写真图片任务：根据任务 ID 查询生成图片任务的处理状态、处理结果。 每个写真模型自训练\ufffd\ufffd...", "status": "online", "parameters": [ { "name": "JobId", "type": "string", "required": true, "description": "查询生成写真图片任务 ID。", "example": "d33c2c966ae1476a5fae5e76" } ], "required": [ "JobId" ] }, { "name": "QueryGlamPicJob", "description": "AI 美照接口将根据模板为用户生成精美照片。分为提交任务和查询任务2个接口。 - 提交任务：提交一个美照生成异步任务，获得任务 ID。 - 查询任务：根据任务 ID 查询任务的处理状态、处理结果，任务处理完成后可获得生成图像结果。 AI 美照默认提供1个并发，代表最多能同时处理1个已提交的任务，上一个任务处理完毕后才能开始处理下一个任务。", "status": "online", "parameters": [ { "name": "JobId", "type": "string", "required": true, "description": "任务ID。", "example": "251197749-1732000778-a319cc1b-a646-11ef-be80-525400047e59-0" } ], "required": [ "JobId" ] }, { "name": "QueryMemeJob", "description": "表情动图生成接口将静态照片制作成动态的表情包。分为提交任务和查询任务2个接口。 - 提交任务：提交一个表情动图生成异步任务，获得任务 ID。 - 查询任务：根据任务 ID 查询任务的处理状态、处理结果，任务处理完成后可获得生成图像结果。 表情动图生成默认提供1个并发，代表最多能同时处理1个已提交的任务，上一个任务处理完毕后才能开始处理下一个任务。", "status": "online", "parameters": [ { "name": "JobId", "type": "string", "required": true, "description": "查询表情动图生成任务 ID。", "example": "1262739692856008704" } ], "required": [ "JobId" ] }, { "name": "QueryTextToImageJob", "description": "混元生图接口，基于混元大模型，根据输入的文本描述快速生成图片。 默认提供0个并发，代表最多能同时处理1个已提交的任务，上一个任务处理完毕后，才能开始处理下一个任务。", "status": "online", "parameters": [ { "name": "JobId", "type": "string", "required": true, "description": "任务 ID。", "example": "1344213737283272704" } ], "required": [ "JobId" ] }, { "name": "QueryTextToImageProJob", "description": "本接口已迁移至腾讯混元大模型-混元生图，即将停止此处维护，可切换至 [混元生图 API](https://cloud.tencent.com/document/product/1729/105970) 继续使用。 文生图（高级版）接口基于高级版文生图大模型，将根据输入的文本描述，智能生成与之相关的结果图。分为提交任务和查询任务2个接口。 提交任务：输入文本等，提交一个文生图（高级版）异步任务，获得任务 ID。 查询任务：根据\ufffd\ufffd...", "status": "online", "parameters": [ { "name": "JobId", "type": "string", "required": true, "description": "任务 ID。", "example": "251197749-1732000778-a319cc1b-a646-11ef-be80-525400047e59-0" } ], "required": [ "JobId" ] }, { "name": "QueryTrainPortraitModelJob", "description": "AI 写真分为上传训练图片、训练写真模型（可选跳过）、生成写真图片3个环节，需要依次调用对应接口。 如果选择免训练模式无需调用本接口。 训练模型分为提交任务和查询任务2个接口： - 提交训练写真模型任务：完成上传图片后，提交一个训练写真模型异步任务，根据写真模型 ID 开始训练模型。 - 查询训练写真模型任务：根据写真模型 ID 查询训练任务的处理状态、处理\ufffd\ufffd...", "status": "online", "parameters": [ { "name": "ModelId", "type": "string", "required": true, "description": "写真模型 ID。", "example": "model_01" } ], "required": [ "ModelId" ] }, { "name": "RefineImage", "description": "将图像变清晰，增强图像细节。变清晰后的图片将保持原图比例，长边为2048。 默认提供1个并发，代表最多能同时处理1个已提交的任务。", "status": "online", "parameters": [ { "name": "InputUrl", "type": "string", "required": false, "description": "输入图 Url。 Base64 和 Url 必须提供一个，如果都提供以 Url 为准。 图片限制：转成 Base64 字符串后小于 6MB，格式支持 jpg、jpeg、png、bmp、tiff、webp。", "example": "https://cos.ap-guangzhou.myqcloud.com/image.jpg" }, { "name": "InputImage", "type": "string", "required": false, "description": "输入图 Base64 数据。 Base64 和 Url 必须提供一个，如果都提供以 Url 为准。 图片限制：转成 Base64 字符串后小于 6MB，格式支持 jpg、jpeg、png、bmp、tiff、webp。", "example": "9j/4QlQaHR0c...N6a2M5ZCI" }, { "name": "RspImgType", "type": "string", "required": false, "description": "返回图像方式（base64 或 url），二选一，默认为 base64。url 有效期为1小时。 示例值：url", "example": "url" } ], "required": [] }, { "name": "ReplaceBackground", "description": "商品背景生成接口根据指定的背景描述 Prompt，将商品图中的原背景替换为自定义的新背景并保留商品主体形象，实现商品背景的自由生成与更换。 商品背景生成默认提供1个并发任务数，代表最多能同时处理1个已提交的任务，上一个任务处理完毕后才能开始处理下一个任务。", "status": "online", "parameters": [ { "name": "ProductUrl", "type": "string", "required": true, "description": "商品原图 Url。 图片限制：单边分辨率小于4000，长宽比在2:5 ~ 5:2之间，转成 Base64 字符串后小于 6MB，格式支持 jpg、jpeg、png、bmp、tiff、webp。", "example": "https://cos.ap-guangzhou.myqcloud.com/product.jpg" }, { "name": "Prompt", "type": "string", "required": true, "description": "对新背景的文本描述。 最多支持256个 utf-8 字符，支持中、英文。 如果 Prompt = \"BackgroundTemplate\" 代表启用背景模板，需要在参数 BackgroundTemplate 中指定一个背景名称。", "example": "放在充满鲜花的环境里，简洁风格，清新自然，广告摄影" }, { "name": "NegativePrompt", "type": "string", "required": false, "description": "反向提示词。 最多支持256个 utf-8 字符，支持中、英文。", "example": "黑白" }, { "name": "Product", "type": "string", "required": false, "description": "商品图中的商品主体名称。 最多支持50个 utf-8 字符，支持中、英文。 建议说明商品主体，否则影响生成效果。", "example": "汽车" }, { "name": "BackgroundTemplate", "type": "string", "required": false, "description": "背景模板。 仅当 Prompt = \"BackgroundTemplate\" 时生效，可支持的模板详见 [商品背景模板列表](https://cloud.tencent.com/document/product/1668/115391) ，请传入字段“背景名称”中的值。", "example": "彩虹渐变" }, { "name": "MaskUrl", "type": "string", "required": false, "description": "商品 Mask 图 Url，要求背景透明，保留商品主体。 如果不传，将自动使用内置的商品分割算法得到 Mask。 支持自定义上传 Mask，如果该参数不为空，则以实际上传的数据为准。 图片限制：Mask 图必须和商品原图分辨率一致，转成 Base64 字符串后小于 6MB，格式仅支持 png。", "example": "https://cos.ap-guangzhou.myqcloud.com/mask.jpg" }, { "name": "Resolution", "type": "string", "required": false, "description": "替换背景后生成的商品图分辨率。 支持生成单边分辨率大于500且小于4000、长宽比在2:5 ~ 5:2之间的图片，不传默认生成1280:1280。 建议图片比例为1:1、9:16、16:9，生成效果更佳，使用其他比例的生成效果可能不如建议比例。", "example": "1280:1280" }, { "name": "LogoAdd", "type": "integer", "required": false, "description": "为生成结果图添加标识的开关，默认为1。 1：添加标识。 0：不添加标识。 其他数值：默认按1处理。 建议您使用显著标识来提示结果图是 AI 生成的图片。", "example": "1" }, { "name": "LogoParam", "type": "object", "required": false, "description": "标识内容设置。 默认在生成结果图右下角添加“图片由 AI 生成”字样，您可根据自身需要替换为其他的标识图片。", "example": "{\"LogoUrl\": \"https://cos.ap-guangzhou.myqcloud.com/logo.jpg\", \"LogoRect\": {\"X\": 10, \"Y\": 10, \"Width\": 20, \"Height\": 20}}", "children": [ { "name": "LogoUrl", "type": "string", "required": false, "description": "水印 Url 注意：此字段可能返回 null，表示取不到有效值。", "example": "https://cos.ap-guangzhou.myqcloud.com/logo.jpg" }, { "name": "LogoImage", "type": "string", "required": false, "description": "水印 Base64，Url 和 Base64 二选一传入，如果都提供以 Url 为准 注意：此字段可能返回 null，表示取不到有效值。", "example": "/9j/4QlQaHR0c...N6a2M5ZCI" }, { "name": "LogoRect", "type": "object", "required": false, "description": "水印图片位于生成结果图中的坐标，将按照坐标对标识图片进行位置和大小的拉伸匹配 注意：此字段可能返回 null，表示取不到有效值。", "example": "{\"X\": 10, \"Y\": 10, \"Width\": 10, \"Height\": 10}", "children": [ { "name": "X", "type": "integer", "required": false, "description": "左上角X坐标 注意：此字段可能返回 null，表示取不到有效值。", "example": "10" }, { "name": "Y", "type": "integer", "required": false, "description": "左上角Y坐标 注意：此字段可能返回 null，表示取不到有效值。", "example": "10" }, { "name": "Width", "type": "integer", "required": false, "description": "方框宽度 注意：此字段可能返回 null，表示取不到有效值。", "example": "10" }, { "name": "Height", "type": "integer", "required": false, "description": "方框高度 注意：此字段可能返回 null，表示取不到有效值。", "example": "10" } ] } ] }, { "name": "RspImgType", "type": "string", "required": false, "description": "返回图像方式（base64 或 url) ，二选一，默认为 base64。url 有效期为1小时。 生成图分辨率较大时建议选择 url，使用 base64 可能因图片过大导致返回失败。", "example": "url" } ], "required": [ "ProductUrl", "Prompt" ] }, { "name": "SketchToImage", "description": "线稿生图接口支持上传一张黑白线稿图，按照指定的主体对象以及样式、颜色、材质、风格等的文本描述prompt ，对线稿图进行色彩填充与细节描绘，得到一张完整绘制的图像。生成图分辨率默认为1024:1024。 线稿生图默认提供1个并发任务数，代表最多能同时处理1个已提交的任务，上一个任务处理完毕后才能开始处理下一个任务。", "status": "online", "parameters": [ { "name": "Prompt", "type": "string", "required": true, "description": "用于线稿生图的文本描述。 最多支持200个 utf-8 字符。 建议格式：线稿中的主体对象+画面场景+配色/材质/元素/风格等", "example": "鞋子，红白配色，皮革材质，真实画质，写实风格，精细，高清摄影，白色背景" }, { "name": "InputImage", "type": "string", "required": false, "description": "线稿图 Base64 数据。 Base64 和 Url 必须提供一个，如果都提供以Url 为准。 图片限制：黑白线稿图片，单边分辨率小于5000且大于128（分辨率过小会导致效果受损），转成 Base64 字符串后小于 6MB，格式支持 jpg、jpeg、png、bmp、tiff、webp。", "example": "/9j/4AAQSkZJRgABAQAAAQABAAD/4gIo...lftXF/DjFZNXoSP5V2U0HMt/1FQf/Z" }, { "name": "InputUrl", "type": "string", "required": false, "description": "线稿图 Url。 Base64 和 Url 必须提供一个，如果都提供以Url 为准。 图片限制：黑白线稿图片，单边分辨率小于5000且大于128（分辨率过小会导致效果受损），转成 Base64 字符串后小于 6MB，格式支持 jpg、jpeg、png、bmp、tiff、webp。", "example": "https://cos.ap-guangzhou.myqcloud.com/image.jpg" }, { "name": "LogoAdd", "type": "integer", "required": false, "description": "为生成结果图添加标识的开关，默认为1。 1：添加标识。 0：不添加标识。 其他数值：默认按1处理。 建议您使用显著标识来提示结果图使用了 AI 绘画技术，是 AI 生成的图片。", "example": "1" }, { "name": "LogoParam", "type": "object", "required": false, "description": "标识内容设置。 默认在生成结果图右下角添加“图片由 AI 生成”字样，您可根据自身需要替换为其他的标识图片。", "example": "{\"LogoUrl\": \"https://cos.ap-guangzhou.myqcloud.com/logo.jpg\", \"LogoRect\": {\"X\": 10, \"Y\": 10, \"Width\": 20, \"Height\": 20}}", "children": [ { "name": "LogoUrl", "type": "string", "required": false, "description": "水印 Url 注意：此字段可能返回 null，表示取不到有效值。", "example": "https://cos.ap-guangzhou.myqcloud.com/logo.jpg" }, { "name": "LogoImage", "type": "string", "required": false, "description": "水印 Base64，Url 和 Base64 二选一传入，如果都提供以 Url 为准 注意：此字段可能返回 null，表示取不到有效值。", "example": "/9j/4QlQaHR0c...N6a2M5ZCI" }, { "name": "LogoRect", "type": "object", "required": false, "description": "水印图片位于生成结果图中的坐标，将按照坐标对标识图片进行位置和大小的拉伸匹配 注意：此字段可能返回 null，表示取不到有效值。", "example": "{\"X\": 10, \"Y\": 10, \"Width\": 10, \"Height\": 10}", "children": [ { "name": "X", "type": "integer", "required": false, "description": "左上角X坐标 注意：此字段可能返回 null，表示取不到有效值。", "example": "10" }, { "name": "Y", "type": "integer", "required": false, "description": "左上角Y坐标 注意：此字段可能返回 null，表示取不到有效值。", "example": "10" }, { "name": "Width", "type": "integer", "required": false, "description": "方框宽度 注意：此字段可能返回 null，表示取不到有效值。", "example": "10" }, { "name": "Height", "type": "integer", "required": false, "description": "方框高度 注意：此字段可能返回 null，表示取不到有效值。", "example": "10" } ] } ] }, { "name": "RspImgType", "type": "string", "required": false, "description": "返回图像方式（base64 或 url) ，二选一，默认为 base64。url 有效期为1小时。生成图分辨率较大时建议选择 url，使用 base64 可能因图片过大导致返回失败。", "example": "url" } ], "required": [ "Prompt" ] }, { "name": "SubmitDrawPortraitJob", "description": "AI 写真分为上传训练图片、训练写真模型（可选跳过）、生成写真图片3个环节，需要依次调用对应接口。 生成图片分为提交任务和查询任务2个接口： - 提交生成写真图片任务：选择风格模板，提交一个生成写真图片异步任务，根据写真模型 ID 生成写真图片，获得任务 ID。 - 查询生成写真图片任务：根据任务 ID 查询生成图片任务的处理状态、处理结果。 每个写真模型自训练\ufffd\ufffd...", "status": "online", "parameters": [ { "name": "ModelId", "type": "string", "required": true, "description": "写真模型 ID。", "example": "model_01" }, { "name": "StyleId", "type": "string", "required": true, "description": "写真风格模板。 请在[ AI 写真风格列表](https://cloud.tencent.com/document/product/1668/105740) 中选择期望的风格，传入风格编号。", "example": "zhengjian_female" }, { "name": "ImageNum", "type": "integer", "required": true, "description": "本次生成的图片数量，取值范围[1,4]", "example": "1" }, { "name": "LogoAdd", "type": "integer", "required": false, "description": "为生成结果图添加标识的开关，默认为1。 1：添加标识。 0：不添加标识。 其他数值：默认按1处理。 建议您使用显著标识来提示结果图是 AI 生成的图片。", "example": "1" }, { "name": "LogoParam", "type": "object", "required": false, "description": "标识内容设置。 默认在生成结果图右下角添加“图片由 AI 生成”字样，您可根据自身需要替换为其他的标识图片。", "example": "{\"LogoUrl\": \"https://cos.ap-guangzhou.myqcloud.com/logo.jpg\", \"LogoRect\": {\"X\": 10, \"Y\": 10, \"Width\": 20, \"Height\": 20}}", "children": [ { "name": "LogoUrl", "type": "string", "required": false, "description": "水印 Url 注意：此字段可能返回 null，表示取不到有效值。", "example": "https://cos.ap-guangzhou.myqcloud.com/logo.jpg" }, { "name": "LogoImage", "type": "string", "required": false, "description": "水印 Base64，Url 和 Base64 二选一传入，如果都提供以 Url 为准 注意：此字段可能返回 null，表示取不到有效值。", "example": "/9j/4QlQaHR0c...N6a2M5ZCI" }, { "name": "LogoRect", "type": "object", "required": false, "description": "水印图片位于生成结果图中的坐标，将按照坐标对标识图片进行位置和大小的拉伸匹配 注意：此字段可能返回 null，表示取不到有效值。", "example": "{\"X\": 10, \"Y\": 10, \"Width\": 10, \"Height\": 10}", "children": [ { "name": "X", "type": "integer", "required": false, "description": "左上角X坐标 注意：此字段可能返回 null，表示取不到有效值。", "example": "10" }, { "name": "Y", "type": "integer", "required": false, "description": "左上角Y坐标 注意：此字段可能返回 null，表示取不到有效值。", "example": "10" }, { "name": "Width", "type": "integer", "required": false, "description": "方框宽度 注意：此字段可能返回 null，表示取不到有效值。", "example": "10" }, { "name": "Height", "type": "integer", "required": false, "description": "方框高度 注意：此字段可能返回 null，表示取不到有效值。", "example": "10" } ] } ] }, { "name": "Definition", "type": "string", "required": false, "description": "清晰度，支持以下选项： sd：基础版，分辨率512:640 hd：高清畅享版，分辨率1024:1280 hdpro：高清优享版，分辨率1024:1280（推荐） uhd：超清版，分辨率2048:2560 不填默认为sd。", "example": "sd" } ], "required": [ "ModelId", "StyleId", "ImageNum" ] }, { "name": "SubmitGlamPicJob", "description": "AI 美照接口将根据模板为用户生成精美照片。分为提交任务和查询任务2个接口。 - 提交任务：提交一个美照生成异步任务，获得任务 ID。 - 查询任务：根据任务 ID 查询任务的处理状态、处理结果，任务处理完成后可获得生成图像结果。 AI 美照默认提供1个并发，代表最多能同时处理1个已提交的任务，上一个任务处理完毕后才能开始处理下一个任务。", "status": "online", "parameters": [ { "name": "TemplateUrl", "type": "string", "required": true, "description": "美照模板图 URL。 图片限制：模板图中最多出现5张人脸，单边分辨率大于300，转成 Base64 字符串后小于 10MB，格式支持 jpg、jpeg、png、bmp、tiff、webp。", "example": "https://cos.ap-guangzhou.myqcloud.com/image.jpg" }, { "name": "FaceInfos", "type": "array", "required": false, "description": "用户图 URL 列表，以及模板图中需要替换成用户的人脸框信息。 一张美照中可包含1 ~ 5个用户形象。每个用户需上传1 ~ 6张照片，仅支持单人照。 模板图中的人脸数量需要大于等于用户个数。如果不传每个用户在模板图中的人脸框位置，默认按照模板图人脸框从大到小的顺序进行替换。如需自定义顺序，需要依次上传每个用户在模板图中的人脸框位置。 图片限制：每张图片转\ufffd\ufffd...", "example": "[{\"ImageUrls\": [\"https://cos.ap-guangzhou.myqcloud.com/image.jpg\"]}]", "item_type": "object", "children": [ { "name": "ImageUrls", "type": "array", "required": false, "description": "用户图 URL 列表", "example": "[\"https://cos.ap-guangzhou.myqcloud.com/input.jpg\"]", "item_type": "string" }, { "name": "TemplateFaceRect", "type": "object", "required": false, "description": "模板图人脸坐标。", "example": "无", "children": [ { "name": "X", "type": "integer", "required": false, "description": "人脸框左上角横坐标。", "example": "1" }, { "name": "Y", "type": "integer", "required": false, "description": "人脸框左上角纵坐标。", "example": "1" }, { "name": "Width", "type": "integer", "required": false, "description": "人脸框宽度。", "example": "30" }, { "name": "Height", "type": "integer", "required": false, "description": "人脸框高度。", "example": "30" } ] } ] }, { "name": "Num", "type": "integer", "required": false, "description": "美照生成数量。 支持1 ~ 4张，默认生成4张。", "example": "4" }, { "name": "Style", "type": "array", "required": false, "description": "美照生成风格。 仅对单人美照生效，单人可支持选择不同风格。需按照美照生成数量，在数组中逐一填入每张美照的风格名称。如果不传，默认取不重复的随机风格顺序。 多人美照只支持 balanced 一种风格，该参数不生效。 可选风格：real：面部相似度更高。balanced：平衡面部真实感和美观度。textured：脸部皮肤更具真实感。beautiful：脸部美观度更高。", "example": "[\"real\", \"balanced\", \"textured\", \"beautiful\"]", "item_type": "string" }, { "name": "Similarity", "type": "float", "required": false, "description": "相似度系数，越高越像用户图。 取值范围[0, 1]，默认为0.6。", "example": "0.6" }, { "name": "Clarity", "type": "string", "required": false, "description": "超分选项，默认不做超分，可选开启。 x2：2倍超分 x4：4倍超分", "example": "x2" }, { "name": "LogoAdd", "type": "integer", "required": false, "description": "为生成结果图添加标识的开关，默认为1。 1：添加标识。 0：不添加标识。 其他数值：默认按1处理。 建议您使用显著标识来提示结果图是 AI 生成的图片。", "example": "1" }, { "name": "LogoParam", "type": "object", "required": false, "description": "标识内容设置。 默认在生成结果图右下角添加“图片由 AI 生成”字样，您可根据自身需要替换为其他的标识图片。", "example": "{\"LogoUrl\": \"https://cos.ap-guangzhou.myqcloud.com/logo.jpg\", \"LogoRect\": {\"X\": 10, \"Y\": 10, \"Width\": 20, \"Height\": 20}}", "children": [ { "name": "LogoUrl", "type": "string", "required": false, "description": "水印 Url 注意：此字段可能返回 null，表示取不到有效值。", "example": "https://cos.ap-guangzhou.myqcloud.com/logo.jpg" }, { "name": "LogoImage", "type": "string", "required": false, "description": "水印 Base64，Url 和 Base64 二选一传入，如果都提供以 Url 为准 注意：此字段可能返回 null，表示取不到有效值。", "example": "/9j/4QlQaHR0c...N6a2M5ZCI" }, { "name": "LogoRect", "type": "object", "required": false, "description": "水印图片位于生成结果图中的坐标，将按照坐标对标识图片进行位置和大小的拉伸匹配 注意：此字段可能返回 null，表示取不到有效值。", "example": "{\"X\": 10, \"Y\": 10, \"Width\": 10, \"Height\": 10}", "children": [ { "name": "X", "type": "integer", "required": false, "description": "左上角X坐标 注意：此字段可能返回 null，表示取不到有效值。", "example": "10" }, { "name": "Y", "type": "integer", "required": false, "description": "左上角Y坐标 注意：此字段可能返回 null，表示取不到有效值。", "example": "10" }, { "name": "Width", "type": "integer", "required": false, "description": "方框宽度 注意：此字段可能返回 null，表示取不到有效值。", "example": "10" }, { "name": "Height", "type": "integer", "required": false, "description": "方框高度 注意：此字段可能返回 null，表示取不到有效值。", "example": "10" } ] } ] } ], "required": [ "TemplateUrl" ] }, { "name": "SubmitMemeJob", "description": "表情动图生成接口将静态照片制作成动态的表情包。分为提交任务和查询任务2个接口。 - 提交任务：提交一个表情动图生成异步任务，获得任务 ID。 - 查询任务：根据任务 ID 查询任务的处理状态、处理结果，任务处理完成后可获得生成图像结果。 表情动图生成默认提供1个并发，代表最多能同时处理1个已提交的任务，上一个任务处理完毕后才能开始处理下一个任务。", "status": "online", "parameters": [ { "name": "Pose", "type": "string", "required": true, "description": "表情模板。 请在 [表情动图模板列表](https://cloud.tencent.com/document/product/1668/115327) 中选择期望的模板，传入 Pose 名称。", "example": "aiyobudeliao" }, { "name": "InputImage", "type": "string", "required": false, "description": "人像参考图 Base64 数据。 Base64 和 Url 必须提供一个，如果都提供以 Url 为准。 图片限制：单边分辨率小于5000，转成 Base64 字符串后小于 6MB，格式支持 jpg、jpeg、png、bmp、tiff、webp。", "example": "9j/4QlQaHR0c...N6a2M5ZCI" }, { "name": "InputUrl", "type": "string", "required": false, "description": "人像参考图 Url。 Base64 和 Url 必须提供一个，如果都提供以 Url 为准。 图片限制：单边分辨率小于5000，转成 Base64 字符串后小于 6MB，格式支持 jpg、jpeg、png、bmp、tiff、webp。", "example": "https://cos.ap-guangzhou.myqcloud.com/image.jpg" }, { "name": "Resolution", "type": "integer", "required": false, "description": "生成分辨率。 真人类型支持256、512，默认为256， 卡通类型仅支持512。", "example": "256" }, { "name": "Text", "type": "string", "required": false, "description": "自定义文案。 仅对真人类型的 Pose 生效，将在生成的表情动图中显示指定的文字。如果传入的字符串长度大于10，只截取前10个显示。 如果不传，默认使用自带的文案。 如果 text = \"\" 空字符串，代表不在表情动图中添加文案。", "example": "谢谢" }, { "name": "Haircut", "type": "boolean", "required": false, "description": "头发遮罩开关。 true：裁剪过长的头发。 false：不裁剪过长的头发。 仅对卡通类型的 Pose 生效，默认为 false。", "example": "false" }, { "name": "LogoAdd", "type": "integer", "required": false, "description": "为生成结果图添加标识的开关，默认为1。 1：添加标识。 0：不添加标识。 其他数值：默认按1处理。 建议您使用显著标识来提示结果图是 AI 生成的图片。", "example": "1" }, { "name": "LogoParam", "type": "object", "required": false, "description": "标识内容设置。 默认在生成结果图右下角添加“图片由 AI 生成”字样，您可根据自身需要替换为其他的标识图片。", "example": "{\"LogoUrl\": \"https://cos.ap-guangzhou.myqcloud.com/logo.jpg\", \"LogoRect\": {\"X\": 10, \"Y\": 10, \"Width\": 20, \"Height\": 20}}", "children": [ { "name": "LogoUrl", "type": "string", "required": false, "description": "水印 Url 注意：此字段可能返回 null，表示取不到有效值。", "example": "https://cos.ap-guangzhou.myqcloud.com/logo.jpg" }, { "name": "LogoImage", "type": "string", "required": false, "description": "水印 Base64，Url 和 Base64 二选一传入，如果都提供以 Url 为准 注意：此字段可能返回 null，表示取不到有效值。", "example": "/9j/4QlQaHR0c...N6a2M5ZCI" }, { "name": "LogoRect", "type": "object", "required": false, "description": "水印图片位于生成结果图中的坐标，将按照坐标对标识图片进行位置和大小的拉伸匹配 注意：此字段可能返回 null，表示取不到有效值。", "example": "{\"X\": 10, \"Y\": 10, \"Width\": 10, \"Height\": 10}", "children": [ { "name": "X", "type": "integer", "required": false, "description": "左上角X坐标 注意：此字段可能返回 null，表示取不到有效值。", "example": "10" }, { "name": "Y", "type": "integer", "required": false, "description": "左上角Y坐标 注意：此字段可能返回 null，表示取不到有效值。", "example": "10" }, { "name": "Width", "type": "integer", "required": false, "description": "方框宽度 注意：此字段可能返回 null，表示取不到有效值。", "example": "10" }, { "name": "Height", "type": "integer", "required": false, "description": "方框高度 注意：此字段可能返回 null，表示取不到有效值。", "example": "10" } ] } ] } ], "required": [ "Pose" ] }, { "name": "SubmitTextToImageJob", "description": "混元生图接口，基于混元大模型，根据输入的文本描述快速生成图片。 默认提供1个并发，代表最多能同时处理1个已提交的任务，上一个任务处理完毕后，才能开始处理下一个任务。", "status": "online", "parameters": [ { "name": "Prompt", "type": "string", "required": true, "description": "文本描述。算法将根据输入的文本智能生成与之相关的图像。不能为空，推荐使用中文。最多可传8192个 utf-8 字符。", "example": "雨中, 竹林, 小路" }, { "name": "Images", "type": "array", "required": false, "description": "参考图，最多三张图。 - Base64 或 Url 。 - 单张图片限制：图片base64后大小小于6M ；格式支持 jpg、jpeg、png、bmp、tiff、webp。", "example": "[\"https://xxx.jpeg\"]", "item_type": "string" }, { "name": "Resolution", "type": "string", "required": false, "description": "生成图分辨率格式：\u0026quot;${宽}:${高}\u0026quot;，说明：分辨率的设置和输入是否有参考图（image_urls/images参数）有关：一、文生图（无参考图）默认分辨率：1024:1024；尺寸约束：宽、高均在 [512, 2048] 像素范围内，宽高乘积 ≤ 1024:1024 像素。二、图生图（有参考图）尺寸约束：宽、高均在 [512, 2048] 像素范围内，宽高乘积 ≤ 1024:1024 像素。传入尺寸时（输出自适应，不严格遵循传入尺寸...", "example": "1024:1024" }, { "name": "Seed", "type": "integer", "required": false, "description": "随机种子，默认随机。不传：随机种子生成。正数：固定种子生成。扩写开启时固定种子不生效，将保持随机。", "example": "148237123" }, { "name": "LogoAdd", "type": "integer", "required": false, "description": "为生成结果图添加显式水印标识的开关，默认为1。1：添加。0：不添加。其他数值：默认按1处理。建议您使用显著标识来提示结果图使用了 AI 绘画技术，是 AI 生成的图片。", "example": "1" }, { "name": "LogoParam", "type": "object", "required": false, "description": "标识内容设置。默认在生成结果图右下角添加“图片由 AI 生成”字样，您可根据自身需要替换为其他的标识图片。", "example": "无", "children": [ { "name": "LogoUrl", "type": "string", "required": false, "description": "水印 Url 注意：此字段可能返回 null，表示取不到有效值。", "example": "https://cos.ap-guangzhou.myqcloud.com/logo.jpg" }, { "name": "LogoImage", "type": "string", "required": false, "description": "水印 Base64，Url 和 Base64 二选一传入，如果都提供以 Url 为准 注意：此字段可能返回 null，表示取不到有效值。", "example": "/9j/4QlQaHR0c...N6a2M5ZCI" }, { "name": "LogoRect", "type": "object", "required": false, "description": "水印图片位于生成结果图中的坐标，将按照坐标对标识图片进行位置和大小的拉伸匹配 注意：此字段可能返回 null，表示取不到有效值。", "example": "{\"X\": 10, \"Y\": 10, \"Width\": 10, \"Height\": 10}", "children": [ { "name": "X", "type": "integer", "required": false, "description": "左上角X坐标 注意：此字段可能返回 null，表示取不到有效值。", "example": "10" }, { "name": "Y", "type": "integer", "required": false, "description": "左上角Y坐标 注意：此字段可能返回 null，表示取不到有效值。", "example": "10" }, { "name": "Width", "type": "integer", "required": false, "description": "方框宽度 注意：此字段可能返回 null，表示取不到有效值。", "example": "10" }, { "name": "Height", "type": "integer", "required": false, "description": "方框高度 注意：此字段可能返回 null，表示取不到有效值。", "example": "10" } ] } ] }, { "name": "Revise", "type": "integer", "required": false, "description": "是否开启prompt改写，为空时默认开启，改写预计会增加20s左右耗时。0：关闭改写1：开启改写建议默认开启，如果关闭改写，需要调用方自己接改写，否则对生图效果有较大影响，改写方法可以参考：改写示例值：1", "example": "0" } ], "required": [ "Prompt" ] }, { "name": "SubmitTextToImageProJob", "description": "本接口已迁移至腾讯混元大模型-混元生图，即将停止此处维护，可切换至 [混元生图 API](https://cloud.tencent.com/document/product/1729/105969) 继续使用。 文生图（高级版）接口基于高级版文生图大模型，将根据输入的文本描述，智能生成与之相关的结果图。分为提交任务和查询任务2个接口。 提交任务：输入文本等，提交一个文生图（高级版）异步任务，获得任务 ID。 查询任务：根据\ufffd\ufffd...", "status": "online", "parameters": [ { "name": "Prompt", "type": "string", "required": true, "description": "文本描述。 算法将根据输入的文本智能生成与之相关的图像。 不能为空，推荐使用中文。最多可传100个 utf-8 字符。", "example": "雨中, 竹林, 小路" }, { "name": "Style", "type": "string", "required": false, "description": "绘画风格。 请在 [文生图（高级版）风格列表](https://cloud.tencent.com/document/product/1668/104567) 中选择期望的风格，传入风格编号。 不传默认不指定风格。", "example": "riman" }, { "name": "Resolution", "type": "string", "required": false, "description": "生成图分辨率。 支持生成以下分辨率的图片：768:768（1:1）、768:1024（3:4）、1024:768（4:3）、1024:1024（1:1）、720:1280（9:16）、1280:720（16:9）、768:1280（3:5）、1280:768（5:3），不传默认使用1024:1024。", "example": "1024:1024" }, { "name": "LogoAdd", "type": "integer", "required": false, "description": "为生成结果图添加显式水印标识的开关，默认为1。 1：添加。 0：不添加。 其他数值：默认按1处理。 建议您使用显著标识来提示结果图使用了 AI 绘画技术，是 AI 生成的图片。", "example": "1" }, { "name": "Engine", "type": "string", "required": false, "description": "文生图模型，默认使用engine1。 取值： engine1 engine2", "example": "engine1" }, { "name": "Revise", "type": "integer", "required": false, "description": "prompt 扩写开关。1为开启，0为关闭，不传默认开启。 开启扩写后，将自动扩写原始输入的 prompt 并使用扩写后的 prompt 生成图片，返回生成图片结果时将一并返回扩写后的 prompt 文本。 如果关闭扩写，将直接使用原始输入的 prompt 生成图片。 建议开启，在多数场景下可提升生成图片效果、丰富生成图片细节。", "example": "0" } ], "required": [ "Prompt" ] }, { "name": "SubmitTrainPortraitModelJob", "description": "AI 写真分为上传训练图片、训练写真模型（可选跳过）、生成写真图片3个环节，需要依次调用对应接口。 如果选择免训练模式无需调用本接口。 训练模型分为提交任务和查询任务2个接口： - 提交训练写真模型任务：完成上传图片后，提交一个训练写真模型异步任务，根据写真模型 ID 开始训练模型。 - 查询训练写真模型任务：根据写真模型 ID 查询训练任务的处理状态、处理\ufffd\ufffd...", "status": "online", "parameters": [ { "name": "ModelId", "type": "string", "required": true, "description": "在上传写真训练图片时指定的写真模型 ID。 每个 AI 写真模型自训练完成起1年内有效，有效期内可使用模型生成图片，期满后需要重新训练模型。", "example": "model_01" } ], "required": [ "ModelId" ] }, { "name": "TextToImageLite", "description": "混元文生图接口，基于混元大模型，根据输入的文本描述智能生成图片 默认提供1个并发，代表最多能同时处理1个已提交的任务，上一个任务处理完毕后，才能开始处理下一个任务。", "status": "online", "parameters": [ { "name": "Prompt", "type": "string", "required": true, "description": "文本描述。将根据输入的文本智能生成与之相关的图像。 不能为空，推荐使用中文。最多可传1024个 utf-8 字符。", "example": "雨中, 竹林, 小路" }, { "name": "NegativePrompt", "type": "string", "required": false, "description": "反向提示词。 减少生成结果中出现描述内容。 推荐使用中文。最多可传1024个 utf-8 字符。", "example": "黑色" }, { "name": "Resolution", "type": "string", "required": false, "description": "生成图分辨率，默认1024:1024。 支持的图像宽高比例: 1:1，3:4，4:3，9:16，16:9。 支持的长边分辨率: 160，200，225，258，512，520，608，768，1024，1080，1280，1600，1620，1920，2048，2400，2560，2592，3440，3840，4096。", "example": "1024:1024" }, { "name": "Seed", "type": "integer", "required": false, "description": "随机种子，默认随机。 0：随机种子生成。 不传：随机种子生成。 正数：固定种子生成。", "example": "1" }, { "name": "LogoAdd", "type": "integer", "required": false, "description": "为生成结果图添加标识的开关，默认为1。 1：添加标识。 0：不添加标识。 其他数值：默认按1处理。 建议您使用显著标识来提示结果图使用了 AI 绘画技术，是 AI 生成的图片。", "example": "1" }, { "name": "LogoParam", "type": "object", "required": false, "description": "标识内容设置。 默认在生成结果图右下角添加“图片由 AI 生成”字样，您可根据自身需要替换为其他的标识图片。", "example": "{\"LogoUrl\": \"https://cos.ap-guangzhou.myqcloud.com/logo.jpg\", \"LogoRect\": {\"X\": 10, \"Y\": 10, \"Width\": 20, \"Height\": 20}}", "children": [ { "name": "LogoUrl", "type": "string", "required": false, "description": "水印 Url 注意：此字段可能返回 null，表示取不到有效值。", "example": "https://cos.ap-guangzhou.myqcloud.com/logo.jpg" }, { "name": "LogoImage", "type": "string", "required": false, "description": "水印 Base64，Url 和 Base64 二选一传入，如果都提供以 Url 为准 注意：此字段可能返回 null，表示取不到有效值。", "example": "/9j/4QlQaHR0c...N6a2M5ZCI" }, { "name": "LogoRect", "type": "object", "required": false, "description": "水印图片位于生成结果图中的坐标，将按照坐标对标识图片进行位置和大小的拉伸匹配 注意：此字段可能返回 null，表示取不到有效值。", "example": "{\"X\": 10, \"Y\": 10, \"Width\": 10, \"Height\": 10}", "children": [ { "name": "X", "type": "integer", "required": false, "description": "左上角X坐标 注意：此字段可能返回 null，表示取不到有效值。", "example": "10" }, { "name": "Y", "type": "integer", "required": false, "description": "左上角Y坐标 注意：此字段可能返回 null，表示取不到有效值。", "example": "10" }, { "name": "Width", "type": "integer", "required": false, "description": "方框宽度 注意：此字段可能返回 null，表示取不到有效值。", "example": "10" }, { "name": "Height", "type": "integer", "required": false, "description": "方框高度 注意：此字段可能返回 null，表示取不到有效值。", "example": "10" } ] } ] }, { "name": "RspImgType", "type": "string", "required": false, "description": "返回图像方式（base64 或 url），二选一，默认为 base64。url 有效期为1小时。", "example": "url" } ], "required": [ "Prompt" ] }, { "name": "TextToImageRapid", "description": "混元文生图接口，基于混元大模型，根据输入的文本描述智能生成图片 默认提供1个并发，代表最多能同时处理1个已提交的任务，上一个任务处理完毕后，才能开始处理下一个任务。", "status": "online", "parameters": [ { "name": "Prompt", "type": "string", "required": true, "description": "文本描述。 算法将根据输入的文本智能生成与之相关的图像。建议详细描述画面主体、细节、场景等，文本描述越丰富，生成效果越精美。 不能为空，推荐使用中文。最多可传256个 utf-8 字符。", "example": "雨中, 竹林, 小路" }, { "name": "Resolution", "type": "string", "required": false, "description": "生成图分辨率，默认1024:1024。 支持的图像宽高比例: 1:1，3:4，4:3，9:16，16:9。 支持的长边分辨率: 160，200，225，258，512，520，608，768，1024，1080，1280，1600，1620，1920，2048，2400，2560，2592，3440，3840，4096。", "example": "1024:1024" }, { "name": "Seed", "type": "integer", "required": false, "description": "随机种子，默认随机。 0：随机种子生成。 不传：随机种子生成。 正数：固定种子生成。", "example": "1" }, { "name": "Image", "type": "object", "required": false, "description": "参考图。 - Base64 和 Url 必须提供一个，如果都提供以 Url 为准。 - 当传入Image参数时，Style和Resolution参数不生效，输出图分辨率将保持Image传入图分辨率。 - 图片限制：单边分辨率大于128且小于2048；图片小于6M；格式支持 jpg、jpeg、png、bmp、tiff、webp。", "example": "无", "children": [ { "name": "Base64", "type": "string", "required": false, "description": "图片Base64", "example": "MIIHNjCCBh6gAwIBAgIQCVe4E0h49mzI0NcSqMy1" }, { "name": "Url", "type": "string", "required": false, "description": "图片Url", "example": "https://cos.ap-guangzhou.myqcloud.com/image.jpg" } ] }, { "name": "Style", "type": "string", "required": false, "description": "生成的图片风格，参考值： 1：宫崎骏风格； 2：新海诚风格； 3：去旅行风格； 4：水彩风格； 5：像素风格； 6：童话世界风格； 7：奇趣卡通风格； 8：赛博朋克风格； 9：极简风格； 10：复古风格； 11：暗黑系风格； 12：波普风风格； 13：糖果色风格； 14：胶片电影风格； 15：素描风格； 16：水墨画风格； 17：油画风格； 18：粉笔风格； 19：粘土风格； 20：毛毡风格； 21：\ufffd\ufffd...", "example": "\"1\"" }, { "name": "LogoAdd", "type": "integer", "required": false, "description": "为生成结果图添加标识的开关，默认为1。 1：添加标识。 0：不添加标识。 其他数值：默认按1处理。 建议您使用显著标识来提示结果图使用了 AI 绘画技术，是 AI 生成的图片。", "example": "1" }, { "name": "LogoParam", "type": "object", "required": false, "description": "标识内容设置。 默认在生成结果图右下角添加“图片由 AI 生成”字样，您可根据自身需要替换为其他的标识图片。", "example": "无", "children": [ { "name": "LogoUrl", "type": "string", "required": false, "description": "水印 Url 注意：此字段可能返回 null，表示取不到有效值。", "example": "https://cos.ap-guangzhou.myqcloud.com/logo.jpg" }, { "name": "LogoImage", "type": "string", "required": false, "description": "水印 Base64，Url 和 Base64 二选一传入，如果都提供以 Url 为准 注意：此字段可能返回 null，表示取不到有效值。", "example": "/9j/4QlQaHR0c...N6a2M5ZCI" }, { "name": "LogoRect", "type": "object", "required": false, "description": "水印图片位于生成结果图中的坐标，将按照坐标对标识图片进行位置和大小的拉伸匹配 注意：此字段可能返回 null，表示取不到有效值。", "example": "{\"X\": 10, \"Y\": 10, \"Width\": 10, \"Height\": 10}", "children": [ { "name": "X", "type": "integer", "required": false, "description": "左上角X坐标 注意：此字段可能返回 null，表示取不到有效值。", "example": "10" }, { "name": "Y", "type": "integer", "required": false, "description": "左上角Y坐标 注意：此字段可能返回 null，表示取不到有效值。", "example": "10" }, { "name": "Width", "type": "integer", "required": false, "description": "方框宽度 注意：此字段可能返回 null，表示取不到有效值。", "example": "10" }, { "name": "Height", "type": "integer", "required": false, "description": "方框高度 注意：此字段可能返回 null，表示取不到有效值。", "example": "10" } ] } ] }, { "name": "RspImgType", "type": "string", "required": false, "description": "返回图像方式（base64 或 url），二选一，默认为 base64。url 有效期为1小时。", "example": "url" } ], "required": [ "Prompt" ] }, { "name": "UploadTrainPortraitImages", "description": "AI 写真分为上传训练图片、训练写真模型（可选跳过）、生成写真图片3个环节，需要依次调用对应接口。 本接口用于上传人像图片并指定对应的写真模型 ID。上传的图片要求是同一个人，建议上传单人、正脸、脸部区域占比较大、脸部清晰无遮挡、无大角度偏转、无夸张表情的图片。 可选模式： - 常规训练模式：上传20 - 25张图片用于模型训练，完成训练后可生成写真图片。 ...", "status": "online", "parameters": [ { "name": "ModelId", "type": "string", "required": true, "description": "写真模型 ID。由英文大小写字母、数字及下划线组成。 用于唯一标识一个写真模型，一个写真模型只能用于一个人物的写真图片生成。", "example": "model_01" }, { "name": "BaseUrl", "type": "string", "required": false, "description": "写真模型训练用的基础图像 URL，用于固定写真模型可生成的人物。 图片数量：1张。 图片内容：单人，脸部清晰。 图片限制：单边分辨率小于2000，转成 Base64 字符串后小于 5MB。", "example": "https://cos.ap-guangzhou.myqcloud.com/image.jpg" }, { "name": "Urls", "type": "array", "required": false, "description": "写真模型训练用的图像 URL 列表，仅常规训练模式需要上传。 图片数量：19 - 24 张。 图片内容：单人，脸部清晰，和基础图像中的人物为同一人。 图片限制：单边分辨率小于2000，转成 Base64 字符串后小于 5MB。", "example": "[\"https://cos.ap-guangzhou.myqcloud.com/image1.jpg\"]", "item_type": "string" }, { "name": "Filter", "type": "object", "required": false, "description": "训练图像质量过滤开关配置。 支持开启或关闭对训练图像分辨率下限、脸部区域大小、脸部遮挡的过滤，默认开启以上过滤。 如果训练图像内包含多人脸或无人脸、和 Base 人像不为同一人也将被过滤，不可关闭该过滤条件。 建议：关闭以上过滤可能导致写真生成效果受损，建议使用单人、正脸、脸部区域占比较大、脸部清晰无遮挡、无大角度偏转、无夸张表情的图像进行训\ufffd\ufffd...", "example": "{\"Resolution\":1,\"Size\":1,\"Occlusion\":1}", "children": [ { "name": "Resolution", "type": "integer", "required": false, "description": "过滤不满足分辨率下限的训练图像，默认开启过滤 开启后将过滤横边\u003c512或竖边\u003c720的图片，横、竖边上限均为2000，不支持调整 1：开启过滤 0：关闭过滤", "example": "1" }, { "name": "Size", "type": "integer", "required": false, "description": "过滤脸部区域过小的训练图像，默认开启过滤 1：开启过滤 0：关闭过滤", "example": "1" }, { "name": "Occlusion", "type": "integer", "required": false, "description": "过滤脸部存在明显遮挡、偏转角度过大等质量较差的训练图像，默认开启过滤 1：开启过滤 0：关闭过滤", "example": "1" } ] }, { "name": "TrainMode", "type": "integer", "required": false, "description": "训练模式。 默认使用常规训练模式。如果使用快速训练模式和免训练模式，只需要在 BaseUrl 中传入1张图片，Urls.N 中无需传入图片。 0：常规训练模式，上传多张图片用于模型训练，完成训练后可生成写真图片。 1：快速训练模式，仅需上传1张图片用于模型训练，训练速度更快，完成训练后可生成写真图片。 2：免训练模式，仅需上传1张图片，跳过模型训练环节，直接生成写真...", "example": "1" } ], "required": [ "ModelId" ] } ] }