tencentcloud-sdk-aiart 3.0.1104 → 3.0.1170

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: c9ed7bd3aac355e1fc4ab5759a03b3d9103229ce
-  data.tar.gz: 65371299ea3a3bfe5eca8f4d138da2099c6c8a96
+  metadata.gz: fed278d31efbc8b5deff85ffb653981548ffa6fe
+  data.tar.gz: 7b4708e4741c4a8bd32c01ad725b0a7e32494df0
 SHA512:
-  metadata.gz: 107ec9cb08c87dca4bb83e88d7d1bb5f9f351033c3a086f79b72a89f6e01613124d0e4285da00632ef4cf3e15ada429a9dc7d6a6c3fe7672f50374c50d1144d4
-  data.tar.gz: b8ea7583d288690ae6cc637c486016e0d6192ddfd131b4450939e9be984d045ada57afef555526e504a3facd8f0bf68187b44d24d82e13f90a76922234979482
+  metadata.gz: 9bd97850f3a217e2f7a5ef683d98e7eee945a07dc3127a5d71cbe5d78117103dcca9b3a59d26bcf1928078ec8dd14a037c2f80395e3b08bfa353e7ca46e88037
+  data.tar.gz: 7cfa700b1736faa2b3e4ff19df9a9896dc87229269fbe4795ea14dfadf8ccc05d2ffa866cf19ca5fb4842eec7c215a894e1b1dc7284aa011d7fc82e2f4183d76

data/lib/VERSION

@@ -1 +1 @@
-3.0.1104
+3.0.1170

data/lib/v20221229/client.rb

@@ -241,6 +241,31 @@ module TencentCloud
           raise TencentCloud::Common::TencentCloudSDKException.new(nil, e.inspect)
         end
 
+        # 混元生图接口，基于混元大模型，根据输入的文本描述快速生成图片。
+        # 默认提供0个并发，代表最多能同时处理1个已提交的任务，上一个任务处理完毕后，才能开始处理下一个任务。
+
+        # @param request: Request instance for QueryTextToImageJob.
+        # @type request: :class:`Tencentcloud::aiart::V20221229::QueryTextToImageJobRequest`
+        # @rtype: :class:`Tencentcloud::aiart::V20221229::QueryTextToImageJobResponse`
+        def QueryTextToImageJob(request)
+          body = send_request('QueryTextToImageJob', request.serialize)
+          response = JSON.parse(body)
+          if response['Response'].key?('Error') == false
+            model = QueryTextToImageJobResponse.new
+            model.deserialize(response['Response'])
+            model
+          else
+            code = response['Response']['Error']['Code']
+            message = response['Response']['Error']['Message']
+            reqid = response['Response']['RequestId']
+            raise TencentCloud::Common::TencentCloudSDKException.new(code, message, reqid)
+          end
+        rescue TencentCloud::Common::TencentCloudSDKException => e
+          raise e
+        rescue StandardError => e
+          raise TencentCloud::Common::TencentCloudSDKException.new(nil, e.inspect)
+        end
+
         # 本接口已迁移至腾讯混元大模型-混元生图，即将停止此处维护，可切换至 [混元生图 API](https://cloud.tencent.com/document/product/1729/105970) 继续使用。
         # 文生图（高级版）接口基于高级版文生图大模型，将根据输入的文本描述，智能生成与之相关的结果图。分为提交任务和查询任务2个接口。
         # 提交任务：输入文本等，提交一个文生图（高级版）异步任务，获得任务 ID。
@@ -464,6 +489,31 @@ module TencentCloud
           raise TencentCloud::Common::TencentCloudSDKException.new(nil, e.inspect)
         end
 
