chore: update doc and samples

README.md

@@ -86,11 +86,12 @@ ZhipuAiClient zhipuClient = ZhipuAiClient.builder().ofZHIPU().build();
 
 // Or set the api-key by code
 ZaiClient client = ZaiClient.builder()
+        .ofZAI()
         .apiKey("your.api.key")
         .build();
 
 // For ZHIPU AI platform https://open.bigmodel.cn/api/paas/v4/
-ZhipuAiClient zhipuClient = ZhipuAiClient.builder().apiKey("your.api.key").build();
+ZhipuAiClient zhipuClient = ZhipuAiClient.builder().ofZHIPU().apiKey("your.api.key").build();
 ```
 
 ### Client Configuration
@@ -119,6 +120,7 @@ import java.util.Arrays;
 
 // Create client
 ZaiClient client = ZaiClient.builder()
+    .ofZAI()
     .apiKey("your.api.key")
     .build();
 
@@ -273,6 +275,7 @@ public class AIController {
 
     public AIController() {
         this.zaiClient = ZaiClient.builder()
+            .ofZAI()
             .apiKey("your.api.key")
             .enableTokenCache()
             .build();

README_CN.md

@@ -85,11 +85,12 @@ ZhipuAiClient zhipuClient = ZhipuAiClient.builder().ofZHIPU().build();
 
 // 或代码设置凭证
 ZaiClient client = ZaiClient.builder()
+    .ofZAI()
     .apiKey("your.api.key")
     .build();
 
 // 或为智谱AI平台 bigmodel.cn 创建客户端
-ZhipuAiClient zhipuClient = ZhipuAiClient.builder().apiKey("your.api.key").build();
+ZhipuAiClient zhipuClient = ZhipuAiClient.builder().ofZHIPU().apiKey("your.api.key").build();
 ```
 
 ### 客户端配置
@@ -118,6 +119,7 @@ import java.util.Arrays;
 
 // 创建客户端
 ZaiClient client = ZaiClient.builder()
+    .ofZAI()
     .apiKey("your.api.key")
     .build();
 
