tencentcloud-sdk-hunyuan 3.0.952 → 3.0.953

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: bbb8c3c8e14e75c4022b1c346dfe985005728b13
-  data.tar.gz: 8e3dd2fbdbc7c354fbdd5a337f8d8c8a73a5fd6d
+  metadata.gz: b5c7a18cbef36bfcbfb6f7e8621292d3813b5332
+  data.tar.gz: 12fcf09938bfb0be4960d910131b5836c212dd87
 SHA512:
-  metadata.gz: 5ae2f5e83f9a8c27d1f5a9bdc41f66c7ce64a13e086fb3e385302cf95d92cb2e138369cca8e9d35abb80a9b458a844af2f11f576fb710720ac2d9f16f3a69a02
-  data.tar.gz: 48ff616fe856f809abd547de94d915f858e0416a851f3986143afc8d25248eec7a7d7d2c29b8d87aafb6054d923aaa4f468fcdf8e799b12baf527ea9dd6bd8c3
+  metadata.gz: d332022b53d1b96c5c3aa1c8d571edad1622f4ed877488bb4df345538e7ef3703f2e443511608df7d6e11ce7fae4913aa81bf30cae3c230d0cc25d5aadca4b0c
+  data.tar.gz: ad7d50831e62e3e86cc1e2448c37aa7e899ecceecd1d3bd8b32de1ec022e8996615dfe3887a5fdc3f078ff51ef52466ce3a3d2cbb2e183d8054355b930c8513a

data/lib/VERSION

@@ -1 +1 @@
-3.0.952
+3.0.953

data/lib/v20230901/client.rb

@@ -89,6 +89,35 @@ module TencentCloud
         #  3. 请使用 SDK 调用本接口，每种开发语言的 SDK Git 仓库 examples/hunyuan/v20230901/ 目录下有提供示例供参考。SDK 链接在文档下方 “**开发者资源 - SDK**” 部分提供。
         #  4. 我们推荐您使用 API Explorer，方便快速地在线调试接口和下载各语言的示例代码，[点击打开](https://console.cloud.tencent.com/api/explorer?Product=hunyuan&Version=2023-09-01&Action=ChatCompletions)。
 
+        # @param request: Request instance for ChatTranslations.
+        # @type request: :class:`Tencentcloud::hunyuan::V20230901::ChatTranslationsRequest`
+        # @rtype: :class:`Tencentcloud::hunyuan::V20230901::ChatTranslationsResponse`
+        def ChatTranslations(request)
+          body = send_request('ChatTranslations', request.serialize)
+          response = JSON.parse(body)
+          if response['Response'].key?('Error') == false
+            model = ChatTranslationsResponse.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
+
+        # 腾讯混元大模型是由腾讯研发的大语言模型，具备强大的中文创作能力，复杂语境下的逻辑推理能力，以及可靠的任务执行能力。本接口支持流式或非流式调用，当使用流式调用时为 SSE 协议。
+
+        #  1. 本接口暂不支持返回图片内容。
+        #  2. 默认该接口下单账号限制并发数为  5 路，如您有提高并发限制的需求请 [购买](https://buy.cloud.tencent.com/hunyuan) 。
+        #  3. 请使用 SDK 调用本接口，每种开发语言的 SDK Git 仓库 examples/hunyuan/v20230901/ 目录下有提供示例供参考。SDK 链接在文档下方 “**开发者资源 - SDK**” 部分提供。
+        #  4. 我们推荐您使用 API Explorer，方便快速地在线调试接口和下载各语言的示例代码，[点击打开](https://console.cloud.tencent.com/api/explorer?Product=hunyuan&Version=2023-09-01&Action=ChatCompletions)。
+
         # @param request: Request instance for CreateThread.
         # @type request: :class:`Tencentcloud::hunyuan::V20230901::CreateThreadRequest`
         # @rtype: :class:`Tencentcloud::hunyuan::V20230901::CreateThreadResponse`

data/lib/v20230901/models.rb

@@ -134,10 +134,15 @@ module TencentCloud
         # @type EnableDeepSearch: Boolean
         # @param Seed: 说明： 1. 确保模型的输出是可复现的。 2. 取值区间为非0正整数，最大值10000。 3. 非必要不建议使用，不合理的取值会影响效果。
         # @type Seed: Integer
+        # @param ForceSearchEnhancement: 强制搜索增强开关。
+        # 说明：
+        # 1. 未传值时默认关闭。
+        # 2. 开启后，将强制走AI搜索，当AI搜索结果为空时，由大模型回复兜底话术。
+        # @type ForceSearchEnhancement: Boolean
 
