tencentcloud-sdk-aiart 3.0.913 → 3.0.914

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 0fd0e0acca97a99219d27bd9c6b9350f494faddb
-  data.tar.gz: 12eddf280de84c6b2eb9eae275e9cabf1f44fddf
+  metadata.gz: ae2cdf4dbaa0c586da56d8edf833dee8981427e1
+  data.tar.gz: 6f353056e46a3284c379cda02df980a6794493fc
 SHA512:
-  metadata.gz: 50f559ba7d6636cabeda1e62c8684cb87ca5c270a4d69d24901e4dcd1fe604d260b8c00086b61ed33f01e9bc638c89818b5ecd6fa986723e6409a7e50f7e720b
-  data.tar.gz: c2726c58072f8c5c21e6e53c3a8d1f4b4fc21d88733469a06c3a56bbd44b031db29b66407cdc0b21b12853a64db8dc1f4f3d92cba343683bcb14af251a239d7d
+  metadata.gz: 01f3ae2c65e5a620f32d213387b43adf464c34b835d6fa4c15db79b181f93fd502a26f93860127509030f5113adab1628b8e1b9ef1fd2ceffd4bc13fe57c439d
+  data.tar.gz: 072b01819faf07e7e74b8e60c7d6a579b725e2c2fe059f8012072d7f0b1c746cec0d573c5a9c4780968bb06358e9a62bfe1fe8c87a48862bc0e95c39cfbf26b8

data/lib/VERSION

@@ -1 +1 @@
-3.0.913
+3.0.914

data/lib/v20221229/client.rb

@@ -105,12 +105,14 @@ module TencentCloud
           raise TencentCloud::Common::TencentCloudSDKException.new(nil, e.inspect)
         end
 
-        # AI 写真提供 AI 写真形象照的训练与生成能力，分为上传训练图片、训练模型、生成图片3个环节，需要依次调用对应接口。
-        # 每个写真模型自训练完成起1年内有效，有效期内可使用写真模型 ID 生成图片，期满后需要重新训练。
-        # 生成图片分为提交任务和查询任务2个接口。
-        # - 提交生成写真图片任务：完成训练写真模型后，选择写真风格模板，提交一个生成写真图片异步任务，根据写真模型 ID 开始生成人物形象在指定风格上的写真图片，获得任务 ID。
+        # AI 写真分为上传训练图片、训练写真模型（可选跳过）、生成写真图片3个环节，需要依次调用对应接口。
+        # 生成图片分为提交任务和查询任务2个接口：
+
+        # - 提交生成写真图片任务：选择风格模板，提交一个生成写真图片异步任务，根据写真模型 ID 生成写真图片，获得任务 ID。
         # - 查询生成写真图片任务：根据任务 ID 查询生成图片任务的处理状态、处理结果。
 
+        # 每个写真模型自训练完成起1年内有效，有效期内可使用写真模型 ID 生成图片，期满后需要重新训练。
+
         # @param request: Request instance for QueryDrawPortraitJob.
         # @type request: :class:`Tencentcloud::aiart::V20221229::QueryDrawPortraitJobRequest`
         # @rtype: :class:`Tencentcloud::aiart::V20221229::QueryDrawPortraitJobResponse`
@@ -161,12 +163,15 @@ module TencentCloud
           raise TencentCloud::Common::TencentCloudSDKException.new(nil, e.inspect)
         end
 
-        # AI 写真提供 AI 写真形象照的训练与生成能力，分为上传训练图片、训练模型、生成图片3个环节，需要依次调用对应接口。
-        # 每个写真模型自训练完成起1年内有效，有效期内可使用写真模型 ID 生成图片，期满后需要重新训练。
-        # 训练模型分为提交任务和查询任务2个接口。
-        # - 提交训练写真模型任务：完成上传训练图片后，提交一个训练写真模型异步任务，根据写真模型 ID 开始训练模型。
+        # AI 写真分为上传训练图片、训练写真模型（可选跳过）、生成写真图片3个环节，需要依次调用对应接口。
+        # 如果选择免训练模式无需调用本接口。
+        # 训练模型分为提交任务和查询任务2个接口：
+
+        # - 提交训练写真模型任务：完成上传图片后，提交一个训练写真模型异步任务，根据写真模型 ID 开始训练模型。
         # - 查询训练写真模型任务：根据写真模型 ID 查询训练任务的处理状态、处理结果。
 
