tencentcloud-sdk-nodejs-ocr 4.1.309 → 4.1.310

package/package.json

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

package/tencentcloud/services/ocr/v20181119/ocr_models.d.ts

@@ -2309,6 +2309,14 @@ export interface VerifyScenePhotoResponse {
      * <p>水印内容，当未检测到文字水印时不返回，返回多组水印时以 | 分隔。</p>
      */
     WatermarkContent?: string;
+    /**
+     * <p>模板图片提示</p>
+     */
+    Template?: SceneWarnInfo;
+    /**
+     * <p>VLM 推理结果。仅当请求中传入 ReasoningPrompt 时返回，否则不返回此字段。</p>
+     */
+    ReasoningResult?: ReasoningResult;
     /**
      * 唯一请求 ID，由服务端生成，每次请求都会返回（若请求因其他原因未能抵达服务端，则该次请求不会获得 RequestId）。定位问题时需要提供该次请求的 RequestId。
      */
@@ -2698,41 +2706,29 @@ export interface SmartStructuralOCRRequest {
     ReturnFullText?: boolean;
 }
 /**
- * 单元格数据
+ * VLM 推理结果
  */
-export interface TableCellInfo {
-    /**
-     * 单元格左上角的列索引
-     */
-    ColTl: number;
-    /**
-     * 单元格左上角的行索引
-     */
-    RowTl: number;
-    /**
-     * 单元格右下角的列索引
-     */
-    ColBr: number;
+export interface ReasoningResult {
     /**
-     * 单元格右下角的行索引
+     * <p>实际使用的推理输出模式：enum 或 string。</p>
      */
-    RowBr: number;
+    OutputMode?: string;
     /**
-     * 单元格内识别出的字符串文本，若文本存在多行，以换行符"\n"隔开
+     * <p>枚举模式下的推理结果值。当 OutputMode=enum 时返回，必定命中请求中 EnumValues 的某个值。 若 VLM 输出无法匹配任何枚举值，则返回 <strong>UNCERTAIN</strong>。</p>
      */
-    Text: string;
+    EnumValue?: string;
     /**
-     * 单元格类型
+     * <p>文本模式下的推理结果值。当 OutputMode=string 时返回。 若 VLM 无法得出结论，则返回 <strong>UNCERTAIN</strong>。</p>
      */
-    Type: string;
+    TextValue?: string;
     /**
-     * 单元格置信度
+     * <p>VLM 原始输出文本（未经过结构化校验）。</p>
      */
-    Confidence: number;
+    RawOutput?: string;
     /**
-     * 单元格在图像中的四点坐标
+     * <p>变量替换后的实际 Prompt（脱敏后）。</p>
      */
-    Polygon: Array<Coord>;
+    RenderedPrompt?: string;
 }
 /**
  * GeneralHandwritingOCR请求参数结构体
@@ -3962,199 +3958,25 @@ export interface ItemNames {
     KeyAuditPrompt?: string;
 }
 /**
- * 混贴票据中单张发票的内容
+ * 推理输出配置
  */
-export interface SingleInvoiceItem {
+export interface ReasoningConfig {
     /**
-     * 增值税专用发票
-  注意：此字段可能返回 null，表示取不到有效值。
-     */
-    VatSpecialInvoice?: VatInvoiceInfo;
-    /**
-     * 增值税普通发票
-  注意：此字段可能返回 null，表示取不到有效值。
+     * <p>实际使用的推理输出模式：enum 或 string。</p>
      */
-    VatCommonInvoice?: VatInvoiceInfo;
+    OutputMode?: string;
     /**
-     * 增值税电子普通发票
-  注意：此字段可能返回 null，表示取不到有效值。
+     * <p>枚举值集合，仅在 OutputMode=enum 时生效。  VLM 输出必须精确命中此集合中的某个值。</p>
      */
-    VatElectronicCommonInvoice?: VatInvoiceInfo;
+    EnumValues?: Array<string>;
     /**
-     * 增值税电子专用发票
-  注意：此字段可能返回 null，表示取不到有效值。
+     * <p>文本输出最大长度，仅在 OutputMode=string 时生效。</p><p>取值范围：[1, 500]</p><p>默认值：200</p>
      */
-    VatElectronicSpecialInvoice?: VatInvoiceInfo;
+    MaxLength?: number;
     /**
-     * 区块链电子发票
-  注意：此字段可能返回 null，表示取不到有效值。
+     * <p>是否在推理调用时向 VLM 传入原图进行多模态理解。  true（默认）：VLM 同时接收原图和渲染后的 Prompt，具备多模态理解能力，可直接&quot;看&quot;图片内容进行推理。  false：不传入原图，仅以渲染后的 Prompt（含变量注入值）进行纯文本推理。适用于推理逻辑完全基于结构化出参字段（如水印文字、置信度比较等）的场景，可降低推理延迟和计费成本。  建议：当 ReasoningPrompt 中未涉及&quot;观察图片&quot;、&quot;直接看图&quot;等多模态指令，且推理规则完全基于 ${变量名} 引用的文字结果时，可设为 false 以优化性能。</p>
      */
-    VatElectronicInvoiceBlockchain?: VatInvoiceInfo;
-    /**
-     * 增值税电子普通发票(通行费)
-  注意：此字段可能返回 null，表示取不到有效值。
-     */
-    VatElectronicInvoiceToll?: VatInvoiceInfo;
-    /**
-     * 电子发票(专用发票)
-  注意：此字段可能返回 null，表示取不到有效值。
-     */
-    VatElectronicSpecialInvoiceFull?: VatElectronicInfo;
-    /**
-     * 电子发票(普通发票)
-  注意：此字段可能返回 null，表示取不到有效值。
-     */
-    VatElectronicInvoiceFull?: VatElectronicInfo;
-    /**
-     * 通用机打发票
-  注意：此字段可能返回 null，表示取不到有效值。
-     */
-    MachinePrintedInvoice?: MachinePrintedInvoice;
-    /**
-     * 汽车票
-  注意：此字段可能返回 null，表示取不到有效值。
-     */
-    BusInvoice?: BusInvoice;
-    /**
-     * 轮船票
-  注意：此字段可能返回 null，表示取不到有效值。
-     */
-    ShippingInvoice?: ShippingInvoice;
-    /**
-     * 过路过桥费发票
-  注意：此字段可能返回 null，表示取不到有效值。
-     */
-    TollInvoice?: TollInvoice;
-    /**
-     * 其他发票
-  注意：此字段可能返回 null，表示取不到有效值。
-     */
-    OtherInvoice?: OtherInvoice;
-    /**
-     * 机动车销售统一发票
-  注意：此字段可能返回 null，表示取不到有效值。
-     */
-    MotorVehicleSaleInvoice?: MotorVehicleSaleInvoice;
-    /**
-     * 二手车销售统一发票
-  注意：此字段可能返回 null，表示取不到有效值。
-     */
-    UsedCarPurchaseInvoice?: UsedCarPurchaseInvoice;
-    /**
-     * 增值税普通发票(卷票)
-  注意：此字段可能返回 null，表示取不到有效值。
-     */
-    VatInvoiceRoll?: VatInvoiceRoll;
-    /**
-     * 出租车发票
-  注意：此字段可能返回 null，表示取不到有效值。
-     */
-    TaxiTicket?: TaxiTicket;
-    /**
-     * 定额发票
-  注意：此字段可能返回 null，表示取不到有效值。
-     */
-    QuotaInvoice?: QuotaInvoice;
-    /**
-     * 机票行程单
-  注意：此字段可能返回 null，表示取不到有效值。
-     */
-    AirTransport?: AirTransport;
-    /**
-     * 非税收入通用票据
-  注意：此字段可能返回 null，表示取不到有效值。
-     */
-    NonTaxIncomeGeneralBill?: NonTaxIncomeBill;
-    /**
-     * 非税收入一般缴款书(电子)
-  注意：此字段可能返回 null，表示取不到有效值。
-     */
-    NonTaxIncomeElectronicBill?: NonTaxIncomeBill;
-    /**
-     * 火车票
-  注意：此字段可能返回 null，表示取不到有效值。
-     */
-    TrainTicket?: TrainTicket;
-    /**
-     * 医疗门诊收费票据（电子）
-  注意：此字段可能返回 null，表示取不到有效值。
-     */
-    MedicalOutpatientInvoice?: MedicalInvoice;
-    /**
-     * 医疗住院收费票据（电子）
-  注意：此字段可能返回 null，表示取不到有效值。
-     */
-    MedicalHospitalizedInvoice?: MedicalInvoice;
-    /**
-     * 增值税销货清单
-  注意：此字段可能返回 null，表示取不到有效值。
-     */
-    VatSalesList?: VatInvoiceInfo;
-    /**
-     * 电子发票（火车票）
-  注意：此字段可能返回 null，表示取不到有效值。
-     */
-    ElectronicTrainTicketFull?: ElectronicTrainTicketFull;
-    /**
-     * 电子发票（机票行程单）
-  注意：此字段可能返回 null，表示取不到有效值。
-     */
-    ElectronicFlightTicketFull?: ElectronicFlightTicketFull;
-    /**
-     * 完税凭证
-  注意：此字段可能返回 null，表示取不到有效值。
-     */
-    TaxPayment?: TaxPayment;
-    /**
-     * 海关缴款
-  注意：此字段可能返回 null，表示取不到有效值。
-     */
-    CustomsPaymentReceipt?: CustomsPaymentReceipt;
-    /**
-     * 银行回单
-  注意：此字段可能返回 null，表示取不到有效值。
-     */
-    BankSlip?: BankSlip;
-    /**
-     * 网约车行程单
-  注意：此字段可能返回 null，表示取不到有效值。
-     */
-    OnlineTaxiItinerary?: OnlineTaxiItinerary;
-    /**
-     * 海关进/出口货物报关单
-  注意：此字段可能返回 null，表示取不到有效值。
-     */
-    CustomsDeclaration?: CustomsDeclaration;
-    /**
-     * 海外发票
-  注意：此字段可能返回 null，表示取不到有效值。
-     */
-    OverseasInvoice?: OverseasInvoice;
-    /**
-     * 购物小票
-  注意：此字段可能返回 null，表示取不到有效值。
-     */
-    ShoppingReceipt?: ShoppingReceipt;
-    /**
-     * 销货清单
-  注意：此字段可能返回 null，表示取不到有效值。
-     */
-    SaleInventory?: SaleInventory;
-    /**
-     * 机动车销售统一发票（电子）
-  注意：此字段可能返回 null，表示取不到有效值。
-     */
-    MotorVehicleSaleInvoiceElectronic?: MotorVehicleSaleInvoice;
-    /**
-     * 二手车销售统一发票（电子）
-  注意：此字段可能返回 null，表示取不到有效值。
-     */
-    UsedCarPurchaseInvoiceElectronic?: UsedCarPurchaseInvoice;
-    /**
-     * 通行费电子票据汇总单
-  注意：此字段可能返回 null，表示取不到有效值。
-     */
-    ElectronicTollSummary?: ElectronicTollSummary;
+    EnableImageInput?: boolean;
 }
 /**
  * 增值税发票返回值
@@ -6751,25 +6573,41 @@ export interface SchemaList {
     SubItems?: Array<SchemaList>;
 }
 /**
- * 增值税普通发票（卷票）条目
+ * 单元格数据
  */
-export interface VatRollItem {
+export interface TableCellInfo {
     /**
-     * 项目名称
+     * 单元格左上角的列索引
      */
-    Name?: string;
+    ColTl: number;
     /**
-     * 数量
+     * 单元格左上角的行索引
      */
-    Quantity?: string;
+    RowTl: number;
     /**
-     * 单价
+     * 单元格右下角的列索引
      */
-    Price?: string;
+    ColBr: number;
     /**
-     * 金额
+     * 单元格右下角的行索引
      */
-    Total?: string;
+    RowBr: number;
+    /**
+     * 单元格内识别出的字符串文本，若文本存在多行，以换行符"\n"隔开
+     */
+    Text: string;
+    /**
+     * 单元格类型
+     */
+    Type: string;
+    /**
+     * 单元格置信度
+     */
+    Confidence: number;
+    /**
+     * 单元格在图像中的四点坐标
+     */
+    Polygon: Array<Coord>;
 }
 /**
  * 机票详细信息元组
@@ -7427,6 +7265,201 @@ export interface ClassifyStoreNameResponse {
      */
     RequestId?: string;
 }
+/**
+ * 混贴票据中单张发票的内容
+ */
+export interface SingleInvoiceItem {
+    /**
+     * 增值税专用发票
+  注意：此字段可能返回 null，表示取不到有效值。
+     */
+    VatSpecialInvoice?: VatInvoiceInfo;
+    /**
+     * 增值税普通发票
+  注意：此字段可能返回 null，表示取不到有效值。
+     */
+    VatCommonInvoice?: VatInvoiceInfo;
+    /**
+     * 增值税电子普通发票
+  注意：此字段可能返回 null，表示取不到有效值。
+     */
+    VatElectronicCommonInvoice?: VatInvoiceInfo;
+    /**
+     * 增值税电子专用发票
+  注意：此字段可能返回 null，表示取不到有效值。
+     */
+    VatElectronicSpecialInvoice?: VatInvoiceInfo;
+    /**
+     * 区块链电子发票
+  注意：此字段可能返回 null，表示取不到有效值。
+     */
+    VatElectronicInvoiceBlockchain?: VatInvoiceInfo;
+    /**
+     * 增值税电子普通发票(通行费)
+  注意：此字段可能返回 null，表示取不到有效值。
+     */
+    VatElectronicInvoiceToll?: VatInvoiceInfo;
+    /**
+     * 电子发票(专用发票)
+  注意：此字段可能返回 null，表示取不到有效值。
+     */
+    VatElectronicSpecialInvoiceFull?: VatElectronicInfo;
+    /**
+     * 电子发票(普通发票)
+  注意：此字段可能返回 null，表示取不到有效值。
+     */
+    VatElectronicInvoiceFull?: VatElectronicInfo;
+    /**
+     * 通用机打发票
+  注意：此字段可能返回 null，表示取不到有效值。
+     */
+    MachinePrintedInvoice?: MachinePrintedInvoice;
+    /**
+     * 汽车票
+  注意：此字段可能返回 null，表示取不到有效值。
+     */
+    BusInvoice?: BusInvoice;
+    /**
+     * 轮船票
+  注意：此字段可能返回 null，表示取不到有效值。
+     */
+    ShippingInvoice?: ShippingInvoice;
+    /**
+     * 过路过桥费发票
+  注意：此字段可能返回 null，表示取不到有效值。
+     */
+    TollInvoice?: TollInvoice;
+    /**
+     * 其他发票
+  注意：此字段可能返回 null，表示取不到有效值。
+     */
+    OtherInvoice?: OtherInvoice;
+    /**
+     * 机动车销售统一发票
+  注意：此字段可能返回 null，表示取不到有效值。
+     */
+    MotorVehicleSaleInvoice?: MotorVehicleSaleInvoice;
+    /**
+     * 二手车销售统一发票
+  注意：此字段可能返回 null，表示取不到有效值。
+     */
+    UsedCarPurchaseInvoice?: UsedCarPurchaseInvoice;
+    /**
+     * 增值税普通发票(卷票)
+  注意：此字段可能返回 null，表示取不到有效值。
+     */
+    VatInvoiceRoll?: VatInvoiceRoll;
+    /**
+     * 出租车发票
+  注意：此字段可能返回 null，表示取不到有效值。
+     */
+    TaxiTicket?: TaxiTicket;
+    /**
+     * 定额发票
+  注意：此字段可能返回 null，表示取不到有效值。
+     */
+    QuotaInvoice?: QuotaInvoice;
+    /**
+     * 机票行程单
+  注意：此字段可能返回 null，表示取不到有效值。
+     */
+    AirTransport?: AirTransport;
+    /**
+     * 非税收入通用票据
+  注意：此字段可能返回 null，表示取不到有效值。
+     */
+    NonTaxIncomeGeneralBill?: NonTaxIncomeBill;
+    /**
+     * 非税收入一般缴款书(电子)
+  注意：此字段可能返回 null，表示取不到有效值。
+     */
+    NonTaxIncomeElectronicBill?: NonTaxIncomeBill;
+    /**
+     * 火车票
+  注意：此字段可能返回 null，表示取不到有效值。
+     */
+    TrainTicket?: TrainTicket;
+    /**
+     * 医疗门诊收费票据（电子）
+  注意：此字段可能返回 null，表示取不到有效值。
+     */
+    MedicalOutpatientInvoice?: MedicalInvoice;
+    /**
+     * 医疗住院收费票据（电子）
+  注意：此字段可能返回 null，表示取不到有效值。
+     */
+    MedicalHospitalizedInvoice?: MedicalInvoice;
+    /**
+     * 增值税销货清单
+  注意：此字段可能返回 null，表示取不到有效值。
+     */
+    VatSalesList?: VatInvoiceInfo;
+    /**
+     * 电子发票（火车票）
+  注意：此字段可能返回 null，表示取不到有效值。
+     */
+    ElectronicTrainTicketFull?: ElectronicTrainTicketFull;
+    /**
+     * 电子发票（机票行程单）
+  注意：此字段可能返回 null，表示取不到有效值。
+     */
+    ElectronicFlightTicketFull?: ElectronicFlightTicketFull;
+    /**
+     * 完税凭证
+  注意：此字段可能返回 null，表示取不到有效值。
+     */
+    TaxPayment?: TaxPayment;
+    /**
+     * 海关缴款
+  注意：此字段可能返回 null，表示取不到有效值。
+     */
+    CustomsPaymentReceipt?: CustomsPaymentReceipt;
+    /**
+     * 银行回单
+  注意：此字段可能返回 null，表示取不到有效值。
+     */
+    BankSlip?: BankSlip;
+    /**
+     * 网约车行程单
+  注意：此字段可能返回 null，表示取不到有效值。
+     */
+    OnlineTaxiItinerary?: OnlineTaxiItinerary;
+    /**
+     * 海关进/出口货物报关单
+  注意：此字段可能返回 null，表示取不到有效值。
+     */
+    CustomsDeclaration?: CustomsDeclaration;
+    /**
+     * 海外发票
+  注意：此字段可能返回 null，表示取不到有效值。
+     */
+    OverseasInvoice?: OverseasInvoice;
+    /**
+     * 购物小票
+  注意：此字段可能返回 null，表示取不到有效值。
+     */
+    ShoppingReceipt?: ShoppingReceipt;
+    /**
+     * 销货清单
+  注意：此字段可能返回 null，表示取不到有效值。
+     */
+    SaleInventory?: SaleInventory;
+    /**
+     * 机动车销售统一发票（电子）
+  注意：此字段可能返回 null，表示取不到有效值。
+     */
+    MotorVehicleSaleInvoiceElectronic?: MotorVehicleSaleInvoice;
+    /**
+     * 二手车销售统一发票（电子）
+  注意：此字段可能返回 null，表示取不到有效值。
+     */
+    UsedCarPurchaseInvoiceElectronic?: UsedCarPurchaseInvoice;
+    /**
+     * 通行费电子票据汇总单
+  注意：此字段可能返回 null，表示取不到有效值。
+     */
+    ElectronicTollSummary?: ElectronicTollSummary;
+}
 /**
  * DescribeExtractDocAgentJob请求参数结构体
  */
@@ -7968,6 +8001,14 @@ export interface VerifyScenePhotoRequest {
      * <p>图片的 Base64 值。要求图片经Base64编码后不超过 10M。</p>
      */
     ImageBase64?: string;
+    /**
+     * <p>推理 Prompt 模板，默认使用 VLM 对图片进行理解推理，同时支持使用 ${变量名} 进行推理。传入该参数即开启推理流程。</p><p>入参限制：长度限制：1–2000 字符</p>
+     */
+    ReasoningPrompt?: string;
+    /**
+     * <p>推理输出配置。当 ReasoningPrompt 传入时建议同步传入，未传入时使用默认配置（OutputMode=enum, EnumValues=[&quot;true&quot;,&quot;false&quot;], EnableImageInput=true）。</p>
+     */
+    ReasoningConfig?: ReasoningConfig;
 }
 /**
  * DescribeQuestionMarkAgentJob请求参数结构体
@@ -10438,29 +10479,25 @@ export interface MixedInvoiceDetectRequest {
     PdfPageNumber?: number;
 }
 /**
- * WaybillOCR请求参数结构体
+ * 增值税普通发票（卷票）条目
  */
-export interface WaybillOCRRequest {
-    /**
-     * 图片的 Base64 值。支持的图片格式：PNG、JPG、JPEG，暂不支持 GIF 格式。支持的图片大小：所下载图片经Base64编码后不超过 10M。图片下载时间不超过 3 秒。图片的 ImageUrl、ImageBase64 必须提供一个，如果都提供，只使用 ImageUrl。
-     */
-    ImageBase64?: string;
+export interface VatRollItem {
     /**
-     * 图片的 Url 地址。支持的图片格式：PNG、JPG、JPEG，暂不支持 GIF 格式。支持的图片大小：所下载图片经 Base64 编码后不超过 10M。图片下载时间不超过 3 秒。图片存储于腾讯云的 Url 可保障更高的下载速度和稳定性，建议图片存储于腾讯云。非腾讯云存储的 Url 速度和稳定性可能受一定影响。
+     * 项目名称
      */
-    ImageUrl?: string;
+    Name?: string;
     /**
-     * 预检测开关，当待识别运单占整个输入图像的比例较小时，建议打开预检测开关。默认值为false。
+     * 数量
      */
-    EnablePreDetect?: boolean;
+    Quantity?: string;
     /**
-     * 是否开启PDF识别，默认值为true，开启后可同时支持图片和PDF的识别。
+     * 单价
      */
-    IsPdf?: boolean;
+    Price?: string;
     /**
-     * 需要识别的PDF页面的对应页码，仅支持PDF单页识别，当上传文件为PDF且IsPdf参数值为true时有效，默认值为1。
+     * 金额
      */
-    PdfPageNumber?: number;
+    Total?: string;
 }
 /**
  * 二维码/条形码识别结果信息
@@ -10501,6 +10538,31 @@ export interface BusinessCertificateInfo {
      */
     Rect?: Rect;
 }
+/**
+ * WaybillOCR请求参数结构体
+ */
+export interface WaybillOCRRequest {
+    /**
+     * 图片的 Base64 值。支持的图片格式：PNG、JPG、JPEG，暂不支持 GIF 格式。支持的图片大小：所下载图片经Base64编码后不超过 10M。图片下载时间不超过 3 秒。图片的 ImageUrl、ImageBase64 必须提供一个，如果都提供，只使用 ImageUrl。
+     */
+    ImageBase64?: string;
+    /**
+     * 图片的 Url 地址。支持的图片格式：PNG、JPG、JPEG，暂不支持 GIF 格式。支持的图片大小：所下载图片经 Base64 编码后不超过 10M。图片下载时间不超过 3 秒。图片存储于腾讯云的 Url 可保障更高的下载速度和稳定性，建议图片存储于腾讯云。非腾讯云存储的 Url 速度和稳定性可能受一定影响。
+     */
+    ImageUrl?: string;
+    /**
+     * 预检测开关，当待识别运单占整个输入图像的比例较小时，建议打开预检测开关。默认值为false。
+     */
+    EnablePreDetect?: boolean;
+    /**
+     * 是否开启PDF识别，默认值为true，开启后可同时支持图片和PDF的识别。
+     */
+    IsPdf?: boolean;
+    /**
+     * 需要识别的PDF页面的对应页码，仅支持PDF单页识别，当上传文件为PDF且IsPdf参数值为true时有效，默认值为1。
+     */
+    PdfPageNumber?: number;
+}
 /**
  * RideHailingTransportLicenseOCR请求参数结构体
  */