-        attr_accessor :Model, :Messages, :Stream, :StreamModeration, :TopP, :Temperature, :EnableEnhancement, :Tools, :ToolChoice, :CustomTool, :SearchInfo, :Citation, :EnableSpeedSearch, :EnableMultimedia, :EnableDeepSearch, :Seed
+        attr_accessor :Model, :Messages, :Stream, :StreamModeration, :TopP, :Temperature, :EnableEnhancement, :Tools, :ToolChoice, :CustomTool, :SearchInfo, :Citation, :EnableSpeedSearch, :EnableMultimedia, :EnableDeepSearch, :Seed, :ForceSearchEnhancement
 
-        def initialize(model=nil, messages=nil, stream=nil, streammoderation=nil, topp=nil, temperature=nil, enableenhancement=nil, tools=nil, toolchoice=nil, customtool=nil, searchinfo=nil, citation=nil, enablespeedsearch=nil, enablemultimedia=nil, enabledeepsearch=nil, seed=nil)
+        def initialize(model=nil, messages=nil, stream=nil, streammoderation=nil, topp=nil, temperature=nil, enableenhancement=nil, tools=nil, toolchoice=nil, customtool=nil, searchinfo=nil, citation=nil, enablespeedsearch=nil, enablemultimedia=nil, enabledeepsearch=nil, seed=nil, forcesearchenhancement=nil)
           @Model = model
           @Messages = messages
           @Stream = stream
@@ -154,6 +159,7 @@ module TencentCloud
           @EnableMultimedia = enablemultimedia
           @EnableDeepSearch = enabledeepsearch
           @Seed = seed
+          @ForceSearchEnhancement = forcesearchenhancement
         end
 
         def deserialize(params)
@@ -190,6 +196,7 @@ module TencentCloud
           @EnableMultimedia = params['EnableMultimedia']
           @EnableDeepSearch = params['EnableDeepSearch']
           @Seed = params['Seed']
+          @ForceSearchEnhancement = params['ForceSearchEnhancement']
         end
       end
 
@@ -274,6 +281,124 @@ module TencentCloud
         end
       end
 
