tencentcloud-sdk-ai3d 3.0.1096

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 62b9c0284aabdeafa0d49876e9310858757a3f84
+  data.tar.gz: 65788d1dbc397ee882650bf927b265892f6bf93d
+SHA512:
+  metadata.gz: d826d7f111a14cc1527ba4169082ab0c3b81d170271185a38f12a88ac064c2cea68d07d3cc2201ff55c786b414cd09f2f7908843e609870c7a7be1e5c516e6ae
+  data.tar.gz: 06ae4a49e83ec0d21135188b1c2baef7f646eca770fb7aed06c4878475d3b7acca4a82af1497317ad27fca2ef284588315349ba8038f755ecf24d51c248928fc

data/lib/VERSION

@@ -0,0 +1 @@
+3.0.1096

data/lib/tencentcloud-sdk-ai3d.rb

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

data/lib/v20250513/client.rb

@@ -0,0 +1,86 @@
+# frozen_string_literal: true
+
+# Copyright (c) 2017-2025 Tencent. 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 Ai3d
+    module V20250513
+      class Client < TencentCloud::Common::AbstractClient
+
+        def initialize(credential, region, profile = nil)
+            api_version = '2025-05-13'
+            api_endpoint = 'ai3d.tencentcloudapi.com'
+            sdk_version = 'AI3D_' + File.read(File.expand_path('../VERSION', __dir__)).strip
+            super(credential, region, api_version, api_endpoint, sdk_version, profile)
+        end
+
+
+        # 混元生3D接口，基于混元大模型，根据输入的文本描述/图片智能生成3D。
+        # 默认提供1个并发，代表最多能同时处理1个已提交的任务，上一个任务处理完毕后，才能开始处理下一个任务。
+
+        # @param request: Request instance for QueryHunyuanTo3DJob.
+        # @type request: :class:`Tencentcloud::ai3d::V20250513::QueryHunyuanTo3DJobRequest`
+        # @rtype: :class:`Tencentcloud::ai3d::V20250513::QueryHunyuanTo3DJobResponse`
+        def QueryHunyuanTo3DJob(request)
+          body = send_request('QueryHunyuanTo3DJob', request.serialize)
+          response = JSON.parse(body)
+          if response['Response'].key?('Error') == false
+            model = QueryHunyuanTo3DJobResponse.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
+
+        # 混元生3D接口，基于混元大模型，根据输入的文本描述/图片智能生成3D。
+        # 默认提供1个并发，代表最多能同时处理1个已提交的任务，上一个任务处理完毕后，才能开始处理下一个任务。
+
+        # @param request: Request instance for SubmitHunyuanTo3DJob.
+        # @type request: :class:`Tencentcloud::ai3d::V20250513::SubmitHunyuanTo3DJobRequest`
+        # @rtype: :class:`Tencentcloud::ai3d::V20250513::SubmitHunyuanTo3DJobResponse`
+        def SubmitHunyuanTo3DJob(request)
+          body = send_request('SubmitHunyuanTo3DJob', request.serialize)
+          response = JSON.parse(body)
+          if response['Response'].key?('Error') == false
+            model = SubmitHunyuanTo3DJobResponse.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/v20250513/models.rb