+        # 每个写真模型自训练完成起1年内有效，有效期内可使用写真模型 ID 生成图片，期满后需要重新训练。
+
         # @param request: Request instance for QueryTrainPortraitModelJob.
         # @type request: :class:`Tencentcloud::aiart::V20221229::QueryTrainPortraitModelJobRequest`
         # @rtype: :class:`Tencentcloud::aiart::V20221229::QueryTrainPortraitModelJobResponse`
@@ -240,13 +245,14 @@ module TencentCloud
           raise TencentCloud::Common::TencentCloudSDKException.new(nil, e.inspect)
         end
 
-        # AI 写真提供 AI 写真形象照的训练与生成能力，分为上传训练图片、训练模型、生成图片3个环节，需要依次调用对应接口。
-        # 每个写真模型自训练完成起1年内有效，有效期内可使用写真模型 ID 生成图片，期满后需要重新训练。
-        # 生成图片分为提交任务和查询任务2个接口。
-        # - 提交生成写真图片任务：完成训练写真模型后，选择风格模板，提交一个生成写真图片异步任务，根据写真模型 ID 开始生成人物形象在指定风格上的写真图片，获得任务 ID。
+        # AI 写真分为上传训练图片、训练写真模型（可选跳过）、生成写真图片3个环节，需要依次调用对应接口。
+        # 生成图片分为提交任务和查询任务2个接口：
+
+        # - 提交生成写真图片任务：选择风格模板，提交一个生成写真图片异步任务，根据写真模型 ID 生成写真图片，获得任务 ID。
         # - 查询生成写真图片任务：根据任务 ID 查询生成图片任务的处理状态、处理结果。
 
-        # 提交生成写真图片任务默认提供1个并发任务数。
+        # 每个写真模型自训练完成起1年内有效，有效期内可使用写真模型 ID 生成图片，期满后需要重新训练。
+        # 提交生成写真图片任务默认提供1个并发。
 
         # @param request: Request instance for SubmitDrawPortraitJob.
         # @type request: :class:`Tencentcloud::aiart::V20221229::SubmitDrawPortraitJobRequest`
@@ -298,12 +304,14 @@ module TencentCloud
           raise TencentCloud::Common::TencentCloudSDKException.new(nil, e.inspect)
         end
 
-        # AI 写真提供 AI 写真形象照的训练与生成能力，分为上传训练图片、训练模型、生成图片3个环节，需要依次调用对应接口。
-        # 每个写真模型自训练完成起1年内有效，有效期内可使用写真模型 ID 生成图片，期满后需要重新训练。
-        # 训练模型分为提交任务和查询任务2个接口。
-        # - 提交训练写真模型任务：完成上传训练图片后，提交一个训练写真模型异步任务，根据写真模型 ID 开始训练模型。
+        # AI 写真分为上传训练图片、训练写真模型（可选跳过）、生成写真图片3个环节，需要依次调用对应接口。
+        # 如果选择免训练模式无需调用本接口。
+        # 训练模型分为提交任务和查询任务2个接口：
+        # - 提交训练写真模型任务：完成上传图片后，提交一个训练写真模型异步任务，根据写真模型 ID 开始训练模型。
         # - 查询训练写真模型任务：根据写真模型 ID 查询训练任务的处理状态、处理结果。
-        # 提交训练写真模型任务按并发任务数计费，无默认并发额度。
+
+        # 每个写真模型自训练完成起1年内有效，有效期内可使用写真模型 ID 生成图片，期满后需要重新训练。
+        # 提交训练写真模型任务按并发计费，无默认并发额度。
 
         # @param request: Request instance for SubmitTrainPortraitModelJob.
         # @type request: :class:`Tencentcloud::aiart::V20221229::SubmitTrainPortraitModelJobRequest`