+      # ChatTranslations请求参数结构体
+      class ChatTranslationsRequest < TencentCloud::Common::AbstractModel
+        # @param Model: 模型名称，可选值包括 hunyuan-translation、hunyuan-translation-lite。
+        # 各模型介绍请阅读 [产品概述](https://cloud.tencent.com/document/product/1729/104753) 中的说明。
+
+        # 注意：
+        # 不同的模型计费不同，请根据 [购买指南](https://cloud.tencent.com/document/product/1729/97731) 按需调用。
+        # @type Model: String
+        # @param Stream: 流式调用开关。
+        # 说明：
+        # 1. 未传值时默认为非流式调用（false）。
+        # 2. 流式调用时以 SSE 协议增量返回结果（返回值取 Choices[n].Delta 中的值，需要拼接增量数据才能获得完整结果）。
+        # 3. 非流式调用时：
+        # 调用方式与普通 HTTP 请求无异。
+        # 接口响应耗时较长，**如需更低时延建议设置为 true**。
+        # 只返回一次最终结果（返回值取 Choices[n].Message 中的值）。
+
+        # 注意：
+        # 通过 SDK 调用时，流式和非流式调用需用**不同的方式**获取返回值，具体参考 SDK 中的注释或示例（在各语言 SDK 代码仓库的 examples/hunyuan/v20230901/ 目录中）。
+        # @type Stream: Boolean
+        # @param Text: 待翻译的文本
+        # @type Text: String
+        # @param Source: 源语言。
+        # 支持语言列表: 1. 简体中文：zh，2. 粤语：yue，3. 英语：en，4. 法语：fr，5. 葡萄牙语：pt，6. 西班牙语：es，7. 日语：ja，8. 土耳其语：tr，9. 俄语：ru，10. 阿拉伯语：ar，11. 韩语：ko，12. 泰语：th，13. 意大利语：it，14. 德语：de，15. 越南语：vi，16. 马来语：ms，17. 印尼语：id
+        # @type Source: String
+        # @param Target: 目标语言。
+        # 支持语言列表: 1. 简体中文：zh，2. 粤语：yue，3. 英语：en，4. 法语：fr，5. 葡萄牙语：pt，6. 西班牙语：es，7. 日语：ja，8. 土耳其语：tr，9. 俄语：ru，10. 阿拉伯语：ar，11. 韩语：ko，12. 泰语：th，13. 意大利语：it，14. 德语：de，15. 越南语：vi，16. 马来语：ms，17. 印尼语：id
+        # @type Target: String
+        # @param Field: 待翻译文本所属领域，例如游戏剧情等
+        # @type Field: String
+        # @param References: 参考示例，最多10个
+        # @type References: Array
+
+        attr_accessor :Model, :Stream, :Text, :Source, :Target, :Field, :References
+
+        def initialize(model=nil, stream=nil, text=nil, source=nil, target=nil, field=nil, references=nil)
+          @Model = model
+          @Stream = stream
+          @Text = text
+          @Source = source
+          @Target = target
+          @Field = field
+          @References = references
+        end
+
+        def deserialize(params)
+          @Model = params['Model']
+          @Stream = params['Stream']
+          @Text = params['Text']
+          @Source = params['Source']
+          @Target = params['Target']
+          @Field = params['Field']
+          unless params['References'].nil?
+            @References = []
+            params['References'].each do |i|
+              reference_tmp = Reference.new
+              reference_tmp.deserialize(i)
+              @References << reference_tmp
+            end
+          end
+        end
+      end
+
+      # ChatTranslations返回参数结构体
+      class ChatTranslationsResponse < TencentCloud::Common::AbstractModel
+        # @param Id: 本次请求的 RequestId。
+        # @type Id: String
+        # @param Note: 免责声明。
+        # @type Note: String
+        # @param Created: Unix 时间戳，单位为秒。
+        # @type Created: Integer
+        # @param Usage: Token 统计信息。
+        # 按照总 Token 数量计费。
+        # @type Usage: :class:`Tencentcloud::Hunyuan.v20230901.models.Usage`
+        # @param Choices: 回复内容。
+        # @type Choices: Array
+        # @param ErrorMsg: 错误信息。
+        # 如果流式返回中服务处理异常，返回该错误信息。
+        # @type ErrorMsg: :class:`Tencentcloud::Hunyuan.v20230901.models.ErrorMsg`
+        # @param RequestId: 唯一请求 ID，由服务端生成，每次请求都会返回（若请求因其他原因未能抵达服务端，则该次请求不会获得 RequestId）。定位问题时需要提供该次请求的 RequestId。本接口为流式响应接口，当请求成功时，RequestId 会被放在 HTTP 响应的 Header "X-TC-RequestId" 中。
+        # @type RequestId: String
+
+        attr_accessor :Id, :Note, :Created, :Usage, :Choices, :ErrorMsg, :RequestId
+
+        def initialize(id=nil, note=nil, created=nil, usage=nil, choices=nil, errormsg=nil, requestid=nil)
+          @Id = id
+          @Note = note
+          @Created = created
+          @Usage = usage
+          @Choices = choices
+          @ErrorMsg = errormsg
+          @RequestId = requestid
+        end
+
+        def deserialize(params)
+          @Id = params['Id']
+          @Note = params['Note']
+          @Created = params['Created']
+          unless params['Usage'].nil?
+            @Usage = Usage.new
+            @Usage.deserialize(params['Usage'])
+          end
+          unless params['Choices'].nil?
+            @Choices = []
+            params['Choices'].each do |i|
+              translationchoice_tmp = TranslationChoice.new
+              translationchoice_tmp.deserialize(i)
+              @Choices << translationchoice_tmp
+            end
+          end
+          unless params['ErrorMsg'].nil?
+            @ErrorMsg = ErrorMsg.new
+            @ErrorMsg.deserialize(params['ErrorMsg'])
+          end
+          @RequestId = params['RequestId']
+        end
+      end
+
       # 返回的回复, 支持多个
       class Choice < TencentCloud::Common::AbstractModel
         # @param FinishReason: 结束标志位，可能为 stop、 sensitive或者tool_calls。
@@ -1391,6 +1516,30 @@ module TencentCloud
         end
       end
 
+      # 翻译对话参考示例
+      class Reference < TencentCloud::Common::AbstractModel
+        # @param Type: 翻译文本类型，枚举"sentence"表示句子, "term"表示术语
+        # @type Type: String
+        # @param Text: 原文
+        # @type Text: String
+        # @param Translation: 译文
+        # @type Translation: String
+
+        attr_accessor :Type, :Text, :Translation
+
+        def initialize(type=nil, text=nil, translation=nil)
+          @Type = type
+          @Text = text
+          @Translation = translation
+        end
+
+        def deserialize(params)
+          @Type = params['Type']
+          @Text = params['Text']
+          @Translation = params['Translation']
+        end
+      end
+
       # 相关组织及人物
       class RelevantEntity < TencentCloud::Common::AbstractModel
         # @param Name: 相关组织及人物名称
@@ -1811,6 +1960,10 @@ module TencentCloud
         # 不传：随机种子生成。
         # 正数：固定种子生成。
         # @type Seed: Integer
