tencentcloud-sdk-aiart 3.0.526

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 6f72ef2a8744b83478bfdb6c67b5b79ec815b03b
+  data.tar.gz: 3d8e1fa69ad46479c5e6e820338731de050c38b4
+SHA512:
+  metadata.gz: 788836c46f9b139eb3be427dcfe27166f025160490de04966f72f40be85e4fac31e2c3b3c979b9868eabf3f5e3a3e29b075e93c03c3314f035aa235f15d27663
+  data.tar.gz: 43c3092724bb028bcd0d5c8b85a3a465b02a587390e532547d8cdb878d272ac270448cd69a6784d4c2709d178ff978010751336405cfe23049abc9c36a87ee02

data/lib/VERSION

@@ -0,0 +1 @@
+3.0.526

data/lib/tencentcloud-sdk-aiart.rb

@@ -0,0 +1,11 @@
+# frozen_string_literal: true
+
+require 'tencentcloud-sdk-common'
+
+require_relative 'v20221229/client'
+require_relative 'v20221229/models'
+
+module TencentCloud
+  module Aiart
+  end
+end

data/lib/v20221229/client.rb

@@ -0,0 +1,94 @@
+# frozen_string_literal: true
+
+# Copyright (c) 2017-2018 THL A29 Limited, a Tencent company. All Rights Reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#    http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+require 'json'
+
+module TencentCloud
+  module Aiart
+    module V20221229
+      class Client < TencentCloud::Common::AbstractClient
+
+        def initialize(credential, region, profile = nil)
+            api_version = '2022-12-29'
+            api_endpoint = 'aiart.tencentcloudapi.com'
+            sdk_version = 'AIART_' + File.read(File.expand_path('../VERSION', __dir__)).strip
+            super(credential, region, api_version, api_endpoint, sdk_version, profile)
+        end
+
+
+        # 智能图生图接口将根据输入的图片及辅助描述文本，智能生成与之相关的结果图。
+        # 输入：单边分辨率小于2000、转成 Base64 字符串后小于 5MB 的图片，建议同时输入描述文本。
+        # 输出：对应风格及分辨率的 AI 生成图。
+        # 可支持的风格详见 [智能图生图风格列表](https://cloud.tencent.com/document/product/1668/86250)，请将列表中的“风格编号”传入 Styles 数组，建议选择一种风格。
+
+        # 请求频率限制为1次/秒。
+
+        # @param request: Request instance for ImageToImage.
+        # @type request: :class:`Tencentcloud::aiart::V20221229::ImageToImageRequest`
+        # @rtype: :class:`Tencentcloud::aiart::V20221229::ImageToImageResponse`
+        def ImageToImage(request)
+          body = send_request('ImageToImage', request.serialize)
+          response = JSON.parse(body)
+          if response['Response'].key?('Error') == false
+            model = ImageToImageResponse.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
+
+        # 智能文生图接口将根据输入的描述文本，智能生成与之相关的结果图。
+        # 输入：512个字符以内的描述性文本，推荐使用中文。
+        # 输出：对应风格及分辨率的 AI 生成图。
+        # 可支持的风格详见 [智能文生图风格列表](https://cloud.tencent.com/document/product/1668/86249)，请将列表中的“风格编号”传入 Styles 数组，建议选择一种风格。
+
+        # 请求频率限制为1次/秒。
+
+        # @param request: Request instance for TextToImage.
+        # @type request: :class:`Tencentcloud::aiart::V20221229::TextToImageRequest`
+        # @rtype: :class:`Tencentcloud::aiart::V20221229::TextToImageResponse`
+        def TextToImage(request)
+          body = send_request('TextToImage', request.serialize)
+          response = JSON.parse(body)
+          if response['Response'].key?('Error') == false
+            model = TextToImageResponse.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
+
+
+      end
+    end
+  end
+end

data/lib/v20221229/models.rb