@@ -355,9 +363,14 @@ module TencentCloud
           raise TencentCloud::Common::TencentCloudSDKException.new(nil, e.inspect)
         end
 
-        # AI 写真提供 AI 写真形象照的训练与生成能力，分为上传训练图片、训练模型、生成图片3个环节，需要依次调用对应接口。
-        # 本接口用于指定一个人物形象的写真模型 ID，上传用于训练该模型的图片。一个写真模型仅用于一个人物形象的写真生成，上传的训练图片要求所属同一人，建议上传单人、正脸、脸部区域占比较大、脸部清晰无遮挡、无大角度偏转、无夸张表情的图片。
-        # 上传写真训练图片默认提供1个并发任务数。
+        # AI 写真分为上传训练图片、训练写真模型（可选跳过）、生成写真图片3个环节，需要依次调用对应接口。
+        # 本接口用于上传人像图片并指定对应的写真模型 ID。上传的图片要求是同一个人，建议上传单人、正脸、脸部区域占比较大、脸部清晰无遮挡、无大角度偏转、无夸张表情的图片。
+        # 可选模式：
+        # - 常规训练模式：上传20 - 25张图片用于模型训练，完成训练后可生成写真图片。
+        # - 快速训练模式：仅需上传1张图片用于模型训练，训练速度更快，完成训练后可生成写真图片。
+        # - 免训练模式：仅需上传1张图片，跳过训练环节，直接生成写真图片。
+
+        # 上传写真训练图片默认提供1个并发。
 
         # @param request: Request instance for UploadTrainPortraitImages.
         # @type request: :class:`Tencentcloud::aiart::V20221229::UploadTrainPortraitImagesRequest`

data/lib/v20221229/models.rb

@@ -991,7 +991,7 @@ module TencentCloud
         # 图片内容：单人，脸部清晰。
         # 图片限制：单边分辨率小于2000，转成 Base64 字符串后小于 5MB。
         # @type BaseUrl: String
-        # @param Urls: 写真模型训练用的图像 URL 列表。
+        # @param Urls: 写真模型训练用的图像 URL 列表，仅常规训练模式需要上传。
         # 图片数量：19 - 24 张。
         # 图片内容：单人，脸部清晰，和基础图像中的人物为同一人。
         # 图片限制：单边分辨率小于2000，转成 Base64 字符串后小于 5MB。
@@ -1001,10 +1001,11 @@ module TencentCloud
         # 如果训练图像内包含多人脸或无人脸、和 Base 人像不为同一人也将被过滤，不可关闭该过滤条件。
         # 建议：关闭以上过滤可能导致写真生成效果受损，建议使用单人、正脸、脸部区域占比较大、脸部清晰无遮挡、无大角度偏转、无夸张表情的图像进行训练。
         # @type Filter: :class:`Tencentcloud::Aiart.v20221229.models.Filter`
-        # @param TrainMode: 是否开启快速训练模式。
-        # 默认不开启。开启后只需要在 BaseUrl 中传入1张图片，Urls.N 中无需传入图片。
-        # 0：不开启
-        # 1：开启
+        # @param TrainMode: 训练模式。
+        # 默认使用常规训练模式。如果使用快速训练模式和免训练模式，只需要在 BaseUrl 中传入1张图片，Urls.N 中无需传入图片。
+        # 0：常规训练模式，上传多张图片用于模型训练，完成训练后可生成写真图片。
+        # 1：快速训练模式，仅需上传1张图片用于模型训练，训练速度更快，完成训练后可生成写真图片。
+        # 2：免训练模式，仅需上传1张图片，跳过模型训练环节，直接生成写真图片。
         # @type TrainMode: Integer
 
         attr_accessor :ModelId, :BaseUrl, :Urls, :Filter, :TrainMode

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: tencentcloud-sdk-aiart
 version: !ruby/object:Gem::Version
-  version: 3.0.913
+  version: 3.0.914
 platform: ruby
 authors:
 - Tencent Cloud
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2024-09-24 00:00:00.000000000 Z
+date: 2024-09-25 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: tencentcloud-sdk-common