+        # @param Clarity: 超分选项，默认不做超分，可选开启。
+        #  x2：2倍超分
+        #  x4：4倍超分
+        # @type Clarity: String
         # @param Revise: prompt 扩写开关。1为开启，0为关闭，不传默认开启。
         # 开启扩写后，将自动扩写原始输入的 prompt 并使用扩写后的 prompt 生成图片，返回生成图片结果时将一并返回扩写后的 prompt 文本。
         # 如果关闭扩写，将直接使用原始输入的 prompt 生成图片。
@@ -1826,15 +1979,16 @@ module TencentCloud
         # 默认在生成结果图右下角添加“图片由 AI 生成”字样，您可根据自身需要替换为其他的标识图片。
         # @type LogoParam: :class:`Tencentcloud::Hunyuan.v20230901.models.LogoParam`
 
-        attr_accessor :Prompt, :NegativePrompt, :Style, :Resolution, :Num, :Seed, :Revise, :LogoAdd, :LogoParam
+        attr_accessor :Prompt, :NegativePrompt, :Style, :Resolution, :Num, :Seed, :Clarity, :Revise, :LogoAdd, :LogoParam
 
-        def initialize(prompt=nil, negativeprompt=nil, style=nil, resolution=nil, num=nil, seed=nil, revise=nil, logoadd=nil, logoparam=nil)
+        def initialize(prompt=nil, negativeprompt=nil, style=nil, resolution=nil, num=nil, seed=nil, clarity=nil, revise=nil, logoadd=nil, logoparam=nil)
           @Prompt = prompt
           @NegativePrompt = negativeprompt
           @Style = style
           @Resolution = resolution
           @Num = num
           @Seed = seed
+          @Clarity = clarity
           @Revise = revise
           @LogoAdd = logoadd
           @LogoParam = logoparam
@@ -1847,6 +2001,7 @@ module TencentCloud
           @Resolution = params['Resolution']
           @Num = params['Num']
           @Seed = params['Seed']
+          @Clarity = params['Clarity']
           @Revise = params['Revise']
           @LogoAdd = params['LogoAdd']
           unless params['LogoParam'].nil?
@@ -2242,6 +2397,82 @@ module TencentCloud
         end
       end
 
+      # 翻译接口返回的回复，支持多个
+      class TranslationChoice < TencentCloud::Common::AbstractModel
+        # @param FinishReason: 结束标志位，可能为 stop、 sensitive。
+        # stop 表示输出正常结束。
+        # sensitive 只在开启流式输出审核时会出现，表示安全审核未通过。
+        # @type FinishReason: String
+        # @param Index: 索引值，流式调用时使用该字段。
+        # @type Index: Integer
+        # @param Delta: 增量返回值，流式调用时使用该字段。
+        # @type Delta: :class:`Tencentcloud::Hunyuan.v20230901.models.TranslationDelta`
+        # @param Message: 返回值，非流式调用时使用该字段。
+        # @type Message: :class:`Tencentcloud::Hunyuan.v20230901.models.TranslationMessage`
+
+        attr_accessor :FinishReason, :Index, :Delta, :Message
+
+        def initialize(finishreason=nil, index=nil, delta=nil, message=nil)
+          @FinishReason = finishreason
+          @Index = index
+          @Delta = delta
+          @Message = message
+        end
+
+        def deserialize(params)
+          @FinishReason = params['FinishReason']
+          @Index = params['Index']
+          unless params['Delta'].nil?
+            @Delta = TranslationDelta.new
+            @Delta.deserialize(params['Delta'])
+          end
+          unless params['Message'].nil?
+            @Message = TranslationMessage.new
+            @Message.deserialize(params['Message'])
+          end
+        end
+      end
+
+      # 翻译接口返回的内容（流式返回）
+      class TranslationDelta < TencentCloud::Common::AbstractModel
+        # @param Role: 角色名称。
+        # @type Role: String
+        # @param Content: 内容详情。
+        # @type Content: String
+
+        attr_accessor :Role, :Content
+
+        def initialize(role=nil, content=nil)
+          @Role = role
+          @Content = content
+        end
+
+        def deserialize(params)
+          @Role = params['Role']
+          @Content = params['Content']
+        end
+      end
+
+      # 翻译接口会话内容
+      class TranslationMessage < TencentCloud::Common::AbstractModel
+        # @param Role: 角色，可选值包括 system、user、assistant、 tool。
+        # @type Role: String
+        # @param Content: 文本内容
+        # @type Content: String
+
+        attr_accessor :Role, :Content
+
+        def initialize(role=nil, content=nil)
+          @Role = role
+          @Content = content
+        end
+
+        def deserialize(params)
+          @Role = params['Role']
+          @Content = params['Content']
+        end
+      end
+
       # Token 数量
       class Usage < TencentCloud::Common::AbstractModel
         # @param PromptTokens: 输入 Token 数量。

metadata

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