Merge 'feat/arkruntime_add_json_schema' into 'integration_2026-01-15_1104234777858'

feat: [development task] ark runtime (2032532)

See merge request: !857

Author: BitsAdmin

volcengine-java-sdk-ark-runtime/src/main/java/com/volcengine/ark/runtime/model/responses/common/ResponsesTextFormat.java

@@ -1,11 +1,18 @@
 package com.volcengine.ark.runtime.model.responses.common;
 
 import com.fasterxml.jackson.annotation.JsonProperty;
+import com.fasterxml.jackson.databind.JsonNode;
 
 public class ResponsesTextFormat {
     @JsonProperty("type")
     private String type;
 
+    @JsonProperty("name")
+    private String name;
+
+    @JsonProperty("schema")
+    private JsonNode schema;
+
     public String getType() {
         return type;
     }
@@ -14,6 +21,22 @@ public void setType(String type) {
         this.type = type;
     }
 
+    public String getName() {
+        return name;
+    }
+
+    public void setName(String name) {
+        this.name = name;
+    }
+
+    public JsonNode getSchema() {
+        return schema;
+    }
+
+    public void setSchema(JsonNode schema) {
+        this.schema = schema;
+    }
+
     @Override
     public String toString() {
         return "ResponsesTextFormat{" +
@@ -27,15 +50,29 @@ public static Builder builder() {
 
     public static class Builder {
         private String type;
+        private String name;
+        private JsonNode schema;
 
         public Builder type(String type) {
             this.type = type;
             return this;
         }
 
+        public Builder name(String name) {
+            this.name = name;
+            return this;
+        }
+
+        public Builder schema(JsonNode schema) {
+            this.schema = schema;
+            return this;
+        }
+
         public ResponsesTextFormat build() {
             ResponsesTextFormat responsesTextFormat = new ResponsesTextFormat();
             responsesTextFormat.setType(type);
+            responsesTextFormat.setName(name);
+            responsesTextFormat.setSchema(schema);
             return responsesTextFormat;
         }
     }

volcengine-java-sdk-ark-runtime/src/main/java/com/volcengine/ark/runtime/model/responses/constant/ResponsesConstants.java

@@ -66,6 +66,7 @@ public class ResponsesConstants {
     // TextType.Enum
     public static final String TEXT_TYPE_TEXT = "text";
     public static final String TEXT_TYPE_JSON_OBJECT = "json_object";
+    public static final String TEXT_TYPE_JSON_SCHEMA = "json_schema";
 
     // ToolChoiceMode.Enum
     public static final String TOOL_CHOICE_MODE_AUTO = "auto";

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

@@ -1,7 +1,10 @@
 package com.volcengine.ark.runtime;
 
+import com.fasterxml.jackson.databind.JsonNode;
 import com.fasterxml.jackson.databind.ObjectMapper;
 import com.volcengine.ark.runtime.model.responses.common.ResponsesCaching;
+import com.volcengine.ark.runtime.model.responses.common.ResponsesText;
+import com.volcengine.ark.runtime.model.responses.common.ResponsesTextFormat;
 import com.volcengine.ark.runtime.model.responses.common.ResponsesThinking;
 import com.volcengine.ark.runtime.model.responses.constant.ResponsesConstants;
 import com.volcengine.ark.runtime.model.responses.content.*;
@@ -32,6 +35,7 @@
 public class CreateResponseExample {
 
     private static final String modelName = "doubao-seed-1-6-250615";
+    private static final String testSchema = "{\"type\":\"object\",\"properties\":{\"steps\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"explanation\":{\"type\":\"string\"},\"output\":{\"type\":\"string\"}},\"required\":[\"explanation\",\"output\"],\"additionalProperties\":false}},\"final_answer\":{\"type\":\"string\"}},\"required\":[\"steps\",\"final_answer\"],\"additionalProperties\":false}";
 
     public static void main(String[] args) {
         String apiKey = System.getenv("ARK_API_KEY");
@@ -334,6 +338,28 @@ public static void main(String[] args) {
             System.err.println("Create Cached Response Error " + e.getMessage());
         }
 
+        try {
+            System.out.println("\n----- [Request with JsonSchema] Request 8-----");
+            CreateResponsesRequest request8 = CreateResponsesRequest.builder()
+                    .input(ResponsesInput.builder().stringValue("return in json format how can I solve 8x + 7 = -23").build())
+                    .model(modelName)
+                    .stream(false)
+                    .text(ResponsesText.builder().format(ResponsesTextFormat.builder()
+                            .type(ResponsesConstants.TEXT_TYPE_JSON_SCHEMA)
+                            .name("math_reasoning")
+                            .schema(new ObjectMapper().readTree(testSchema))
+                            .build()).build())
+                    .build();
+
+            ResponseObject response8 = service.createResponse(request8);
+            System.out.println("=== response 8 ===");
+            printResponseObject(response8);
+        } catch (Exception e) {
+            System.err.println("Create Response 8 Error " + e.getMessage());
+        }
+
+
+
         service.shutdownExecutor();
     }