@@ -0,0 +1,274 @@
+# frozen_string_literal: true
+
+# Copyright (c) 2017-2018 THL A29 Limited, a Tencent company. All Rights Reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#    http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+module TencentCloud
+  module Aiart
+    module V20221229
+      # ImageToImage请求参数结构体
+      class ImageToImageRequest < TencentCloud::Common::AbstractModel
+        # @param InputImage: 输入图 Base64 数据。
+        # 算法将根据输入的图片，结合文本描述智能生成与之相关的图像。
+        # Base64 和 Url 必须提供一个，如果都提供以 Base64 为准。
+        # 图片限制：单边分辨率小于2000，转成 Base64 字符串后小于 5MB。
+        # @type InputImage: String
+        # @param InputUrl: 输入图 Url。
+        # 算法将根据输入的图片，结合文本描述智能生成与之相关的图像。
+        # Base64 和 Url 必须提供一个，如果都提供以 Base64 为准。
+        # 图片限制：单边分辨率小于2000，转成 Base64 字符串后小于 5MB。
+        # @type InputUrl: String
+        # @param Prompt: 文本描述。
+        # 用于在输入图的基础上引导生成图效果，建议详细描述画面主体、细节、场景等，文本描述越丰富，生成效果越精美。推荐使用中文。最多支持512个 utf-8 字符。
+        # 注意：如果不输入任何文本描述，可能导致较差的效果，建议根据期望的效果输入相应的文本描述。
+        # @type Prompt: String
+        # @param NegativePrompt: 反向文本描述。
+        # 用于一定程度上从反面引导模型生成的走向，减少生成结果中出现描述内容的可能，但不能完全杜绝。
+        # 推荐使用中文。最多可传512个 utf-8 字符。
+        # @type NegativePrompt: String
+        # @param Styles: 绘画风格。
+        # 请在  [智能图生图风格列表](https://cloud.tencent.com/document/product/1668/86250) 中选择期望的风格，传入风格编号。
+        # 推荐使用且只使用一种风格。不传默认使用201（日系动漫风格）。
+        # 如果想要探索风格列表之外的风格，也可以尝试在 Prompt 中输入其他的风格描述。
+        # @type Styles: Array
+        # @param ResultConfig: 生成图结果的配置，包括输出图片分辨率和尺寸等。
+        # @type ResultConfig: :class:`Tencentcloud::Aiart.v20221229.models.ResultConfig`
+        # @param LogoAdd: 为生成结果图添加标识的开关，默认为1。
+        # 1：添加标识。
+        # 0：不添加标识。
+        # 其他数值：默认按1处理。
+        # 建议您使用显著标识来提示结果图使用了 AI 绘画技术，是 AI 生成的图片。
+        # @type LogoAdd: Integer
+        # @param LogoParam: 标识内容设置。
+        # 默认在生成结果图右下角添加“图片由 AI 生成”字样，您可根据自身需要替换为其他的标识图片。
+        # @type LogoParam: :class:`Tencentcloud::Aiart.v20221229.models.LogoParam`
+        # @param Strength: 生成自由度。
+        # Strength 值越小，生成图和原图越接近。取值范围0~1，不传默认为0.6。
+        # @type Strength: Float
+
+        attr_accessor :InputImage, :InputUrl, :Prompt, :NegativePrompt, :Styles, :ResultConfig, :LogoAdd, :LogoParam, :Strength
+        
+        def initialize(inputimage=nil, inputurl=nil, prompt=nil, negativeprompt=nil, styles=nil, resultconfig=nil, logoadd=nil, logoparam=nil, strength=nil)
+          @InputImage = inputimage
+          @InputUrl = inputurl
+          @Prompt = prompt
+          @NegativePrompt = negativeprompt
+          @Styles = styles
+          @ResultConfig = resultconfig
+          @LogoAdd = logoadd
+          @LogoParam = logoparam
+          @Strength = strength
+        end
+
+        def deserialize(params)
+          @InputImage = params['InputImage']
+          @InputUrl = params['InputUrl']
+          @Prompt = params['Prompt']
+          @NegativePrompt = params['NegativePrompt']
+          @Styles = params['Styles']
+          unless params['ResultConfig'].nil?
+            @ResultConfig = ResultConfig.new
+            @ResultConfig.deserialize(params['ResultConfig'])
+          end
+          @LogoAdd = params['LogoAdd']
+          unless params['LogoParam'].nil?
+            @LogoParam = LogoParam.new
+            @LogoParam.deserialize(params['LogoParam'])
+          end
+          @Strength = params['Strength']
+        end
+      end
+
+      # ImageToImage返回参数结构体
+      class ImageToImageResponse < TencentCloud::Common::AbstractModel
+        # @param ResultImage: 返回的生成图 Base64 编码。
+        # @type ResultImage: String
+        # @param RequestId: 唯一请求 ID，每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
+        # @type RequestId: String
+
+        attr_accessor :ResultImage, :RequestId
+        
+        def initialize(resultimage=nil, requestid=nil)
+          @ResultImage = resultimage
+          @RequestId = requestid
+        end
+
+        def deserialize(params)
+          @ResultImage = params['ResultImage']
+          @RequestId = params['RequestId']
+        end
+      end
+
+      # logo参数
+      class LogoParam < TencentCloud::Common::AbstractModel
+        # @param LogoUrl: 水印url
+        # 注意：此字段可能返回 null，表示取不到有效值。
+        # @type LogoUrl: String
+        # @param LogoImage: 水印base64，url和base64二选一传入
+        # 注意：此字段可能返回 null，表示取不到有效值。
+        # @type LogoImage: String
+        # @param LogoRect: 水印图片位于融合结果图中的坐标，将按照坐标对标识图片进行位置和大小的拉伸匹配
+        # 注意：此字段可能返回 null，表示取不到有效值。
+        # @type LogoRect: :class:`Tencentcloud::Aiart.v20221229.models.LogoRect`
+
+        attr_accessor :LogoUrl, :LogoImage, :LogoRect
+        
+        def initialize(logourl=nil, logoimage=nil, logorect=nil)
+          @LogoUrl = logourl
+          @LogoImage = logoimage
+          @LogoRect = logorect
+        end
+
+        def deserialize(params)
+          @LogoUrl = params['LogoUrl']
+          @LogoImage = params['LogoImage']
+          unless params['LogoRect'].nil?
+            @LogoRect = LogoRect.new
+            @LogoRect.deserialize(params['LogoRect'])
+          end
+        end
+      end
+
+      # 输入框
+      class LogoRect < TencentCloud::Common::AbstractModel
+        # @param X: 左上角X坐标
+        # 注意：此字段可能返回 null，表示取不到有效值。
+        # @type X: Integer
+        # @param Y: 左上角Y坐标
+        # 注意：此字段可能返回 null，表示取不到有效值。
+        # @type Y: Integer
+        # @param Width: 方框宽度
+        # 注意：此字段可能返回 null，表示取不到有效值。
+        # @type Width: Integer
+        # @param Height: 方框高度
+        # 注意：此字段可能返回 null，表示取不到有效值。
+        # @type Height: Integer
+
+        attr_accessor :X, :Y, :Width, :Height
+        
+        def initialize(x=nil, y=nil, width=nil, height=nil)
+          @X = x
+          @Y = y
+          @Width = width
+          @Height = height
+        end
+
+        def deserialize(params)
+          @X = params['X']
+          @Y = params['Y']
+          @Width = params['Width']
+          @Height = params['Height']
+        end
+      end
+
+      # 返回结果配置
+      class ResultConfig < TencentCloud::Common::AbstractModel
+        # @param Resolution: 生成图分辨率
+        # 支持生成以下不同分辨率的图片，对应1:1方图、3:4竖图、4:3横图三种尺寸规格，不传默认为"768:768"
+        # 取值：
+        # ● 768:768
+        # ● 768:1024
+        # ● 1024:768
+        # 注意：此字段可能返回 null，表示取不到有效值。
+        # @type Resolution: String
+
+        attr_accessor :Resolution
+        
+        def initialize(resolution=nil)
+          @Resolution = resolution
+        end
+
+        def deserialize(params)
+          @Resolution = params['Resolution']
+        end
+      end
+
+      # TextToImage请求参数结构体
+      class TextToImageRequest < TencentCloud::Common::AbstractModel
+        # @param Prompt: 文本描述。
+        # 算法将根据输入的文本智能生成与之相关的图像。建议详细描述画面主体、细节、场景等，文本描述越丰富，生成效果越精美。
+        # 不能为空，推荐使用中文。最多可传512个 utf-8 字符。
+        # @type Prompt: String
+        # @param NegativePrompt: 反向文本描述。
+        # 用于一定程度上从反面引导模型生成的走向，减少生成结果中出现描述内容的可能，但不能完全杜绝。
+        # 推荐使用中文。最多可传512个 utf-8 字符。
+        # @type NegativePrompt: String
+        # @param Styles: 绘画风格。
+        # 请在 [智能文生图风格列表](https://cloud.tencent.com/document/product/1668/86249) 中选择期望的风格，传入风格编号。
+        # 推荐使用且只使用一种风格。不传默认使用201（日系动漫风格）。
+        # 如果想要探索风格列表之外的风格，也可以尝试在 Prompt 中输入其他的风格描述。
+        # @type Styles: Array
+        # @param ResultConfig: 生成图结果的配置，包括输出图片分辨率和尺寸等。
+        # @type ResultConfig: :class:`Tencentcloud::Aiart.v20221229.models.ResultConfig`
+        # @param LogoAdd: 为生成结果图添加标识的开关，默认为1。
+        # 1：添加标识。
+        # 0：不添加标识。
+        # 其他数值：默认按1处理。
+        # 建议您使用显著标识来提示结果图使用了 AI 绘画技术，是 AI 生成的图片。
+        # @type LogoAdd: Integer
+        # @param LogoParam: 标识内容设置。
+        # 默认在生成结果图右下角添加“图片由 AI 生成”字样，您可根据自身需要替换为其他的标识图片。
+        # @type LogoParam: :class:`Tencentcloud::Aiart.v20221229.models.LogoParam`
+
+        attr_accessor :Prompt, :NegativePrompt, :Styles, :ResultConfig, :LogoAdd, :LogoParam
+        
+        def initialize(prompt=nil, negativeprompt=nil, styles=nil, resultconfig=nil, logoadd=nil, logoparam=nil)
+          @Prompt = prompt
+          @NegativePrompt = negativeprompt
+          @Styles = styles
+          @ResultConfig = resultconfig
+          @LogoAdd = logoadd
+          @LogoParam = logoparam
+        end
+
+        def deserialize(params)
+          @Prompt = params['Prompt']
+          @NegativePrompt = params['NegativePrompt']
+          @Styles = params['Styles']
+          unless params['ResultConfig'].nil?
+            @ResultConfig = ResultConfig.new
+            @ResultConfig.deserialize(params['ResultConfig'])
+          end
+          @LogoAdd = params['LogoAdd']
+          unless params['LogoParam'].nil?
+            @LogoParam = LogoParam.new
+            @LogoParam.deserialize(params['LogoParam'])
+          end
+        end
+      end
+
+      # TextToImage返回参数结构体
+      class TextToImageResponse < TencentCloud::Common::AbstractModel
+        # @param ResultImage: 返回的生成图 Base64 编码。
+        # @type ResultImage: String
+        # @param RequestId: 唯一请求 ID，每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
+        # @type RequestId: String
+
+        attr_accessor :ResultImage, :RequestId
+        
+        def initialize(resultimage=nil, requestid=nil)
+          @ResultImage = resultimage
+          @RequestId = requestid
+        end
+
+        def deserialize(params)
+          @ResultImage = params['ResultImage']
+          @RequestId = params['RequestId']
+        end
+      end
+
+    end
+  end
+end
+

metadata

@@ -0,0 +1,66 @@
+--- !ruby/object:Gem::Specification
+name: tencentcloud-sdk-aiart
+version: !ruby/object:Gem::Version
+  version: 3.0.526
+platform: ruby
+authors:
+- Tencent Cloud
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2023-03-10 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: tencentcloud-sdk-common
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '3.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '3.0'
+description: Tencent Cloud Ruby SDK is the official software development kit, which
+  allows Ruby developers to write software that makes use of Tencent Cloud service
+  AIART.
+email:
+- tencentcloudapi@tencent.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- lib/v20221229/models.rb
+- lib/v20221229/client.rb
+- lib/tencentcloud-sdk-aiart.rb
+- lib/VERSION
+homepage: https://github.com/TencentCloud/tencentcloud-sdk-ruby
+licenses:
+- Apache-2.0
+metadata:
+  source_code_uri: https://github.com/TencentCloud/tencentcloud-sdk-ruby/tencentcloud-sdk-aiart
+  changelog_uri: https://github.com/TencentCloud/tencentcloud-sdk-ruby/blob/master/CHANGELOG.md
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.0.14
+signing_key: 
+specification_version: 4
+summary: Tencent Cloud SDK for Ruby - AIART
+test_files: []