Merge branch 'feat/seededit' into 'integration_2025-07-17_1012625778946'

feat: [development task] ark runtime (1462278)

See merge request iaasng/volcengine-java-sdk!576

Author: BitsAdmin

volcengine-java-sdk-ark-runtime/src/main/java/com/volcengine/ark/runtime/model/images/generation/GenerateImagesRequest.java

@@ -1,9 +1,6 @@
 package com.volcengine.ark.runtime.model.images.generation;
 
 import com.fasterxml.jackson.annotation.JsonProperty;
-import com.volcengine.ark.runtime.model.content.generation.CreateContentGenerationTaskRequest;
-
-import java.util.List;
 
 public class GenerateImagesRequest {
 
@@ -13,6 +10,9 @@ public class GenerateImagesRequest {
     @JsonProperty("prompt")
     private String prompt;
 
+    @JsonProperty("image")
+    private String image;
+
     @JsonProperty("response_format")
     private String responseFormat;
 
@@ -28,12 +28,16 @@ public class GenerateImagesRequest {
     @JsonProperty("watermark")
     private Boolean watermark;
 
+    @JsonProperty("optimize_prompt")
+    private Boolean optimizePrompt;
+
     public GenerateImagesRequest() {
     }
 
-    public GenerateImagesRequest(String model, String prompt, String responseFormat, Integer seed, Double guidanceScale, String size) {
+    public GenerateImagesRequest(String model, String prompt, String image, String responseFormat, Integer seed, Double guidanceScale, String size) {
         this.model = model;
         this.prompt = prompt;
+        this.image = image;
         this.responseFormat = responseFormat;
         this.seed = seed;
         this.guidanceScale = guidanceScale;
@@ -57,6 +61,14 @@ public void setPrompt(String prompt) {
         this.prompt = prompt;
     }
 
+    public String getImage() {
+        return this.image;
+    }
+
+    public void setImage(String image) {
+        this.image = image;
+    }
+
     public String getResponseFormat() {
         return this.responseFormat;
     }
@@ -97,16 +109,26 @@ public void setWatermark(Boolean watermark) {
         this.watermark = watermark;
     }
 
+    public Boolean getOptimizePrompt() {
+        return this.optimizePrompt;
+    }
+
+    public void setOptimizePrompt(Boolean optimizePrompt) {
+        this.optimizePrompt = optimizePrompt;
+    }
+
     @Override
     public String toString() {
         return "GenerateImagesRequest{" +
                 "model='" + model + '\'' +
                 ", prompt=" + prompt +
+                ", image=" + image +
                 ", responseFormat=" + responseFormat +
                 ", seed=" + seed +
                 ", guidanceScale=" + guidanceScale +
                 ", size=" + size +
                 ", watermark=" + watermark +
+                ", optimizePrompt=" + optimizePrompt +
                 '}';
     }
 
@@ -117,11 +139,13 @@ public static GenerateImagesRequest.Builder builder() {
     public static class Builder {
         private String model;
         private String prompt;
+        private String image;
         private String responseFormat;
         private Integer seed;
         private Double guidanceScale;
         private String size;
         private Boolean watermark;
+        private Boolean optimizePrompt;
 
         private Builder() {
         }
@@ -136,6 +160,11 @@ public GenerateImagesRequest.Builder prompt(String prompt) {
             return this;
         }
 
+        public GenerateImagesRequest.Builder image(String image) {
+            this.image = image;
+            return this;
+        }
+
         public GenerateImagesRequest.Builder responseFormat(String responseFormat) {
             this.responseFormat = responseFormat;
             return this;
@@ -161,15 +190,22 @@ public GenerateImagesRequest.Builder watermark(Boolean watermark) {
             return this;
         }
 
+        public GenerateImagesRequest.Builder optimizePrompt(Boolean optimizePrompt) {
+            this.optimizePrompt = optimizePrompt;
+            return this;
+        }
+
         public GenerateImagesRequest build() {
             GenerateImagesRequest generateImagesRequest = new GenerateImagesRequest();
             generateImagesRequest.setModel(model);
             generateImagesRequest.setPrompt(prompt);
+            generateImagesRequest.setImage(image);
             generateImagesRequest.setResponseFormat(responseFormat);
             generateImagesRequest.setSeed(seed);
             generateImagesRequest.setGuidanceScale(guidanceScale);
             generateImagesRequest.setSize(size);
             generateImagesRequest.setWatermark(watermark);
+            generateImagesRequest.setOptimizePrompt(optimizePrompt);
             return generateImagesRequest;
         }
     }

volcengine-java-sdk-ark-runtime/src/main/java/com/volcengine/ark/runtime/model/images/generation/Size.java

@@ -0,0 +1,5 @@
+package com.volcengine.ark.runtime.model.images.generation;
+
+public class Size {
+    public static final String Adaptive = "adaptive";
+}

volcengine-java-sdk-ark-runtime/test/java/com/volcengine/ark/runtime/ImageGenerationsExample.java

@@ -1,15 +1,13 @@
 package com.volcengine.ark.runtime;
 
-import com.volcengine.ark.runtime.model.content.generation.*;
 import com.volcengine.ark.runtime.model.images.generation.GenerateImagesRequest;
 import com.volcengine.ark.runtime.model.images.generation.ImagesResponse;
 import com.volcengine.ark.runtime.model.images.generation.ResponseFormat;
+import com.volcengine.ark.runtime.model.images.generation.Size;
 import com.volcengine.ark.runtime.service.ArkService;
 import okhttp3.ConnectionPool;
 import okhttp3.Dispatcher;
 
-import java.util.ArrayList;
-import java.util.List;
 import java.util.concurrent.TimeUnit;
 
 public class ImageGenerationsExample {
@@ -30,10 +28,10 @@ public class ImageGenerationsExample {
     public static void main(String[] args) {
         String model = "YOUR_ENDPOINT_ID";
 
-        System.out.println("\n----- Generate Images Request -----");
+        System.out.println("\n----- [Seedream] Generate Images Request -----");
 
         GenerateImagesRequest generateRequest = GenerateImagesRequest.builder()
-                .model(model)
+                .model(model)    // Replace with your Seedream endpoint ID
                 .prompt("龙与地下城女骑士背景是起伏的平原，目光从镜头转向平原")
                 .responseFormat(ResponseFormat.Url)
                 .seed(1234567890)
@@ -47,6 +45,24 @@ public static void main(String[] args) {
         ImagesResponse imagesResponse = service.generateImages(generateRequest);
         System.out.println(imagesResponse.getData().get(0).getUrl());
 
+        System.out.println("\n----- [Seededit] Generate Images Request -----");
+
+        generateRequest = GenerateImagesRequest.builder()
+                .model(model)    // Replace with your Seededit endpoint ID
+                .prompt("龙与地下城女骑士背景是起伏的平原，目光从镜头转向平原")
+                .image("https://an-test-imgs.tos-cn-beijing.volces.com/avi/9m_001.jpg")   // Replace with your input image URL
+                .responseFormat(ResponseFormat.Url)
+                .seed(1234567890)
+                .watermark(true)
+                .size(Size.Adaptive)
+                .guidanceScale(2.5)
+                .build();
+
+        System.out.println(generateRequest.toString());
+        // send create request
+        imagesResponse = service.generateImages(generateRequest);
+        System.out.println(imagesResponse.getData().get(0).getUrl());
+
         service.shutdownExecutor();
     }
 }