@alicloud/aidge20260428 3.1.0 → 4.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (46) hide show
  1. package/dist/client.d.ts +81 -52
  2. package/dist/client.js +117 -52
  3. package/dist/client.js.map +1 -1
  4. package/dist/models/ImageTranslationProRequest.d.ts +11 -8
  5. package/dist/models/ImageTranslationProRequest.js.map +1 -1
  6. package/dist/models/ImageTranslationProResponseBody.d.ts +16 -24
  7. package/dist/models/ImageTranslationProResponseBody.js +0 -2
  8. package/dist/models/ImageTranslationProResponseBody.js.map +1 -1
  9. package/dist/models/ImageTranslationStandardRequest.d.ts +14 -6
  10. package/dist/models/ImageTranslationStandardRequest.js +2 -0
  11. package/dist/models/ImageTranslationStandardRequest.js.map +1 -1
  12. package/dist/models/ImageTranslationStandardResponseBody.d.ts +357 -4
  13. package/dist/models/ImageTranslationStandardResponseBody.js +222 -1
  14. package/dist/models/ImageTranslationStandardResponseBody.js.map +1 -1
  15. package/dist/models/MerchandisePlacementDetectionRequest.d.ts +47 -0
  16. package/dist/models/MerchandisePlacementDetectionRequest.js +64 -0
  17. package/dist/models/MerchandisePlacementDetectionRequest.js.map +1 -0
  18. package/dist/models/MerchandisePlacementDetectionResponse.d.ts +19 -0
  19. package/dist/models/MerchandisePlacementDetectionResponse.js +69 -0
  20. package/dist/models/MerchandisePlacementDetectionResponse.js.map +1 -0
  21. package/dist/models/MerchandisePlacementDetectionResponseBody.d.ts +210 -0
  22. package/dist/models/MerchandisePlacementDetectionResponseBody.js +182 -0
  23. package/dist/models/MerchandisePlacementDetectionResponseBody.js.map +1 -0
  24. package/dist/models/QueryAsyncTaskResultResponseBody.d.ts +3 -3
  25. package/dist/models/TextTranslateRequest.d.ts +7 -1
  26. package/dist/models/TextTranslateRequest.js.map +1 -1
  27. package/dist/models/TextTranslateResponseBody.d.ts +4 -4
  28. package/dist/models/TextTranslateShrinkRequest.d.ts +7 -1
  29. package/dist/models/TextTranslateShrinkRequest.js.map +1 -1
  30. package/dist/models/model.d.ts +13 -0
  31. package/dist/models/model.js +32 -6
  32. package/dist/models/model.js.map +1 -1
  33. package/package.json +1 -1
  34. package/src/client.ts +124 -52
  35. package/src/models/ImageTranslationProRequest.ts +11 -8
  36. package/src/models/ImageTranslationProResponseBody.ts +16 -26
  37. package/src/models/ImageTranslationStandardRequest.ts +16 -6
  38. package/src/models/ImageTranslationStandardResponseBody.ts +524 -4
  39. package/src/models/MerchandisePlacementDetectionRequest.ts +66 -0
  40. package/src/models/MerchandisePlacementDetectionResponse.ts +40 -0
  41. package/src/models/MerchandisePlacementDetectionResponseBody.ts +309 -0
  42. package/src/models/QueryAsyncTaskResultResponseBody.ts +3 -3
  43. package/src/models/TextTranslateRequest.ts +7 -1
  44. package/src/models/TextTranslateResponseBody.ts +4 -4
  45. package/src/models/TextTranslateShrinkRequest.ts +7 -1
  46. package/src/models/model.ts +13 -0
