ai.z.openapi

Class ZaiClient

java.lang.Object

ai.z.openapi.service.AbstractClientBaseService

ai.z.openapi.AbstractAiClient

ai.z.openapi.ZaiClient

public class ZaiClient
extends AbstractAiClient

ZaiClient is the main entry point for interacting with the Z.ai API. This client provides access to various AI services including chat, embeddings, file operations, audio processing, image generation, and more.

The client supports both Z.ai and ZHIPU AI endpoints and provides thread-safe lazy initialization of services.

Example usage:

 ZaiClient client = new ZaiClient.Builder("your-api-key")
     .networkConfig(30, 10, 30, 30, TimeUnit.SECONDS)
     .build();

 ChatService chatService = client.chat();
 // Use the chat service...

 client.close(); // Don't forget to close when done
 

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	ZaiClient.Builder Builder class for creating ZaiClient instances with custom configurations.

Nested classes/interfaces inherited from class ai.z.openapi.AbstractAiClient

AbstractAiClient.AbstractBuilder<T extends AbstractAiClient,B extends AbstractAiClient.AbstractBuilder<T,B>>

Field Summary

Fields inherited from class ai.z.openapi.AbstractAiClient

httpClient, retrofit

Fields inherited from class ai.z.openapi.service.AbstractClientBaseService

mapper

Constructor Summary

Constructors

Constructor and Description
ZaiClient(ZaiConfig config) Constructs a new ZaiClient with the specified configuration.

Method Summary

Modifier and Type	Method and Description
static ZaiClient.Builder	builder() Creates a new Builder instance for constructing ZaiClient.
static ZaiClient.Builder	ofZHIPU() Creates a ZaiClient configured for ZHIPU AI platform with the specified API key.
static ZaiClient.Builder	ofZHIPU(String apiKey) Creates a ZaiClient configured for ZHIPU AI platform with the specified API key.

Methods inherited from class ai.z.openapi.AbstractAiClient

agents, assistants, audio, batches, biStreamRequest, chat, close, embeddings, executeRequest, fileParsing, files, handwriting, images, moderations, retrofit, streamRequest, videos, voiceClone, webReader, webSearch

Methods inherited from class ai.z.openapi.service.AbstractClientBaseService

execute, stream, stream, stream

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

ZaiClient

public ZaiClient(ZaiConfig config)

Constructs a new ZaiClient with the specified configuration. By default, this client uses the Z.ai OpenAPI endpoint.

Parameters:

config - the configuration object containing API keys, timeouts, and other settings

Throws:

IllegalArgumentException - if config is null or invalid

Method Detail

builder

public static ZaiClient.Builder builder()

Creates a new Builder instance for constructing ZaiClient.

Returns:

a new Builder instance

ofZHIPU

public static ZaiClient.Builder ofZHIPU(String apiKey)

Creates a ZaiClient configured for ZHIPU AI platform with the specified API key.

Parameters:

apiKey - the API key for authentication

Returns:

a new ZaiClient instance configured for ZHIPU AI

Throws:

IllegalArgumentException - if apiKey is null or empty

ofZHIPU

public static ZaiClient.Builder ofZHIPU()

Creates a ZaiClient configured for ZHIPU AI platform with the specified API key.

Returns:

a new ZaiClient instance configured for ZHIPU AI

Throws:

IllegalArgumentException - if apiKey is null or empty