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 +21 -23
- package/package.json +1 -1
- package/src/services/aiart/v20221229/aiart_client.ts +39 -5
- package/src/services/aiart/v20221229/aiart_models.ts +247 -93
- package/tencentcloud/services/aiart/v20221229/aiart_client.d.ts +17 -1
- package/tencentcloud/services/aiart/v20221229/aiart_client.js +20 -0
- package/tencentcloud/services/aiart/v20221229/aiart_models.d.ts +241 -93
package/README.md
CHANGED
|
@@ -1,21 +1,20 @@
|
|
|
1
1
|
# 简介
|
|
2
2
|
|
|
3
|
-
欢迎使用腾讯云开发者工具套件(SDK),
|
|
4
|
-
为方便
|
|
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.
|
|
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
|
-
|
|
13
|
+
使用 SDK 需要 API 密钥,可前往 [腾讯云控制台 - 访问密钥](https://console.cloud.tencent.com/cam/capi) 页面申请,API 密钥包括 SecretID 和 SecretKey,密钥须严格保管,避免泄露。
|
|
15
14
|
|
|
16
|
-
## 通过
|
|
15
|
+
## 通过 npm 安装
|
|
17
16
|
|
|
18
|
-
通过
|
|
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
|
-
在支持
|
|
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
|
-
|
|
116
|
+
实例化 `Client` 的入参支持 `clientConfig`,数据结构和说明详见 [ClientConfig](https://github.com/TencentCloud/tencentcloud-sdk-nodejs/blob/master/src/common/interface.ts)。
|
|
116
117
|
|
|
117
118
|
## Common Client
|
|
118
|
-
|
|
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
|
-
|
|
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直接用于
|
|
155
|
+
请**务必不要**将此 SDK 直接用于 Web 前端(包括小程序等),暴露密钥在这些环境非常不安全。
|
|
158
156
|
|
|
159
|
-
正确的做法是在自己的服务端引用此SDK
|
|
157
|
+
正确的做法是在自己的服务端引用此 SDK,并保存好密钥,做好请求鉴权,前端再调用服务端执行业务流程。
|
|
160
158
|
|
|
161
159
|
- `The "original" argument must be of type Function.`
|
|
162
160
|
|
|
163
|
-
通常是因为
|
|
161
|
+
通常是因为 Node.js 版本低于 `v10` ,或处于非 Node.js 环境,请再次确认执行环境。
|
|
164
162
|
|
|
165
163
|
- 请求不通
|
|
166
164
|
|
package/package.json
CHANGED
|
@@ -20,35 +20,41 @@ import {
|
|
|
20
20
|
SubmitDrawPortraitJobResponse,
|
|
21
21
|
LogoParam,
|
|
22
22
|
ImageToImageRequest,
|
|
23
|
-
|
|
23
|
+
QueryTrainPortraitModelJobRequest,
|
|
24
24
|
QueryTextToImageProJobResponse,
|
|
25
25
|
UploadTrainPortraitImagesRequest,
|
|
26
26
|
ResultConfig,
|
|
27
|
-
|
|
28
|
-
|
|
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
|
-
|
|
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
|
-
*
|
|
131
|
+
* QueryTrainPortraitModelJob请求参数结构体
|
|
132
132
|
*/
|
|
133
|
-
export interface
|
|
133
|
+
export interface QueryTrainPortraitModelJobRequest {
|
|
134
134
|
/**
|
|
135
|
-
*
|
|
135
|
+
* 写真模型 ID。
|
|
136
|
+
|
|
136
137
|
*/
|
|
137
|
-
|
|
138
|
+
ModelId: string
|
|
138
139
|
}
|
|
139
140
|
|
|
140
141
|
/**
|
|
@@ -235,79 +236,49 @@ export interface ResultConfig {
|
|
|
235
236
|
}
|
|
236
237
|
|
|
237
238
|
/**
|
|
238
|
-
*
|
|
239
|
+
* QueryMemeJob请求参数结构体
|
|
239
240
|
*/
|
|
240
|
-
export interface
|
|
241
|
+
export interface QueryMemeJobRequest {
|
|
241
242
|
/**
|
|
242
|
-
*
|
|
243
|
-
|
|
243
|
+
* 查询表情动图生成任务 ID。
|
|
244
244
|
*/
|
|
245
|
-
|
|
245
|
+
JobId: string
|
|
246
246
|
}
|
|
247
247
|
|
|
248
248
|
/**
|
|
249
|
-
*
|
|
249
|
+
* QueryGlamPicJob返回参数结构体
|
|
250
250
|
*/
|
|
251
|
-
export interface
|
|
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
|
-
*
|
|
264
|
-
|
|
265
|
-
输入要求:
|
|
266
|
-
建议上传服装完整的正面平铺图片,仅包含1个服装主体,服装类型支持上衣、下装、连衣裙,三选一。算法将根据输入的图片,结合服装图片给模特换装。
|
|
253
|
+
* 当前任务状态码:
|
|
254
|
+
1:等待中、2:运行中、4:处理失败、5:处理完成。
|
|
267
255
|
*/
|
|
268
|
-
|
|
256
|
+
JobStatusCode?: string
|
|
269
257
|
/**
|
|
270
|
-
*
|
|
271
|
-
|
|
272
|
-
Upper-body:上衣
|
|
273
|
-
Lower-body:下装
|
|
274
|
-
Dress:连衣裙
|
|
258
|
+
* 当前任务状态:排队中、处理中、处理失败或者处理完成。
|
|
259
|
+
|
|
275
260
|
*/
|
|
276
|
-
|
|
261
|
+
JobStatusMsg?: string
|
|
277
262
|
/**
|
|
278
|
-
*
|
|
279
|
-
|
|
280
|
-
0:不添加标识。
|
|
281
|
-
其他数值:默认按1处理。
|
|
282
|
-
建议您使用显著标识来提示结果图使用了 AI 绘画技术,是 AI 生成的图片。
|
|
263
|
+
* 任务处理失败错误码。
|
|
264
|
+
|
|
283
265
|
*/
|
|
284
|
-
|
|
266
|
+
JobErrorCode?: string
|
|
285
267
|
/**
|
|
286
|
-
*
|
|
287
|
-
|
|
268
|
+
* 任务处理失败错误信息。
|
|
269
|
+
|
|
288
270
|
*/
|
|
289
|
-
|
|
271
|
+
JobErrorMsg?: string
|
|
290
272
|
/**
|
|
291
|
-
*
|
|
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
|
-
*
|
|
278
|
+
* 结果 detail 数组,Success 代表成功。
|
|
279
|
+
|
|
309
280
|
*/
|
|
310
|
-
|
|
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
|
-
*
|
|
1091
|
+
* ChangeClothes请求参数结构体
|
|
924
1092
|
*/
|
|
925
|
-
export interface
|
|
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
|
-
|
|
1095
|
+
* 模特图片 Url。
|
|
1096
|
+
图片限制:单边分辨率小于3000,且大于512,转成 Base64 字符串后小于 8MB。
|
|
1097
|
+
输入要求:
|
|
1098
|
+
1、建议上传正面模特图片,至少完整露出应穿着输入指定服装的身体部位(全身、上半身或下半身),无大角度身体偏转或异常姿势。
|
|
1099
|
+
2、建议上传3:4比例的图片,生成效果更佳。
|
|
1100
|
+
3、建议模特图片中的原始服装和更换后的服装类别一致,或原始服装在身体上的覆盖范围小于等于更换后的服装(例如需要给模特换上短裤,则原始模特图片中也建议穿短裤,不建议穿长裤),否则会影响人像生成效果。
|
|
1101
|
+
|
|
950
1102
|
*/
|
|
951
|
-
|
|
1103
|
+
ModelUrl: string
|
|
952
1104
|
/**
|
|
953
|
-
*
|
|
954
|
-
|
|
955
|
-
|
|
956
|
-
|
|
1105
|
+
* 服装图片 Url。
|
|
1106
|
+
图片限制:单边分辨率小于3000,大于512,转成 Base64 字符串后小于 8MB。
|
|
1107
|
+
输入要求:
|
|
1108
|
+
建议上传服装完整的正面平铺图片,仅包含1个服装主体,服装类型支持上衣、下装、连衣裙,三选一。算法将根据输入的图片,结合服装图片给模特换装。
|
|
957
1109
|
*/
|
|
958
|
-
|
|
1110
|
+
ClothesUrl: string
|
|
959
1111
|
/**
|
|
960
|
-
*
|
|
961
|
-
|
|
962
|
-
|
|
1112
|
+
* 服装类型,需要和服装图片保持一致。
|
|
1113
|
+
取值:
|
|
1114
|
+
Upper-body:上衣
|
|
1115
|
+
Lower-body:下装
|
|
1116
|
+
Dress:连衣裙
|
|
963
1117
|
*/
|
|
964
|
-
|
|
1118
|
+
ClothesType: string
|
|
965
1119
|
/**
|
|
966
1120
|
* 为生成结果图添加标识的开关,默认为1。
|
|
967
1121
|
1:添加标识。
|
|
968
1122
|
0:不添加标识。
|
|
969
1123
|
其他数值:默认按1处理。
|
|
970
|
-
|
|
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,
|
|
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
|
-
*
|
|
111
|
+
* QueryTrainPortraitModelJob请求参数结构体
|
|
112
112
|
*/
|
|
113
|
-
export interface
|
|
113
|
+
export interface QueryTrainPortraitModelJobRequest {
|
|
114
114
|
/**
|
|
115
|
-
*
|
|
115
|
+
* 写真模型 ID。
|
|
116
|
+
|
|
116
117
|
*/
|
|
117
|
-
|
|
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
|
-
*
|
|
215
|
+
* QueryMemeJob请求参数结构体
|
|
215
216
|
*/
|
|
216
|
-
export interface
|
|
217
|
+
export interface QueryMemeJobRequest {
|
|
217
218
|
/**
|
|
218
|
-
*
|
|
219
|
-
|
|
219
|
+
* 查询表情动图生成任务 ID。
|
|
220
220
|
*/
|
|
221
|
-
|
|
221
|
+
JobId: string;
|
|
222
222
|
}
|
|
223
223
|
/**
|
|
224
|
-
*
|
|
224
|
+
* QueryGlamPicJob返回参数结构体
|
|
225
225
|
*/
|
|
226
|
-
export interface
|
|
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
|
-
|
|
231
|
+
JobStatusCode?: string;
|
|
252
232
|
/**
|
|
253
|
-
*
|
|
254
|
-
|
|
255
|
-
0:不添加标识。
|
|
256
|
-
其他数值:默认按1处理。
|
|
257
|
-
建议您使用显著标识来提示结果图使用了 AI 绘画技术,是 AI 生成的图片。
|
|
233
|
+
* 当前任务状态:排队中、处理中、处理失败或者处理完成。
|
|
234
|
+
|
|
258
235
|
*/
|
|
259
|
-
|
|
236
|
+
JobStatusMsg?: string;
|
|
260
237
|
/**
|
|
261
|
-
*
|
|
262
|
-
|
|
238
|
+
* 任务处理失败错误码。
|
|
239
|
+
|
|
263
240
|
*/
|
|
264
|
-
|
|
241
|
+
JobErrorCode?: string;
|
|
265
242
|
/**
|
|
266
|
-
*
|
|
267
|
-
|
|
243
|
+
* 任务处理失败错误信息。
|
|
244
|
+
|
|
268
245
|
*/
|
|
269
|
-
|
|
270
|
-
}
|
|
271
|
-
/**
|
|
272
|
-
* ReplaceBackground返回参数结构体
|
|
273
|
-
*/
|
|
274
|
-
export interface ReplaceBackgroundResponse {
|
|
246
|
+
JobErrorMsg?: string;
|
|
275
247
|
/**
|
|
276
|
-
*
|
|
277
|
-
|
|
278
|
-
如果传入 url 则返回的生成图 URL , 有效期1小时,请及时保存。
|
|
248
|
+
* 生成图 URL 列表,有效期1小时,请及时保存。
|
|
249
|
+
|
|
279
250
|
*/
|
|
280
|
-
ResultImage?: string
|
|
251
|
+
ResultImage?: Array<string>;
|
|
281
252
|
/**
|
|
282
|
-
*
|
|
253
|
+
* 结果 detail 数组,Success 代表成功。
|
|
254
|
+
|
|
283
255
|
*/
|
|
284
|
-
|
|
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
|
-
*
|
|
1037
|
+
* ChangeClothes请求参数结构体
|
|
876
1038
|
*/
|
|
877
|
-
export interface
|
|
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
|
-
|
|
1041
|
+
* 模特图片 Url。
|
|
1042
|
+
图片限制:单边分辨率小于3000,且大于512,转成 Base64 字符串后小于 8MB。
|
|
1043
|
+
输入要求:
|
|
1044
|
+
1、建议上传正面模特图片,至少完整露出应穿着输入指定服装的身体部位(全身、上半身或下半身),无大角度身体偏转或异常姿势。
|
|
1045
|
+
2、建议上传3:4比例的图片,生成效果更佳。
|
|
1046
|
+
3、建议模特图片中的原始服装和更换后的服装类别一致,或原始服装在身体上的覆盖范围小于等于更换后的服装(例如需要给模特换上短裤,则原始模特图片中也建议穿短裤,不建议穿长裤),否则会影响人像生成效果。
|
|
1047
|
+
|
|
902
1048
|
*/
|
|
903
|
-
|
|
1049
|
+
ModelUrl: string;
|
|
904
1050
|
/**
|
|
905
|
-
*
|
|
906
|
-
|
|
907
|
-
|
|
908
|
-
|
|
1051
|
+
* 服装图片 Url。
|
|
1052
|
+
图片限制:单边分辨率小于3000,大于512,转成 Base64 字符串后小于 8MB。
|
|
1053
|
+
输入要求:
|
|
1054
|
+
建议上传服装完整的正面平铺图片,仅包含1个服装主体,服装类型支持上衣、下装、连衣裙,三选一。算法将根据输入的图片,结合服装图片给模特换装。
|
|
909
1055
|
*/
|
|
910
|
-
|
|
1056
|
+
ClothesUrl: string;
|
|
911
1057
|
/**
|
|
912
|
-
*
|
|
913
|
-
|
|
914
|
-
|
|
1058
|
+
* 服装类型,需要和服装图片保持一致。
|
|
1059
|
+
取值:
|
|
1060
|
+
Upper-body:上衣
|
|
1061
|
+
Lower-body:下装
|
|
1062
|
+
Dress:连衣裙
|
|
915
1063
|
*/
|
|
916
|
-
|
|
1064
|
+
ClothesType: string;
|
|
917
1065
|
/**
|
|
918
1066
|
* 为生成结果图添加标识的开关,默认为1。
|
|
919
1067
|
1:添加标识。
|
|
920
1068
|
0:不添加标识。
|
|
921
1069
|
其他数值:默认按1处理。
|
|
922
|
-
|
|
1070
|
+
建议您使用显著标识来提示结果图使用了 AI 绘画技术,是 AI 生成的图片。
|
|
923
1071
|
*/
|
|
924
1072
|
LogoAdd?: number;
|
|
925
1073
|
/**
|