package/dist/client.d.ts CHANGED
@@ -789,18 +789,12 @@ export default class Client extends OpenApi {
789
789
  */
790
790
  imageRemove(request: $_model.ImageRemoveRequest): Promise<$_model.ImageRemoveResponse>;
791
791
  /**
792
- * Translates images using the Pro edition, which is designed specifically for e-commerce images. This product integrates multimodal large model technology to achieve more accurate image understanding, significantly improve translation quality, and continuously expand and optimize multilingual translation capabilities. Supports more than 100 language directions (including bridged translations).
792
+ * Translates text in e-commerce images using the Pro edition, which integrates multimodal foundation model technology for more accurate image understanding and significantly improved translation quality.
793
793
  *
794
794
  * @remarks
795
- * ## Product Introduction
796
- * The Image Translation Pro edition is designed specifically for e-commerce images. It integrates multimodal large model technology to achieve more accurate image understanding, significantly improve translation quality, and continuously expand and optimize multilingual translation capabilities. Supports more than 100 language directions (including bridged translations).
797
- * ## Scenarios
798
- * E-commerce product images, marketing images, and images for various other scenarios.
799
- * ## Features
800
- * - **Product subject protection**: Supports custom selection of whether to translate text on the product subject, helping you protect subject information from being translated, such as embedded information like product names.
801
- * - **Post-translation editing**: Supports custom selection of whether to return layout information such as text position, font, and color. This can be used for secondary editing when integrated with an image editor. The editor SDK package is not yet available. Follow platform notifications for updates.
802
- * - **Brand name protection**: Supports custom selection of whether to translate brand names on images, helping you protect brand name information from being translated.
803
- * - **Translation intervention**: Supports custom translation results, including do-not-translate (ABC-ABC), specified translation (ABC-DEF), and no translation (ABC-empty value). This is commonly used for brand name protection scenarios. Simply pass the corresponding intervention glossary ID when calling the API to meet your translation needs in different scenarios. You can upload up to 100,000 intervention terms. Contact the platform if you need more.
795
+ * ## Product Introduction.
796
+ * ## Scenarios.
797
+ * ## Features.
804
798
  *
805
799
  * @param request - ImageTranslationProRequest
806
800
  * @param runtime - runtime options for this request RuntimeOptions
@@ -808,35 +802,24 @@ export default class Client extends OpenApi {
808
802
  */
809
803
  imageTranslationProWithOptions(request: $_model.ImageTranslationProRequest, runtime: $dara.RuntimeOptions): Promise<$_model.ImageTranslationProResponse>;
810
804
  /**
811
- * Translates images using the Pro edition, which is designed specifically for e-commerce images. This product integrates multimodal large model technology to achieve more accurate image understanding, significantly improve translation quality, and continuously expand and optimize multilingual translation capabilities. Supports more than 100 language directions (including bridged translations).
805
+ * Translates text in e-commerce images using the Pro edition, which integrates multimodal foundation model technology for more accurate image understanding and significantly improved translation quality.
812
806
  *
813
807
  * @remarks
814
- * ## Product Introduction
815
- * The Image Translation Pro edition is designed specifically for e-commerce images. It integrates multimodal large model technology to achieve more accurate image understanding, significantly improve translation quality, and continuously expand and optimize multilingual translation capabilities. Supports more than 100 language directions (including bridged translations).
816
- * ## Scenarios
817
- * E-commerce product images, marketing images, and images for various other scenarios.
818
- * ## Features
819
- * - **Product subject protection**: Supports custom selection of whether to translate text on the product subject, helping you protect subject information from being translated, such as embedded information like product names.
820
- * - **Post-translation editing**: Supports custom selection of whether to return layout information such as text position, font, and color. This can be used for secondary editing when integrated with an image editor. The editor SDK package is not yet available. Follow platform notifications for updates.
821
- * - **Brand name protection**: Supports custom selection of whether to translate brand names on images, helping you protect brand name information from being translated.
822
- * - **Translation intervention**: Supports custom translation results, including do-not-translate (ABC-ABC), specified translation (ABC-DEF), and no translation (ABC-empty value). This is commonly used for brand name protection scenarios. Simply pass the corresponding intervention glossary ID when calling the API to meet your translation needs in different scenarios. You can upload up to 100,000 intervention terms. Contact the platform if you need more.
808
+ * ## Product Introduction.
809
+ * ## Scenarios.
810
+ * ## Features.
823
811
  *
824
812
  * @param request - ImageTranslationProRequest
825
813
  * @returns ImageTranslationProResponse
826
814
  */
827
815
  imageTranslationPro(request: $_model.ImageTranslationProRequest): Promise<$_model.ImageTranslationProResponse>;
828
816
  /**
829
- * Image Translation is designed specifically for e-commerce images. It supports more than 100 language directions, accurately processes complex text layouts within images, and ensures that translated content matches the image content. This helps e-commerce platforms and developers easily achieve multilingual conversion and rendering of image content.
817
+ * Translates text in images with support for over 100 language pairs (including bridging). This product is designed specifically for e-commerce images, accurately handling complex text layouts within images and ensuring that translated content matches the image context. It helps e-commerce platforms and developers easily achieve multilingual conversion and presentation of image content. The product also returns layer information such as text position, font, and color within images, facilitating integration with image editors for secondary editing of translation results.
830
818
  *
831
819
  * @remarks
832
- * ## Product Introduction
833
- * Image Translation is designed specifically for e-commerce images. It supports more than 100 language directions, accurately processes complex text layouts within images, and ensures that translated content matches the image content. This helps e-commerce platforms and developers easily achieve multilingual conversion and rendering of image content.
834
- * ## Common scenarios
835
- * E-commerce product images, marketing images, and images for various other scenarios.
836
- * ## Functions and features
837
- * - **Product subject information protection**: You can choose whether to translate text on the product subject. This helps protect subject information from being translated, such as embedded information like product names.
838
- * - **Brand name protection**: You can choose whether to translate brand names on images. This helps protect brand name information from being translated.
839
- * - **Translation intervention support**: You can customize translation results, including keeping text untranslated (ABC-ABC), specifying translations (ABC-DEF), or removing text (ABC-empty value). This is commonly used for brand name protection and similar scenarios. Pass the corresponding intervention glossary ID when calling the API to meet your translation needs in different scenarios. You can upload up to 100,000 intervention terms. If you need more, contact the platform for assistance.
820
+ * # 1. Product Introduction.
821
+ * # 2. Common scenarios.
822
+ * # 3. Features.
840
823
  *
841
824
  * @param request - ImageTranslationStandardRequest
842
825
  * @param runtime - runtime options for this request RuntimeOptions
@@ -844,17 +827,12 @@ export default class Client extends OpenApi {
844
827
  */
845
828
  imageTranslationStandardWithOptions(request: $_model.ImageTranslationStandardRequest, runtime: $dara.RuntimeOptions): Promise<$_model.ImageTranslationStandardResponse>;
846
829
  /**
847
- * Image Translation is designed specifically for e-commerce images. It supports more than 100 language directions, accurately processes complex text layouts within images, and ensures that translated content matches the image content. This helps e-commerce platforms and developers easily achieve multilingual conversion and rendering of image content.
830
+ * Translates text in images with support for over 100 language pairs (including bridging). This product is designed specifically for e-commerce images, accurately handling complex text layouts within images and ensuring that translated content matches the image context. It helps e-commerce platforms and developers easily achieve multilingual conversion and presentation of image content. The product also returns layer information such as text position, font, and color within images, facilitating integration with image editors for secondary editing of translation results.
848
831
  *
849
832
  * @remarks
850
- * ## Product Introduction
851
- * Image Translation is designed specifically for e-commerce images. It supports more than 100 language directions, accurately processes complex text layouts within images, and ensures that translated content matches the image content. This helps e-commerce platforms and developers easily achieve multilingual conversion and rendering of image content.
852
- * ## Common scenarios
853
- * E-commerce product images, marketing images, and images for various other scenarios.
854
- * ## Functions and features
855
- * - **Product subject information protection**: You can choose whether to translate text on the product subject. This helps protect subject information from being translated, such as embedded information like product names.
856
- * - **Brand name protection**: You can choose whether to translate brand names on images. This helps protect brand name information from being translated.
857
- * - **Translation intervention support**: You can customize translation results, including keeping text untranslated (ABC-ABC), specifying translations (ABC-DEF), or removing text (ABC-empty value). This is commonly used for brand name protection and similar scenarios. Pass the corresponding intervention glossary ID when calling the API to meet your translation needs in different scenarios. You can upload up to 100,000 intervention terms. If you need more, contact the platform for assistance.
833
+ * # 1. Product Introduction.
834
+ * # 2. Common scenarios.
835
+ * # 3. Features.
858
836
  *
859
837
  * @param request - ImageTranslationStandardRequest
860
838
  * @returns ImageTranslationStandardResponse
@@ -942,6 +920,57 @@ export default class Client extends OpenApi {
942
920
  * @returns MaterialInspectionResponse
943
921
  */
944
922
  materialInspection(request: $_model.MaterialInspectionRequest): Promise<$_model.MaterialInspectionResponse>;
923
+ /**
924
+ * Detects and identifies products displayed on store shelves or floor stacks by combining a multimodal large language model (MLLM) with visual vector recall, targeting shelf and floor-stack inspection scenarios in offline retail and channel stores. The service first uses an MLLM to detect bounding boxes and preliminary names for each product in a store photo, then performs similarity recall against a customer-specific SKU vector library to exactly match each product to the customer\\"s own SKUs, and outputs per-product structured results that can be directly integrated with business systems. This is suitable for large-scale, high-concurrency visual recognition pipelines such as remote auditing of in-store displays by headquarters, SKU distribution verification, and display compliance inspection.
925
+ *
926
+ * @remarks
927
+ * ## **Product Introduction**
928
+ * Display detection is an intelligent store product display recognition capability built on a multimodal large language model (MLLM) combined with visual vector recall. It targets shelf and floor-stack display inspection scenarios in offline retail and channel stores. For store photos of shelves or floor stacks, the service first uses an MLLM to detect the bounding box and preliminary name for each product, then performs similarity recall against a customer-specific SKU vector library to exactly match each product to the customer\\"s own SKUs, and outputs per-product structured results that can be directly integrated with business systems. This is suitable for large-scale, high-concurrency visual recognition pipelines such as remote auditing of in-store displays by headquarters, SKU distribution verification, and display compliance inspection.
929
+ * ## **Scenarios**
930
+ * - **Shelf/floor-stack display recognition and inventory**: Identifies each product in a shelf or floor-stack image, matches it to the customer\\"s SKU library, and outputs a per-product list (product name + position + similarity score), replacing manual counting.
931
+ *
932
+ * - **Distribution verification/SKU compliance**: Verifies whether stores display specified SKUs as required by headquarters and whether out-of-stock or misplaced items exist, supporting batch automated verification during promotions or new product launches.
933
+ *
934
+ * - **Customer-specific SKU library**: Customers upload their own standard SKU images to build a dedicated vector library (isolated by `RagId`). During recognition, retrieval is performed only within that customer\\"s library, ensuring name accuracy and data isolation between customers.
935
+ * ## **Features**
936
+ * - **Two-stage detection + retrieval collaboration**: The MLLM detects each product\\"s bounding box and preliminary name across the entire image (semantic-level understanding, adapted for dense displays and partial occlusion). Then visual embedding vectors perform similarity retrieval within the customer\\"s SKU library, overriding the preliminary name with the top-1 precise SKU name to balance recall rate and name accuracy.
937
+ *
938
+ * - **Isolated retrieval with dedicated vector libraries**: A dedicated SKU vector library is maintained for each customer by `RagId`. Recognition retrieves only within the corresponding library, ensuring strict isolation between customers. Newly added or updated SKUs take effect in real time.
939
+ *
940
+ * - **Per-product structured output**: Output is unified as `Result.Items[]`, with each product independently providing a bounding box, recalled SKU name, SKU code, and similarity score. This facilitates direct integration with downstream inventory/verification systems and supports case-level manual review and traceability.
941
+ *
942
+ * - **Supported input formats**: Currently supports image URLs accessible via the public network or OSS. A single shelf or floor-stack image is sufficient for recognition, and the output structure is consistent.
943
+ *
944
+ * @param request - MerchandisePlacementDetectionRequest
945
+ * @param runtime - runtime options for this request RuntimeOptions
946
+ * @returns MerchandisePlacementDetectionResponse
947
+ */
948
+ merchandisePlacementDetectionWithOptions(request: $_model.MerchandisePlacementDetectionRequest, runtime: $dara.RuntimeOptions): Promise<$_model.MerchandisePlacementDetectionResponse>;
949
+ /**
950
+ * Detects and identifies products displayed on store shelves or floor stacks by combining a multimodal large language model (MLLM) with visual vector recall, targeting shelf and floor-stack inspection scenarios in offline retail and channel stores. The service first uses an MLLM to detect bounding boxes and preliminary names for each product in a store photo, then performs similarity recall against a customer-specific SKU vector library to exactly match each product to the customer\\"s own SKUs, and outputs per-product structured results that can be directly integrated with business systems. This is suitable for large-scale, high-concurrency visual recognition pipelines such as remote auditing of in-store displays by headquarters, SKU distribution verification, and display compliance inspection.
951
+ *
952
+ * @remarks
953
+ * ## **Product Introduction**
954
+ * Display detection is an intelligent store product display recognition capability built on a multimodal large language model (MLLM) combined with visual vector recall. It targets shelf and floor-stack display inspection scenarios in offline retail and channel stores. For store photos of shelves or floor stacks, the service first uses an MLLM to detect the bounding box and preliminary name for each product, then performs similarity recall against a customer-specific SKU vector library to exactly match each product to the customer\\"s own SKUs, and outputs per-product structured results that can be directly integrated with business systems. This is suitable for large-scale, high-concurrency visual recognition pipelines such as remote auditing of in-store displays by headquarters, SKU distribution verification, and display compliance inspection.
955
+ * ## **Scenarios**
956
+ * - **Shelf/floor-stack display recognition and inventory**: Identifies each product in a shelf or floor-stack image, matches it to the customer\\"s SKU library, and outputs a per-product list (product name + position + similarity score), replacing manual counting.
957
+ *
958
+ * - **Distribution verification/SKU compliance**: Verifies whether stores display specified SKUs as required by headquarters and whether out-of-stock or misplaced items exist, supporting batch automated verification during promotions or new product launches.
959
+ *
960
+ * - **Customer-specific SKU library**: Customers upload their own standard SKU images to build a dedicated vector library (isolated by `RagId`). During recognition, retrieval is performed only within that customer\\"s library, ensuring name accuracy and data isolation between customers.
961
+ * ## **Features**
962
+ * - **Two-stage detection + retrieval collaboration**: The MLLM detects each product\\"s bounding box and preliminary name across the entire image (semantic-level understanding, adapted for dense displays and partial occlusion). Then visual embedding vectors perform similarity retrieval within the customer\\"s SKU library, overriding the preliminary name with the top-1 precise SKU name to balance recall rate and name accuracy.
963
+ *
964
+ * - **Isolated retrieval with dedicated vector libraries**: A dedicated SKU vector library is maintained for each customer by `RagId`. Recognition retrieves only within the corresponding library, ensuring strict isolation between customers. Newly added or updated SKUs take effect in real time.
965
+ *
966
+ * - **Per-product structured output**: Output is unified as `Result.Items[]`, with each product independently providing a bounding box, recalled SKU name, SKU code, and similarity score. This facilitates direct integration with downstream inventory/verification systems and supports case-level manual review and traceability.
967
+ *
968
+ * - **Supported input formats**: Currently supports image URLs accessible via the public network or OSS. A single shelf or floor-stack image is sufficient for recognition, and the output structure is consistent.
969
+ *
970
+ * @param request - MerchandisePlacementDetectionRequest
971
+ * @returns MerchandisePlacementDetectionResponse
972
+ */
973
+ merchandisePlacementDetection(request: $_model.MerchandisePlacementDetectionRequest): Promise<$_model.MerchandisePlacementDetectionResponse>;
945
974
  /**
946
975
  * An intelligent logistics parcel auditing product built on the synergy of Multimodal Large Language Models (MLLM) and specialized vision algorithms, designed for automated compliance review in the "piece-weight-dimension" stage of e-commerce logistics. The product performs structured auditing across multiple dimensions including bounding box validity, bounding box fit accuracy, and foreign object interference on parcels placed on scanning platforms. It supports different hardware acquisition scenarios such as white background boards and green background boards, and outputs Boolean audit conclusions with Chinese reason descriptions that can be directly integrated into business systems. It is suitable for large-scale, high-concurrency inbound quality inspection pipelines.
947
976
  *
@@ -988,10 +1017,10 @@ export default class Client extends OpenApi {
988
1017
  */
989
1018
  packageWeightSizeCheck(request: $_model.PackageWeightSizeCheckRequest): Promise<$_model.PackageWeightSizeCheckResponse>;
990
1019
  /**
991
- * API name on the POP gateway: QueryAsyncTaskResult.
1020
+ * Queries the result of an asynchronous task. The API name on the POP gateway is QueryAsyncTaskResult.
992
1021
  *
993
1022
  * @remarks
994
- * API name on the POP gateway: QueryAsyncTaskResult.
1023
+ * The API name on the POP gateway is QueryAsyncTaskResult.
995
1024
  *
996
1025
  * @param request - QueryAsyncTaskResultRequest
997
1026
  * @param runtime - runtime options for this request RuntimeOptions
@@ -999,10 +1028,10 @@ export default class Client extends OpenApi {
999
1028
  */
1000
1029
  queryAsyncTaskResultWithOptions(request: $_model.QueryAsyncTaskResultRequest, runtime: $dara.RuntimeOptions): Promise<$_model.QueryAsyncTaskResultResponse>;
1001
1030
  /**
1002
- * API name on the POP gateway: QueryAsyncTaskResult.
1031
+ * Queries the result of an asynchronous task. The API name on the POP gateway is QueryAsyncTaskResult.
1003
1032
  *
1004
1033
  * @remarks
1005
- * API name on the POP gateway: QueryAsyncTaskResult.
1034
+ * The API name on the POP gateway is QueryAsyncTaskResult.
1006
1035
  *
1007
1036
  * @param request - QueryAsyncTaskResultRequest
1008
1037
  * @returns QueryAsyncTaskResultResponse
@@ -1362,28 +1391,28 @@ export default class Client extends OpenApi {
1362
1391
  */
1363
1392
  textCorrect(request: $_model.TextCorrectRequest): Promise<$_model.TextCorrectResponse>;
1364
1393
  /**
1365
- * Marco MT is an e-commerce translation model trained on over 1 billion high-quality bilingual sentence pairs, continuously optimized for e-commerce-specific terminology such as brands, models, materials, and attributes. It supports translation between more than 100 language pairs (including bridged translations), especially Chinese-English, Chinese-multilingual, and English-multilingual translations. It supports language detection for 24 language directions. If you do not specify a source language, automatic detection is performed.
1394
+ * Marco MT is an e-commerce translation model trained on over 1 billion high-quality bilingual sentence pairs, continuously optimized for e-commerce-specific terminology such as brands, models, materials, and attributes. It supports translation between more than 100 language pairs (including bridged translations), especially Chinese-English, Chinese-to-multilingual, and English-to-multilingual translations. It supports language detection for 24 language directions. If you do not specify a source language, automatic detection is performed.
1366
1395
  *
1367
1396
  * @remarks
1368
1397
  * ## Product Introduction
1369
- * Marco MT is an e-commerce translation model trained on over 1 billion high-quality bilingual sentence pairs, continuously optimized for e-commerce-specific terminology such as brands, models, materials, and attributes. It supports translation between more than 100 language pairs (including bridged translations), especially Chinese-English, Chinese-multilingual, and English-multilingual translations. It supports language detection for 24 language directions. If you do not specify a source language, automatic detection is performed.
1398
+ * Marco MT is an e-commerce translation model trained on over 1 billion\\+ high-quality bilingual sentence pairs, continuously optimized for e-commerce-specific terminology such as brands, models, materials, and attributes. It supports translation between more than 100 language pairs (including bridged translations), especially Chinese-English, Chinese-to-multilingual, and English-to-multilingual translations. It supports language detection for 24 language directions. If you do not specify a source language, automatic detection is performed.
1370
1399
  * ## Common scenarios
1371
1400
  * - Product titles: Marco MT large model translation accurately translates phrases, keywords, and trending words in product titles into the target language, improving product visibility on e-commerce platforms.
1372
1401
  * - Product descriptions: Product descriptions are typically long with diverse and complex formatting. Marco large model translation supports long text translation and HTML format, delivering excellent translation quality and format preservation.
1373
1402
  * - Product attributes: Product attribute terms are short and may contain e-commerce-specific terms such as model numbers and parameters.
1374
1403
  * - Customer service conversations: In customer service scenarios, the model optimizes issues such as missing context and typos, and supports polite expressions for certain language directions.
1375
- * Marco MT large model translation can also be used for general-purpose translation scenarios such as office work, meetings, and daily conversations.
1404
+ * Marco MT large model translation can also be used for general translation scenarios such as office work, meetings, and daily conversations.
1376
1405
  * ## Features
1377
1406
  * - **Supported language directions** Marco MT large model translation supports translation between more than 100 languages and language detection for 23 languages. For specific language directions, refer to the language mapping table in section 5.6.
1378
1407
  * - **Ultra-low hallucination rate and high-speed inference** Marco MT large model translation is a large language model with preference alignment for translation scenarios. Compared with general-purpose large language models, it offers faster translation inference and an extremely low hallucination rate, making it especially suitable for large-scale invocation scenarios.
1379
1408
  * - **Supported text format types** Currently supports text and html text types.
1380
- * - **Translation intervention support** Supports custom translation results, including do-not-translate (ABC-ABC), specified translation (ABC-DEF), and no translation (ABC-empty value). This is commonly used for brand name protection scenarios. Simply pass the corresponding intervention glossary ID when calling the API to meet your translation needs across different scenarios. You can upload up to 100,000 intervention terms. Contact the platform for additional capacity.
1409
+ * - **Translation intervention support** Supports custom translation results, including do-not-translate (ABC-ABC), specified translation (ABC-DEF), and no translation (ABC-empty value). This is commonly used for brand name protection scenarios. Simply pass the corresponding intervention glossary ID when calling the API to meet your translation needs across different scenarios. You can upload up to 100,000 intervention terms. If you need more, contact the platform for assistance.
1381
1410
  * ## Translation quality comparison
1382
1411
  * | **Source text** | **Aidge translation** | **Other translation product 1** | **Other translation product 2** | **Aidge translation advantage** |
1383
1412
  * |----------|---------------|-----------------------|-----------------------|---------------------|
1384
1413
  * | 75mm 4Pin 0.38A GA81S2U 12V GTX 960 Cooling Fan for Zotac GTX960 Graphics Card Cooling Fan | 75mm 4Pin 0.38A GA81S2U 12V GTX 960, ventilador de enfriamiento para tarjeta gráfica Zotac GTX960. | Ventilador de refrigeración de 75mm 4Pin 0.38A GA81S2U 12V para la tarjeta gráfica Zotac GTX960 Ventilador de enfriamiento GTX 960. | Ventilador de refrigeración para tarjeta gráfica Zotac GTX960, 75mm, 4 pines, 0,38A, GA81S2U, 12V, GTX 960 | Clearer product subject |
1385
1414
  * | New Arrival Classic Style Luxury Brand 6 Hands Swiss Automatic Mechanical Men\\"s Business Steel Watch | Nueva llegada, reloj mecánico automático de lujo con 6 manecillas, estilo clásico, de acero para hombres de negocios | Nueva Llegada Reloj De Acero de Negocios para Hombre con Mecanismo Automático Suizo y 6 Agujas de Estilo Clásico de Marca de Lujo. | Reloj de acero de negocios para hombre, mecánico automático suizo, marca de lujo, estilo clásico, 6 manos, nueva llegada | More complete sentence structure, clearer expression, and more reasonable segmentation |
1386
- * | Men Key Bag Genuine Cow Leather Buckets Key Cases Pouch Zipper Keychain Auto Car Key Case Women Home Key Holder Wallet | Sac à clés pour hommes en cuir de vache véritable, étuis à clés, pochette à fermeture éclair, porte-clés, étui à clé de voiture, porte-clés pour femmes, organisateur de portefeuille | Porte-clés sac en cuir de vache véritable, étuis à clés en forme de seau, pochette à fermeture éclair, porte-clés auto pour voiture, étui à clés pour femmes, organisateur de clés de maison, portefeuille. | Hommes porte-clés en cuir de vache véritable sac/pochette fermature éclair porte-clés Auto voiture porte-clés femmes maison porte-clés organisateur portefeuille | Clearer and more accurate product subject expression as "key bag" rather than "keychain". Other translations may cause ambiguity about the product subject |
1415
+ * | Men Key Bag Genuine Cow Leather Buckets Key Cases Pouch Zipper Keychain Auto Car Key Case Women Home Key Holder Wallet | Sac à clés pour hommes en cuir de vache véritable, étuis à clés, pochette à fermeture éclair, porte-clés, étui à clé de voiture, porte-clés pour femmes, organisateur de portefeuille | Porte-clés sac en cuir de vache véritable, étuis à clés en forme de seau, pochette à fermeture éclair, porte-clés auto pour voiture, étui à clés pour femmes, organisateur de clés de maison, portefeuille. | Hommes porte-clés en cuir de vache véritable sac/pochette fermature éclair porte-clés Auto voiture porte-clés femmes maison porte-clés organisateur portefeuille | Clearer and more precise product subject expression as "key bag" rather than "keychain", avoiding ambiguity about the product type |
1387
1416
  *
1388
1417
  * @param tmpReq - TextTranslateRequest
1389
1418
  * @param runtime - runtime options for this request RuntimeOptions
@@ -1391,28 +1420,28 @@ export default class Client extends OpenApi {
1391
1420
  */
1392
1421
  textTranslateWithOptions(tmpReq: $_model.TextTranslateRequest, runtime: $dara.RuntimeOptions): Promise<$_model.TextTranslateResponse>;
1393
1422
  /**
1394
- * Marco MT is an e-commerce translation model trained on over 1 billion high-quality bilingual sentence pairs, continuously optimized for e-commerce-specific terminology such as brands, models, materials, and attributes. It supports translation between more than 100 language pairs (including bridged translations), especially Chinese-English, Chinese-multilingual, and English-multilingual translations. It supports language detection for 24 language directions. If you do not specify a source language, automatic detection is performed.
1423
+ * Marco MT is an e-commerce translation model trained on over 1 billion high-quality bilingual sentence pairs, continuously optimized for e-commerce-specific terminology such as brands, models, materials, and attributes. It supports translation between more than 100 language pairs (including bridged translations), especially Chinese-English, Chinese-to-multilingual, and English-to-multilingual translations. It supports language detection for 24 language directions. If you do not specify a source language, automatic detection is performed.
1395
1424
  *
1396
1425
  * @remarks
1397
1426
  * ## Product Introduction
1398
- * Marco MT is an e-commerce translation model trained on over 1 billion high-quality bilingual sentence pairs, continuously optimized for e-commerce-specific terminology such as brands, models, materials, and attributes. It supports translation between more than 100 language pairs (including bridged translations), especially Chinese-English, Chinese-multilingual, and English-multilingual translations. It supports language detection for 24 language directions. If you do not specify a source language, automatic detection is performed.
1427
+ * Marco MT is an e-commerce translation model trained on over 1 billion\\+ high-quality bilingual sentence pairs, continuously optimized for e-commerce-specific terminology such as brands, models, materials, and attributes. It supports translation between more than 100 language pairs (including bridged translations), especially Chinese-English, Chinese-to-multilingual, and English-to-multilingual translations. It supports language detection for 24 language directions. If you do not specify a source language, automatic detection is performed.
1399
1428
  * ## Common scenarios
1400
1429
  * - Product titles: Marco MT large model translation accurately translates phrases, keywords, and trending words in product titles into the target language, improving product visibility on e-commerce platforms.
1401
1430
  * - Product descriptions: Product descriptions are typically long with diverse and complex formatting. Marco large model translation supports long text translation and HTML format, delivering excellent translation quality and format preservation.
1402
1431
  * - Product attributes: Product attribute terms are short and may contain e-commerce-specific terms such as model numbers and parameters.
1403
1432
  * - Customer service conversations: In customer service scenarios, the model optimizes issues such as missing context and typos, and supports polite expressions for certain language directions.
1404
- * Marco MT large model translation can also be used for general-purpose translation scenarios such as office work, meetings, and daily conversations.
1433
+ * Marco MT large model translation can also be used for general translation scenarios such as office work, meetings, and daily conversations.
1405
1434
  * ## Features
1406
1435
  * - **Supported language directions** Marco MT large model translation supports translation between more than 100 languages and language detection for 23 languages. For specific language directions, refer to the language mapping table in section 5.6.
1407
1436
  * - **Ultra-low hallucination rate and high-speed inference** Marco MT large model translation is a large language model with preference alignment for translation scenarios. Compared with general-purpose large language models, it offers faster translation inference and an extremely low hallucination rate, making it especially suitable for large-scale invocation scenarios.
1408
1437
  * - **Supported text format types** Currently supports text and html text types.
1409
- * - **Translation intervention support** Supports custom translation results, including do-not-translate (ABC-ABC), specified translation (ABC-DEF), and no translation (ABC-empty value). This is commonly used for brand name protection scenarios. Simply pass the corresponding intervention glossary ID when calling the API to meet your translation needs across different scenarios. You can upload up to 100,000 intervention terms. Contact the platform for additional capacity.
1438
+ * - **Translation intervention support** Supports custom translation results, including do-not-translate (ABC-ABC), specified translation (ABC-DEF), and no translation (ABC-empty value). This is commonly used for brand name protection scenarios. Simply pass the corresponding intervention glossary ID when calling the API to meet your translation needs across different scenarios. You can upload up to 100,000 intervention terms. If you need more, contact the platform for assistance.
1410
1439
  * ## Translation quality comparison
1411
1440
  * | **Source text** | **Aidge translation** | **Other translation product 1** | **Other translation product 2** | **Aidge translation advantage** |
1412
1441
  * |----------|---------------|-----------------------|-----------------------|---------------------|
1413
1442
  * | 75mm 4Pin 0.38A GA81S2U 12V GTX 960 Cooling Fan for Zotac GTX960 Graphics Card Cooling Fan | 75mm 4Pin 0.38A GA81S2U 12V GTX 960, ventilador de enfriamiento para tarjeta gráfica Zotac GTX960. | Ventilador de refrigeración de 75mm 4Pin 0.38A GA81S2U 12V para la tarjeta gráfica Zotac GTX960 Ventilador de enfriamiento GTX 960. | Ventilador de refrigeración para tarjeta gráfica Zotac GTX960, 75mm, 4 pines, 0,38A, GA81S2U, 12V, GTX 960 | Clearer product subject |
1414
1443
  * | New Arrival Classic Style Luxury Brand 6 Hands Swiss Automatic Mechanical Men\\"s Business Steel Watch | Nueva llegada, reloj mecánico automático de lujo con 6 manecillas, estilo clásico, de acero para hombres de negocios | Nueva Llegada Reloj De Acero de Negocios para Hombre con Mecanismo Automático Suizo y 6 Agujas de Estilo Clásico de Marca de Lujo. | Reloj de acero de negocios para hombre, mecánico automático suizo, marca de lujo, estilo clásico, 6 manos, nueva llegada | More complete sentence structure, clearer expression, and more reasonable segmentation |
1415
- * | Men Key Bag Genuine Cow Leather Buckets Key Cases Pouch Zipper Keychain Auto Car Key Case Women Home Key Holder Wallet | Sac à clés pour hommes en cuir de vache véritable, étuis à clés, pochette à fermeture éclair, porte-clés, étui à clé de voiture, porte-clés pour femmes, organisateur de portefeuille | Porte-clés sac en cuir de vache véritable, étuis à clés en forme de seau, pochette à fermeture éclair, porte-clés auto pour voiture, étui à clés pour femmes, organisateur de clés de maison, portefeuille. | Hommes porte-clés en cuir de vache véritable sac/pochette fermature éclair porte-clés Auto voiture porte-clés femmes maison porte-clés organisateur portefeuille | Clearer and more accurate product subject expression as "key bag" rather than "keychain". Other translations may cause ambiguity about the product subject |
1444
+ * | Men Key Bag Genuine Cow Leather Buckets Key Cases Pouch Zipper Keychain Auto Car Key Case Women Home Key Holder Wallet | Sac à clés pour hommes en cuir de vache véritable, étuis à clés, pochette à fermeture éclair, porte-clés, étui à clé de voiture, porte-clés pour femmes, organisateur de portefeuille | Porte-clés sac en cuir de vache véritable, étuis à clés en forme de seau, pochette à fermeture éclair, porte-clés auto pour voiture, étui à clés pour femmes, organisateur de clés de maison, portefeuille. | Hommes porte-clés en cuir de vache véritable sac/pochette fermature éclair porte-clés Auto voiture porte-clés femmes maison porte-clés organisateur portefeuille | Clearer and more precise product subject expression as "key bag" rather than "keychain", avoiding ambiguity about the product type |
1416
1445
  *
1417
1446
  * @param request - TextTranslateRequest
1418
1447
  * @returns TextTranslateResponse
package/dist/client.js CHANGED
@@ -1267,18 +1267,12 @@ class Client extends openapi_core_1.default {
1267
1267
  return await this.imageRemoveWithOptions(request, runtime);
1268
1268
  }
1269
1269
  /**
1270
- * Translates images using the Pro edition, which is designed specifically for e-commerce images. This product integrates multimodal large model technology to achieve more accurate image understanding, significantly improve translation quality, and continuously expand and optimize multilingual translation capabilities. Supports more than 100 language directions (including bridged translations).
1270
+ * Translates text in e-commerce images using the Pro edition, which integrates multimodal foundation model technology for more accurate image understanding and significantly improved translation quality.
1271
1271
  *
1272
1272
  * @remarks
1273
- * ## Product Introduction
1274
- * The Image Translation Pro edition is designed specifically for e-commerce images. It integrates multimodal large model technology to achieve more accurate image understanding, significantly improve translation quality, and continuously expand and optimize multilingual translation capabilities. Supports more than 100 language directions (including bridged translations).
1275
- * ## Scenarios
1276
- * E-commerce product images, marketing images, and images for various other scenarios.
1277
- * ## Features
1278
- * - **Product subject protection**: Supports custom selection of whether to translate text on the product subject, helping you protect subject information from being translated, such as embedded information like product names.
1279
- * - **Post-translation editing**: Supports custom selection of whether to return layout information such as text position, font, and color. This can be used for secondary editing when integrated with an image editor. The editor SDK package is not yet available. Follow platform notifications for updates.
1280
- * - **Brand name protection**: Supports custom selection of whether to translate brand names on images, helping you protect brand name information from being translated.
1281
- * - **Translation intervention**: Supports custom translation results, including do-not-translate (ABC-ABC), specified translation (ABC-DEF), and no translation (ABC-empty value). This is commonly used for brand name protection scenarios. Simply pass the corresponding intervention glossary ID when calling the API to meet your translation needs in different scenarios. You can upload up to 100,000 intervention terms. Contact the platform if you need more.
1273
+ * ## Product Introduction.
1274
+ * ## Scenarios.
1275
+ * ## Features.
1282
1276
  *
1283
1277
  * @param request - ImageTranslationProRequest
1284
1278
  * @param runtime - runtime options for this request RuntimeOptions
@@ -1328,18 +1322,12 @@ class Client extends openapi_core_1.default {
1328
1322
  return $dara.cast(await this.callApi(params, req, runtime), new $_model.ImageTranslationProResponse({}));
1329
1323
  }
1330
1324
  /**
1331
- * Translates images using the Pro edition, which is designed specifically for e-commerce images. This product integrates multimodal large model technology to achieve more accurate image understanding, significantly improve translation quality, and continuously expand and optimize multilingual translation capabilities. Supports more than 100 language directions (including bridged translations).
1325
+ * Translates text in e-commerce images using the Pro edition, which integrates multimodal foundation model technology for more accurate image understanding and significantly improved translation quality.
1332
1326
  *
1333
1327
  * @remarks
1334
- * ## Product Introduction
1335
- * The Image Translation Pro edition is designed specifically for e-commerce images. It integrates multimodal large model technology to achieve more accurate image understanding, significantly improve translation quality, and continuously expand and optimize multilingual translation capabilities. Supports more than 100 language directions (including bridged translations).
1336
- * ## Scenarios
1337
- * E-commerce product images, marketing images, and images for various other scenarios.
1338
- * ## Features
1339
- * - **Product subject protection**: Supports custom selection of whether to translate text on the product subject, helping you protect subject information from being translated, such as embedded information like product names.
1340
- * - **Post-translation editing**: Supports custom selection of whether to return layout information such as text position, font, and color. This can be used for secondary editing when integrated with an image editor. The editor SDK package is not yet available. Follow platform notifications for updates.
1341
- * - **Brand name protection**: Supports custom selection of whether to translate brand names on images, helping you protect brand name information from being translated.
1342
- * - **Translation intervention**: Supports custom translation results, including do-not-translate (ABC-ABC), specified translation (ABC-DEF), and no translation (ABC-empty value). This is commonly used for brand name protection scenarios. Simply pass the corresponding intervention glossary ID when calling the API to meet your translation needs in different scenarios. You can upload up to 100,000 intervention terms. Contact the platform if you need more.
1328
+ * ## Product Introduction.
1329
+ * ## Scenarios.
1330
+ * ## Features.
1343
1331
  *
1344
1332
  * @param request - ImageTranslationProRequest
1345
1333
  * @returns ImageTranslationProResponse
@@ -1349,17 +1337,12 @@ class Client extends openapi_core_1.default {
1349
1337
  return await this.imageTranslationProWithOptions(request, runtime);
1350
1338
  }
1351
1339
  /**
1352
- * Image Translation is designed specifically for e-commerce images. It supports more than 100 language directions, accurately processes complex text layouts within images, and ensures that translated content matches the image content. This helps e-commerce platforms and developers easily achieve multilingual conversion and rendering of image content.
1340
+ * Translates text in images with support for over 100 language pairs (including bridging). This product is designed specifically for e-commerce images, accurately handling complex text layouts within images and ensuring that translated content matches the image context. It helps e-commerce platforms and developers easily achieve multilingual conversion and presentation of image content. The product also returns layer information such as text position, font, and color within images, facilitating integration with image editors for secondary editing of translation results.
1353
1341
  *
1354
1342
  * @remarks
1355
- * ## Product Introduction
1356
- * Image Translation is designed specifically for e-commerce images. It supports more than 100 language directions, accurately processes complex text layouts within images, and ensures that translated content matches the image content. This helps e-commerce platforms and developers easily achieve multilingual conversion and rendering of image content.
1357
- * ## Common scenarios
1358
- * E-commerce product images, marketing images, and images for various other scenarios.
1359
- * ## Functions and features
1360
- * - **Product subject information protection**: You can choose whether to translate text on the product subject. This helps protect subject information from being translated, such as embedded information like product names.
1361
- * - **Brand name protection**: You can choose whether to translate brand names on images. This helps protect brand name information from being translated.
1362
- * - **Translation intervention support**: You can customize translation results, including keeping text untranslated (ABC-ABC), specifying translations (ABC-DEF), or removing text (ABC-empty value). This is commonly used for brand name protection and similar scenarios. Pass the corresponding intervention glossary ID when calling the API to meet your translation needs in different scenarios. You can upload up to 100,000 intervention terms. If you need more, contact the platform for assistance.
1343
+ * # 1. Product Introduction.
1344
+ * # 2. Common scenarios.
1345
+ * # 3. Features.
1363
1346
  *
1364
1347
  * @param request - ImageTranslationStandardRequest
1365
1348
  * @param runtime - runtime options for this request RuntimeOptions
@@ -1386,6 +1369,9 @@ class Client extends openapi_core_1.default {
1386
1369
  if (!$dara.isNull(request.translatingBrandInTheProduct)) {
1387
1370
  query["TranslatingBrandInTheProduct"] = request.translatingBrandInTheProduct;
1388
1371
  }
1372
+ if (!$dara.isNull(request.useImageEditor)) {
1373
+ query["UseImageEditor"] = request.useImageEditor;
1374
+ }
1389
1375
  let req = new openapi_core_2.$OpenApiUtil.OpenApiRequest({
1390
1376
  query: openapi_core_2.OpenApiUtil.query(query),
1391
1377
  });
@@ -1403,17 +1389,12 @@ class Client extends openapi_core_1.default {
1403
1389
  return $dara.cast(await this.callApi(params, req, runtime), new $_model.ImageTranslationStandardResponse({}));
1404
1390
  }
1405
1391
  /**
1406
- * Image Translation is designed specifically for e-commerce images. It supports more than 100 language directions, accurately processes complex text layouts within images, and ensures that translated content matches the image content. This helps e-commerce platforms and developers easily achieve multilingual conversion and rendering of image content.
1392
+ * Translates text in images with support for over 100 language pairs (including bridging). This product is designed specifically for e-commerce images, accurately handling complex text layouts within images and ensuring that translated content matches the image context. It helps e-commerce platforms and developers easily achieve multilingual conversion and presentation of image content. The product also returns layer information such as text position, font, and color within images, facilitating integration with image editors for secondary editing of translation results.
1407
1393
  *
1408
1394
  * @remarks
1409
- * ## Product Introduction
1410
- * Image Translation is designed specifically for e-commerce images. It supports more than 100 language directions, accurately processes complex text layouts within images, and ensures that translated content matches the image content. This helps e-commerce platforms and developers easily achieve multilingual conversion and rendering of image content.
1411
- * ## Common scenarios
1412
- * E-commerce product images, marketing images, and images for various other scenarios.
1413
- * ## Functions and features
1414
- * - **Product subject information protection**: You can choose whether to translate text on the product subject. This helps protect subject information from being translated, such as embedded information like product names.
1415
- * - **Brand name protection**: You can choose whether to translate brand names on images. This helps protect brand name information from being translated.
1416
- * - **Translation intervention support**: You can customize translation results, including keeping text untranslated (ABC-ABC), specifying translations (ABC-DEF), or removing text (ABC-empty value). This is commonly used for brand name protection and similar scenarios. Pass the corresponding intervention glossary ID when calling the API to meet your translation needs in different scenarios. You can upload up to 100,000 intervention terms. If you need more, contact the platform for assistance.
1395
+ * # 1. Product Introduction.
1396
+ * # 2. Common scenarios.
1397
+ * # 3. Features.
1417
1398
  *
1418
1399
  * @param request - ImageTranslationStandardRequest
1419
1400
  * @returns ImageTranslationStandardResponse
@@ -1564,6 +1545,90 @@ class Client extends openapi_core_1.default {
1564
1545
  let runtime = new $dara.RuntimeOptions({});
1565
1546
  return await this.materialInspectionWithOptions(request, runtime);
1566
1547
  }
1548
+ /**
1549
+ * Detects and identifies products displayed on store shelves or floor stacks by combining a multimodal large language model (MLLM) with visual vector recall, targeting shelf and floor-stack inspection scenarios in offline retail and channel stores. The service first uses an MLLM to detect bounding boxes and preliminary names for each product in a store photo, then performs similarity recall against a customer-specific SKU vector library to exactly match each product to the customer\\"s own SKUs, and outputs per-product structured results that can be directly integrated with business systems. This is suitable for large-scale, high-concurrency visual recognition pipelines such as remote auditing of in-store displays by headquarters, SKU distribution verification, and display compliance inspection.
1550
+ *
1551
+ * @remarks
1552
+ * ## **Product Introduction**
1553
+ * Display detection is an intelligent store product display recognition capability built on a multimodal large language model (MLLM) combined with visual vector recall. It targets shelf and floor-stack display inspection scenarios in offline retail and channel stores. For store photos of shelves or floor stacks, the service first uses an MLLM to detect the bounding box and preliminary name for each product, then performs similarity recall against a customer-specific SKU vector library to exactly match each product to the customer\\"s own SKUs, and outputs per-product structured results that can be directly integrated with business systems. This is suitable for large-scale, high-concurrency visual recognition pipelines such as remote auditing of in-store displays by headquarters, SKU distribution verification, and display compliance inspection.
1554
+ * ## **Scenarios**
1555
+ * - **Shelf/floor-stack display recognition and inventory**: Identifies each product in a shelf or floor-stack image, matches it to the customer\\"s SKU library, and outputs a per-product list (product name + position + similarity score), replacing manual counting.
1556
+ *
1557
+ * - **Distribution verification/SKU compliance**: Verifies whether stores display specified SKUs as required by headquarters and whether out-of-stock or misplaced items exist, supporting batch automated verification during promotions or new product launches.
1558
+ *
1559
+ * - **Customer-specific SKU library**: Customers upload their own standard SKU images to build a dedicated vector library (isolated by `RagId`). During recognition, retrieval is performed only within that customer\\"s library, ensuring name accuracy and data isolation between customers.
1560
+ * ## **Features**
1561
+ * - **Two-stage detection + retrieval collaboration**: The MLLM detects each product\\"s bounding box and preliminary name across the entire image (semantic-level understanding, adapted for dense displays and partial occlusion). Then visual embedding vectors perform similarity retrieval within the customer\\"s SKU library, overriding the preliminary name with the top-1 precise SKU name to balance recall rate and name accuracy.
1562
+ *
1563
+ * - **Isolated retrieval with dedicated vector libraries**: A dedicated SKU vector library is maintained for each customer by `RagId`. Recognition retrieves only within the corresponding library, ensuring strict isolation between customers. Newly added or updated SKUs take effect in real time.
1564
+ *
1565
+ * - **Per-product structured output**: Output is unified as `Result.Items[]`, with each product independently providing a bounding box, recalled SKU name, SKU code, and similarity score. This facilitates direct integration with downstream inventory/verification systems and supports case-level manual review and traceability.
1566
+ *
1567
+ * - **Supported input formats**: Currently supports image URLs accessible via the public network or OSS. A single shelf or floor-stack image is sufficient for recognition, and the output structure is consistent.
1568
+ *
1569
+ * @param request - MerchandisePlacementDetectionRequest
1570
+ * @param runtime - runtime options for this request RuntimeOptions
1571
+ * @returns MerchandisePlacementDetectionResponse
1572
+ */
1573
+ async merchandisePlacementDetectionWithOptions(request, runtime) {
1574
+ request.validate();
1575
+ let query = {};
1576
+ if (!$dara.isNull(request.apiId)) {
1577
+ query["ApiId"] = request.apiId;
1578
+ }
1579
+ if (!$dara.isNull(request.imageUrl)) {
1580
+ query["ImageUrl"] = request.imageUrl;
1581
+ }
1582
+ if (!$dara.isNull(request.ragId)) {
1583
+ query["RagId"] = request.ragId;
1584
+ }
1585
+ if (!$dara.isNull(request.type)) {
1586
+ query["Type"] = request.type;
1587
+ }
1588
+ let req = new openapi_core_2.$OpenApiUtil.OpenApiRequest({
1589
+ query: openapi_core_2.OpenApiUtil.query(query),
1590
+ });
1591
+ let params = new openapi_core_2.$OpenApiUtil.Params({
1592
+ action: "MerchandisePlacementDetection",
1593
+ version: "2026-04-28",
1594
+ protocol: "HTTPS",
1595
+ pathname: "/",
1596
+ method: "POST",
1597
+ authType: "AK",
1598
+ style: "RPC",
1599
+ reqBodyType: "formData",
1600
+ bodyType: "json",
1601
+ });
1602
+ return $dara.cast(await this.callApi(params, req, runtime), new $_model.MerchandisePlacementDetectionResponse({}));
1603
+ }
1604
+ /**
1605
+ * Detects and identifies products displayed on store shelves or floor stacks by combining a multimodal large language model (MLLM) with visual vector recall, targeting shelf and floor-stack inspection scenarios in offline retail and channel stores. The service first uses an MLLM to detect bounding boxes and preliminary names for each product in a store photo, then performs similarity recall against a customer-specific SKU vector library to exactly match each product to the customer\\"s own SKUs, and outputs per-product structured results that can be directly integrated with business systems. This is suitable for large-scale, high-concurrency visual recognition pipelines such as remote auditing of in-store displays by headquarters, SKU distribution verification, and display compliance inspection.
1606
+ *
1607
+ * @remarks
1608
+ * ## **Product Introduction**
1609
+ * Display detection is an intelligent store product display recognition capability built on a multimodal large language model (MLLM) combined with visual vector recall. It targets shelf and floor-stack display inspection scenarios in offline retail and channel stores. For store photos of shelves or floor stacks, the service first uses an MLLM to detect the bounding box and preliminary name for each product, then performs similarity recall against a customer-specific SKU vector library to exactly match each product to the customer\\"s own SKUs, and outputs per-product structured results that can be directly integrated with business systems. This is suitable for large-scale, high-concurrency visual recognition pipelines such as remote auditing of in-store displays by headquarters, SKU distribution verification, and display compliance inspection.
1610
+ * ## **Scenarios**
1611
+ * - **Shelf/floor-stack display recognition and inventory**: Identifies each product in a shelf or floor-stack image, matches it to the customer\\"s SKU library, and outputs a per-product list (product name + position + similarity score), replacing manual counting.
1612
+ *
1613
+ * - **Distribution verification/SKU compliance**: Verifies whether stores display specified SKUs as required by headquarters and whether out-of-stock or misplaced items exist, supporting batch automated verification during promotions or new product launches.
1614
+ *
1615
+ * - **Customer-specific SKU library**: Customers upload their own standard SKU images to build a dedicated vector library (isolated by `RagId`). During recognition, retrieval is performed only within that customer\\"s library, ensuring name accuracy and data isolation between customers.
1616
+ * ## **Features**
1617
+ * - **Two-stage detection + retrieval collaboration**: The MLLM detects each product\\"s bounding box and preliminary name across the entire image (semantic-level understanding, adapted for dense displays and partial occlusion). Then visual embedding vectors perform similarity retrieval within the customer\\"s SKU library, overriding the preliminary name with the top-1 precise SKU name to balance recall rate and name accuracy.
1618
+ *
1619
+ * - **Isolated retrieval with dedicated vector libraries**: A dedicated SKU vector library is maintained for each customer by `RagId`. Recognition retrieves only within the corresponding library, ensuring strict isolation between customers. Newly added or updated SKUs take effect in real time.
1620
+ *
1621
+ * - **Per-product structured output**: Output is unified as `Result.Items[]`, with each product independently providing a bounding box, recalled SKU name, SKU code, and similarity score. This facilitates direct integration with downstream inventory/verification systems and supports case-level manual review and traceability.
1622
+ *
1623
+ * - **Supported input formats**: Currently supports image URLs accessible via the public network or OSS. A single shelf or floor-stack image is sufficient for recognition, and the output structure is consistent.
1624
+ *
1625
+ * @param request - MerchandisePlacementDetectionRequest
1626
+ * @returns MerchandisePlacementDetectionResponse
1627
+ */
1628
+ async merchandisePlacementDetection(request) {
1629
+ let runtime = new $dara.RuntimeOptions({});
1630
+ return await this.merchandisePlacementDetectionWithOptions(request, runtime);
1631
+ }
1567
1632
  /**
1568
1633
  * An intelligent logistics parcel auditing product built on the synergy of Multimodal Large Language Models (MLLM) and specialized vision algorithms, designed for automated compliance review in the "piece-weight-dimension" stage of e-commerce logistics. The product performs structured auditing across multiple dimensions including bounding box validity, bounding box fit accuracy, and foreign object interference on parcels placed on scanning platforms. It supports different hardware acquisition scenarios such as white background boards and green background boards, and outputs Boolean audit conclusions with Chinese reason descriptions that can be directly integrated into business systems. It is suitable for large-scale, high-concurrency inbound quality inspection pipelines.
1569
1634
  *
@@ -1637,10 +1702,10 @@ class Client extends openapi_core_1.default {
1637
1702
  return await this.packageWeightSizeCheckWithOptions(request, runtime);
1638
1703
  }
1639
1704
  /**
1640
- * API name on the POP gateway: QueryAsyncTaskResult.
1705
+ * Queries the result of an asynchronous task. The API name on the POP gateway is QueryAsyncTaskResult.
1641
1706
  *
1642
1707
  * @remarks
1643
- * API name on the POP gateway: QueryAsyncTaskResult.
1708
+ * The API name on the POP gateway is QueryAsyncTaskResult.
1644
1709
  *
1645
1710
  * @param request - QueryAsyncTaskResultRequest
1646
1711
  * @param runtime - runtime options for this request RuntimeOptions
@@ -1669,10 +1734,10 @@ class Client extends openapi_core_1.default {
1669
1734
  return $dara.cast(await this.callApi(params, req, runtime), new $_model.QueryAsyncTaskResultResponse({}));
1670
1735
  }
1671
1736
  /**
1672
- * API name on the POP gateway: QueryAsyncTaskResult.
1737
+ * Queries the result of an asynchronous task. The API name on the POP gateway is QueryAsyncTaskResult.
1673
1738
  *
1674
1739
  * @remarks
1675
- * API name on the POP gateway: QueryAsyncTaskResult.
1740
+ * The API name on the POP gateway is QueryAsyncTaskResult.
1676
1741
  *
1677
1742
  * @param request - QueryAsyncTaskResultRequest
1678
1743
  * @returns QueryAsyncTaskResultResponse
@@ -2124,28 +2189,28 @@ class Client extends openapi_core_1.default {
2124
2189
  return await this.textCorrectWithOptions(request, runtime);
2125
2190
  }
2126
2191
  /**
2127
- * Marco MT is an e-commerce translation model trained on over 1 billion high-quality bilingual sentence pairs, continuously optimized for e-commerce-specific terminology such as brands, models, materials, and attributes. It supports translation between more than 100 language pairs (including bridged translations), especially Chinese-English, Chinese-multilingual, and English-multilingual translations. It supports language detection for 24 language directions. If you do not specify a source language, automatic detection is performed.
2192
+ * Marco MT is an e-commerce translation model trained on over 1 billion high-quality bilingual sentence pairs, continuously optimized for e-commerce-specific terminology such as brands, models, materials, and attributes. It supports translation between more than 100 language pairs (including bridged translations), especially Chinese-English, Chinese-to-multilingual, and English-to-multilingual translations. It supports language detection for 24 language directions. If you do not specify a source language, automatic detection is performed.
2128
2193
  *
2129
2194
  * @remarks
2130
2195
  * ## Product Introduction
2131
- * Marco MT is an e-commerce translation model trained on over 1 billion high-quality bilingual sentence pairs, continuously optimized for e-commerce-specific terminology such as brands, models, materials, and attributes. It supports translation between more than 100 language pairs (including bridged translations), especially Chinese-English, Chinese-multilingual, and English-multilingual translations. It supports language detection for 24 language directions. If you do not specify a source language, automatic detection is performed.
2196
+ * Marco MT is an e-commerce translation model trained on over 1 billion\\+ high-quality bilingual sentence pairs, continuously optimized for e-commerce-specific terminology such as brands, models, materials, and attributes. It supports translation between more than 100 language pairs (including bridged translations), especially Chinese-English, Chinese-to-multilingual, and English-to-multilingual translations. It supports language detection for 24 language directions. If you do not specify a source language, automatic detection is performed.
2132
2197
  * ## Common scenarios
2133
2198
  * - Product titles: Marco MT large model translation accurately translates phrases, keywords, and trending words in product titles into the target language, improving product visibility on e-commerce platforms.
2134
2199
  * - Product descriptions: Product descriptions are typically long with diverse and complex formatting. Marco large model translation supports long text translation and HTML format, delivering excellent translation quality and format preservation.
2135
2200
  * - Product attributes: Product attribute terms are short and may contain e-commerce-specific terms such as model numbers and parameters.
2136
2201
  * - Customer service conversations: In customer service scenarios, the model optimizes issues such as missing context and typos, and supports polite expressions for certain language directions.
2137
- * Marco MT large model translation can also be used for general-purpose translation scenarios such as office work, meetings, and daily conversations.
2202
+ * Marco MT large model translation can also be used for general translation scenarios such as office work, meetings, and daily conversations.
2138
2203
  * ## Features
2139
2204
  * - **Supported language directions** Marco MT large model translation supports translation between more than 100 languages and language detection for 23 languages. For specific language directions, refer to the language mapping table in section 5.6.
2140
2205
  * - **Ultra-low hallucination rate and high-speed inference** Marco MT large model translation is a large language model with preference alignment for translation scenarios. Compared with general-purpose large language models, it offers faster translation inference and an extremely low hallucination rate, making it especially suitable for large-scale invocation scenarios.
2141
2206
  * - **Supported text format types** Currently supports text and html text types.
2142
- * - **Translation intervention support** Supports custom translation results, including do-not-translate (ABC-ABC), specified translation (ABC-DEF), and no translation (ABC-empty value). This is commonly used for brand name protection scenarios. Simply pass the corresponding intervention glossary ID when calling the API to meet your translation needs across different scenarios. You can upload up to 100,000 intervention terms. Contact the platform for additional capacity.
2207
+ * - **Translation intervention support** Supports custom translation results, including do-not-translate (ABC-ABC), specified translation (ABC-DEF), and no translation (ABC-empty value). This is commonly used for brand name protection scenarios. Simply pass the corresponding intervention glossary ID when calling the API to meet your translation needs across different scenarios. You can upload up to 100,000 intervention terms. If you need more, contact the platform for assistance.
2143
2208
  * ## Translation quality comparison
2144
2209
  * | **Source text** | **Aidge translation** | **Other translation product 1** | **Other translation product 2** | **Aidge translation advantage** |
2145
2210
  * |----------|---------------|-----------------------|-----------------------|---------------------|
2146
2211
  * | 75mm 4Pin 0.38A GA81S2U 12V GTX 960 Cooling Fan for Zotac GTX960 Graphics Card Cooling Fan | 75mm 4Pin 0.38A GA81S2U 12V GTX 960, ventilador de enfriamiento para tarjeta gráfica Zotac GTX960. | Ventilador de refrigeración de 75mm 4Pin 0.38A GA81S2U 12V para la tarjeta gráfica Zotac GTX960 Ventilador de enfriamiento GTX 960. | Ventilador de refrigeración para tarjeta gráfica Zotac GTX960, 75mm, 4 pines, 0,38A, GA81S2U, 12V, GTX 960 | Clearer product subject |
2147
2212
  * | New Arrival Classic Style Luxury Brand 6 Hands Swiss Automatic Mechanical Men\\"s Business Steel Watch | Nueva llegada, reloj mecánico automático de lujo con 6 manecillas, estilo clásico, de acero para hombres de negocios | Nueva Llegada Reloj De Acero de Negocios para Hombre con Mecanismo Automático Suizo y 6 Agujas de Estilo Clásico de Marca de Lujo. | Reloj de acero de negocios para hombre, mecánico automático suizo, marca de lujo, estilo clásico, 6 manos, nueva llegada | More complete sentence structure, clearer expression, and more reasonable segmentation |
2148
- * | Men Key Bag Genuine Cow Leather Buckets Key Cases Pouch Zipper Keychain Auto Car Key Case Women Home Key Holder Wallet | Sac à clés pour hommes en cuir de vache véritable, étuis à clés, pochette à fermeture éclair, porte-clés, étui à clé de voiture, porte-clés pour femmes, organisateur de portefeuille | Porte-clés sac en cuir de vache véritable, étuis à clés en forme de seau, pochette à fermeture éclair, porte-clés auto pour voiture, étui à clés pour femmes, organisateur de clés de maison, portefeuille. | Hommes porte-clés en cuir de vache véritable sac/pochette fermature éclair porte-clés Auto voiture porte-clés femmes maison porte-clés organisateur portefeuille | Clearer and more accurate product subject expression as "key bag" rather than "keychain". Other translations may cause ambiguity about the product subject |
2213
+ * | Men Key Bag Genuine Cow Leather Buckets Key Cases Pouch Zipper Keychain Auto Car Key Case Women Home Key Holder Wallet | Sac à clés pour hommes en cuir de vache véritable, étuis à clés, pochette à fermeture éclair, porte-clés, étui à clé de voiture, porte-clés pour femmes, organisateur de portefeuille | Porte-clés sac en cuir de vache véritable, étuis à clés en forme de seau, pochette à fermeture éclair, porte-clés auto pour voiture, étui à clés pour femmes, organisateur de clés de maison, portefeuille. | Hommes porte-clés en cuir de vache véritable sac/pochette fermature éclair porte-clés Auto voiture porte-clés femmes maison porte-clés organisateur portefeuille | Clearer and more precise product subject expression as "key bag" rather than "keychain", avoiding ambiguity about the product type |
2149
2214
  *
2150
2215
  * @param tmpReq - TextTranslateRequest
2151
2216
  * @param runtime - runtime options for this request RuntimeOptions
@@ -2197,28 +2262,28 @@ class Client extends openapi_core_1.default {
2197
2262
  return $dara.cast(await this.callApi(params, req, runtime), new $_model.TextTranslateResponse({}));
2198
2263
  }
2199
2264
  /**
2200
- * Marco MT is an e-commerce translation model trained on over 1 billion high-quality bilingual sentence pairs, continuously optimized for e-commerce-specific terminology such as brands, models, materials, and attributes. It supports translation between more than 100 language pairs (including bridged translations), especially Chinese-English, Chinese-multilingual, and English-multilingual translations. It supports language detection for 24 language directions. If you do not specify a source language, automatic detection is performed.
2265
+ * Marco MT is an e-commerce translation model trained on over 1 billion high-quality bilingual sentence pairs, continuously optimized for e-commerce-specific terminology such as brands, models, materials, and attributes. It supports translation between more than 100 language pairs (including bridged translations), especially Chinese-English, Chinese-to-multilingual, and English-to-multilingual translations. It supports language detection for 24 language directions. If you do not specify a source language, automatic detection is performed.
2201
2266
  *
2202
2267
  * @remarks
2203
2268
  * ## Product Introduction
2204
- * Marco MT is an e-commerce translation model trained on over 1 billion high-quality bilingual sentence pairs, continuously optimized for e-commerce-specific terminology such as brands, models, materials, and attributes. It supports translation between more than 100 language pairs (including bridged translations), especially Chinese-English, Chinese-multilingual, and English-multilingual translations. It supports language detection for 24 language directions. If you do not specify a source language, automatic detection is performed.
2269
+ * Marco MT is an e-commerce translation model trained on over 1 billion\\+ high-quality bilingual sentence pairs, continuously optimized for e-commerce-specific terminology such as brands, models, materials, and attributes. It supports translation between more than 100 language pairs (including bridged translations), especially Chinese-English, Chinese-to-multilingual, and English-to-multilingual translations. It supports language detection for 24 language directions. If you do not specify a source language, automatic detection is performed.
2205
2270
  * ## Common scenarios
2206
2271
  * - Product titles: Marco MT large model translation accurately translates phrases, keywords, and trending words in product titles into the target language, improving product visibility on e-commerce platforms.
2207
2272
  * - Product descriptions: Product descriptions are typically long with diverse and complex formatting. Marco large model translation supports long text translation and HTML format, delivering excellent translation quality and format preservation.
2208
2273
  * - Product attributes: Product attribute terms are short and may contain e-commerce-specific terms such as model numbers and parameters.
2209
2274
  * - Customer service conversations: In customer service scenarios, the model optimizes issues such as missing context and typos, and supports polite expressions for certain language directions.
2210
- * Marco MT large model translation can also be used for general-purpose translation scenarios such as office work, meetings, and daily conversations.
2275
+ * Marco MT large model translation can also be used for general translation scenarios such as office work, meetings, and daily conversations.
2211
2276
  * ## Features
2212
2277
  * - **Supported language directions** Marco MT large model translation supports translation between more than 100 languages and language detection for 23 languages. For specific language directions, refer to the language mapping table in section 5.6.
2213
2278
  * - **Ultra-low hallucination rate and high-speed inference** Marco MT large model translation is a large language model with preference alignment for translation scenarios. Compared with general-purpose large language models, it offers faster translation inference and an extremely low hallucination rate, making it especially suitable for large-scale invocation scenarios.
2214
2279
  * - **Supported text format types** Currently supports text and html text types.
2215
- * - **Translation intervention support** Supports custom translation results, including do-not-translate (ABC-ABC), specified translation (ABC-DEF), and no translation (ABC-empty value). This is commonly used for brand name protection scenarios. Simply pass the corresponding intervention glossary ID when calling the API to meet your translation needs across different scenarios. You can upload up to 100,000 intervention terms. Contact the platform for additional capacity.
2280
+ * - **Translation intervention support** Supports custom translation results, including do-not-translate (ABC-ABC), specified translation (ABC-DEF), and no translation (ABC-empty value). This is commonly used for brand name protection scenarios. Simply pass the corresponding intervention glossary ID when calling the API to meet your translation needs across different scenarios. You can upload up to 100,000 intervention terms. If you need more, contact the platform for assistance.
2216
2281
  * ## Translation quality comparison
2217
2282
  * | **Source text** | **Aidge translation** | **Other translation product 1** | **Other translation product 2** | **Aidge translation advantage** |
2218
2283
  * |----------|---------------|-----------------------|-----------------------|---------------------|
2219
2284
  * | 75mm 4Pin 0.38A GA81S2U 12V GTX 960 Cooling Fan for Zotac GTX960 Graphics Card Cooling Fan | 75mm 4Pin 0.38A GA81S2U 12V GTX 960, ventilador de enfriamiento para tarjeta gráfica Zotac GTX960. | Ventilador de refrigeración de 75mm 4Pin 0.38A GA81S2U 12V para la tarjeta gráfica Zotac GTX960 Ventilador de enfriamiento GTX 960. | Ventilador de refrigeración para tarjeta gráfica Zotac GTX960, 75mm, 4 pines, 0,38A, GA81S2U, 12V, GTX 960 | Clearer product subject |
2220
2285
  * | New Arrival Classic Style Luxury Brand 6 Hands Swiss Automatic Mechanical Men\\"s Business Steel Watch | Nueva llegada, reloj mecánico automático de lujo con 6 manecillas, estilo clásico, de acero para hombres de negocios | Nueva Llegada Reloj De Acero de Negocios para Hombre con Mecanismo Automático Suizo y 6 Agujas de Estilo Clásico de Marca de Lujo. | Reloj de acero de negocios para hombre, mecánico automático suizo, marca de lujo, estilo clásico, 6 manos, nueva llegada | More complete sentence structure, clearer expression, and more reasonable segmentation |
2221
- * | Men Key Bag Genuine Cow Leather Buckets Key Cases Pouch Zipper Keychain Auto Car Key Case Women Home Key Holder Wallet | Sac à clés pour hommes en cuir de vache véritable, étuis à clés, pochette à fermeture éclair, porte-clés, étui à clé de voiture, porte-clés pour femmes, organisateur de portefeuille | Porte-clés sac en cuir de vache véritable, étuis à clés en forme de seau, pochette à fermeture éclair, porte-clés auto pour voiture, étui à clés pour femmes, organisateur de clés de maison, portefeuille. | Hommes porte-clés en cuir de vache véritable sac/pochette fermature éclair porte-clés Auto voiture porte-clés femmes maison porte-clés organisateur portefeuille | Clearer and more accurate product subject expression as "key bag" rather than "keychain". Other translations may cause ambiguity about the product subject |
2286
+ * | Men Key Bag Genuine Cow Leather Buckets Key Cases Pouch Zipper Keychain Auto Car Key Case Women Home Key Holder Wallet | Sac à clés pour hommes en cuir de vache véritable, étuis à clés, pochette à fermeture éclair, porte-clés, étui à clé de voiture, porte-clés pour femmes, organisateur de portefeuille | Porte-clés sac en cuir de vache véritable, étuis à clés en forme de seau, pochette à fermeture éclair, porte-clés auto pour voiture, étui à clés pour femmes, organisateur de clés de maison, portefeuille. | Hommes porte-clés en cuir de vache véritable sac/pochette fermature éclair porte-clés Auto voiture porte-clés femmes maison porte-clés organisateur portefeuille | Clearer and more precise product subject expression as "key bag" rather than "keychain", avoiding ambiguity about the product type |
2222
2287
  *
2223
2288
  * @param request - TextTranslateRequest
2224
2289
  * @returns TextTranslateResponse