tencentcloud-sdk-nodejs-ai3d 4.1.79 → 4.1.117

package/es/services/ai3d/v20250513/ai3d_client.js

@@ -3,10 +3,22 @@ export class Client extends TencentCloudCommon.AbstractClient {
     constructor(clientConfig) {
         super("ai3d.tencentcloudapi.com", "2025-05-13", clientConfig);
     }
+    async QueryHunyuanTo3DJob(req, cb) {
+        return this.request("QueryHunyuanTo3DJob", req, cb);
+    }
+    async SubmitHunyuanTo3DProJob(req, cb) {
+        return this.request("SubmitHunyuanTo3DProJob", req, cb);
+    }
+    async QueryHunyuanTo3DRapidJob(req, cb) {
+        return this.request("QueryHunyuanTo3DRapidJob", req, cb);
+    }
     async SubmitHunyuanTo3DJob(req, cb) {
         return this.request("SubmitHunyuanTo3DJob", req, cb);
     }
-    async QueryHunyuanTo3DJob(req, cb) {
-        return this.request("QueryHunyuanTo3DJob", req, cb);
+    async QueryHunyuanTo3DProJob(req, cb) {
+        return this.request("QueryHunyuanTo3DProJob", req, cb);
+    }
+    async SubmitHunyuanTo3DRapidJob(req, cb) {
+        return this.request("SubmitHunyuanTo3DRapidJob", req, cb);
     }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tencentcloud-sdk-nodejs-ai3d",
-  "version": "4.1.79",
+  "version": "4.1.117",
   "description": "腾讯云 API NODEJS SDK",
   "main": "./tencentcloud/index.js",
   "module": "./es/index.js",

package/tencentcloud/services/ai3d/v20250513/ai3d_client.d.ts

@@ -1,5 +1,5 @@
 import * as TencentCloudCommon from "tencentcloud-sdk-nodejs-common";
-import { QueryHunyuanTo3DJobRequest, SubmitHunyuanTo3DJobResponse, QueryHunyuanTo3DJobResponse, SubmitHunyuanTo3DJobRequest } from "./ai3d_models";
+import { SubmitHunyuanTo3DRapidJobResponse, SubmitHunyuanTo3DRapidJobRequest, SubmitHunyuanTo3DProJobResponse, SubmitHunyuanTo3DJobResponse, QueryHunyuanTo3DJobRequest, SubmitHunyuanTo3DProJobRequest, QueryHunyuanTo3DProJobRequest, QueryHunyuanTo3DRapidJobResponse, QueryHunyuanTo3DProJobResponse, SubmitHunyuanTo3DJobRequest, QueryHunyuanTo3DRapidJobRequest, QueryHunyuanTo3DJobResponse } from "./ai3d_models";
 /**
  * ai3d client
  * @class
@@ -8,6 +8,21 @@ export declare class Client extends TencentCloudCommon.AbstractClient {
     constructor(clientConfig: TencentCloudCommon.ClientConfig);
     /**
        * 混元生3D接口，基于混元大模型，根据输入的文本描述/图片智能生成3D。
+  默认提供1个并发，代表最多能同时处理1个已提交的任务，上一个任务处理完毕后，才能开始处理下一个任务。
+       */
+    QueryHunyuanTo3DJob(req: QueryHunyuanTo3DJobRequest, cb?: (error: string, rep: QueryHunyuanTo3DJobResponse) => void): Promise<QueryHunyuanTo3DJobResponse>;
+    /**
+       * 混元生3D接口，基于混元大模型，根据输入的文本描述/图片智能生成3D。
+  默认提供1个并发，代表最多能同时处理1个已提交的任务，上一个任务处理完毕后，才能开始处理下一个任务。
+       */
+    SubmitHunyuanTo3DProJob(req: SubmitHunyuanTo3DProJobRequest, cb?: (error: string, rep: SubmitHunyuanTo3DProJobResponse) => void): Promise<SubmitHunyuanTo3DProJobResponse>;
+    /**
+       * 混元生3D接口，基于混元大模型，根据输入的文本描述/图片智能生成3D。
+  默认提供1个并发，代表最多能同时处理1个已提交的任务，上一个任务处理完毕后，才能开始处理下一个任务。
+       */
+    QueryHunyuanTo3DRapidJob(req: QueryHunyuanTo3DRapidJobRequest, cb?: (error: string, rep: QueryHunyuanTo3DRapidJobResponse) => void): Promise<QueryHunyuanTo3DRapidJobResponse>;
+    /**
+       * 混元生3D接口，基于混元大模型，根据输入的文本描述/图片智能生成3D。
   默认提供1个并发，代表最多能同时处理1个已提交的任务，上一个任务处理完毕后，才能开始处理下一个任务。
        */
     SubmitHunyuanTo3DJob(req: SubmitHunyuanTo3DJobRequest, cb?: (error: string, rep: SubmitHunyuanTo3DJobResponse) => void): Promise<SubmitHunyuanTo3DJobResponse>;
@@ -15,5 +30,10 @@ export declare class Client extends TencentCloudCommon.AbstractClient {
        * 混元生3D接口，基于混元大模型，根据输入的文本描述/图片智能生成3D。
   默认提供1个并发，代表最多能同时处理1个已提交的任务，上一个任务处理完毕后，才能开始处理下一个任务。
        */
-    QueryHunyuanTo3DJob(req: QueryHunyuanTo3DJobRequest, cb?: (error: string, rep: QueryHunyuanTo3DJobResponse) => void): Promise<QueryHunyuanTo3DJobResponse>;
+    QueryHunyuanTo3DProJob(req: QueryHunyuanTo3DProJobRequest, cb?: (error: string, rep: QueryHunyuanTo3DProJobResponse) => void): Promise<QueryHunyuanTo3DProJobResponse>;
+    /**
+       * 混元生3D接口，基于混元大模型，根据输入的文本描述/图片智能生成3D。
+  默认提供1个并发，代表最多能同时处理1个已提交的任务，上一个任务处理完毕后，才能开始处理下一个任务。
+       */
+    SubmitHunyuanTo3DRapidJob(req: SubmitHunyuanTo3DRapidJobRequest, cb?: (error: string, rep: SubmitHunyuanTo3DRapidJobResponse) => void): Promise<SubmitHunyuanTo3DRapidJobResponse>;
 }

package/tencentcloud/services/ai3d/v20250513/ai3d_client.js

@@ -30,6 +30,27 @@ class Client extends TencentCloudCommon.AbstractClient {
     }
     /**
        * 混元生3D接口，基于混元大模型，根据输入的文本描述/图片智能生成3D。
+  默认提供1个并发，代表最多能同时处理1个已提交的任务，上一个任务处理完毕后，才能开始处理下一个任务。
+       */
+    async QueryHunyuanTo3DJob(req, cb) {
+        return this.request("QueryHunyuanTo3DJob", req, cb);
+    }
+    /**
+       * 混元生3D接口，基于混元大模型，根据输入的文本描述/图片智能生成3D。
+  默认提供1个并发，代表最多能同时处理1个已提交的任务，上一个任务处理完毕后，才能开始处理下一个任务。
+       */
+    async SubmitHunyuanTo3DProJob(req, cb) {
+        return this.request("SubmitHunyuanTo3DProJob", req, cb);
+    }
+    /**
+       * 混元生3D接口，基于混元大模型，根据输入的文本描述/图片智能生成3D。
+  默认提供1个并发，代表最多能同时处理1个已提交的任务，上一个任务处理完毕后，才能开始处理下一个任务。
+       */
+    async QueryHunyuanTo3DRapidJob(req, cb) {
+        return this.request("QueryHunyuanTo3DRapidJob", req, cb);
+    }
+    /**
+       * 混元生3D接口，基于混元大模型，根据输入的文本描述/图片智能生成3D。
   默认提供1个并发，代表最多能同时处理1个已提交的任务，上一个任务处理完毕后，才能开始处理下一个任务。
        */
     async SubmitHunyuanTo3DJob(req, cb) {
@@ -39,8 +60,15 @@ class Client extends TencentCloudCommon.AbstractClient {
        * 混元生3D接口，基于混元大模型，根据输入的文本描述/图片智能生成3D。
   默认提供1个并发，代表最多能同时处理1个已提交的任务，上一个任务处理完毕后，才能开始处理下一个任务。
        */
-    async QueryHunyuanTo3DJob(req, cb) {
-        return this.request("QueryHunyuanTo3DJob", req, cb);
+    async QueryHunyuanTo3DProJob(req, cb) {
+        return this.request("QueryHunyuanTo3DProJob", req, cb);
+    }
+    /**
+       * 混元生3D接口，基于混元大模型，根据输入的文本描述/图片智能生成3D。
+  默认提供1个并发，代表最多能同时处理1个已提交的任务，上一个任务处理完毕后，才能开始处理下一个任务。
+       */
+    async SubmitHunyuanTo3DRapidJob(req, cb) {
+        return this.request("SubmitHunyuanTo3DRapidJob", req, cb);
     }
 }
 exports.Client = Client;

package/tencentcloud/services/ai3d/v20250513/ai3d_models.d.ts

@@ -1,25 +1,63 @@
 /**
- * QueryHunyuanTo3DJob请求参数结构体
+ * SubmitHunyuanTo3DRapidJob返回参数结构体
  */
-export interface QueryHunyuanTo3DJobRequest {
+export interface SubmitHunyuanTo3DRapidJobResponse {
     /**
-     * 任务ID。
+     * 任务ID（有效期24小时）
      */
     JobId?: string;
+    /**
+     * 唯一请求 ID，由服务端生成，每次请求都会返回（若请求因其他原因未能抵达服务端，则该次请求不会获得 RequestId）。定位问题时需要提供该次请求的 RequestId。
+     */
+    RequestId?: string;
 }
 /**
- * 多视角图片
+ * SubmitHunyuanTo3DRapidJob请求参数结构体
  */
-export interface ViewImage {
+export interface SubmitHunyuanTo3DRapidJobRequest {
     /**
-     * 视角类型。
-  取值：back、left、right
+     * 文生3D，3D内容的描述，中文正向提示词。
+  最多支持200个 utf-8 字符。
+  文生3D, image、image_url和 prompt必填其一，且prompt和image/image_url不能同时存在。
      */
-    ViewType?: string;
+    Prompt?: string;
     /**
-     * 图片Url地址
+     * 输入图 Base64 数据。
+  大小：单边分辨率要求不小于128，不大于5000。大小不超过8m（base64编码后会大30%左右，建议实际输入图片不超过6m）
+  格式：jpg，png，jpeg，webp。
+  ImageBase64、ImageUrl和 Prompt必填其一，且Prompt和ImageBase64/ImageUrl不能同时存在。
      */
-    ViewImageUrl?: string;
+    ImageBase64?: string;
+    /**
+     * 输入图Url。
+  大小：单边分辨率要求不小于128，不大于5000。大小不超过8m（base64编码后会大30%左右，建议实际输入图片不超过6m）
+  格式：jpg，png，jpeg，webp。
+  ImageBase64/ImageUrl和 Prompt必填其一，且Prompt和ImageBase64/ImageUrl不能同时存在。
+     */
+    ImageUrl?: string;
+    /**
+     * 生成模型的格式，仅限制生成一种格式。
+  生成模型文件组默认返回obj格式。
+  可选值：OBJ，GLB，STL，USDZ，FBX，MP4。
+     */
+    ResultFormat?: string;
+    /**
+     * 是否开启 PBR材质生成，默认 false。
+     */
+    EnablePBR?: boolean;
+}
+/**
+ * SubmitHunyuanTo3DProJob返回参数结构体
+ */
+export interface SubmitHunyuanTo3DProJobResponse {
+    /**
+     * 任务ID（有效期24小时）
+     */
+    JobId?: string;
+    /**
+     * 唯一请求 ID，由服务端生成，每次请求都会返回（若请求因其他原因未能抵达服务端，则该次请求不会获得 RequestId）。定位问题时需要提供该次请求的 RequestId。
+     */
+    RequestId?: string;
 }
 /**
  * SubmitHunyuanTo3DJob返回参数结构体
@@ -34,6 +72,78 @@ export interface SubmitHunyuanTo3DJobResponse {
      */
     RequestId?: string;
 }
+/**
+ * QueryHunyuanTo3DJob请求参数结构体
+ */
+export interface QueryHunyuanTo3DJobRequest {
+    /**
+     * 任务ID。
+     */
+    JobId?: string;
+}
+/**
+ * SubmitHunyuanTo3DProJob请求参数结构体
+ */
+export interface SubmitHunyuanTo3DProJobRequest {
+    /**
+     * 文生3D，3D内容的描述，中文正向提示词。
+  最多支持1024个 utf-8 字符。
+  文生3D, image、image_url和 prompt必填其一，且prompt和image/image_url不能同时存在。
+     */
+    Prompt?: string;
+    /**
+     * 输入图 Base64 数据。
+  大小：单边分辨率要求不小于128，不大于5000。大小不超过8m（base64编码后会大30%左右，建议实际输入图片不超过6m）
+  格式：jpg，png，jpeg，webp。
+  ImageBase64、ImageUrl和 Prompt必填其一，且Prompt和ImageBase64/ImageUrl不能同时存在。
+     */
+    ImageBase64?: string;
+    /**
+     * 输入图Url。
+  大小：单边分辨率要求不小于128，不大于5000。大小不超过8m（base64编码后会大30%左右，建议实际输入图片不超过6m）
+  格式：jpg，png，jpeg，webp。
+  ImageBase64/ImageUrl和 Prompt必填其一，且Prompt和ImageBase64/ImageUrl不能同时存在。
+     */
+    ImageUrl?: string;
+    /**
+     * 多视角的模型图片，视角参考值：
+  left：左视图；
+  right：右视图；
+  back：后视图；
+  
+  每个视角仅限制一张图片。
+  ●图片大小限制：编码后大小不可超过8M。
+  ●图片分辨率限制：单边分辨率小于5000且大于128。
+  ●支持图片格式：支持jpg或png
+     */
+    MultiViewImages?: Array<ViewImage>;
+    /**
+     * 是否开启 PBR材质生成，默认 false。
+     */
+    EnablePBR?: boolean;
+    /**
+     * 生成3D模型的面数，默认值为500000。
+  可支持生成面数范围，参考值：40000-500000。
+     */
+    FaceCount?: number;
+    /**
+     * 生成任务类型，默认Normal，参考值：
+  Normal：可生成带纹理的几何模型。
+  LowPoly：可生成智能减面后的模型。
+  Geometry：可生成不带纹理的几何模型（白模），选择此任务时，EnablePBR参数不生效。
+  Sketch：可输入草图或线稿图生成模型。
+     */
+    GenerateType?: string;
+}
+/**
+ * QueryHunyuanTo3DProJob请求参数结构体
+ */
+export interface QueryHunyuanTo3DProJobRequest {
+    /**
+     * 任务ID。
+     */
+    JobId: string;
+}
 /**
  * 3D文件
  */
@@ -52,9 +162,48 @@ export interface File3D {
     PreviewImageUrl?: string;
 }
 /**
- * QueryHunyuanTo3DJob返回参数结构体
+ * QueryHunyuanTo3DRapidJob返回参数结构体
  */
-export interface QueryHunyuanTo3DJobResponse {
+export interface QueryHunyuanTo3DRapidJobResponse {
+    /**
+     * 任务状态。WAIT：等待中，RUN：执行中，FAIL：任务失败，DONE：任务成功
+     */
+    Status?: string;
+    /**
+     * 错误码
+     */
+    ErrorCode?: string;
+    /**
+     * 错误信息
+     */
+    ErrorMessage?: string;
+    /**
+     * 生成的3D文件数组。
+     */
+    ResultFile3Ds?: Array<File3D>;
+    /**
+     * 唯一请求 ID，由服务端生成，每次请求都会返回（若请求因其他原因未能抵达服务端，则该次请求不会获得 RequestId）。定位问题时需要提供该次请求的 RequestId。
+     */
+    RequestId?: string;
+}
+/**
+ * 多视角图片
+ */
+export interface ViewImage {
+    /**
+     * 视角类型。
+  取值：back、left、right
+     */
+    ViewType?: string;
+    /**
+     * 图片Url地址
+     */
+    ViewImageUrl?: string;
+}
+/**
+ * QueryHunyuanTo3DProJob返回参数结构体
+ */
+export interface QueryHunyuanTo3DProJobResponse {
     /**
      * 任务状态。WAIT：等待中，RUN：执行中，FAIL：任务失败，DONE：任务成功
      */
@@ -123,3 +272,37 @@ export interface SubmitHunyuanTo3DJobRequest {
      */
     EnablePBR?: boolean;
 }
+/**
+ * QueryHunyuanTo3DRapidJob请求参数结构体
+ */
+export interface QueryHunyuanTo3DRapidJobRequest {
+    /**
+     * 任务ID。
+     */
+    JobId?: string;
+}
+/**
+ * QueryHunyuanTo3DJob返回参数结构体
+ */
+export interface QueryHunyuanTo3DJobResponse {
+    /**
+     * 任务状态。WAIT：等待中，RUN：执行中，FAIL：任务失败，DONE：任务成功
+     */
+    Status?: string;
+    /**
+     * 错误码
+     */
+    ErrorCode?: string;
+    /**
+     * 错误信息
+     */
+    ErrorMessage?: string;
+    /**
+     * 生成的3D文件数组。
+     */
+    ResultFile3Ds?: Array<File3D>;
+    /**
+     * 唯一请求 ID，由服务端生成，每次请求都会返回（若请求因其他原因未能抵达服务端，则该次请求不会获得 RequestId）。定位问题时需要提供该次请求的 RequestId。
+     */
+    RequestId?: string;
+}