Merge branch 'ReleasePreparation'

Author: vderyushev

Examples/ApiExamples/Java/pom.xml

@@ -54,9 +54,15 @@
         <dependency>
             <groupId>com.aspose</groupId>
             <artifactId>aspose-words</artifactId>
-            <version>24.10</version>
+            <version>25.1</version>
             <classifier>jdk17</classifier>
         </dependency>
+        <dependency>
+            <groupId>com.aspose</groupId>
+            <artifactId>aspose-words</artifactId>
+            <version>25.1</version>
+            <classifier>shaping-harfbuzz-plugin</classifier>
+        </dependency>
         <dependency>
             <groupId>com.aspose</groupId>
             <artifactId>aspose-barcode</artifactId>

Examples/ApiExamples/Java/src/main/java/Examples/ExAI.java

@@ -0,0 +1,75 @@
+package Examples;
+
+// Copyright (c) 2001-2024 Aspose Pty Ltd. All Rights Reserved.
+//
+// This file is part of Aspose.Words. The source code in this file
+// is only intended as a supplement to the documentation, and is provided
+// "as is", without warranty of any kind, either expressed or implied.
+//////////////////////////////////////////////////////////////////////////
+
+import com.aspose.words.*;
+import org.testng.annotations.Test;
+
+@Test
+public class ExAI extends ApiExampleBase
+{
+    @Test (enabled = false, description = "This test should be run manually to manage API requests amount")
+    public void aiSummarize() throws Exception
+    {
+        //ExStart:AiSummarize
+        //GistId:72d57eeddb7fb342fd51b26e5fcf9642
+        //ExFor:GoogleAiModel
+        //ExFor:OpenAiModel
+        //ExFor:OpenAiModel.WithOrganization(String)
+        //ExFor:OpenAiModel.WithProject(String)
+        //ExFor:IAiModelText
+        //ExFor:IAiModelText.Summarize(Document, SummarizeOptions)
+        //ExFor:IAiModelText.Summarize(Document[], SummarizeOptions)
+        //ExFor:SummarizeOptions
+        //ExFor:SummarizeOptions.#ctor
+        //ExFor:SummarizeOptions.SummaryLength
+        //ExFor:SummaryLength
+        //ExFor:AiModel
+        //ExFor:AiModel.Create(AiModelType)
+        //ExFor:AiModel.WithApiKey(String)
+        //ExFor:AiModelType
+        //ExSummary:Shows how to summarize text using OpenAI and Google models.
+        Document firstDoc = new Document(getMyDir() + "Big document.docx");
+        Document secondDoc = new Document(getMyDir() + "Document.docx");
+
+        String apiKey = System.getenv("API_KEY");
+        // Use OpenAI or Google generative language models.
+        IAiModelText model = ((OpenAiModel)AiModel.create(AiModelType.GPT_4_O_MINI).withApiKey(apiKey)).withOrganization("Organization").withProject("Project");
+
+        SummarizeOptions options = new SummarizeOptions();
+        options.setSummaryLength(SummaryLength.SHORT);
+        Document oneDocumentSummary = model.summarize(firstDoc, options);
+        oneDocumentSummary.save(getArtifactsDir() + "AI.AiSummarize.One.docx");
+
+        options = new SummarizeOptions();
+        options.setSummaryLength(SummaryLength.LONG);
+        Document multiDocumentSummary = model.summarize(new Document[] { firstDoc, secondDoc }, options);
+        multiDocumentSummary.save(getArtifactsDir() + "AI.AiSummarize.Multi.docx");
+        //ExEnd:AiSummarize
+    }
+
+    @Test (enabled = false, description = "This test should be run manually to manage API requests amount")
+    public void aiTranslate() throws Exception
+    {
+        //ExStart:AiTranslate
+        //GistId:93fefe5344a8337b931d0fed5c028225
+        //ExFor:IAiModelText.Translate(Document, AI.Language)
+        //ExFor:AI.Language
+        //ExSummary:Shows how to translate text using Google models.
+        Document doc = new Document(getMyDir() + "Document.docx");
+
+        String apiKey = System.getenv("API_KEY");
+        // Use Google generative language models.
+        IAiModelText model = (IAiModelText)AiModel.create(AiModelType.GEMINI_15_FLASH).withApiKey(apiKey);
+
+        Document translatedDoc = model.translate(doc, Language.ARABIC);
+        translatedDoc.save(getArtifactsDir() + "AI.AiTranslate.docx");
+        //ExEnd:AiTranslate
+    }
+}
+