+        # 混元生图接口，基于混元大模型，根据输入的文本描述快速生成图片。
+        # 默认提供1个并发，代表最多能同时处理1个已提交的任务，上一个任务处理完毕后，才能开始处理下一个任务。
+
+        # @param request: Request instance for SubmitTextToImageJob.
+        # @type request: :class:`Tencentcloud::aiart::V20221229::SubmitTextToImageJobRequest`
+        # @rtype: :class:`Tencentcloud::aiart::V20221229::SubmitTextToImageJobResponse`
+        def SubmitTextToImageJob(request)
+          body = send_request('SubmitTextToImageJob', request.serialize)
+          response = JSON.parse(body)
+          if response['Response'].key?('Error') == false
+            model = SubmitTextToImageJobResponse.new
+            model.deserialize(response['Response'])
+            model
+          else
+            code = response['Response']['Error']['Code']
+            message = response['Response']['Error']['Message']
+            reqid = response['Response']['RequestId']
+            raise TencentCloud::Common::TencentCloudSDKException.new(code, message, reqid)
+          end
+        rescue TencentCloud::Common::TencentCloudSDKException => e
+          raise e
+        rescue StandardError => e
+          raise TencentCloud::Common::TencentCloudSDKException.new(nil, e.inspect)
+        end
+
         # 本接口已迁移至腾讯混元大模型-混元生图，即将停止此处维护，可切换至 [混元生图 API](https://cloud.tencent.com/document/product/1729/105969) 继续使用。
         # 文生图（高级版）接口基于高级版文生图大模型，将根据输入的文本描述，智能生成与之相关的结果图。分为提交任务和查询任务2个接口。
         # 提交任务：输入文本等，提交一个文生图（高级版）异步任务，获得任务 ID。

data/lib/v20221229/models.rb

@@ -283,7 +283,7 @@ module TencentCloud
         # Mask 的 Base64 和 Url 必须提供一个，如果都提供以 Url 为准。
         # 图片限制：Mask 分辨率需要和输入原图保持一致，转成 Base64 字符串后小于 6MB。
         # @type MaskUrl: String
-        # @param RspImgType: 返回图像方式（base64 或 url) ，二选一，默认为 base64。url 有效期为1小时。
+        # @param RspImgType: 返回图像方式（base64 或 url），二选一，默认为 base64。url 有效期为1小时。
         # @type RspImgType: String
         # @param LogoAdd: 为生成结果图添加标识的开关，默认为1。
         # 1：添加标识。
@@ -354,7 +354,7 @@ module TencentCloud
         # Base64 和 Url 必须提供一个，如果都提供以 Url 为准。
         # 图片限制：单边分辨率小于5000，转成 Base64 字符串后小于 6MB，格式支持 jpg、jpeg、png、bmp、tiff、webp。
         # @type InputUrl: String
-        # @param RspImgType: 返回图像方式（base64 或 url) ，二选一，默认为 base64。url 有效期为1小时。
+        # @param RspImgType: 返回图像方式（base64 或 url），二选一，默认为 base64。url 有效期为1小时。
         # @type RspImgType: String
         # @param LogoAdd: 为生成结果图添加标识的开关，默认为1。
         # 1：添加标识。
@@ -755,6 +755,67 @@ module TencentCloud
         end
       end
 
