tencentcloud-sdk-hunyuan 3.0.741 → 3.0.743

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 1b851110ab877f073099c3a0ff4b75bfc4863db8
-  data.tar.gz: 08014f7ba5388bea05c60b42f8db7574d8d2d1d5
+  metadata.gz: be9aeba27b1d7d529987d07a3288926a7b5d95b1
+  data.tar.gz: 50fa9bfeaec4a02ff792ea4ff2a011e9417af4fb
 SHA512:
-  metadata.gz: 74f5b58fdf229bee0aa25a4aa3b30ad4ed6acd3005fd43be6f77cbe3f4f53cb0fdeefbd3c613ab8ecf2f812671faded78a6e55ec6428e107cc7a142711ce53e9
-  data.tar.gz: 506eaebb9fc54091a299dfcb91284d8cb524f4c8c1f9ffb2d965664c9b119f401394bd5630b6d7c14a9c0dc8dfa1bcf1ce02d6e8b448eff0faa0d3a9e1e8e687
+  metadata.gz: aa00ba0dd3d41111a81d9063fdadba750b27ed04c4d86cbbd36cbf604be446c8ba22fe245ebd9c70fac04e3fefd6b1e88abc87151e9872548265ca9978a417a5
+  data.tar.gz: 1ca9b876e8e6817e7975a2c6d9898dfef3e582dd8736c88f379c4d66b3670885910ac83f455e0c30ae5bd73e5fd3d7914bb934a551ad0303e4ac2f9fae16d9db

data/lib/VERSION

@@ -1 +1 @@
-3.0.741
+3.0.743

data/lib/v20230901/client.rb

@@ -85,6 +85,30 @@ module TencentCloud
           raise TencentCloud::Common::TencentCloudSDKException.new(nil, e.inspect)
         end
 
+        # 腾讯混元-Embedding接口，可以将文本转化为高质量的向量数据。
+
+        # @param request: Request instance for GetEmbedding.
+        # @type request: :class:`Tencentcloud::hunyuan::V20230901::GetEmbeddingRequest`
+        # @rtype: :class:`Tencentcloud::hunyuan::V20230901::GetEmbeddingResponse`
+        def GetEmbedding(request)
+          body = send_request('GetEmbedding', request.serialize)
+          response = JSON.parse(body)
+          if response['Response'].key?('Error') == false
+            model = GetEmbeddingResponse.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
+
         # 该接口用于计算文本对应Token数、字符数。
 
         # @param request: Request instance for GetTokenCount.

data/lib/v20230901/models.rb

@@ -22,7 +22,7 @@ module TencentCloud
         # @param Messages: 聊天上下文信息。
         # 说明：
         # 1.长度最多为40, 按对话时间从旧到新在数组中排列。
-        # 2.Message的Role当前可选值：user、assistant，其中，user和assistant需要交替出现(一问一答)，最后一个为user提问, 且Content不能为空。
+        # 2.Message的Role当前可选值：system、user、assistant，其中，system角色是可选的，如果存在，必须位于列表的最开始。user和assistant需要交替出现(一问一答)，最后一个为user提问, 且Content不能为空。
         # 3.Messages中Content总长度不超过16000 token，超过则会截断最前面的内容，只保留尾部内容。建议不超过4000 token。
         # @type Messages: Array
         # @param TopP: 说明：
@@ -254,6 +254,53 @@ module TencentCloud
         end
       end
 
+      # embedding 信息，当前不支持批量，所以数组元素数目为1。
+      class EmbeddingData < TencentCloud::Common::AbstractModel
+        # @param Embedding: embedding 信息。
+        # 注意：此字段可能返回 null，表示取不到有效值。
+        # @type Embedding: Array
+        # @param Index: 下标。
+        # 注意：此字段可能返回 null，表示取不到有效值。
+        # @type Index: Integer
+        # @param Object: embedding
+        # 注意：此字段可能返回 null，表示取不到有效值。
+        # @type Object: String
+
+        attr_accessor :Embedding, :Index, :Object
+
+        def initialize(embedding=nil, index=nil, object=nil)
+          @Embedding = embedding
+          @Index = index
+          @Object = object
+        end
+
+        def deserialize(params)
+          @Embedding = params['Embedding']
+          @Index = params['Index']
+          @Object = params['Object']
+        end
+      end
+
+      # token 使用计数。
+      class EmbeddingUsage < TencentCloud::Common::AbstractModel
+        # @param PromptTokens: 输入Token数。
+        # @type PromptTokens: Integer
+        # @param TotalTokens: 总Token数。
+        # @type TotalTokens: Integer
+
+        attr_accessor :PromptTokens, :TotalTokens
+
+        def initialize(prompttokens=nil, totaltokens=nil)
+          @PromptTokens = prompttokens
+          @TotalTokens = totaltokens
+        end
+
+        def deserialize(params)
+          @PromptTokens = params['PromptTokens']
+          @TotalTokens = params['TotalTokens']
+        end
+      end
+
       # 运行时异常信息。
       class ErrorMsg < TencentCloud::Common::AbstractModel
         # @param Msg: 错误提示信息。
@@ -276,6 +323,56 @@ module TencentCloud
         end
       end
 
+      # GetEmbedding请求参数结构体
+      class GetEmbeddingRequest < TencentCloud::Common::AbstractModel
+        # @param Input: 输入文本。总长度不超过1024 个token, 超过则会截断最后面的内容。
+        # @type Input: String
+
+        attr_accessor :Input
+
+        def initialize(input=nil)
+          @Input = input
+        end
+
+        def deserialize(params)
+          @Input = params['Input']
+        end
+      end
+
+      # GetEmbedding返回参数结构体
+      class GetEmbeddingResponse < TencentCloud::Common::AbstractModel
+        # @param Data: 返回的 embedding 信息。
+        # @type Data: Array
+        # @param Usage: token 使用计数，按照总token数量收费。
+        # @type Usage: :class:`Tencentcloud::Hunyuan.v20230901.models.EmbeddingUsage`
+        # @param RequestId: 唯一请求 ID，每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
+        # @type RequestId: String
+
+        attr_accessor :Data, :Usage, :RequestId
+
+        def initialize(data=nil, usage=nil, requestid=nil)
+          @Data = data
+          @Usage = usage
+          @RequestId = requestid
+        end
+
+        def deserialize(params)
+          unless params['Data'].nil?
+            @Data = []
+            params['Data'].each do |i|
+              embeddingdata_tmp = EmbeddingData.new
+              embeddingdata_tmp.deserialize(i)
+              @Data << embeddingdata_tmp
+            end
+          end
+          unless params['Usage'].nil?
+            @Usage = EmbeddingUsage.new
+            @Usage.deserialize(params['Usage'])
+          end
+          @RequestId = params['RequestId']
+        end
+      end
+
       # GetTokenCount请求参数结构体
       class GetTokenCountRequest < TencentCloud::Common::AbstractModel
         # @param Prompt: 输入文本

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: tencentcloud-sdk-hunyuan
 version: !ruby/object:Gem::Version
-  version: 3.0.741
+  version: 3.0.743
 platform: ruby
 authors:
 - Tencent Cloud
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2024-01-04 00:00:00.000000000 Z
+date: 2024-01-07 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: tencentcloud-sdk-common