feat: add support for ai translate strings (#360)

Author: andreichirila0712

src/main/java/com/crowdin/client/ai/AIApi.java

@@ -587,9 +587,24 @@ public ResponseList<AiSupportedModel> listSupportedAiProviderModels(Long userId,
         return AiSupportedModelResponseList.to(responseList);
     }
 
+    /**
+     * @param userId user identifier
+     * @param request AiTranslateRequest
+     * @return translated strings
+     * @see <ul>
+     * <li><a href="https://developer.crowdin.com/api/v2/#tag/AI/operation/api.users.ai.translate.strings.post" target="_blank"><b>API Documentation</b></a></li>
+     * <li><a href="https://developer.crowdin.com/enterprise/api/v2/#tag/AI/operation/api.ai.translate.strings.post" target="_blank"><b>Enterprise API Documentation</b></a></li>
+     * </ul>
+     */
+    public ResponseObject<AiTranslate> aiTranslateStrings(Long userId, AiTranslateRequest request) {
+        String url = getAIPath(userId, "ai/translate");
+        AiTranslateResponse response = this.httpClient.post(url, request, new HttpRequestConfig(), AiTranslateResponse.class);
+
+        return ResponseObject.of(response.getData());
+    }
+
     private String getAIPath(Long userId, String path) {
         return userId != null ? String.format("%s/users/%d/%s", this.url, userId, path) : String.format("%s/%s", this.url, path);
     }
-
 }
 

src/main/java/com/crowdin/client/ai/model/AiTranslate.java

@@ -0,0 +1,12 @@
+package com.crowdin.client.ai.model;
+
+import lombok.Data;
+
+import java.util.List;
+
+@Data
+public class AiTranslate {
+    private String sourceLanguageId;
+    private String targetLanguageId;
+    private List<String> translations;
+}

src/main/java/com/crowdin/client/ai/model/AiTranslateRequest.java

@@ -0,0 +1,19 @@
+package com.crowdin.client.ai.model;
+
+import lombok.Data;
+
+import java.util.List;
+
+@Data
+public class AiTranslateRequest {
+    private List<String> strings;
+    private String sourceLanguageId;
+    private String targetLanguageId;
+    private List<Long> tmIds;
+    private List<Long> glossaryIds;
+    private Long aiPromptId;
+    private Long aiProviderId;
+    private String aiModelId;
+    private List<String> instructions;
+    private List<Long> attachmentIds;
+}

src/main/java/com/crowdin/client/ai/model/AiTranslateResponse.java

@@ -0,0 +1,8 @@
+package com.crowdin.client.ai.model;
+
+import lombok.Data;
+
+@Data
+public class AiTranslateResponse {
+    private AiTranslate data;
+}

src/test/java/com/crowdin/client/ai/AIApiTest.java

@@ -66,6 +66,7 @@ public class AIApiTest extends TestClient {
     private static final String AI_PROMPT_COMPLETION_DOWNLOAD = "%s/users/%d/ai/prompts/%d/completions/%s/download";
     private static final String PROXY_CHAT = "%s/users/%d/ai/providers/%d/chat/completions";
     private static final String LIST_SUPPORTED_AI_PROVIDER_MODELS = "%s/users/%d/ai/providers/supported-models";
+    private static final String AI_TRANSLATE_STRING = "%s/users/%d/ai/translate";
 
     @Override
     public List<RequestMock> getMocks() {
@@ -106,7 +107,8 @@ public List<RequestMock> getMocks() {
             RequestMock.build(String.format(AI_PROMPT, this.url, userId, aiPromptId), HttpDelete.METHOD_NAME),
             RequestMock.build(String.format(AI_PROMPT, this.url, userId, aiPromptId), HttpPatch.METHOD_NAME, "api/ai/editPromptRequest.json", "api/ai/promptResponse.json"),
             RequestMock.build(String.format(PROXY_CHAT, this.url, userId, aiPromptId), HttpPost.METHOD_NAME, "api/ai/proxyChatCompletionRequest.json", "api/ai/proxyChatCompletionResponse.json"),
-            RequestMock.build(String.format(LIST_SUPPORTED_AI_PROVIDER_MODELS, this.url, userId), HttpGet.METHOD_NAME, "api/ai/listSupportedAiProviderModels.json")
+            RequestMock.build(String.format(LIST_SUPPORTED_AI_PROVIDER_MODELS, this.url, userId), HttpGet.METHOD_NAME, "api/ai/listSupportedAiProviderModels.json"),
+            RequestMock.build(String.format(AI_TRANSLATE_STRING, this.url, userId), HttpPost.METHOD_NAME, "api/ai/aiTranslateRequest.json", "api/ai/aiTranslateResponse.json")
         );
     }
 
@@ -531,4 +533,25 @@ public void listSupportedAiProviderModelsTest() {
         assertTrue(response.getData().get(0).getData().getModalities().getOutput().getImage());
         assertEquals(0.1, response.getData().get(0).getData().getPrice().getInput());
     }
+
+    @Test
+    public void aiTranslateStringsTest() {
+        AiTranslateRequest request = new AiTranslateRequest();
+        request.setStrings(Collections.singletonList("Some text to translate!"));
+        request.setSourceLanguageId("en");
+        request.setTargetLanguageId("uk");
+        request.setTmIds(Collections.singletonList(123L));
+        request.setGlossaryIds(Collections.singletonList(456L));
+        request.setAiPromptId(789L);
+        request.setAiProviderId(12L);
+        request.setAiModelId("gpt-4.1");
+        request.setInstructions(Collections.singletonList("Keep a formal tone"));
+        request.setAttachmentIds(Collections.singletonList(123L));
+        ResponseObject<AiTranslate> response = this.getAiApi().aiTranslateStrings(userId, request);
+
+        assertEquals("en", response.getData().getSourceLanguageId());
+        assertEquals("uk", response.getData().getTargetLanguageId());
+        assertEquals(2, response.getData().getTranslations().size());
+        assertEquals("Перекладений текст 1", response.getData().getTranslations().get(0));
+    }
 }

src/test/resources/api/ai/aiTranslateRequest.json

@@ -0,0 +1,22 @@
+{
+  "strings": [
+    "Some text to translate!"
+  ],
+  "sourceLanguageId": "en",
+  "targetLanguageId": "uk",
+  "tmIds": [
+    123
+  ],
+  "glossaryIds": [
+    456
+  ],
+  "aiPromptId": 789,
+  "aiProviderId": 12,
+  "aiModelId": "gpt-4.1",
+  "instructions": [
+    "Keep a formal tone"
+  ],
+  "attachmentIds": [
+    123
+  ]
+}

src/test/resources/api/ai/aiTranslateResponse.json

@@ -0,0 +1,10 @@
+{
+  "data": {
+    "sourceLanguageId": "en",
+    "targetLanguageId": "uk",
+    "translations": [
+      "Перекладений текст 1",
+      "Перекладений текст 2"
+    ]
+  }
+}