+      # QueryTextToImageJob请求参数结构体
+      class QueryTextToImageJobRequest < TencentCloud::Common::AbstractModel
+        # @param JobId: 任务 ID。
+        # @type JobId: String
+
+        attr_accessor :JobId
+
+        def initialize(jobid=nil)
+          @JobId = jobid
+        end
+
+        def deserialize(params)
+          @JobId = params['JobId']
+        end
+      end
+
+      # QueryTextToImageJob返回参数结构体
+      class QueryTextToImageJobResponse < TencentCloud::Common::AbstractModel
+        # @param JobStatusCode: 当前任务状态码：
+        # 1：等待中、2：运行中、4：处理失败、5：处理完成。
+        # @type JobStatusCode: String
+        # @param JobStatusMsg: 当前任务状态：排队中、处理中、处理失败或者处理完成。
+        # @type JobStatusMsg: String
+        # @param JobErrorCode: 任务处理失败错误码。
+        # @type JobErrorCode: String
+        # @param JobErrorMsg: 任务处理失败错误信息。
+        # @type JobErrorMsg: String
+        # @param ResultImage: 生成图 URL 列表，有效期1小时，请及时保存。
+        # @type ResultImage: Array
+        # @param ResultDetails: 结果 detail 数组，Success 代表成功。
+        # @type ResultDetails: Array
+        # @param RevisedPrompt: 对应 SubmitTextToImageProJob 接口中 Revise 参数。开启扩写时，返回扩写后的 prompt 文本。 如果关闭扩写，将直接返回原始输入的 prompt。
+        # @type RevisedPrompt: Array
+        # @param RequestId: 唯一请求 ID，由服务端生成，每次请求都会返回（若请求因其他原因未能抵达服务端，则该次请求不会获得 RequestId）。定位问题时需要提供该次请求的 RequestId。
+        # @type RequestId: String
+
+        attr_accessor :JobStatusCode, :JobStatusMsg, :JobErrorCode, :JobErrorMsg, :ResultImage, :ResultDetails, :RevisedPrompt, :RequestId
+
+        def initialize(jobstatuscode=nil, jobstatusmsg=nil, joberrorcode=nil, joberrormsg=nil, resultimage=nil, resultdetails=nil, revisedprompt=nil, requestid=nil)
+          @JobStatusCode = jobstatuscode
+          @JobStatusMsg = jobstatusmsg
+          @JobErrorCode = joberrorcode
+          @JobErrorMsg = joberrormsg
+          @ResultImage = resultimage
+          @ResultDetails = resultdetails
+          @RevisedPrompt = revisedprompt
+          @RequestId = requestid
+        end
+
+        def deserialize(params)
+          @JobStatusCode = params['JobStatusCode']
+          @JobStatusMsg = params['JobStatusMsg']
+          @JobErrorCode = params['JobErrorCode']
+          @JobErrorMsg = params['JobErrorMsg']
+          @ResultImage = params['ResultImage']
+          @ResultDetails = params['ResultDetails']
+          @RevisedPrompt = params['RevisedPrompt']
+          @RequestId = params['RequestId']
+        end
+      end
+
       # QueryTextToImageProJob请求参数结构体
       class QueryTextToImageProJobRequest < TencentCloud::Common::AbstractModel
         # @param JobId: 任务 ID。
@@ -903,7 +964,7 @@ module TencentCloud
         # Base64 和 Url 必须提供一个，如果都提供以 Url 为准。
         # 图片限制：转成 Base64 字符串后小于 6MB，格式支持 jpg、jpeg、png、bmp、tiff、webp。
         # @type InputImage: String
-        # @param RspImgType: 返回图像方式（base64 或 url) ，二选一，默认为 base64。url 有效期为1小时。 示例值：url
+        # @param RspImgType: 返回图像方式（base64 或 url），二选一，默认为 base64。url 有效期为1小时。 示例值：url
         # @type RspImgType: String
 
         attr_accessor :InputUrl, :InputImage, :RspImgType
@@ -1378,6 +1439,80 @@ module TencentCloud
         end
       end
 
