This project provides a Java client for the Moonshot AI API. It is based on the Spring AI project's Moonshot integration and has been extracted to be used as a standalone library.
The Moonshot AI Java Client is organized as a multi-module Maven project:
moonshot-parent: The parent POM with dependency managementmoonshot-core: The core implementation of the Moonshot AI clientdocs: Documentation module built with Antora
- Chat Models: Comprehensive implementation of the Moonshot Chat API supporting models like
moonshot-v1-8k,moonshot-v1-32k, andmoonshot-v1-128k - Flexible Configuration: Extensive customization options including temperature, max tokens, top-p sampling, and more
- Streaming Responses: Support for token-by-token streaming responses for interactive applications
- Function Calling: Register custom Java functions that Moonshot models can intelligently invoke with appropriate arguments
- Robust Error Handling: Built-in retry mechanism with configurable exponential backoff for handling transient errors
- Observability: Integration with Micrometer for metrics collection and performance monitoring
- Type Safety: Fully typed API that provides compile-time safety and excellent IDE support
- Java 17 or higher
- Maven 3.6.3 or higher
To build the project from source, run:
./mvnw clean installTo build the documentation locally:
cd docs
../mvnw antora:antoraThe generated documentation will be available at docs/target/antora/site/.
Add the following dependency to your project:
<dependency>
<groupId>org.springframework.ai.moonshot</groupId>
<artifactId>moonshot-core</artifactId>
<version>0.1.0-SNAPSHOT</version>
</dependency>// Create the Moonshot API client
MoonshotApi moonshotApi = new MoonshotApi("your-api-key");
// Create the chat model
MoonshotChatModel chatModel = new MoonshotChatModel(moonshotApi);
// Create a prompt
UserMessage userMessage = new UserMessage("Tell me a joke about programming");
Prompt prompt = new Prompt(List.of(userMessage));
// Get the response
ChatResponse response = chatModel.call(prompt);
String content = response.getResult().getOutput().getContent();
System.out.println(content);This project is licensed under the Apache License 2.0.