tencentcloud-sdk-nodejs-aiart 4.1.79 → 4.1.137

package/README.md

@@ -62,6 +62,8 @@ npm install tencentcloud-sdk-slim-nodejs --save
 
 1. clone 代码到本地：
 ```
+git clone https://cnb.cool/tencent/cloud/api/sdk/tencentcloud-sdk-nodejs
+# 或者
 git clone https://github.com/tencentcloud/tencentcloud-sdk-nodejs
 # 或者
 git clone https://gitee.com/tencentcloud/tencentcloud-sdk-nodejs
@@ -135,7 +137,7 @@ const CvmClient = tencentcloud.cvm.v20170312.Client
 // ...
 ```
 
-实例化 `Client` 的入参支持 `clientConfig`，数据结构和说明详见 [ClientConfig](https://github.com/TencentCloud/tencentcloud-sdk-nodejs/blob/master/src/common/interface.ts)。
+实例化 `Client` 的入参支持 `clientConfig`，数据结构和说明详见 [ClientConfig](src/common/interface.ts)。
 
 ## Common Client
 
@@ -143,17 +145,17 @@ const CvmClient = tencentcloud.cvm.v20170312.Client
 
 **注意，您必须明确知道您调用的接口所需参数，否则可能会调用失败。**
 
-详细使用请参阅示例：[使用 Common Client 进行调用](https://github.com/TencentCloud/tencentcloud-sdk-nodejs/tree/master/examples/common)
+详细使用请参阅示例：[使用 Common Client 进行调用](examples/common)
 
 ## 更多示例
 
-请参考 [examples](https://github.com/TencentCloud/tencentcloud-sdk-nodejs/tree/master/examples) 目录。
+请参考 [examples](examples) 目录。
 
 # 相关配置
 
 ## 代理
 
-如果是有代理的环境下，需要配置代理，请在创建 Client 时传入 [profile.httpProfile.proxy](https://github.com/TencentCloud/tencentcloud-sdk-nodejs/blob/master/src/common/interface.ts#L78) 参数，或设置系统环境变量 `http_proxy` ，否则可能无法正常调用，抛出连接超时的异常。
+如果是有代理的环境下，需要配置代理，请在创建 Client 时传入 [profile.httpProfile.proxy](src/common/interface.ts#L78) 参数，或设置系统环境变量 `http_proxy` ，否则可能无法正常调用，抛出连接超时的异常。
 
 # 凭证管理
 

package/es/services/aiart/v20221229/aiart_client.js

@@ -9,9 +9,6 @@ export class Client extends TencentCloudCommon.AbstractClient {
     async SubmitTrainPortraitModelJob(req, cb) {
         return this.request("SubmitTrainPortraitModelJob", req, cb);
     }
-    async TextToImage(req, cb) {
-        return this.request("TextToImage", req, cb);
-    }
     async SubmitDrawPortraitJob(req, cb) {
         return this.request("SubmitDrawPortraitJob", req, cb);
     }
@@ -27,6 +24,9 @@ export class Client extends TencentCloudCommon.AbstractClient {
     async GenerateAvatar(req, cb) {
         return this.request("GenerateAvatar", req, cb);
     }
+    async QueryTextToImageJob(req, cb) {
+        return this.request("QueryTextToImageJob", req, cb);
+    }
     async SubmitMemeJob(req, cb) {
         return this.request("SubmitMemeJob", req, cb);
     }
@@ -54,6 +54,9 @@ export class Client extends TencentCloudCommon.AbstractClient {
     async SubmitTextToImageProJob(req, cb) {
         return this.request("SubmitTextToImageProJob", req, cb);
     }
+    async SubmitTextToImageJob(req, cb) {
+        return this.request("SubmitTextToImageJob", req, cb);
+    }
     async UploadTrainPortraitImages(req, cb) {
         return this.request("UploadTrainPortraitImages", req, cb);
     }

package/es/services/aiart/v20221229/aiart_models.js

@@ -0,0 +1 @@
+export {};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tencentcloud-sdk-nodejs-aiart",
-  "version": "4.1.79",
+  "version": "4.1.137",
   "description": "腾讯云 API NODEJS SDK",
   "main": "./tencentcloud/index.js",
   "module": "./es/index.js",
@@ -12,7 +12,8 @@
     "build:es": "tsc -p tsconfig.es.json",
     "build:slim": "node ./scripts/build_slim.js",
     "prettier": "prettier --config prettier.config.js --write 'src/**/*.{tsx,ts,jsx,js,css,json,vue}'",
-    "clean": "rimraf tencentcloud es"
+    "clean": "rimraf tencentcloud es",
+    "test:common": "vitest run"
   },
   "engines": {
     "node": ">=10"
@@ -44,9 +45,9 @@
     "url": "https://github.com/tencentcloud/tencentcloud-sdk-nodejs"
   },
   "devDependencies": {
-    "@types/form-data": "^2.5.0",
+    "@types/ini": "^4.1.1",
     "@types/json-bigint": "^1.0.1",
-    "@types/node": "^14.0.26",
+    "@types/node": "^18.0.0",
     "@types/node-fetch": "^2.5.7",
     "@types/uuid": "^9.0.8",
     "@typescript-eslint/eslint-plugin": "^2.34.0",
@@ -61,6 +62,7 @@
     "prettier": "^2.3.0",
     "rimraf": "^5.0.10",
     "ts-node": "^8.10.2",
-    "typescript": "^3.9.7"
+    "typescript": "^5.9.2",
+    "vitest": "2.1.9"
   }
 }

package/tencentcloud/services/aiart/v20221229/aiart_client.d.ts

@@ -1,5 +1,5 @@
 import * as TencentCloudCommon from "tencentcloud-sdk-nodejs-common";
-import { SubmitDrawPortraitJobResponse, RefineImageRequest, ImageToImageRequest, QueryTrainPortraitModelJobRequest, GenerateAvatarRequest, UploadTrainPortraitImagesResponse, UploadTrainPortraitImagesRequest, QueryMemeJobRequest, QueryGlamPicJobResponse, ImageOutpaintingRequest, ReplaceBackgroundResponse, QueryMemeJobResponse, QueryDrawPortraitJobResponse, QueryTrainPortraitModelJobResponse, ChangeClothesResponse, SubmitGlamPicJobResponse, SubmitMemeJobResponse, SubmitTrainPortraitModelJobRequest, SketchToImageRequest, TextToImageRequest, SubmitTextToImageProJobResponse, SubmitGlamPicJobRequest, QueryTextToImageProJobResponse, TextToImageLiteRequest, TextToImageRapidResponse, ImageInpaintingRemovalResponse, SubmitMemeJobRequest, ReplaceBackgroundRequest, SubmitTextToImageProJobRequest, SubmitTrainPortraitModelJobResponse, QueryDrawPortraitJobRequest, ImageToImageResponse, TextToImageRapidRequest, QueryGlamPicJobRequest, ImageInpaintingRemovalRequest, ChangeClothesRequest, ImageOutpaintingResponse, TextToImageLiteResponse, QueryTextToImageProJobRequest, GenerateAvatarResponse, RefineImageResponse, TextToImageResponse, SketchToImageResponse, SubmitDrawPortraitJobRequest } from "./aiart_models";
+import { SubmitDrawPortraitJobResponse, RefineImageRequest, QueryTextToImageJobResponse, ImageToImageRequest, QueryTrainPortraitModelJobRequest, GenerateAvatarRequest, UploadTrainPortraitImagesResponse, UploadTrainPortraitImagesRequest, QueryMemeJobRequest, QueryGlamPicJobResponse, ImageOutpaintingRequest, ReplaceBackgroundResponse, QueryMemeJobResponse, QueryDrawPortraitJobResponse, QueryTrainPortraitModelJobResponse, ChangeClothesResponse, SubmitTextToImageJobRequest, SubmitGlamPicJobResponse, SubmitMemeJobResponse, SubmitTrainPortraitModelJobRequest, SketchToImageRequest, SubmitTextToImageProJobResponse, SubmitGlamPicJobRequest, QueryTextToImageProJobResponse, TextToImageLiteRequest, TextToImageRapidResponse, SubmitTextToImageJobResponse, ImageInpaintingRemovalResponse, SubmitMemeJobRequest, QueryTextToImageJobRequest, ReplaceBackgroundRequest, SubmitTextToImageProJobRequest, SubmitTrainPortraitModelJobResponse, QueryDrawPortraitJobRequest, ImageToImageResponse, TextToImageRapidRequest, QueryGlamPicJobRequest, ImageInpaintingRemovalRequest, ChangeClothesRequest, ImageOutpaintingResponse, TextToImageLiteResponse, QueryTextToImageProJobRequest, GenerateAvatarResponse, RefineImageResponse, SketchToImageResponse, SubmitDrawPortraitJobRequest } from "./aiart_models";
 /**
  * aiart client
  * @class
@@ -23,14 +23,6 @@ export declare class Client extends TencentCloudCommon.AbstractClient {
   提交训练写真模型任务按并发计费，无默认并发额度。
        */
     SubmitTrainPortraitModelJob(req: SubmitTrainPortraitModelJobRequest, cb?: (error: string, rep: SubmitTrainPortraitModelJobResponse) => void): Promise<SubmitTrainPortraitModelJobResponse>;
-    /**
-       * **本接口已迁移至腾讯混元大模型-文生图轻量版，即将停止此处维护，可切换至 [文生图轻量版 API](https://cloud.tencent.com/document/product/1729/108738) 继续使用。**
-  
-  智能文生图接口基于文生图（标准版）模型，将根据输入的文本描述，智能生成与之相关的结果图。
-  
-  智能文生图默认提供3个并发任务数，代表最多能同时处理3个已提交的任务，上一个任务处理完毕后才能开始处理下一个任务。
-       */
-    TextToImage(req: TextToImageRequest, cb?: (error: string, rep: TextToImageResponse) => void): Promise<TextToImageResponse>;
     /**
        * AI 写真分为上传训练图片、训练写真模型（可选跳过）、生成写真图片3个环节，需要依次调用对应接口。
   生成图片分为提交任务和查询任务2个接口：
@@ -62,6 +54,11 @@ export declare class Client extends TencentCloudCommon.AbstractClient {
   百变头像默认提供1个并发任务数，代表最多能同时处理1个已提交的任务，上一个任务处理完毕后才能开始处理下一个任务。
        */
     GenerateAvatar(req: GenerateAvatarRequest, cb?: (error: string, rep: GenerateAvatarResponse) => void): Promise<GenerateAvatarResponse>;
+    /**
+       * 混元生图接口，基于混元大模型，根据输入的文本描述快速生成图片。
+  默认提供0个并发，代表最多能同时处理1个已提交的任务，上一个任务处理完毕后，才能开始处理下一个任务。
+       */
+    QueryTextToImageJob(req: QueryTextToImageJobRequest, cb?: (error: string, rep: QueryTextToImageJobResponse) => void): Promise<QueryTextToImageJobResponse>;
     /**
        * 表情动图生成接口将静态照片制作成动态的表情包。分为提交任务和查询任务2个接口。
   
@@ -129,6 +126,11 @@ export declare class Client extends TencentCloudCommon.AbstractClient {
   并发任务数（并发）说明：并发任务数指能同时处理的任务数量。文生图（高级版）默认提供1个并发任务数，代表最多能同时处理1个已提交的任务，上一个任务处理完毕后才能开始处理下一个任务。
        */
     SubmitTextToImageProJob(req: SubmitTextToImageProJobRequest, cb?: (error: string, rep: SubmitTextToImageProJobResponse) => void): Promise<SubmitTextToImageProJobResponse>;
+    /**
+       * 混元生图接口，基于混元大模型，根据输入的文本描述快速生成图片。
+  默认提供1个并发，代表最多能同时处理1个已提交的任务，上一个任务处理完毕后，才能开始处理下一个任务。
+       */
+    SubmitTextToImageJob(req: SubmitTextToImageJobRequest, cb?: (error: string, rep: SubmitTextToImageJobResponse) => void): Promise<SubmitTextToImageJobResponse>;
     /**
        * AI 写真分为上传训练图片、训练写真模型（可选跳过）、生成写真图片3个环节，需要依次调用对应接口。
   本接口用于上传人像图片并指定对应的写真模型 ID。上传的图片要求是同一个人，建议上传单人、正脸、脸部区域占比较大、脸部清晰无遮挡、无大角度偏转、无夸张表情的图片。

package/tencentcloud/services/aiart/v20221229/aiart_client.js

@@ -49,16 +49,6 @@ class Client extends TencentCloudCommon.AbstractClient {
     async SubmitTrainPortraitModelJob(req, cb) {
         return this.request("SubmitTrainPortraitModelJob", req, cb);
     }
-    /**
-       * **本接口已迁移至腾讯混元大模型-文生图轻量版，即将停止此处维护，可切换至 [文生图轻量版 API](https://cloud.tencent.com/document/product/1729/108738) 继续使用。**
-  
-  智能文生图接口基于文生图（标准版）模型，将根据输入的文本描述，智能生成与之相关的结果图。
-  
-  智能文生图默认提供3个并发任务数，代表最多能同时处理3个已提交的任务，上一个任务处理完毕后才能开始处理下一个任务。
-       */
-    async TextToImage(req, cb) {
-        return this.request("TextToImage", req, cb);
-    }
     /**
        * AI 写真分为上传训练图片、训练写真模型（可选跳过）、生成写真图片3个环节，需要依次调用对应接口。
   生成图片分为提交任务和查询任务2个接口：
@@ -100,6 +90,13 @@ class Client extends TencentCloudCommon.AbstractClient {
     async GenerateAvatar(req, cb) {
         return this.request("GenerateAvatar", req, cb);
     }
+    /**
+       * 混元生图接口，基于混元大模型，根据输入的文本描述快速生成图片。
+  默认提供0个并发，代表最多能同时处理1个已提交的任务，上一个任务处理完毕后，才能开始处理下一个任务。
+       */
+    async QueryTextToImageJob(req, cb) {
+        return this.request("QueryTextToImageJob", req, cb);
+    }
     /**
        * 表情动图生成接口将静态照片制作成动态的表情包。分为提交任务和查询任务2个接口。
   
@@ -185,6 +182,13 @@ class Client extends TencentCloudCommon.AbstractClient {
     async SubmitTextToImageProJob(req, cb) {
         return this.request("SubmitTextToImageProJob", req, cb);
     }
+    /**
+       * 混元生图接口，基于混元大模型，根据输入的文本描述快速生成图片。
+  默认提供1个并发，代表最多能同时处理1个已提交的任务，上一个任务处理完毕后，才能开始处理下一个任务。
+       */
+    async SubmitTextToImageJob(req, cb) {
+        return this.request("SubmitTextToImageJob", req, cb);
+    }
     /**
        * AI 写真分为上传训练图片、训练写真模型（可选跳过）、生成写真图片3个环节，需要依次调用对应接口。
   本接口用于上传人像图片并指定对应的写真模型 ID。上传的图片要求是同一个人，建议上传单人、正脸、脸部区域占比较大、脸部清晰无遮挡、无大角度偏转、无夸张表情的图片。

package/tencentcloud/services/aiart/v20221229/aiart_models.d.ts

@@ -33,6 +33,49 @@ export interface RefineImageRequest {
      */
     RspImgType?: string;
 }
+/**
+ * QueryTextToImageJob返回参数结构体
+ */
+export interface QueryTextToImageJobResponse {
+    /**
+     * 当前任务状态码：
+  1：等待中、2：运行中、4：处理失败、5：处理完成。
+     */
+    JobStatusCode?: string;
+    /**
+     * 当前任务状态：排队中、处理中、处理失败或者处理完成。
+  
+     */
+    JobStatusMsg?: string;
+    /**
+     * 任务处理失败错误码。
+  
+     */
+    JobErrorCode?: string;
+    /**
+     * 任务处理失败错误信息。
+  
+     */
+    JobErrorMsg?: string;
+    /**
+     * 生成图 URL 列表，有效期1小时，请及时保存。
+  
+     */
+    ResultImage?: Array<string>;
+    /**
+     * 结果 detail 数组，Success 代表成功。
+  
+     */
+    ResultDetails?: Array<string>;
+    /**
+     * 对应 SubmitTextToImageProJob 接口中 Revise 参数。开启扩写时，返回扩写后的 prompt 文本。 如果关闭扩写，将直接返回原始输入的 prompt。
+     */
+    RevisedPrompt?: Array<string>;
+    /**
+     * 唯一请求 ID，由服务端生成，每次请求都会返回（若请求因其他原因未能抵达服务端，则该次请求不会获得 RequestId）。定位问题时需要提供该次请求的 RequestId。
+     */
+    RequestId?: string;
+}
 /**
  * logo参数
  */
@@ -475,6 +518,48 @@ export interface ChangeClothesResponse {
      */
     RequestId?: string;
 }
+/**
+ * SubmitTextToImageJob请求参数结构体
+ */
+export interface SubmitTextToImageJobRequest {
+    /**
+     * 文本描述。
+  算法将根据输入的文本智能生成与之相关的图像。
+  不能为空，推荐使用中文。最多可传1024个 utf-8 字符。
+     */
+    Prompt: string;
+    /**
+     * 生成图分辨率，仅支持以下分辨率：
+  640:1408,704:1344,768:1280,832:1216,896:1152,960:1088,1024:1024,1088:960,1152:896,1216:832,1280:768,1344:704,1408:640
+     */
+    Resolution?: string;
+    /**
+     * 随机种子，默认随机。
+  不传：随机种子生成。
+  正数：固定种子生成。
+  扩写开启时固定种子不生效，将保持随机。
+     */
+    Seed?: number;
+    /**
+     * 为生成结果图添加显式水印标识的开关，默认为1。
+  1：添加。
+  0：不添加。
+  其他数值：默认按1处理。
+  建议您使用显著标识来提示结果图使用了 AI 绘画技术，是 AI 生成的图片。
+     */
+    LogoAdd?: number;
+    /**
+     * 标识内容设置。
+  默认在生成结果图右下角添加“图片由 AI 生成”字样，您可根据自身需要替换为其他的标识图片。
+     */
+    LogoParam?: LogoParam;
+    /**
+     * 是否开启prompt改写，默认开启，改写预计会增加20s左右耗时。
+  
+  如果关闭改写，需要调用方自己接改写，否则对生图效果有较大影响，改写方法可以参考：[改写](https://github.com/Tencent-Hunyuan/HunyuanImage-3.0/tree/main/PE)
+     */
+    Revise?: number;
+}
 /**
  * SubmitGlamPicJob返回参数结构体
  */
@@ -552,52 +637,6 @@ export interface SketchToImageRequest {
      */
     RspImgType?: string;
 }
-/**
- * TextToImage请求参数结构体
- */
-export interface TextToImageRequest {
-    /**
-     * 文本描述。
-  算法将根据输入的文本智能生成与之相关的图像。建议详细描述画面主体、细节、场景等，文本描述越丰富，生成效果越精美。
-  不能为空，推荐使用中文。最多可传256个 utf-8 字符。
-     */
-    Prompt: string;
-    /**
-     * 反向文本描述。
-  用于一定程度上从反面引导模型生成的走向，减少生成结果中出现描述内容的可能，但不能完全杜绝。
-  推荐使用中文。最多可传256个 utf-8 字符。
-     */
-    NegativePrompt?: string;
-    /**
-     * 绘画风格。
-  请在 [智能文生图风格列表](https://cloud.tencent.com/document/product/1668/86249) 中选择期望的风格，传入风格编号。
-  推荐使用且只使用一种风格。不传默认使用201（日系动漫风格）。
-     */
-    Styles?: Array<string>;
-    /**
-     * 生成图结果的配置，包括输出图片分辨率和尺寸等。
-  支持生成以下分辨率的图片：768:768（1:1）、768:1024（3:4）、1024:768（4:3）、1024:1024（1:1）、720:1280（9:16）、1280:720（16:9）、768:1280（3:5）、1280:768（5:3）、1080:1920（9:16）、1920:1080（16:9），不传默认使用768:768。
-  
-     */
-    ResultConfig?: ResultConfig;
-    /**
-     * 为生成结果图添加标识的开关，默认为1。
-  1：添加标识。
-  0：不添加标识。
-  其他数值：默认按1处理。
-  建议您使用显著标识来提示结果图使用了 AI 绘画技术，是 AI 生成的图片。
-     */
-    LogoAdd?: number;
-    /**
-     * 标识内容设置。
-  默认在生成结果图右下角添加“图片由 AI 生成”字样，您可根据自身需要替换为其他的标识图片。
-     */
-    LogoParam?: LogoParam;
-    /**
-     * 返回图像方式（base64 或 url) ，二选一，默认为 base64。url 有效期为1小时。
-     */
-    RspImgType?: string;
-}
 /**
  * 人脸框坐标
  */
@@ -861,6 +900,19 @@ export interface TextToImageRapidResponse {
      */
     RequestId?: string;
 }
+/**
+ * SubmitTextToImageJob返回参数结构体
+ */
+export interface SubmitTextToImageJobResponse {
+    /**
+     * 任务 ID。
+     */
+    JobId?: string;
+    /**
+     * 唯一请求 ID，由服务端生成，每次请求都会返回（若请求因其他原因未能抵达服务端，则该次请求不会获得 RequestId）。定位问题时需要提供该次请求的 RequestId。
+     */
+    RequestId?: string;
+}
 /**
  * ImageInpaintingRemoval返回参数结构体
  */
@@ -929,6 +981,15 @@ export interface SubmitMemeJobRequest {
      */
     LogoParam?: LogoParam;
 }
+/**
+ * QueryTextToImageJob请求参数结构体
+ */
+export interface QueryTextToImageJobRequest {
+    /**
+     * 任务 ID。
+     */
+    JobId: string;
+}
 /**
  * ReplaceBackground请求参数结构体
  */
@@ -1345,21 +1406,6 @@ export interface RefineImageResponse {
      */
     RequestId?: string;
 }
-/**
- * TextToImage返回参数结构体
- */
-export interface TextToImageResponse {
-    /**
-     * 根据入参 RspImgType 填入不同，返回不同的内容。
-  如果传入 base64 则返回生成图 Base64 编码。
-  如果传入 url 则返回的生成图 URL , 有效期1小时，请及时保存。
-     */
-    ResultImage?: string;
-    /**
-     * 唯一请求 ID，由服务端生成，每次请求都会返回（若请求因其他原因未能抵达服务端，则该次请求不会获得 RequestId）。定位问题时需要提供该次请求的 RequestId。
-     */
-    RequestId?: string;
-}
 /**
  * SketchToImage返回参数结构体
  */

package/tencentcloud/services/index.js

@@ -1,4 +1,5 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.aiart = void 0;
 var aiart_1 = require("./aiart");
 Object.defineProperty(exports, "aiart", { enumerable: true, get: function () { return aiart_1.aiart; } });