+      # SubmitTextToImageJob请求参数结构体
+      class SubmitTextToImageJobRequest < TencentCloud::Common::AbstractModel
+        # @param Prompt: 文本描述。
+        # 算法将根据输入的文本智能生成与之相关的图像。
+        # 不能为空，推荐使用中文。最多可传1024个 utf-8 字符。
+        # @type Prompt: String
+        # @param Resolution: 生成图分辨率，仅支持以下分辨率：
+        # 640:1408,704:1344,768:1280,832:1216,896:1152,960:1088,1024:1024,1088:960,1152:896,1216:832,1280:768,1344:704,1408:640
+        # @type Resolution: String
+        # @param Seed: 随机种子，默认随机。
+        # 不传：随机种子生成。
+        # 正数：固定种子生成。
+        # 扩写开启时固定种子不生效，将保持随机。
+        # @type Seed: Integer
+        # @param LogoAdd: 为生成结果图添加显式水印标识的开关，默认为1。
+        # 1：添加。
+        # 0：不添加。
+        # 其他数值：默认按1处理。
+        # 建议您使用显著标识来提示结果图使用了 AI 绘画技术，是 AI 生成的图片。
+        # @type LogoAdd: Integer
+        # @param LogoParam: 标识内容设置。
+        # 默认在生成结果图右下角添加“图片由 AI 生成”字样，您可根据自身需要替换为其他的标识图片。
+        # @type LogoParam: :class:`Tencentcloud::Aiart.v20221229.models.LogoParam`
+        # @param Revise: 是否开启prompt改写，为空时默认开启，改写预计会增加20s左右耗时。
+        # 0：关闭改写
+        # 1：开启改写
+        # 建议默认开启，如果关闭改写，需要调用方自己接改写，否则对生图效果有较大影响，改写方法可以参考：[改写](https://github.com/Tencent-Hunyuan/HunyuanImage-3.0/tree/main/PE)
+        # 示例值：1
+        # @type Revise: Integer
+
+        attr_accessor :Prompt, :Resolution, :Seed, :LogoAdd, :LogoParam, :Revise
+
+        def initialize(prompt=nil, resolution=nil, seed=nil, logoadd=nil, logoparam=nil, revise=nil)
+          @Prompt = prompt
+          @Resolution = resolution
+          @Seed = seed
+          @LogoAdd = logoadd
+          @LogoParam = logoparam
+          @Revise = revise
+        end
+
+        def deserialize(params)
+          @Prompt = params['Prompt']
+          @Resolution = params['Resolution']
+          @Seed = params['Seed']
+          @LogoAdd = params['LogoAdd']
+          unless params['LogoParam'].nil?
+            @LogoParam = LogoParam.new
+            @LogoParam.deserialize(params['LogoParam'])
+          end
+          @Revise = params['Revise']
+        end
+      end
+
+      # SubmitTextToImageJob返回参数结构体
+      class SubmitTextToImageJobResponse < TencentCloud::Common::AbstractModel
+        # @param JobId: 任务 ID。
+        # @type JobId: String
+        # @param RequestId: 唯一请求 ID，由服务端生成，每次请求都会返回（若请求因其他原因未能抵达服务端，则该次请求不会获得 RequestId）。定位问题时需要提供该次请求的 RequestId。
+        # @type RequestId: String
+
+        attr_accessor :JobId, :RequestId
+
+        def initialize(jobid=nil, requestid=nil)
+          @JobId = jobid
+          @RequestId = requestid
+        end
+
+        def deserialize(params)
+          @JobId = params['JobId']
+          @RequestId = params['RequestId']
+        end
+      end
+
       # SubmitTextToImageProJob请求参数结构体
       class SubmitTextToImageProJobRequest < TencentCloud::Common::AbstractModel
         # @param Prompt: 文本描述。
@@ -1626,7 +1761,7 @@ module TencentCloud
         # @param LogoParam: 标识内容设置。
         # 默认在生成结果图右下角添加“图片由 AI 生成”字样，您可根据自身需要替换为其他的标识图片。
         # @type LogoParam: :class:`Tencentcloud::Aiart.v20221229.models.LogoParam`
-        # @param RspImgType: 返回图像方式（base64 或 url) ，二选一，默认为 base64。url 有效期为1小时。
+        # @param RspImgType: 返回图像方式（base64 或 url），二选一，默认为 base64。url 有效期为1小时。
         # @type RspImgType: String
 
         attr_accessor :Prompt, :Resolution, :Seed, :Image, :Style, :LogoAdd, :LogoParam, :RspImgType

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: tencentcloud-sdk-aiart
 version: !ruby/object:Gem::Version
-  version: 3.0.1104
+  version: 3.0.1170
 platform: ruby
 authors:
 - Tencent Cloud
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2025-07-20 00:00:00.000000000 Z
+date: 2025-11-19 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: tencentcloud-sdk-common