Merge branch 'feat/arkruntime_0826' into 'integration_2025-09-11_1051245470210'

feat: [development task] ark runtime (1649393)

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

Author: BitsAdmin

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

@@ -1,6 +1,18 @@
 package com.volcengine.ark.runtime.model.images.generation;
 
+import com.fasterxml.jackson.annotation.JsonIgnoreProperties;
 import com.fasterxml.jackson.annotation.JsonProperty;
+import com.fasterxml.jackson.core.JsonParser;
+import com.fasterxml.jackson.core.JsonProcessingException;
+import com.fasterxml.jackson.databind.DeserializationContext;
+import com.fasterxml.jackson.databind.JsonDeserializer;
+import com.fasterxml.jackson.databind.annotation.JsonDeserialize;
+import com.fasterxml.jackson.databind.JsonNode;
+
+import java.io.IOException;
+import java.util.ArrayList;
+import java.util.Collections;
+import java.util.List;
 
 public class GenerateImagesRequest {
 
@@ -11,7 +23,8 @@ public class GenerateImagesRequest {
     private String prompt;
 
     @JsonProperty("image")
-    private String image;
+    @JsonDeserialize(using = ImageDeserializer.class)
+    private List<String> image;
 
     @JsonProperty("response_format")
     private String responseFormat;
@@ -31,10 +44,39 @@ public class GenerateImagesRequest {
     @JsonProperty("optimize_prompt")
     private Boolean optimizePrompt;
 
+    @JsonProperty("sequential_image_generation")
+    private String sequentialImageGeneration;
+
+    @JsonProperty("sequential_image_generation_options")
+    private SequentialImageGenerationOptions sequentialImageGenerationOptions;
+
+    @JsonProperty("stream")
+    private Boolean stream;
+
+    @JsonIgnoreProperties(ignoreUnknown = true)
+    public static class SequentialImageGenerationOptions {
+        private Integer maxImages;
+
+        public Integer getMaxImages() {
+            return maxImages;
+        }
+
+        public void setMaxImages(Integer maxImages) {
+            this.maxImages = maxImages;
+        }
+
+        @Override
+        public String toString() {
+            return "SequentialImageGenerationOptions{" +
+                    "maxImages=" + maxImages +
+                    '}';
+        }
+    }
+
     public GenerateImagesRequest() {
     }
 
-    public GenerateImagesRequest(String model, String prompt, String image, String responseFormat, Integer seed, Double guidanceScale, String size, Boolean watermark, Boolean optimizePrompt) {
+    public GenerateImagesRequest(String model, String prompt, List<String> image, String responseFormat, Integer seed, Double guidanceScale, String size, Boolean watermark, String sequentialImageGeneration, SequentialImageGenerationOptions sequentialImageGenerationOptions, Boolean optimizePrompt, Boolean stream) {
         this.model = model;
         this.prompt = prompt;
         this.image = image;
@@ -44,6 +86,9 @@ public GenerateImagesRequest(String model, String prompt, String image, String r
         this.size = size;
         this.watermark = watermark;
         this.optimizePrompt = optimizePrompt;
+        this.sequentialImageGeneration = sequentialImageGeneration;
+        this.sequentialImageGenerationOptions = sequentialImageGenerationOptions;
+        this.stream = stream;
     }
 
     public String getModel() {
@@ -62,14 +107,18 @@ public void setPrompt(String prompt) {
         this.prompt = prompt;
     }
 
-    public String getImage() {
+    public List<String> getImage() {
         return this.image;
     }
 
-    public void setImage(String image) {
+    public void setImage(List<String> image) {
         this.image = image;
     }
 
+    public void setImage(String image) {
+        this.image = image == null ? null : Collections.singletonList(image);
+    }
+
     public String getResponseFormat() {
         return this.responseFormat;
     }
@@ -118,6 +167,30 @@ public void setOptimizePrompt(Boolean optimizePrompt) {
         this.optimizePrompt = optimizePrompt;
     }
 
+    public Boolean getStream() {
+        return this.stream;
+    }
+
+    public void setStream(Boolean stream) {
+        this.stream = stream;
+    }
+
+    public SequentialImageGenerationOptions getSequentialImageGenerationOptions() {
+        return this.sequentialImageGenerationOptions;
+    }
+
+    public void setSequentialImageGenerationOptions(SequentialImageGenerationOptions sequentialImageGenerationOptions) {
+        this.sequentialImageGenerationOptions = sequentialImageGenerationOptions;
+    }
+
+    public String getSequentialImageGeneration() {
+        return sequentialImageGeneration;
+    }
+
+    public void setSequentialImageGeneration(String sequentialImageGeneration) {
+        this.sequentialImageGeneration = sequentialImageGeneration;
+    }
+
     @Override
     public String toString() {
         return "GenerateImagesRequest{" +
@@ -130,6 +203,9 @@ public String toString() {
                 ", size=" + size +
                 ", watermark=" + watermark +
                 ", optimizePrompt=" + optimizePrompt +
+                ", stream=" + stream +
+                ", sequentialImageGeneration=" + sequentialImageGeneration +
+                ", sequentialImageGenerationOptions=" + sequentialImageGenerationOptions +
                 '}';
     }
 
@@ -140,13 +216,19 @@ public static GenerateImagesRequest.Builder builder() {
     public static class Builder {
         private String model;
         private String prompt;
-        private String image;
+        @JsonDeserialize(using = ImageDeserializer.class)
+        private List<String> image;
         private String responseFormat;
         private Integer seed;
         private Double guidanceScale;
         private String size;
         private Boolean watermark;
         private Boolean optimizePrompt;
+        private String sequentialImageGeneration;
+
+        private SequentialImageGenerationOptions sequentialImageGenerationOptions;
+
+        private Boolean stream;
 
         private Builder() {
         }
@@ -161,11 +243,16 @@ public GenerateImagesRequest.Builder prompt(String prompt) {
             return this;
         }
 
-        public GenerateImagesRequest.Builder image(String image) {
+        public GenerateImagesRequest.Builder image(List<String> image) {
             this.image = image;
             return this;
         }
 
+        public GenerateImagesRequest.Builder image(String image) {
+            this.image = image == null ? null : Collections.singletonList(image);
+            return this;
+        }
+
         public GenerateImagesRequest.Builder responseFormat(String responseFormat) {
             this.responseFormat = responseFormat;
             return this;
@@ -196,6 +283,21 @@ public GenerateImagesRequest.Builder optimizePrompt(Boolean optimizePrompt) {
             return this;
         }
 
+        public GenerateImagesRequest.Builder sequentialImageGeneration(String sequentialImageGeneration) {
+            this.sequentialImageGeneration = sequentialImageGeneration;
+            return this;
+        }
+
+        public GenerateImagesRequest.Builder sequentialImageGenerationOptions(SequentialImageGenerationOptions sequentialImageGenerationOptions) {
+            this.sequentialImageGenerationOptions = sequentialImageGenerationOptions;
+            return this;
+        }
+
+        public GenerateImagesRequest.Builder stream(Boolean stream) {
+            this.stream = stream;
+            return this;
+        }
+
         public GenerateImagesRequest build() {
             GenerateImagesRequest generateImagesRequest = new GenerateImagesRequest();
             generateImagesRequest.setModel(model);
@@ -207,7 +309,36 @@ public GenerateImagesRequest build() {
             generateImagesRequest.setSize(size);
             generateImagesRequest.setWatermark(watermark);
             generateImagesRequest.setOptimizePrompt(optimizePrompt);
+            generateImagesRequest.setSequentialImageGeneration(sequentialImageGeneration);
+            generateImagesRequest.setSequentialImageGenerationOptions(sequentialImageGenerationOptions);
+            generateImagesRequest.setStream(stream);
             return generateImagesRequest;
         }
     }
 }
+
+class ImageDeserializer extends JsonDeserializer<List<String>> {
+    @Override
+    public List<String> deserialize(JsonParser p, DeserializationContext ctxt)
+            throws IOException, JsonProcessingException {
+
+        JsonNode node = p.getCodec().readTree(p);
+
+        // 如果是单个 string
+        if (node.isTextual()) {
+            return Collections.singletonList(node.asText());
+        }
+
+        // 如果是数组
+        if (node.isArray()) {
+            List<String> list = new ArrayList<>();
+            for (JsonNode element : node) {
+                list.add(element.asText());
+            }
+            return list;
+        }
+
+        // 其他情况（null、对象等）返回空
+        return Collections.emptyList();
+    }
+}