tencentcloud-sdk-nodejs-aiart 4.0.1027 → 4.0.1034

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -1,21 +1,20 @@
1
1
  # 简介
2
2
 
3
- 欢迎使用腾讯云开发者工具套件(SDK),NODEJS SDK 4.0 是云 API 3.0 平台的配套工具。
4
- 为方便 NODEJS 开发者调试和接入腾讯云产品 API,这里向您介绍适用于 NODEJS 的腾讯云开发工具包,并提供首次使用开发工具包的简单示例。让您快速获取腾讯云 NODEJS SDK 并开始调用。
3
+ 欢迎使用腾讯云开发者工具套件(SDK),Node.js SDK 4.0 是云 API 3.0 平台的配套工具。
4
+ 为方便 Node.js 开发者调试和接入腾讯云产品 API,这里向您介绍适用于 Node.js 的腾讯云开发工具包,并提供首次使用开发工具包的简单示例。让您快速获取腾讯云 Node.js SDK 并开始调用。
5
5
 
6
6
  # 依赖环境
7
7
 
8
- 1. NODEJS 10.0.0 版本及以上
9
- 2. 从腾讯云控制台 开通相应产品
10
- 3. 获取 SecretID、SecretKey 以及调用地址(endpoint),endpoint 一般形式为\*.tencentcloudapi.com,如 CVM 的调用地址为 cvm.tencentcloudapi.com,具体参考各产品说明。
8
+ 1. Node.js 10.0.0 版本及以上。
9
+ 2. 注意:部分产品需在 [腾讯云控制台](https://console.cloud.tencent.com/) 开通服务后才能使用。
11
10
 
12
11
  # 获取安装
13
12
 
14
- 安装 NODEJS SDK 前,先获取安全凭证。在第一次使用云 API 之前,用户首先需要在腾讯云控制台上申请安全凭证,安全凭证包括 SecretID SecretKey, SecretID 是用于标识 API 调用者的身份,SecretKey 是用于加密签名字符串和服务器端验证签名字符串的密钥。SecretKey 必须严格保管,避免泄露。
13
+ 使用 SDK 需要 API 密钥,可前往 [腾讯云控制台 - 访问密钥](https://console.cloud.tencent.com/cam/capi) 页面申请,API 密钥包括 SecretID SecretKey,密钥须严格保管,避免泄露。
15
14
 
16
- ## 通过 NPM 安装
15
+ ## 通过 npm 安装
17
16
 
18
- 通过 NPM 获取安装是使用 NODEJS SDK 的推荐方法,NPM NODEJS 的包管理工具。关于 NPM 详细可参考 [NPM 官网](https://www.npmjs.com/) 。
17
+ 通过 npm 获取安装是使用 Node.js SDK 的推荐方法,关于 npm 详细可参考 [NPM 官网](https://www.npmjs.com/) 。
19
18
 
20
19
  ### 安装指定产品 SDK(推荐)
21
20
 
@@ -56,10 +55,12 @@ npm install tencentcloud-sdk-nodejs --save
56
55
  1. 前往 [GitHub 仓库](https://github.com/tencentcloud/tencentcloud-sdk-nodejs) 或者 [Gitee 仓库](https://gitee.com/tencentcloud/tencentcloud-sdk-nodejs) 下载源码压缩包。
57
56
  2. 解压源码包到您项目合适的位置,例如 `sdk/tencentcloud-sdk-nodejs`。
58
57
  3. 执行 `npm install ./sdk/tencentcloud-sdk-nodejs`。
59
- 4. 使用 `require("tencentcloud-sdk-nodejs")` 的方式引入SDK,具体可参考示例。
58
+ 4. 使用 `require("tencentcloud-sdk-nodejs")` 的方式引入 SDK,具体可参考示例。
60
59
 
61
60
  # 示例
62
61
 
62
+ 以云服务器产品查询可用区列表接口为例。
63
+
63
64
  ```js
64
65
  const tencentcloud = require("tencentcloud-sdk-nodejs")
65
66
 
@@ -102,7 +103,7 @@ client.DescribeZones().then(
102
103
  )
103
104
  ```
104
105
 
105
- 在支持 typescript 项目中,采用如下方式调用
106
+ 在支持 TypeScript 项目中,采用如下方式调用
106
107
 
107
108
  ```js
108
109
  import * as tencentcloud from "tencentcloud-sdk-nodejs"
@@ -112,10 +113,11 @@ const CvmClient = tencentcloud.cvm.v20170312.Client
112
113
  // ...
113
114
  ```
114
115
 
115
- 实例化`Client` 的入参支持 `clientConfig` 数据结构和说明 详见 [ClientConfig](https://github.com/TencentCloud/tencentcloud-sdk-nodejs/blob/master/src/common/interface.ts)
116
+ 实例化 `Client` 的入参支持 `clientConfig`,数据结构和说明详见 [ClientConfig](https://github.com/TencentCloud/tencentcloud-sdk-nodejs/blob/master/src/common/interface.ts)
116
117
 
117
118
  ## Common Client
118
- 从 4.0.714 版本开始腾讯云 NODEJS SDK 支持使用泛用性的 API 调用方式(Common Client)进行请求。您只需要安装 tencentcloud-sdk-nodejs-common 包,即可向任何产品发起调用。
119
+
120
+ 从 4.0.714 版本开始,腾讯云 Node.js SDK 支持使用泛用性的 API 调用方式(Common Client)进行请求。您只需要安装 tencentcloud-sdk-nodejs-common 包,即可向任何产品发起调用。
119
121
 
120
122
  **注意,您必须明确知道您调用的接口所需参数,否则可能会调用失败。**
121
123
 
@@ -123,19 +125,19 @@ const CvmClient = tencentcloud.cvm.v20170312.Client
123
125
 
124
126
  ## 更多示例
125
127
 
126
- 更丰富的使用 demo 请在 examples 目录中寻找。
128
+ 请参考 [examples](https://github.com/TencentCloud/tencentcloud-sdk-nodejs/tree/master/examples) 目录。
127
129
 
128
130
  # 相关配置
129
131
 
130
132
  ## 代理
131
133
 
132
- 如果是有代理的环境下,需要配置代理,请在创建Client时传入 [profile.httpProfile.proxy](https://github.com/TencentCloud/tencentcloud-sdk-nodejs/blob/master/src/common/interface.ts#L78) 参数,或设置系统环境变量 `http_proxy` ,否则可能无法正常调用,抛出连接超时的异常。
134
+ 如果是有代理的环境下,需要配置代理,请在创建 Client 时传入 [profile.httpProfile.proxy](https://github.com/TencentCloud/tencentcloud-sdk-nodejs/blob/master/src/common/interface.ts#L78) 参数,或设置系统环境变量 `http_proxy` ,否则可能无法正常调用,抛出连接超时的异常。
133
135
 
134
136
  # 凭证管理
135
137
 
136
138
  除显式传入凭证外,从 `v4.0.506` 起支持 [腾讯云实例角色](https://cloud.tencent.com/document/product/213/47668)
137
139
 
138
- 在您为实例绑定角色后,您可以在实例中访问相关元数据接口获取临时凭证。用法可参考 [js示例代码](./examples/cvm_role.js) 或 [ts示例代码](./examples/cvm_role.ts)
140
+ 在您为实例绑定角色后,您可以在实例中访问相关元数据接口获取临时凭证。用法可参考 [js 示例代码](./examples/cvm_role.js) 或 [ts 示例代码](./examples/cvm_role.ts)
139
141
  ```javascript
140
142
  // ...
141
143
  const CvmRoleCredential = require("tencentcloud-sdk-nodejs/tencentcloud/common/cvm_role_credential").default
@@ -147,20 +149,16 @@ new XxxClient({
147
149
  })
148
150
  ```
149
151
 
150
- # 旧版 SDK
151
-
152
- 我们推荐使用新版 NODEJS SDK,如果一定要用旧版 SDK,请前往[GitHub 仓库](https://github.com/CFETeam/qcloudapi-sdk)下载。
153
-
154
152
  # 常见问题
155
- - webpack打包出错/浏览器报错
153
+ - webpack 打包出错/浏览器报错
156
154
 
157
- 请**务必不要**将此SDK直接用于web前端(包括小程序等),暴露密钥在这些环境非常不安全。
155
+ 请**务必不要**将此 SDK 直接用于 Web 前端(包括小程序等),暴露密钥在这些环境非常不安全。
158
156
 
159
- 正确的做法是在自己的服务端引用此SDK,并保存好密钥,做好请求鉴权;前端再调用服务端执行业务流程。
157
+ 正确的做法是在自己的服务端引用此 SDK,并保存好密钥,做好请求鉴权,前端再调用服务端执行业务流程。
160
158
 
161
159
  - `The "original" argument must be of type Function.`
162
160
 
163
- 通常是因为nodejs版本低于 `v10` ,或处于非node环境,请再次确认执行环境。
161
+ 通常是因为 Node.js 版本低于 `v10` ,或处于非 Node.js 环境,请再次确认执行环境。
164
162
 
165
163
  - 请求不通
166
164
 
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "tencentcloud-sdk-nodejs-aiart",
3
- "version": "4.0.1027",
3
+ "version": "4.0.1034",
4
4
  "description": "Tencent Cloud API NODEJS SDK",
5
5
  "main": "tencentcloud/index.js",
6
6
  "scripts": {
@@ -20,35 +20,41 @@ import {
20
20
  SubmitDrawPortraitJobResponse,
21
21
  LogoParam,
22
22
  ImageToImageRequest,
23
- QueryMemeJobRequest,
23
+ QueryTrainPortraitModelJobRequest,
24
24
  QueryTextToImageProJobResponse,
25
25
  UploadTrainPortraitImagesRequest,
26
26
  ResultConfig,
27
- QueryTrainPortraitModelJobRequest,
28
- ChangeClothesRequest,
29
- ReplaceBackgroundResponse,
27
+ QueryMemeJobRequest,
28
+ QueryGlamPicJobResponse,
30
29
  ImageOutpaintingRequest,
30
+ ReplaceBackgroundResponse,
31
31
  QueryMemeJobResponse,
32
32
  QueryDrawPortraitJobResponse,
33
33
  QueryTrainPortraitModelJobResponse,
34
34
  ChangeClothesResponse,
35
+ SubmitGlamPicJobResponse,
35
36
  SubmitMemeJobResponse,
36
37
  SubmitTrainPortraitModelJobRequest,
37
38
  SketchToImageRequest,
38
39
  TextToImageRequest,
40
+ Rect,
41
+ FaceInfo,
39
42
  SubmitTextToImageProJobResponse,
43
+ SubmitGlamPicJobRequest,
40
44
  GenerateAvatarRequest,
41
45
  LogoRect,
42
46
  Filter,
43
47
  ImageInpaintingRemovalResponse,
44
48
  SubmitMemeJobRequest,
49
+ ReplaceBackgroundRequest,
45
50
  SubmitTextToImageProJobRequest,
46
51
  SubmitTrainPortraitModelJobResponse,
47
52
  QueryDrawPortraitJobRequest,
48
53
  ImageToImageResponse,
49
54
  SketchToImageResponse,
55
+ QueryGlamPicJobRequest,
50
56
  ImageInpaintingRemovalRequest,
51
- ReplaceBackgroundRequest,
57
+ ChangeClothesRequest,
52
58
  ImageOutpaintingResponse,
53
59
  UploadTrainPortraitImagesResponse,
54
60
  QueryTextToImageProJobRequest,
@@ -204,6 +210,20 @@ export class Client extends TencentCloudCommon.AbstractClient {
204
210
  return this.request("QueryDrawPortraitJob", req, cb)
205
211
  }
206
212
 
213
+ /**
214
+ * AI 美照接口将根据模板为用户生成精美照片。分为提交任务和查询任务2个接口。
215
+ - 提交任务:提交一个美照生成异步任务,获得任务 ID。
216
+ - 查询任务:根据任务 ID 查询任务的处理状态、处理结果,任务处理完成后可获得生成图像结果。
217
+
218
+ AI 美照默认提供1个并发,代表最多能同时处理1个已提交的任务,上一个任务处理完毕后才能开始处理下一个任务。
219
+ */
220
+ async QueryGlamPicJob(
221
+ req: QueryGlamPicJobRequest,
222
+ cb?: (error: string, rep: QueryGlamPicJobResponse) => void
223
+ ): Promise<QueryGlamPicJobResponse> {
224
+ return this.request("QueryGlamPicJob", req, cb)
225
+ }
226
+
207
227
  /**
208
228
  * AI 写真分为上传训练图片、训练写真模型(可选跳过)、生成写真图片3个环节,需要依次调用对应接口。
209
229
  本接口用于上传人像图片并指定对应的写真模型 ID。上传的图片要求是同一个人,建议上传单人、正脸、脸部区域占比较大、脸部清晰无遮挡、无大角度偏转、无夸张表情的图片。
@@ -249,6 +269,20 @@ export class Client extends TencentCloudCommon.AbstractClient {
249
269
  return this.request("QueryTextToImageProJob", req, cb)
250
270
  }
251
271
 
272
+ /**
273
+ * AI 美照接口将根据模板为用户生成精美照片。分为提交任务和查询任务2个接口。
274
+ - 提交任务:提交一个美照生成异步任务,获得任务 ID。
275
+ - 查询任务:根据任务 ID 查询任务的处理状态、处理结果,任务处理完成后可获得生成图像结果。
276
+
277
+ AI 美照默认提供1个并发,代表最多能同时处理1个已提交的任务,上一个任务处理完毕后才能开始处理下一个任务。
278
+ */
279
+ async SubmitGlamPicJob(
280
+ req: SubmitGlamPicJobRequest,
281
+ cb?: (error: string, rep: SubmitGlamPicJobResponse) => void
282
+ ): Promise<SubmitGlamPicJobResponse> {
283
+ return this.request("SubmitGlamPicJob", req, cb)
284
+ }
285
+
252
286
  /**
253
287
  * AI 写真分为上传训练图片、训练写真模型(可选跳过)、生成写真图片3个环节,需要依次调用对应接口。
254
288
  生成图片分为提交任务和查询任务2个接口:
@@ -128,13 +128,14 @@ Strength 值越小,生成图和原图越接近,取值范围(0, 1],不传
128
128
  }
129
129
 
130
130
  /**
131
- * QueryMemeJob请求参数结构体
131
+ * QueryTrainPortraitModelJob请求参数结构体
132
132
  */
133
- export interface QueryMemeJobRequest {
133
+ export interface QueryTrainPortraitModelJobRequest {
134
134
  /**
135
- * 查询表情动图生成任务 ID。
135
+ * 写真模型 ID。
136
+
136
137
  */
137
- JobId: string
138
+ ModelId: string
138
139
  }
139
140
 
140
141
  /**
@@ -235,79 +236,49 @@ export interface ResultConfig {
235
236
  }
236
237
 
237
238
  /**
238
- * QueryTrainPortraitModelJob请求参数结构体
239
+ * QueryMemeJob请求参数结构体
239
240
  */
240
- export interface QueryTrainPortraitModelJobRequest {
241
+ export interface QueryMemeJobRequest {
241
242
  /**
242
- * 写真模型 ID。
243
-
243
+ * 查询表情动图生成任务 ID。
244
244
  */
245
- ModelId: string
245
+ JobId: string
246
246
  }
247
247
 
248
248
  /**
249
- * ChangeClothes请求参数结构体
249
+ * QueryGlamPicJob返回参数结构体
250
250
  */
251
- export interface ChangeClothesRequest {
252
- /**
253
- * 模特图片 Url。
254
- 图片限制:单边分辨率小于3000,且大于512,转成 Base64 字符串后小于 8MB。
255
- 输入要求:
256
- 1、建议上传正面模特图片,至少完整露出应穿着输入指定服装的身体部位(全身、上半身或下半身),无大角度身体偏转或异常姿势。
257
- 2、建议上传3:4比例的图片,生成效果更佳。
258
- 3、建议模特图片中的原始服装和更换后的服装类别一致,或原始服装在身体上的覆盖范围小于等于更换后的服装(例如需要给模特换上短裤,则原始模特图片中也建议穿短裤,不建议穿长裤),否则会影响人像生成效果。
259
-
260
- */
261
- ModelUrl: string
251
+ export interface QueryGlamPicJobResponse {
262
252
  /**
263
- * 服装图片 Url。
264
- 图片限制:单边分辨率小于3000,大于512,转成 Base64 字符串后小于 8MB。
265
- 输入要求:
266
- 建议上传服装完整的正面平铺图片,仅包含1个服装主体,服装类型支持上衣、下装、连衣裙,三选一。算法将根据输入的图片,结合服装图片给模特换装。
253
+ * 当前任务状态码:
254
+ 1:等待中、2:运行中、4:处理失败、5:处理完成。
267
255
  */
268
- ClothesUrl: string
256
+ JobStatusCode?: string
269
257
  /**
270
- * 服装类型,需要和服装图片保持一致。
271
- 取值:
272
- Upper-body:上衣
273
- Lower-body:下装
274
- Dress:连衣裙
258
+ * 当前任务状态:排队中、处理中、处理失败或者处理完成。
259
+
275
260
  */
276
- ClothesType: string
261
+ JobStatusMsg?: string
277
262
  /**
278
- * 为生成结果图添加标识的开关,默认为1。
279
- 1:添加标识。
280
- 0:不添加标识。
281
- 其他数值:默认按1处理。
282
- 建议您使用显著标识来提示结果图使用了 AI 绘画技术,是 AI 生成的图片。
263
+ * 任务处理失败错误码。
264
+
283
265
  */
284
- LogoAdd?: number
266
+ JobErrorCode?: string
285
267
  /**
286
- * 标识内容设置。
287
- 默认在生成结果图右下角添加“图片由 AI 生成”字样,您可根据自身需要替换为其他的标识图片。
268
+ * 任务处理失败错误信息。
269
+
288
270
  */
289
- LogoParam?: LogoParam
271
+ JobErrorMsg?: string
290
272
  /**
291
- * 返回图像方式(base64 url) ,二选一,默认为 base64。url 有效期为1小时。
292
- 生成图分辨率较大时建议选择 url,使用 base64 可能因图片过大导致返回失败。
293
- */
294
- RspImgType?: string
295
- }
273
+ * 生成图 URL 列表,有效期1小时,请及时保存。
296
274
 
297
- /**
298
- * ReplaceBackground返回参数结构体
299
- */
300
- export interface ReplaceBackgroundResponse {
301
- /**
302
- * 根据入参 RspImgType 填入不同,返回不同的内容。
303
- 如果传入 base64 则返回生成图 Base64 编码。
304
- 如果传入 url 则返回的生成图 URL , 有效期1小时,请及时保存。
305
275
  */
306
- ResultImage?: string
276
+ ResultImage?: Array<string>
307
277
  /**
308
- * 如果 MaskUrl 未传,则返回使用内置商品分割算法得到的 Mask 结果。
278
+ * 结果 detail 数组,Success 代表成功。
279
+
309
280
  */
310
- MaskImage?: string
281
+ ResultDetails?: Array<string>
311
282
  /**
312
283
  * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
313
284
  */
@@ -354,6 +325,26 @@ Base64 和 Url 必须提供一个,如果都提供以 Url 为准。
354
325
  LogoParam?: LogoParam
355
326
  }
356
327
 
328
+ /**
329
+ * ReplaceBackground返回参数结构体
330
+ */
331
+ export interface ReplaceBackgroundResponse {
332
+ /**
333
+ * 根据入参 RspImgType 填入不同,返回不同的内容。
334
+ 如果传入 base64 则返回生成图 Base64 编码。
335
+ 如果传入 url 则返回的生成图 URL , 有效期1小时,请及时保存。
336
+ */
337
+ ResultImage?: string
338
+ /**
339
+ * 如果 MaskUrl 未传,则返回使用内置商品分割算法得到的 Mask 结果。
340
+ */
341
+ MaskImage?: string
342
+ /**
343
+ * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
344
+ */
345
+ RequestId?: string
346
+ }
347
+
357
348
  /**
358
349
  * QueryMemeJob返回参数结构体
359
350
  */
@@ -466,6 +457,20 @@ export interface ChangeClothesResponse {
466
457
  RequestId?: string
467
458
  }
468
459
 
460
+ /**
461
+ * SubmitGlamPicJob返回参数结构体
462
+ */
463
+ export interface SubmitGlamPicJobResponse {
464
+ /**
465
+ * 任务ID。
466
+ */
467
+ JobId?: string
468
+ /**
469
+ * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
470
+ */
471
+ RequestId?: string
472
+ }
473
+
469
474
  /**
470
475
  * SubmitMemeJob返回参数结构体
471
476
  */
@@ -580,6 +585,42 @@ export interface TextToImageRequest {
580
585
  RspImgType?: string
581
586
  }
582
587
 
588
+ /**
589
+ * 人脸框坐标
590
+ */
591
+ export interface Rect {
592
+ /**
593
+ * 人脸框左上角横坐标。
594
+ */
595
+ X?: number
596
+ /**
597
+ * 人脸框左上角纵坐标。
598
+ */
599
+ Y?: number
600
+ /**
601
+ * 人脸框宽度。
602
+ */
603
+ Width?: number
604
+ /**
605
+ * 人脸框高度。
606
+ */
607
+ Height?: number
608
+ }
609
+
610
+ /**
611
+ * 融合信息
612
+ */
613
+ export interface FaceInfo {
614
+ /**
615
+ * 用户图 URL 列表
616
+ */
617
+ ImageUrls?: Array<string>
618
+ /**
619
+ * 模版图人脸坐标。
620
+ */
621
+ TemplateFaceRect?: Rect
622
+ }
623
+
583
624
  /**
584
625
  * SubmitTextToImageProJob返回参数结构体
585
626
  */
@@ -594,6 +635,60 @@ export interface SubmitTextToImageProJobResponse {
594
635
  RequestId?: string
595
636
  }
596
637
 
638
+ /**
639
+ * SubmitGlamPicJob请求参数结构体
640
+ */
641
+ export interface SubmitGlamPicJobRequest {
642
+ /**
643
+ * 美照模板图 URL。
644
+ 图片限制:模板图中最多出现5张人脸,单边分辨率大于300,转成 Base64 字符串后小于 10MB,格式支持 jpg、jpeg、png、bmp、tiff、webp。
645
+ */
646
+ TemplateUrl: string
647
+ /**
648
+ * 用户图 URL 列表,以及模板图中需要替换成用户的人脸框信息。
649
+ 一张美照中可包含1 ~ 5个用户形象。每个用户需上传1 ~ 6张照片,如果图中存在多个人脸将取最大人脸。
650
+ 模板图中的人脸数量需要大于等于用户个数。如果不传每个用户在模板图中的人脸框位置,默认按照模板图人脸框从大到小的顺序进行替换。如需自定义顺序,需要依次上传每个用户在模板图中的人脸框位置。
651
+ 图片限制:每张图片转成 Base64 字符串后小于 10MB,格式支持 jpg、jpeg、png、bmp、tiff、webp。建议使用单人、正脸、脸部区域占比较大、脸部清晰无遮挡、无大角度偏转、无夸张表情的用户图。
652
+ */
653
+ FaceInfos?: Array<FaceInfo>
654
+ /**
655
+ * 美照生成数量。
656
+ 支持1 ~ 4张,默认生成4张。
657
+ */
658
+ Num?: number
659
+ /**
660
+ * 美照生成风格。
661
+ 仅对单人美照生效,单人可支持选择不同风格。需按照美照生成数量,在数组中逐一填入每张美照的风格名称。如果不传,默认取不重复的随机风格顺序。
662
+ 多人美照只支持 balanced 一种风格,该参数不生效。
663
+ 可选风格:<ul><li>real:面部相似度更高。</li><li>balanced:平衡面部真实感和美观度。</li><li>extured:脸部皮肤更具真实感。</li><li>beautiful:脸部美观度更高。</li></ul>
664
+ */
665
+ Style?: Array<string>
666
+ /**
667
+ * 相似度系数,越高越像用户图。
668
+ 取值范围[0, 1],默认为0.6。
669
+ */
670
+ Similarity?: number
671
+ /**
672
+ * 超分选项,默认不做超分,可选开启。
673
+ x2:2倍超分
674
+ x4:4倍超分
675
+ */
676
+ Clarity?: string
677
+ /**
678
+ * 为生成结果图添加标识的开关,默认为1。
679
+ 1:添加标识。
680
+ 0:不添加标识。
681
+ 其他数值:默认按1处理。
682
+ 建议您使用显著标识来提示结果图是 AI 生成的图片。
683
+ */
684
+ LogoAdd?: number
685
+ /**
686
+ * 标识内容设置。
687
+ 默认在生成结果图右下角添加“图片由 AI 生成”字样,您可根据自身需要替换为其他的标识图片。
688
+ */
689
+ LogoParam?: LogoParam
690
+ }
691
+
597
692
  /**
598
693
  * GenerateAvatar请求参数结构体
599
694
  */
@@ -773,6 +868,69 @@ false:不裁剪过长的头发。
773
868
  LogoParam?: LogoParam
774
869
  }
775
870
 
871
+ /**
872
+ * ReplaceBackground请求参数结构体
873
+ */
874
+ export interface ReplaceBackgroundRequest {
875
+ /**
876
+ * 商品原图 Url。
877
+ 图片限制:单边分辨率小于4000,长宽比在2:5 ~ 5:2之间,转成 Base64 字符串后小于 6MB,格式支持 jpg、jpeg、png、bmp、tiff、webp。
878
+ */
879
+ ProductUrl: string
880
+ /**
881
+ * 对新背景的文本描述。
882
+ 最多支持256个 utf-8 字符,支持中、英文。
883
+ 如果 Prompt = "BackgroundTemplate" 代表启用背景模板,需要在参数 BackgroundTemplate 中指定一个背景名称。
884
+ */
885
+ Prompt: string
886
+ /**
887
+ * 反向提示词。
888
+ 最多支持256个 utf-8 字符,支持中、英文。
889
+ */
890
+ NegativePrompt?: string
891
+ /**
892
+ * 商品图中的商品主体名称。
893
+ 建议说明商品主体,否则影响生成效果。
894
+ */
895
+ Product?: string
896
+ /**
897
+ * 背景模板。
898
+ 仅当 Prompt = "BackgroundTemplate" 时生效,可支持的模板详见 [商品背景模板列表](https://cloud.tencent.com/document/product/1668/115391) ,请传入字段“背景名称”中的值。
899
+ */
900
+ BackgroundTemplate?: string
901
+ /**
902
+ * 商品 Mask 图 Url,要求背景透明,保留商品主体。
903
+ 如果不传,将自动使用内置的商品分割算法得到 Mask。
904
+ 支持自定义上传 Mask,如果该参数不为空,则以实际上传的数据为准。
905
+ 图片限制:Mask 图必须和商品原图分辨率一致,转成 Base64 字符串后小于 6MB,格式仅支持 png。
906
+ */
907
+ MaskUrl?: string
908
+ /**
909
+ * 替换背景后生成的商品图分辨率。
910
+ 支持生成单边分辨率大于500且小于4000、长宽比在2:5 ~ 5:2之间的图片,不传默认生成1280:1280。
911
+ 建议图片比例为1:1、9:16、16:9,生成效果更佳,使用其他比例的生成效果可能不如建议比例。
912
+ */
913
+ Resolution?: string
914
+ /**
915
+ * 为生成结果图添加标识的开关,默认为1。
916
+ 1:添加标识。
917
+ 0:不添加标识。
918
+ 其他数值:默认按1处理。
919
+ 建议您使用显著标识来提示结果图是 AI 生成的图片。
920
+ */
921
+ LogoAdd?: number
922
+ /**
923
+ * 标识内容设置。
924
+ 默认在生成结果图右下角添加“图片由 AI 生成”字样,您可根据自身需要替换为其他的标识图片。
925
+ */
926
+ LogoParam?: LogoParam
927
+ /**
928
+ * 返回图像方式(base64 或 url) ,二选一,默认为 base64。url 有效期为1小时。
929
+ 生成图分辨率较大时建议选择 url,使用 base64 可能因图片过大导致返回失败。
930
+ */
931
+ RspImgType?: string
932
+ }
933
+
776
934
  /**
777
935
  * SubmitTextToImageProJob请求参数结构体
778
936
  */
@@ -870,6 +1028,16 @@ export interface SketchToImageResponse {
870
1028
  RequestId?: string
871
1029
  }
872
1030
 
1031
+ /**
1032
+ * QueryGlamPicJob请求参数结构体
1033
+ */
1034
+ export interface QueryGlamPicJobRequest {
1035
+ /**
1036
+ * 任务ID。
1037
+ */
1038
+ JobId: string
1039
+ }
1040
+
873
1041
  /**
874
1042
  * ImageInpaintingRemoval请求参数结构体
875
1043
  */
@@ -920,54 +1088,40 @@ Mask 的 Base64 和 Url 必须提供一个,如果都提供以 Url 为准。
920
1088
  }
921
1089
 
922
1090
  /**
923
- * ReplaceBackground请求参数结构体
1091
+ * ChangeClothes请求参数结构体
924
1092
  */
925
- export interface ReplaceBackgroundRequest {
926
- /**
927
- * 商品原图 Url。
928
- 图片限制:单边分辨率小于4000,长宽比在2:5 ~ 5:2之间,转成 Base64 字符串后小于 6MB,格式支持 jpg、jpeg、png、bmp、tiff、webp。
929
- */
930
- ProductUrl: string
931
- /**
932
- * 对新背景的文本描述。
933
- 最多支持256个 utf-8 字符,支持中、英文。
934
- 如果 Prompt = "BackgroundTemplate" 代表启用背景模板,需要在参数 BackgroundTemplate 中指定一个背景名称。
935
- */
936
- Prompt: string
937
- /**
938
- * 反向提示词。
939
- 最多支持256个 utf-8 字符,支持中、英文。
940
- */
941
- NegativePrompt?: string
942
- /**
943
- * 商品图中的商品主体名称。
944
- 建议说明商品主体,否则影响生成效果。
945
- */
946
- Product?: string
1093
+ export interface ChangeClothesRequest {
947
1094
  /**
948
- * 背景模板。
949
- 仅当 Prompt = "BackgroundTemplate" 时生效,可支持的模板详见 [商品背景模板列表](https://cloud.tencent.com/document/product/1668/115391) ,请传入字段“背景名称”中的值。
1095
+ * 模特图片 Url。
1096
+ 图片限制:单边分辨率小于3000,且大于512,转成 Base64 字符串后小于 8MB。
1097
+ 输入要求:
1098
+ 1、建议上传正面模特图片,至少完整露出应穿着输入指定服装的身体部位(全身、上半身或下半身),无大角度身体偏转或异常姿势。
1099
+ 2、建议上传3:4比例的图片,生成效果更佳。
1100
+ 3、建议模特图片中的原始服装和更换后的服装类别一致,或原始服装在身体上的覆盖范围小于等于更换后的服装(例如需要给模特换上短裤,则原始模特图片中也建议穿短裤,不建议穿长裤),否则会影响人像生成效果。
1101
+
950
1102
  */
951
- BackgroundTemplate?: string
1103
+ ModelUrl: string
952
1104
  /**
953
- * 商品 Mask 图 Url,要求背景透明,保留商品主体。
954
- 如果不传,将自动使用内置的商品分割算法得到 Mask
955
- 支持自定义上传 Mask,如果该参数不为空,则以实际上传的数据为准。
956
- 图片限制:Mask 图必须和商品原图分辨率一致,转成 Base64 字符串后小于 6MB,格式仅支持 png。
1105
+ * 服装图片 Url
1106
+ 图片限制:单边分辨率小于3000,大于512,转成 Base64 字符串后小于 8MB
1107
+ 输入要求:
1108
+ 建议上传服装完整的正面平铺图片,仅包含1个服装主体,服装类型支持上衣、下装、连衣裙,三选一。算法将根据输入的图片,结合服装图片给模特换装。
957
1109
  */
958
- MaskUrl?: string
1110
+ ClothesUrl: string
959
1111
  /**
960
- * 替换背景后生成的商品图分辨率。
961
- 支持生成单边分辨率大于500且小于4000、长宽比在2:5 ~ 5:2之间的图片,不传默认生成1280:1280。
962
- 建议图片比例为1:1、9:16、16:9,生成效果更佳,使用其他比例的生成效果可能不如建议比例。
1112
+ * 服装类型,需要和服装图片保持一致。
1113
+ 取值:
1114
+ Upper-body:上衣
1115
+ Lower-body:下装
1116
+ Dress:连衣裙
963
1117
  */
964
- Resolution?: string
1118
+ ClothesType: string
965
1119
  /**
966
1120
  * 为生成结果图添加标识的开关,默认为1。
967
1121
  1:添加标识。
968
1122
  0:不添加标识。
969
1123
  其他数值:默认按1处理。
970
- 建议您使用显著标识来提示结果图是 AI 生成的图片。
1124
+ 建议您使用显著标识来提示结果图使用了 AI 绘画技术,是 AI 生成的图片。
971
1125
  */
972
1126
  LogoAdd?: number
973
1127
  /**
@@ -1,5 +1,5 @@
1
1
  import * as TencentCloudCommon from "tencentcloud-sdk-nodejs-common";
2
- import { SubmitDrawPortraitJobResponse, ImageToImageRequest, QueryMemeJobRequest, QueryTextToImageProJobResponse, UploadTrainPortraitImagesRequest, QueryTrainPortraitModelJobRequest, ChangeClothesRequest, ReplaceBackgroundResponse, ImageOutpaintingRequest, QueryMemeJobResponse, QueryDrawPortraitJobResponse, QueryTrainPortraitModelJobResponse, ChangeClothesResponse, SubmitMemeJobResponse, SubmitTrainPortraitModelJobRequest, SketchToImageRequest, TextToImageRequest, SubmitTextToImageProJobResponse, GenerateAvatarRequest, ImageInpaintingRemovalResponse, SubmitMemeJobRequest, SubmitTextToImageProJobRequest, SubmitTrainPortraitModelJobResponse, QueryDrawPortraitJobRequest, ImageToImageResponse, SketchToImageResponse, ImageInpaintingRemovalRequest, ReplaceBackgroundRequest, ImageOutpaintingResponse, UploadTrainPortraitImagesResponse, QueryTextToImageProJobRequest, GenerateAvatarResponse, TextToImageResponse, SubmitDrawPortraitJobRequest } from "./aiart_models";
2
+ import { SubmitDrawPortraitJobResponse, ImageToImageRequest, QueryTrainPortraitModelJobRequest, QueryTextToImageProJobResponse, UploadTrainPortraitImagesRequest, QueryMemeJobRequest, QueryGlamPicJobResponse, ImageOutpaintingRequest, ReplaceBackgroundResponse, QueryMemeJobResponse, QueryDrawPortraitJobResponse, QueryTrainPortraitModelJobResponse, ChangeClothesResponse, SubmitGlamPicJobResponse, SubmitMemeJobResponse, SubmitTrainPortraitModelJobRequest, SketchToImageRequest, TextToImageRequest, SubmitTextToImageProJobResponse, SubmitGlamPicJobRequest, GenerateAvatarRequest, ImageInpaintingRemovalResponse, SubmitMemeJobRequest, ReplaceBackgroundRequest, SubmitTextToImageProJobRequest, SubmitTrainPortraitModelJobResponse, QueryDrawPortraitJobRequest, ImageToImageResponse, SketchToImageResponse, QueryGlamPicJobRequest, ImageInpaintingRemovalRequest, ChangeClothesRequest, ImageOutpaintingResponse, UploadTrainPortraitImagesResponse, QueryTextToImageProJobRequest, GenerateAvatarResponse, TextToImageResponse, SubmitDrawPortraitJobRequest } from "./aiart_models";
3
3
  /**
4
4
  * aiart client
5
5
  * @class
@@ -84,6 +84,14 @@ export declare class Client extends TencentCloudCommon.AbstractClient {
84
84
  每个写真模型自训练完成起1年内有效,有效期内可使用写真模型 ID 生成图片,期满后需要重新训练。
85
85
  */
86
86
  QueryDrawPortraitJob(req: QueryDrawPortraitJobRequest, cb?: (error: string, rep: QueryDrawPortraitJobResponse) => void): Promise<QueryDrawPortraitJobResponse>;
87
+ /**
88
+ * AI 美照接口将根据模板为用户生成精美照片。分为提交任务和查询任务2个接口。
89
+ - 提交任务:提交一个美照生成异步任务,获得任务 ID。
90
+ - 查询任务:根据任务 ID 查询任务的处理状态、处理结果,任务处理完成后可获得生成图像结果。
91
+
92
+ AI 美照默认提供1个并发,代表最多能同时处理1个已提交的任务,上一个任务处理完毕后才能开始处理下一个任务。
93
+ */
94
+ QueryGlamPicJob(req: QueryGlamPicJobRequest, cb?: (error: string, rep: QueryGlamPicJobResponse) => void): Promise<QueryGlamPicJobResponse>;
87
95
  /**
88
96
  * AI 写真分为上传训练图片、训练写真模型(可选跳过)、生成写真图片3个环节,需要依次调用对应接口。
89
97
  本接口用于上传人像图片并指定对应的写真模型 ID。上传的图片要求是同一个人,建议上传单人、正脸、脸部区域占比较大、脸部清晰无遮挡、无大角度偏转、无夸张表情的图片。
@@ -111,6 +119,14 @@ export declare class Client extends TencentCloudCommon.AbstractClient {
111
119
  并发任务数(并发)说明:并发任务数指能同时处理的任务数量。文生图(高级版)默认提供1个并发任务数,代表最多能同时处理1个已提交的任务,上一个任务处理完毕后才能开始处理下一个任务。
112
120
  */
113
121
  QueryTextToImageProJob(req: QueryTextToImageProJobRequest, cb?: (error: string, rep: QueryTextToImageProJobResponse) => void): Promise<QueryTextToImageProJobResponse>;
122
+ /**
123
+ * AI 美照接口将根据模板为用户生成精美照片。分为提交任务和查询任务2个接口。
124
+ - 提交任务:提交一个美照生成异步任务,获得任务 ID。
125
+ - 查询任务:根据任务 ID 查询任务的处理状态、处理结果,任务处理完成后可获得生成图像结果。
126
+
127
+ AI 美照默认提供1个并发,代表最多能同时处理1个已提交的任务,上一个任务处理完毕后才能开始处理下一个任务。
128
+ */
129
+ SubmitGlamPicJob(req: SubmitGlamPicJobRequest, cb?: (error: string, rep: SubmitGlamPicJobResponse) => void): Promise<SubmitGlamPicJobResponse>;
114
130
  /**
115
131
  * AI 写真分为上传训练图片、训练写真模型(可选跳过)、生成写真图片3个环节,需要依次调用对应接口。
116
132
  生成图片分为提交任务和查询任务2个接口:
@@ -125,6 +125,16 @@ class Client extends TencentCloudCommon.AbstractClient {
125
125
  async QueryDrawPortraitJob(req, cb) {
126
126
  return this.request("QueryDrawPortraitJob", req, cb);
127
127
  }
128
+ /**
129
+ * AI 美照接口将根据模板为用户生成精美照片。分为提交任务和查询任务2个接口。
130
+ - 提交任务:提交一个美照生成异步任务,获得任务 ID。
131
+ - 查询任务:根据任务 ID 查询任务的处理状态、处理结果,任务处理完成后可获得生成图像结果。
132
+
133
+ AI 美照默认提供1个并发,代表最多能同时处理1个已提交的任务,上一个任务处理完毕后才能开始处理下一个任务。
134
+ */
135
+ async QueryGlamPicJob(req, cb) {
136
+ return this.request("QueryGlamPicJob", req, cb);
137
+ }
128
138
  /**
129
139
  * AI 写真分为上传训练图片、训练写真模型(可选跳过)、生成写真图片3个环节,需要依次调用对应接口。
130
140
  本接口用于上传人像图片并指定对应的写真模型 ID。上传的图片要求是同一个人,建议上传单人、正脸、脸部区域占比较大、脸部清晰无遮挡、无大角度偏转、无夸张表情的图片。
@@ -158,6 +168,16 @@ class Client extends TencentCloudCommon.AbstractClient {
158
168
  async QueryTextToImageProJob(req, cb) {
159
169
  return this.request("QueryTextToImageProJob", req, cb);
160
170
  }
171
+ /**
172
+ * AI 美照接口将根据模板为用户生成精美照片。分为提交任务和查询任务2个接口。
173
+ - 提交任务:提交一个美照生成异步任务,获得任务 ID。
174
+ - 查询任务:根据任务 ID 查询任务的处理状态、处理结果,任务处理完成后可获得生成图像结果。
175
+
176
+ AI 美照默认提供1个并发,代表最多能同时处理1个已提交的任务,上一个任务处理完毕后才能开始处理下一个任务。
177
+ */
178
+ async SubmitGlamPicJob(req, cb) {
179
+ return this.request("SubmitGlamPicJob", req, cb);
180
+ }
161
181
  /**
162
182
  * AI 写真分为上传训练图片、训练写真模型(可选跳过)、生成写真图片3个环节,需要依次调用对应接口。
163
183
  生成图片分为提交任务和查询任务2个接口:
@@ -108,13 +108,14 @@ export interface ImageToImageRequest {
108
108
  RestoreFace?: number;
109
109
  }
110
110
  /**
111
- * QueryMemeJob请求参数结构体
111
+ * QueryTrainPortraitModelJob请求参数结构体
112
112
  */
113
- export interface QueryMemeJobRequest {
113
+ export interface QueryTrainPortraitModelJobRequest {
114
114
  /**
115
- * 查询表情动图生成任务 ID。
115
+ * 写真模型 ID。
116
+
116
117
  */
117
- JobId: string;
118
+ ModelId: string;
118
119
  }
119
120
  /**
120
121
  * QueryTextToImageProJob返回参数结构体
@@ -211,77 +212,48 @@ export interface ResultConfig {
211
212
  Resolution?: string;
212
213
  }
213
214
  /**
214
- * QueryTrainPortraitModelJob请求参数结构体
215
+ * QueryMemeJob请求参数结构体
215
216
  */
216
- export interface QueryTrainPortraitModelJobRequest {
217
+ export interface QueryMemeJobRequest {
217
218
  /**
218
- * 写真模型 ID。
219
-
219
+ * 查询表情动图生成任务 ID。
220
220
  */
221
- ModelId: string;
221
+ JobId: string;
222
222
  }
223
223
  /**
224
- * ChangeClothes请求参数结构体
224
+ * QueryGlamPicJob返回参数结构体
225
225
  */
226
- export interface ChangeClothesRequest {
227
- /**
228
- * 模特图片 Url。
229
- 图片限制:单边分辨率小于3000,且大于512,转成 Base64 字符串后小于 8MB。
230
- 输入要求:
231
- 1、建议上传正面模特图片,至少完整露出应穿着输入指定服装的身体部位(全身、上半身或下半身),无大角度身体偏转或异常姿势。
232
- 2、建议上传3:4比例的图片,生成效果更佳。
233
- 3、建议模特图片中的原始服装和更换后的服装类别一致,或原始服装在身体上的覆盖范围小于等于更换后的服装(例如需要给模特换上短裤,则原始模特图片中也建议穿短裤,不建议穿长裤),否则会影响人像生成效果。
234
-
235
- */
236
- ModelUrl: string;
237
- /**
238
- * 服装图片 Url。
239
- 图片限制:单边分辨率小于3000,大于512,转成 Base64 字符串后小于 8MB。
240
- 输入要求:
241
- 建议上传服装完整的正面平铺图片,仅包含1个服装主体,服装类型支持上衣、下装、连衣裙,三选一。算法将根据输入的图片,结合服装图片给模特换装。
242
- */
243
- ClothesUrl: string;
226
+ export interface QueryGlamPicJobResponse {
244
227
  /**
245
- * 服装类型,需要和服装图片保持一致。
246
- 取值:
247
- Upper-body:上衣
248
- Lower-body:下装
249
- Dress:连衣裙
228
+ * 当前任务状态码:
229
+ 1:等待中、2:运行中、4:处理失败、5:处理完成。
250
230
  */
251
- ClothesType: string;
231
+ JobStatusCode?: string;
252
232
  /**
253
- * 为生成结果图添加标识的开关,默认为1。
254
- 1:添加标识。
255
- 0:不添加标识。
256
- 其他数值:默认按1处理。
257
- 建议您使用显著标识来提示结果图使用了 AI 绘画技术,是 AI 生成的图片。
233
+ * 当前任务状态:排队中、处理中、处理失败或者处理完成。
234
+
258
235
  */
259
- LogoAdd?: number;
236
+ JobStatusMsg?: string;
260
237
  /**
261
- * 标识内容设置。
262
- 默认在生成结果图右下角添加“图片由 AI 生成”字样,您可根据自身需要替换为其他的标识图片。
238
+ * 任务处理失败错误码。
239
+
263
240
  */
264
- LogoParam?: LogoParam;
241
+ JobErrorCode?: string;
265
242
  /**
266
- * 返回图像方式(base64 或 url) ,二选一,默认为 base64。url 有效期为1小时。
267
- 生成图分辨率较大时建议选择 url,使用 base64 可能因图片过大导致返回失败。
243
+ * 任务处理失败错误信息。
244
+
268
245
  */
269
- RspImgType?: string;
270
- }
271
- /**
272
- * ReplaceBackground返回参数结构体
273
- */
274
- export interface ReplaceBackgroundResponse {
246
+ JobErrorMsg?: string;
275
247
  /**
276
- * 根据入参 RspImgType 填入不同,返回不同的内容。
277
- 如果传入 base64 则返回生成图 Base64 编码。
278
- 如果传入 url 则返回的生成图 URL , 有效期1小时,请及时保存。
248
+ * 生成图 URL 列表,有效期1小时,请及时保存。
249
+
279
250
  */
280
- ResultImage?: string;
251
+ ResultImage?: Array<string>;
281
252
  /**
282
- * 如果 MaskUrl 未传,则返回使用内置商品分割算法得到的 Mask 结果。
253
+ * 结果 detail 数组,Success 代表成功。
254
+
283
255
  */
284
- MaskImage?: string;
256
+ ResultDetails?: Array<string>;
285
257
  /**
286
258
  * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
287
259
  */
@@ -326,6 +298,25 @@ export interface ImageOutpaintingRequest {
326
298
  */
327
299
  LogoParam?: LogoParam;
328
300
  }
301
+ /**
302
+ * ReplaceBackground返回参数结构体
303
+ */
304
+ export interface ReplaceBackgroundResponse {
305
+ /**
306
+ * 根据入参 RspImgType 填入不同,返回不同的内容。
307
+ 如果传入 base64 则返回生成图 Base64 编码。
308
+ 如果传入 url 则返回的生成图 URL , 有效期1小时,请及时保存。
309
+ */
310
+ ResultImage?: string;
311
+ /**
312
+ * 如果 MaskUrl 未传,则返回使用内置商品分割算法得到的 Mask 结果。
313
+ */
314
+ MaskImage?: string;
315
+ /**
316
+ * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
317
+ */
318
+ RequestId?: string;
319
+ }
329
320
  /**
330
321
  * QueryMemeJob返回参数结构体
331
322
  */
@@ -434,6 +425,19 @@ export interface ChangeClothesResponse {
434
425
  */
435
426
  RequestId?: string;
436
427
  }
428
+ /**
429
+ * SubmitGlamPicJob返回参数结构体
430
+ */
431
+ export interface SubmitGlamPicJobResponse {
432
+ /**
433
+ * 任务ID。
434
+ */
435
+ JobId?: string;
436
+ /**
437
+ * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
438
+ */
439
+ RequestId?: string;
440
+ }
437
441
  /**
438
442
  * SubmitMemeJob返回参数结构体
439
443
  */
@@ -544,6 +548,40 @@ export interface TextToImageRequest {
544
548
  */
545
549
  RspImgType?: string;
546
550
  }
551
+ /**
552
+ * 人脸框坐标
553
+ */
554
+ export interface Rect {
555
+ /**
556
+ * 人脸框左上角横坐标。
557
+ */
558
+ X?: number;
559
+ /**
560
+ * 人脸框左上角纵坐标。
561
+ */
562
+ Y?: number;
563
+ /**
564
+ * 人脸框宽度。
565
+ */
566
+ Width?: number;
567
+ /**
568
+ * 人脸框高度。
569
+ */
570
+ Height?: number;
571
+ }
572
+ /**
573
+ * 融合信息
574
+ */
575
+ export interface FaceInfo {
576
+ /**
577
+ * 用户图 URL 列表
578
+ */
579
+ ImageUrls?: Array<string>;
580
+ /**
581
+ * 模版图人脸坐标。
582
+ */
583
+ TemplateFaceRect?: Rect;
584
+ }
547
585
  /**
548
586
  * SubmitTextToImageProJob返回参数结构体
549
587
  */
@@ -557,6 +595,59 @@ export interface SubmitTextToImageProJobResponse {
557
595
  */
558
596
  RequestId?: string;
559
597
  }
598
+ /**
599
+ * SubmitGlamPicJob请求参数结构体
600
+ */
601
+ export interface SubmitGlamPicJobRequest {
602
+ /**
603
+ * 美照模板图 URL。
604
+ 图片限制:模板图中最多出现5张人脸,单边分辨率大于300,转成 Base64 字符串后小于 10MB,格式支持 jpg、jpeg、png、bmp、tiff、webp。
605
+ */
606
+ TemplateUrl: string;
607
+ /**
608
+ * 用户图 URL 列表,以及模板图中需要替换成用户的人脸框信息。
609
+ 一张美照中可包含1 ~ 5个用户形象。每个用户需上传1 ~ 6张照片,如果图中存在多个人脸将取最大人脸。
610
+ 模板图中的人脸数量需要大于等于用户个数。如果不传每个用户在模板图中的人脸框位置,默认按照模板图人脸框从大到小的顺序进行替换。如需自定义顺序,需要依次上传每个用户在模板图中的人脸框位置。
611
+ 图片限制:每张图片转成 Base64 字符串后小于 10MB,格式支持 jpg、jpeg、png、bmp、tiff、webp。建议使用单人、正脸、脸部区域占比较大、脸部清晰无遮挡、无大角度偏转、无夸张表情的用户图。
612
+ */
613
+ FaceInfos?: Array<FaceInfo>;
614
+ /**
615
+ * 美照生成数量。
616
+ 支持1 ~ 4张,默认生成4张。
617
+ */
618
+ Num?: number;
619
+ /**
620
+ * 美照生成风格。
621
+ 仅对单人美照生效,单人可支持选择不同风格。需按照美照生成数量,在数组中逐一填入每张美照的风格名称。如果不传,默认取不重复的随机风格顺序。
622
+ 多人美照只支持 balanced 一种风格,该参数不生效。
623
+ 可选风格:<ul><li>real:面部相似度更高。</li><li>balanced:平衡面部真实感和美观度。</li><li>extured:脸部皮肤更具真实感。</li><li>beautiful:脸部美观度更高。</li></ul>
624
+ */
625
+ Style?: Array<string>;
626
+ /**
627
+ * 相似度系数,越高越像用户图。
628
+ 取值范围[0, 1],默认为0.6。
629
+ */
630
+ Similarity?: number;
631
+ /**
632
+ * 超分选项,默认不做超分,可选开启。
633
+ x2:2倍超分
634
+ x4:4倍超分
635
+ */
636
+ Clarity?: string;
637
+ /**
638
+ * 为生成结果图添加标识的开关,默认为1。
639
+ 1:添加标识。
640
+ 0:不添加标识。
641
+ 其他数值:默认按1处理。
642
+ 建议您使用显著标识来提示结果图是 AI 生成的图片。
643
+ */
644
+ LogoAdd?: number;
645
+ /**
646
+ * 标识内容设置。
647
+ 默认在生成结果图右下角添加“图片由 AI 生成”字样,您可根据自身需要替换为其他的标识图片。
648
+ */
649
+ LogoParam?: LogoParam;
650
+ }
560
651
  /**
561
652
  * GenerateAvatar请求参数结构体
562
653
  */
@@ -731,6 +822,68 @@ export interface SubmitMemeJobRequest {
731
822
  */
732
823
  LogoParam?: LogoParam;
733
824
  }
825
+ /**
826
+ * ReplaceBackground请求参数结构体
827
+ */
828
+ export interface ReplaceBackgroundRequest {
829
+ /**
830
+ * 商品原图 Url。
831
+ 图片限制:单边分辨率小于4000,长宽比在2:5 ~ 5:2之间,转成 Base64 字符串后小于 6MB,格式支持 jpg、jpeg、png、bmp、tiff、webp。
832
+ */
833
+ ProductUrl: string;
834
+ /**
835
+ * 对新背景的文本描述。
836
+ 最多支持256个 utf-8 字符,支持中、英文。
837
+ 如果 Prompt = "BackgroundTemplate" 代表启用背景模板,需要在参数 BackgroundTemplate 中指定一个背景名称。
838
+ */
839
+ Prompt: string;
840
+ /**
841
+ * 反向提示词。
842
+ 最多支持256个 utf-8 字符,支持中、英文。
843
+ */
844
+ NegativePrompt?: string;
845
+ /**
846
+ * 商品图中的商品主体名称。
847
+ 建议说明商品主体,否则影响生成效果。
848
+ */
849
+ Product?: string;
850
+ /**
851
+ * 背景模板。
852
+ 仅当 Prompt = "BackgroundTemplate" 时生效,可支持的模板详见 [商品背景模板列表](https://cloud.tencent.com/document/product/1668/115391) ,请传入字段“背景名称”中的值。
853
+ */
854
+ BackgroundTemplate?: string;
855
+ /**
856
+ * 商品 Mask 图 Url,要求背景透明,保留商品主体。
857
+ 如果不传,将自动使用内置的商品分割算法得到 Mask。
858
+ 支持自定义上传 Mask,如果该参数不为空,则以实际上传的数据为准。
859
+ 图片限制:Mask 图必须和商品原图分辨率一致,转成 Base64 字符串后小于 6MB,格式仅支持 png。
860
+ */
861
+ MaskUrl?: string;
862
+ /**
863
+ * 替换背景后生成的商品图分辨率。
864
+ 支持生成单边分辨率大于500且小于4000、长宽比在2:5 ~ 5:2之间的图片,不传默认生成1280:1280。
865
+ 建议图片比例为1:1、9:16、16:9,生成效果更佳,使用其他比例的生成效果可能不如建议比例。
866
+ */
867
+ Resolution?: string;
868
+ /**
869
+ * 为生成结果图添加标识的开关,默认为1。
870
+ 1:添加标识。
871
+ 0:不添加标识。
872
+ 其他数值:默认按1处理。
873
+ 建议您使用显著标识来提示结果图是 AI 生成的图片。
874
+ */
875
+ LogoAdd?: number;
876
+ /**
877
+ * 标识内容设置。
878
+ 默认在生成结果图右下角添加“图片由 AI 生成”字样,您可根据自身需要替换为其他的标识图片。
879
+ */
880
+ LogoParam?: LogoParam;
881
+ /**
882
+ * 返回图像方式(base64 或 url) ,二选一,默认为 base64。url 有效期为1小时。
883
+ 生成图分辨率较大时建议选择 url,使用 base64 可能因图片过大导致返回失败。
884
+ */
885
+ RspImgType?: string;
886
+ }
734
887
  /**
735
888
  * SubmitTextToImageProJob请求参数结构体
736
889
  */
@@ -823,6 +976,15 @@ export interface SketchToImageResponse {
823
976
  */
824
977
  RequestId?: string;
825
978
  }
979
+ /**
980
+ * QueryGlamPicJob请求参数结构体
981
+ */
982
+ export interface QueryGlamPicJobRequest {
983
+ /**
984
+ * 任务ID。
985
+ */
986
+ JobId: string;
987
+ }
826
988
  /**
827
989
  * ImageInpaintingRemoval请求参数结构体
828
990
  */
@@ -872,54 +1034,40 @@ export interface ImageInpaintingRemovalRequest {
872
1034
  LogoParam?: LogoParam;
873
1035
  }
874
1036
  /**
875
- * ReplaceBackground请求参数结构体
1037
+ * ChangeClothes请求参数结构体
876
1038
  */
877
- export interface ReplaceBackgroundRequest {
878
- /**
879
- * 商品原图 Url。
880
- 图片限制:单边分辨率小于4000,长宽比在2:5 ~ 5:2之间,转成 Base64 字符串后小于 6MB,格式支持 jpg、jpeg、png、bmp、tiff、webp。
881
- */
882
- ProductUrl: string;
883
- /**
884
- * 对新背景的文本描述。
885
- 最多支持256个 utf-8 字符,支持中、英文。
886
- 如果 Prompt = "BackgroundTemplate" 代表启用背景模板,需要在参数 BackgroundTemplate 中指定一个背景名称。
887
- */
888
- Prompt: string;
889
- /**
890
- * 反向提示词。
891
- 最多支持256个 utf-8 字符,支持中、英文。
892
- */
893
- NegativePrompt?: string;
894
- /**
895
- * 商品图中的商品主体名称。
896
- 建议说明商品主体,否则影响生成效果。
897
- */
898
- Product?: string;
1039
+ export interface ChangeClothesRequest {
899
1040
  /**
900
- * 背景模板。
901
- 仅当 Prompt = "BackgroundTemplate" 时生效,可支持的模板详见 [商品背景模板列表](https://cloud.tencent.com/document/product/1668/115391) ,请传入字段“背景名称”中的值。
1041
+ * 模特图片 Url。
1042
+ 图片限制:单边分辨率小于3000,且大于512,转成 Base64 字符串后小于 8MB。
1043
+ 输入要求:
1044
+ 1、建议上传正面模特图片,至少完整露出应穿着输入指定服装的身体部位(全身、上半身或下半身),无大角度身体偏转或异常姿势。
1045
+ 2、建议上传3:4比例的图片,生成效果更佳。
1046
+ 3、建议模特图片中的原始服装和更换后的服装类别一致,或原始服装在身体上的覆盖范围小于等于更换后的服装(例如需要给模特换上短裤,则原始模特图片中也建议穿短裤,不建议穿长裤),否则会影响人像生成效果。
1047
+
902
1048
  */
903
- BackgroundTemplate?: string;
1049
+ ModelUrl: string;
904
1050
  /**
905
- * 商品 Mask 图 Url,要求背景透明,保留商品主体。
906
- 如果不传,将自动使用内置的商品分割算法得到 Mask
907
- 支持自定义上传 Mask,如果该参数不为空,则以实际上传的数据为准。
908
- 图片限制:Mask 图必须和商品原图分辨率一致,转成 Base64 字符串后小于 6MB,格式仅支持 png。
1051
+ * 服装图片 Url
1052
+ 图片限制:单边分辨率小于3000,大于512,转成 Base64 字符串后小于 8MB
1053
+ 输入要求:
1054
+ 建议上传服装完整的正面平铺图片,仅包含1个服装主体,服装类型支持上衣、下装、连衣裙,三选一。算法将根据输入的图片,结合服装图片给模特换装。
909
1055
  */
910
- MaskUrl?: string;
1056
+ ClothesUrl: string;
911
1057
  /**
912
- * 替换背景后生成的商品图分辨率。
913
- 支持生成单边分辨率大于500且小于4000、长宽比在2:5 ~ 5:2之间的图片,不传默认生成1280:1280。
914
- 建议图片比例为1:1、9:16、16:9,生成效果更佳,使用其他比例的生成效果可能不如建议比例。
1058
+ * 服装类型,需要和服装图片保持一致。
1059
+ 取值:
1060
+ Upper-body:上衣
1061
+ Lower-body:下装
1062
+ Dress:连衣裙
915
1063
  */
916
- Resolution?: string;
1064
+ ClothesType: string;
917
1065
  /**
918
1066
  * 为生成结果图添加标识的开关,默认为1。
919
1067
  1:添加标识。
920
1068
  0:不添加标识。
921
1069
  其他数值:默认按1处理。
922
- 建议您使用显著标识来提示结果图是 AI 生成的图片。
1070
+ 建议您使用显著标识来提示结果图使用了 AI 绘画技术,是 AI 生成的图片。
923
1071
  */
924
1072
  LogoAdd?: number;
925
1073
  /**