@@ -274,6 +276,7 @@ public class AIController {
 
     public AIController() {
         this.zaiClient = ZaiClient.builder()
+            .ofZAI()
             .apiKey("your.api.key")
             .enableTokenCache()
             .build();

samples/src/main/ai.z.openapi.samples/AgentExample.java

@@ -1,6 +1,7 @@
 package ai.z.openapi.samples;
 
 import ai.z.openapi.ZaiClient;
+import ai.z.openapi.ZhipuAiClient;
 import ai.z.openapi.service.agents.AgentContent;
 import ai.z.openapi.service.agents.AgentMessage;
 import ai.z.openapi.service.agents.AgentsCompletionRequest;
@@ -22,8 +23,8 @@ public class AgentExample {
     public static void main(String[] args) {
         // Create client, recommended to set API Key via environment variable
         // export ZAI_API_KEY=your.api_key
-        // for Z.ai use the `ZaiClient`, for Zhipu AI use the ZhipuAiClient
-        ZaiClient client = ZaiClient.builder().build();
+        // for Z.ai use the `ZaiClient`, for Zhipu AI use the ZhipuAiClient.builder().ofZHIPU().build()
+        ZaiClient client = ZaiClient.builder().ofZAI().build();
 
         syncAgentCompletion(client);
     }

samples/src/main/ai.z.openapi.samples/AgentVideoExample.java

@@ -22,8 +22,8 @@ public class AgentVideoExample {
     public static void main(String[] args) {
         // Create client, recommended to set API Key via environment variable
         // export ZAI_API_KEY=your.api_key
-        // for Z.ai use the `ZaiClient`, for Zhipu AI use the ZhipuAiClient
-        ZaiClient client = ZaiClient.builder().build();
+        // for Z.ai use the `ZaiClient`, for Zhipu AI use the ZhipuAiClient.builder().ofZHIPU().build()
+        ZaiClient client = ZaiClient.builder().ofZAI().build();
 
         syncAgentCompletion(client);
     }

samples/src/main/ai.z.openapi.samples/AudioSpeechExample.java

@@ -1,5 +1,6 @@
 package ai.z.openapi.samples;
 
+import ai.z.openapi.ZaiClient;
 import ai.z.openapi.ZhipuAiClient;
 import ai.z.openapi.core.Constants;
 import ai.z.openapi.service.audio.AudioSpeechRequest;
@@ -14,8 +15,8 @@ public class AudioSpeechExample {
     public static void main(String[] args) {
         // Create client, recommended to set API Key via environment variable
         // export ZAI_API_KEY=your.api_key
-        // for Z.ai use the `ZaiClient`, for Zhipu AI use the ZhipuAiClient
-        ZhipuAiClient client = ZhipuAiClient.builder().build();
+        // for Z.ai use the `ZaiClient`, for Zhipu AI use the ZhipuAiClient.builder().ofZHIPU().build()
+        ZaiClient client = ZaiClient.builder().ofZAI().build();
 
         // Create request
         AudioSpeechRequest request = AudioSpeechRequest.builder()

samples/src/main/ai.z.openapi.samples/ChatAsyncCompletionExample.java

@@ -1,5 +1,6 @@
 package ai.z.openapi.samples;
 
+import ai.z.openapi.ZaiClient;
 import ai.z.openapi.ZhipuAiClient;
 import ai.z.openapi.core.Constants;
 import ai.z.openapi.service.model.AsyncResultRetrieveParams;
@@ -20,8 +21,8 @@ public class ChatAsyncCompletionExample {
     public static void main(String[] args) {
         // Create client, recommended to set API Key via environment variable
         // export ZAI_API_KEY=your.api_key
-        // for Z.ai use the `ZaiClient`, for Zhipu AI use the ZhipuAiClient
-        ZhipuAiClient client = ZhipuAiClient.builder().build();
+        // for Z.ai use the `ZaiClient`, for Zhipu AI use the ZhipuAiClient.builder().ofZHIPU().build()
+        ZaiClient client = ZaiClient.builder().ofZAI().build();
 
         // Or set API Key via code
         // ZaiClient client = ZaiClient.builder()

samples/src/main/ai.z.openapi.samples/ChatCompletionBase64Example.java

@@ -1,5 +1,6 @@
 package ai.z.openapi.samples;
 
+import ai.z.openapi.ZaiClient;
 import ai.z.openapi.ZhipuAiClient;
 import ai.z.openapi.service.model.ChatCompletionCreateParams;
 import ai.z.openapi.service.model.ChatCompletionResponse;
@@ -23,8 +24,8 @@ public class ChatCompletionBase64Example {
 
     public static void main(String[] args) throws IOException {
         // Create client
-        // for Z.ai use the `ZaiClient`, for Zhipu AI use the ZhipuAiClient
-        ZhipuAiClient client = ZhipuAiClient.builder().build();
+        // for Z.ai use the `ZaiClient`, for Zhipu AI use the ZhipuAiClient.builder().ofZHIPU().build()
+        ZaiClient client = ZaiClient.builder().ofZAI().build();
 
         String file = ClassLoader.getSystemResource("grounding.png").getFile();
         byte[] bytes = Files.readAllBytes(new File(file).toPath());

samples/src/main/ai.z.openapi.samples/ChatCompletionExample.java

@@ -1,5 +1,6 @@
 package ai.z.openapi.samples;
 
+import ai.z.openapi.ZaiClient;
 import ai.z.openapi.ZhipuAiClient;
 import ai.z.openapi.service.model.*;
 
@@ -14,8 +15,8 @@ public class ChatCompletionExample {
     public static void main(String[] args) {
         // Create client, recommended to set API Key via environment variable
         // export ZAI_API_KEY=your.api_key
-        // for Z.ai use the `ZaiClient`, for Zhipu AI use the ZhipuAiClient
-        ZhipuAiClient client = ZhipuAiClient.builder().build();
+        // for Z.ai use the `ZaiClient`, for Zhipu AI use the ZhipuAiClient.builder().ofZHIPU().build()
+        ZaiClient client = ZaiClient.builder().ofZAI().build();
 
         // Or set API Key via code
         // ZaiClient client = ZaiClient.builder()

samples/src/main/ai.z.openapi.samples/ChatCompletionMultiFileExample.java

@@ -1,14 +1,17 @@
 package ai.z.openapi.samples;
 
+import ai.z.openapi.ZaiClient;
 import ai.z.openapi.ZhipuAiClient;
 import ai.z.openapi.service.model.*;
 import java.util.Arrays;
 
 public class ChatCompletionMultiFileExample {
 
     public static void main(String[] args) {
-        ZhipuAiClient client = ZhipuAiClient.builder()
-            .build();
+        // Create client, recommended to set API Key via environment variable
+        // export ZAI_API_KEY=your.api_key
+        // for Z.ai use the `ZaiClient`, for Zhipu AI use the ZhipuAiClient.builder().ofZHIPU().build()
+        ZaiClient client = ZaiClient.builder().ofZAI().build();
 
         ChatCompletionCreateParams request = ChatCompletionCreateParams.builder()
             .model("glm-4.6v")

samples/src/main/ai.z.openapi.samples/ChatCompletionStreamExample.java

@@ -12,8 +12,8 @@ public class ChatCompletionStreamExample {
 
     public static void main(String[] args) {
         // Create client
-        // for Z.ai use the `ZaiClient`, for Zhipu AI use the ZhipuAiClient
-        ZaiClient client = ZaiClient.builder().build();
+        // for Z.ai use the `ZaiClient`, for Zhipu AI use the ZhipuAiClient.builder().ofZHIPU().build()
+        ZaiClient client = ZaiClient.builder().ofZAI().build();
 
         // Create chat request
         ChatCompletionCreateParams streamRequest = ChatCompletionCreateParams.builder()

samples/src/main/ai.z.openapi.samples/ChatCompletionWithCustomHeadersExample.java

@@ -1,5 +1,6 @@
 package ai.z.openapi.samples;
 
+import ai.z.openapi.ZaiClient;
 import ai.z.openapi.ZhipuAiClient;
 import ai.z.openapi.service.model.*;
 import ai.z.openapi.core.Constants;
@@ -17,8 +18,8 @@ public class ChatCompletionWithCustomHeadersExample {
     public static void main(String[] args) {
         // Create client, recommended to set API Key via environment variable
         // export ZAI_API_KEY=your.api_key
-        // for Z.ai use the `ZaiClient`, for Zhipu AI use the ZhipuAiClient
-        ZhipuAiClient client = ZhipuAiClient.builder().build();
+        // for Z.ai use the `ZaiClient`, for Zhipu AI use the ZhipuAiClient.builder().ofZHIPU().build()
+        ZaiClient client = ZaiClient.builder().ofZAI().build();
 
         // Create chat request
         ChatCompletionCreateParams request = ChatCompletionCreateParams.builder()

samples/src/main/ai.z.openapi.samples/ChatCompletionWithMcpServerUrlExample.java

@@ -1,5 +1,6 @@
 package ai.z.openapi.samples;
 
+import ai.z.openapi.ZaiClient;
 import ai.z.openapi.ZhipuAiClient;
 import ai.z.openapi.service.model.ChatCompletionCreateParams;
 import ai.z.openapi.service.model.ChatCompletionResponse;
@@ -24,8 +25,8 @@ public class ChatCompletionWithMcpServerUrlExample {
     public static void main(String[] args) {
         // Create client, recommended to set API Key via environment variable
         // export ZAI_API_KEY=your.api_key
-        // for Z.ai use the `ZaiClient`, for Zhipu AI use the ZhipuAiClient
-        ZhipuAiClient client = ZhipuAiClient.builder().build();
+        // for Z.ai use the `ZaiClient`, for Zhipu AI use the ZhipuAiClient.builder().ofZHIPU().build()
+        ZaiClient client = ZaiClient.builder().ofZAI().build();
 
         // Or set API Key via code
         // ZaiClient client = ZaiClient.builder()

samples/src/main/ai.z.openapi.samples/CogVideoX3Example.java

@@ -17,8 +17,8 @@ public class CogVideoX3Example {
     public static void main(String[] args) {
         // Create client, recommended to set API Key via environment variable
         // export ZAI_API_KEY=your.api_key
-        // for Z.ai use the `ZaiClient`, for Zhipu AI use the ZhipuAiClient
-        ZaiClient client = ZaiClient.builder().build();
+        // for Z.ai use the `ZaiClient`, for Zhipu AI use the ZhipuAiClient.builder().ofZHIPU().build()
+        ZaiClient client = ZaiClient.builder().ofZAI().build();
 
         // Or set API Key via code
         // ZaiClient client = ZaiClient.builder()

samples/src/main/ai.z.openapi.samples/CogVideoXExample.java

@@ -14,8 +14,8 @@ public class CogVideoXExample {
     public static void main(String[] args) {
         // Create client, recommended to set API Key via environment variable
         // export ZAI_API_KEY=your.api_key
-        // for Z.ai use the `ZaiClient`, for Zhipu AI use the ZhipuAiClient
-        ZaiClient client = ZaiClient.builder().build();
+        // for Z.ai use the `ZaiClient`, for Zhipu AI use the ZhipuAiClient.builder().ofZHIPU().build()
+        ZaiClient client = ZaiClient.builder().ofZAI().build();
 
         // Or set API Key via code
         // ZaiClient client = ZaiClient.builder()

samples/src/main/ai.z.openapi.samples/CustomClientExample.java

@@ -28,7 +28,7 @@ public class CustomClientExample {
     public static void main(String[] args) throws Exception {
         // Create client, recommended to set API Key via environment variable
         // export ZAI_API_KEY=your.api_key
-        // for Z.ai use the `ZaiClient`, for Zhipu AI use the ZhipuAiClient
+        // for Z.ai use the `ZaiClient`, for Zhipu AI use the ZhipuAiClient.builder().ofZHIPU().build()
         ZaiConfig zaiConfig = ZaiConfig.builder()
             .apiKey(System.getenv("ZAI_API_KEY"))
             .baseUrl(Constants.ZHIPU_AI_BASE_URL)

samples/src/main/ai.z.openapi.samples/CustomTimeoutExample.java

@@ -1,5 +1,6 @@
 package ai.z.openapi.samples;
 
+import ai.z.openapi.ZaiClient;
 import ai.z.openapi.ZhipuAiClient;
 import ai.z.openapi.core.Constants;
 import ai.z.openapi.service.model.ChatCompletionCreateParams;
@@ -23,8 +24,8 @@ public class CustomTimeoutExample {
     public static void main(String[] args) {
         // Create client, recommended to set API Key via environment variable
         // export ZAI_API_KEY=your.api_key
-        // for Z.ai use the `ZaiClient`, for Zhipu AI use the ZhipuAiClient
-        ZhipuAiClient client = ZhipuAiClient.builder()
+        // for Z.ai use the `ZaiClient`, for Zhipu AI use the ZhipuAiClient.builder().ofZHIPU().build()
+        ZaiClient client = ZaiClient.builder().ofZAI()
             .networkConfig(0, 10, 30, 30, TimeUnit.SECONDS)
             .build();
 

samples/src/main/ai.z.openapi.samples/EmbeddingsExample.java

@@ -12,9 +12,10 @@
 public class EmbeddingsExample {
 
     public static void main(String[] args) {
-        // Create client
-
-        ZaiClient client = ZaiClient.builder().build();
+        // Create client, recommended to set API Key via environment variable
+        // export ZAI_API_KEY=your.api_key
+        // for Z.ai use the `ZaiClient`, for Zhipu AI use the ZhipuAiClient.builder().ofZHIPU().build()
+        ZaiClient client = ZaiClient.builder().ofZAI().build();
 
         // Create embedding request
         EmbeddingCreateParams request = EmbeddingCreateParams.builder()

samples/src/main/ai.z.openapi.samples/FileParsingExample.java

@@ -10,16 +10,11 @@
 public class FileParsingExample {
 
     public static void main(String[] args) {
-// It's recommended to set the API Key via environment variable
-// export ZAI_API_KEY=your.api_key
-// ZaiClient client = ZaiClient.builder().build();
 
-// You can also specify the API Key directly in code
-
-
-        ZaiClient client = ZaiClient.builder()
-                .apiKey("API Key")
-                .build();
+        // Create client, recommended to set API Key via environment variable
+        // export ZAI_API_KEY=your.api_key
+        // for Z.ai use the `ZaiClient`, for Zhipu AI use the ZhipuAiClient.builder().ofZHIPU().build()
+        ZaiClient client = ZaiClient.builder().ofZAI().build();
 
         try {
             // Example 1: Create a file parsing task

samples/src/main/ai.z.openapi.samples/FileParsingSyncExample.java

@@ -8,14 +8,12 @@
 public class FileParsingSyncExample {
 
     public static void main(String[] args) {
-        // It is recommended to set the API Key using an environment variable
+        // Create client, recommended to set API Key via environment variable
         // export ZAI_API_KEY=your.api_key
-        // ZaiClient client = ZaiClient.builder().build();
+        // for Z.ai use the `ZaiClient`, for Zhipu AI use the ZhipuAiClient.builder().ofZHIPU().build()
 
         // Alternatively, the API Key can be specified directly in the code
-        ZaiClient client = ZaiClient.builder()
-                .apiKey("API Key")
-                .build();
+        ZaiClient client = ZaiClient.builder().ofZAI().build();
 
         try {
             System.out.println("=== Example: Creating file parsing task ===");

samples/src/main/ai.z.openapi.samples/FunctionCallingExample.java

@@ -28,7 +28,10 @@ public static Map<String, Object> getStockPrice(String symbol) {
     }
 
     public static void main(String[] args) {
-        ZaiClient client = ZaiClient.builder().build();
+        // Create client, recommended to set API Key via environment variable
+        // export ZAI_API_KEY=your.api_key
+        // for Z.ai use the `ZaiClient`, for Zhipu AI use the ZhipuAiClient.builder().ofZHIPU().build()
+        ZaiClient client = ZaiClient.builder().ofZAI().build();
 
         // Define function tools
         Map<String, ChatFunctionParameterProperty> properties = new HashMap<>();

samples/src/main/ai.z.openapi.samples/GLM41VThinkingExample.java

@@ -14,10 +14,8 @@ public class GLM41VThinkingExample {
 
     public static void main(String[] args) {
 
-        // for Z.ai use the `ZaiClient`, for Zhipu AI use the ZhipuAiClient
-        ZaiClient client = ZaiClient.builder()
-                .apiKey("your.api_key")
-                .build();
+        // for Z.ai use the `ZaiClient`, for Zhipu AI use the ZhipuAiClient.builder().ofZHIPU().build()
+        ZaiClient client = ZaiClient.builder().ofZAI().build();
 
         ChatCompletionCreateParams request = ChatCompletionCreateParams.builder()
                 .model("glm-4.1v-thinking-flashx")

samples/src/main/ai.z.openapi.samples/GLM45VExample.java

@@ -1,5 +1,6 @@
 package ai.z.openapi.samples;
 
+import ai.z.openapi.ZaiClient;
 import ai.z.openapi.ZhipuAiClient;
 import ai.z.openapi.core.Constants;
 import ai.z.openapi.service.model.ChatCompletionCreateParams;
@@ -21,8 +22,8 @@ public class GLM45VExample {
 
     public static void main(String[] args) throws IOException {
         // Create client
-        // for Z.ai use the `ZaiClient`, for Zhipu AI use the ZhipuAiClient
-        ZhipuAiClient client = ZhipuAiClient.builder().build();
+        // for Z.ai use the `ZaiClient`, for Zhipu AI use the ZhipuAiClient.builder().ofZHIPU().build()
+        ZaiClient client = ZaiClient.builder().ofZAI().build();
 
         // Create chat request
         ChatCompletionCreateParams streamRequest = ChatCompletionCreateParams.builder()

samples/src/main/ai.z.openapi.samples/GLM4VPlusExample.java

@@ -14,8 +14,10 @@ public class GLM4VPlusExample {
 
     public static void main(String[] args) {
 
-        // for Z.ai use the `ZaiClient`, for Zhipu AI use the ZhipuAiClient
-        ZaiClient client = ZaiClient.builder().apiKey("your.api_key").build();
+        // Create client, recommended to set API Key via environment variable
+        // export ZAI_API_KEY=your.api_key
+        // for Z.ai use the `ZaiClient`, for Zhipu AI use the ZhipuAiClient.builder().ofZHIPU().build()
+        ZaiClient client = ZaiClient.builder().ofZAI().apiKey("your.api_key").build();
 
         ChatCompletionCreateParams request = ChatCompletionCreateParams.builder()
                 .model("glm-4v-plus-0111")