@@ -0,0 +1,204 @@
+# frozen_string_literal: true
+
+# Copyright (c) 2017-2025 Tencent. 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 Ai3d
+    module V20250513
+      # 3D文件
+      class File3D < TencentCloud::Common::AbstractModel
+        # @param Type: 3D文件的格式。取值范围：OBJ
+        # @type Type: String
+        # @param Url: 文件的Url（有效期24小时）
+        # @type Url: String
+        # @param PreviewImageUrl: 预览图片Url
+        # @type PreviewImageUrl: String
+
+        attr_accessor :Type, :Url, :PreviewImageUrl
+
+        def initialize(type=nil, url=nil, previewimageurl=nil)
+          @Type = type
+          @Url = url
+          @PreviewImageUrl = previewimageurl
+        end
+
+        def deserialize(params)
+          @Type = params['Type']
+          @Url = params['Url']
+          @PreviewImageUrl = params['PreviewImageUrl']
+        end
+      end
+
+      # QueryHunyuanTo3DJob请求参数结构体
+      class QueryHunyuanTo3DJobRequest < 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
+
+      # QueryHunyuanTo3DJob返回参数结构体
+      class QueryHunyuanTo3DJobResponse < TencentCloud::Common::AbstractModel
+        # @param Status: 任务状态。WAIT：等待中，RUN：执行中，FAIL：任务失败，DONE：任务成功
+        # @type Status: String
+        # @param ErrorCode: 错误码
+        # @type ErrorCode: String
+        # @param ErrorMessage: 错误信息
+        # @type ErrorMessage: String
+        # @param ResultFile3Ds: 生成的3D文件数组。
+        # @type ResultFile3Ds: Array
+        # @param RequestId: 唯一请求 ID，由服务端生成，每次请求都会返回（若请求因其他原因未能抵达服务端，则该次请求不会获得 RequestId）。定位问题时需要提供该次请求的 RequestId。
+        # @type RequestId: String
+
+        attr_accessor :Status, :ErrorCode, :ErrorMessage, :ResultFile3Ds, :RequestId
+
+        def initialize(status=nil, errorcode=nil, errormessage=nil, resultfile3ds=nil, requestid=nil)
+          @Status = status
+          @ErrorCode = errorcode
+          @ErrorMessage = errormessage
+          @ResultFile3Ds = resultfile3ds
+          @RequestId = requestid
+        end
+
+        def deserialize(params)
+          @Status = params['Status']
+          @ErrorCode = params['ErrorCode']
+          @ErrorMessage = params['ErrorMessage']
+          unless params['ResultFile3Ds'].nil?
+            @ResultFile3Ds = []
+            params['ResultFile3Ds'].each do |i|
+              file3d_tmp = File3D.new
+              file3d_tmp.deserialize(i)
+              @ResultFile3Ds << file3d_tmp
+            end
+          end
+          @RequestId = params['RequestId']
+        end
+      end
+
+      # SubmitHunyuanTo3DJob请求参数结构体
+      class SubmitHunyuanTo3DJobRequest < TencentCloud::Common::AbstractModel
+        # @param Prompt: 文生3D，3D内容的描述，中文正向提示词。
+        # 最多支持200个 utf-8 字符。
+        # 文生3D, image、image_url和 prompt必填其一，且prompt和image/image_url不能同时存在。
+        # @type Prompt: String
+        # @param ImageBase64: 输入图 Base64 数据。
+        # 大小：单边分辨率要求不小于128，不大于5000。大小不超过8m（base64编码后会大30%左右，建议实际输入图片不超过6m）
+        # 格式：jpg，png，jpeg，webp。
+        # ImageBase64、ImageUrl和 Prompt必填其一，且Prompt和ImageBase64/ImageUrl不能同时存在。
+        # @type ImageBase64: String
+        # @param ImageUrl: 输入图Url。
+        # 大小：单边分辨率要求不小于128，不大于5000。大小不超过8m（base64编码后会大30%左右，建议实际输入图片不超过6m）
+        # 格式：jpg，png，jpeg，webp。
+        # ImageBase64/ImageUrl和 Prompt必填其一，且Prompt和ImageBase64/ImageUrl不能同时存在。
+        # @type ImageUrl: String
+        # @param MultiViewImages: 多视角的模型图片，视角参考值：
+        # left：左视图；
+        # right：右视图；
+        # back：后视图；
+
+        # 每个视角仅限制一张图片。
+        # ●图片大小限制：编码后大小不可超过8M。
+        # ●图片分辨率限制：单边分辨率小于5000且大于128。
+        # ●支持图片格式：支持jpg或png
+        # @type MultiViewImages: Array
+        # @param ResultFormat: 生成模型的格式，仅限制生成一种格式。
+        # 生成模型文件组默认返回obj格式。
+        # 可选值：OBJ，GLB，STL，USDZ，FBX，MP4。
+        # @type ResultFormat: String
+        # @param EnablePBR: 是否开启 PBR材质生成，默认 false。
+        # @type EnablePBR: Boolean
+
+        attr_accessor :Prompt, :ImageBase64, :ImageUrl, :MultiViewImages, :ResultFormat, :EnablePBR
+
+        def initialize(prompt=nil, imagebase64=nil, imageurl=nil, multiviewimages=nil, resultformat=nil, enablepbr=nil)
+          @Prompt = prompt
+          @ImageBase64 = imagebase64
+          @ImageUrl = imageurl
+          @MultiViewImages = multiviewimages
+          @ResultFormat = resultformat
+          @EnablePBR = enablepbr
+        end
+
+        def deserialize(params)
+          @Prompt = params['Prompt']
+          @ImageBase64 = params['ImageBase64']
+          @ImageUrl = params['ImageUrl']
+          unless params['MultiViewImages'].nil?
+            @MultiViewImages = []
+            params['MultiViewImages'].each do |i|
+              viewimage_tmp = ViewImage.new
+              viewimage_tmp.deserialize(i)
+              @MultiViewImages << viewimage_tmp
+            end
+          end
+          @ResultFormat = params['ResultFormat']
+          @EnablePBR = params['EnablePBR']
+        end
+      end
+
+      # SubmitHunyuanTo3DJob返回参数结构体
+      class SubmitHunyuanTo3DJobResponse < TencentCloud::Common::AbstractModel
+        # @param JobId: 任务ID（有效期24小时）
+        # @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
+
+      # 多视角图片
+      class ViewImage < TencentCloud::Common::AbstractModel
+        # @param ViewType: 视角类型。
+        # 取值：back、left、right
+        # @type ViewType: String
+        # @param ViewImageUrl: 图片Url地址
+        # @type ViewImageUrl: String
+
+        attr_accessor :ViewType, :ViewImageUrl
+
+        def initialize(viewtype=nil, viewimageurl=nil)
+          @ViewType = viewtype
+          @ViewImageUrl = viewimageurl
+        end
+
+        def deserialize(params)
+          @ViewType = params['ViewType']
+          @ViewImageUrl = params['ViewImageUrl']
+        end
+      end
+
+    end
+  end
+end
+

metadata

@@ -0,0 +1,66 @@
+--- !ruby/object:Gem::Specification
+name: tencentcloud-sdk-ai3d
+version: !ruby/object:Gem::Version
+  version: 3.0.1096
+platform: ruby
+authors:
+- Tencent Cloud
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2025-07-07 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
+  AI3D.
+email:
+- tencentcloudapi@tencent.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- lib/tencentcloud-sdk-ai3d.rb
+- lib/v20250513/client.rb
+- lib/v20250513/models.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-ai3d
+  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 - AI3D
+test_files: []