Simple-OpenAI: The OpenAI Java Client

sashirestela · May 19, 2025, 5:04pm

Release 3.20.0 - Responses API

simple-openai has been updated for adding support to Responses API.

Here you can see a conversation demo code using the Responses API:

src/demo/java/io/github/sashirestela/openai/demo/ConversationV3Demo.java

main


      
          public void runConversation() {
              String myQuestion = "";
              while (true) {
                  myQuestion = System.console().readLine(HINT);
                  if (myQuestion.equalsIgnoreCase(EXIT)) {
                      break;
                  }
                  var responseRequest = ResponseRequest.builder()
                          .instructions("You are a helpful assistant. Respond in a concise way.")
                          .input(myQuestion)
                          .tools(this.responseToolList)
                          .previousResponseId(this.responseId)
                          .model("gpt-4o-mini")
                          .temperature(0.1)
                          .build();
                  var responseStream = this.openAI.responses().createStream(responseRequest).join();
                  handleResponseEvents(responseStream);
              }
          }

sashirestela · June 5, 2025, 5:54pm

Release 3.21.0 - New Features in Responses API

simple-openai has been updated to support the new features in the Responses API:

Remote Model-Context-Protocol (MCP)
Image Generation
Code Interpreter

Here you can see the demo code for the updated Responses API:

github.com/sashirestela/simple-openai

src/demo/java/io/github/sashirestela/openai/demo/ResponseDemo.java

main


      
          public void createResponseRemoteMcp() {
              var question = "What is the design philosophy of the sashirestela/cleverclient library?";
              System.out.println("Question:\n" + question);
              var responseRequest = ResponseRequest.builder()
                      .instructions("Answer questions using tools as needed")
                      .input(question)
                      .tool(McpResponseTool.builder()
                              .serverLabel("deepwiki")
                              .serverUrl("https://mcp.deepwiki.com/mcp")
                              .requireApproval(McpToolApprovalSetting.NEVER)
                              .allowedTools(List.of("ask_question"))
                              .build())
                      .model(this.model)
                      .temperature(0.1)
                      .build();
              var responseResponse = responseProvider.responses().create(responseRequest).join();
              this.responseIdList.add(responseResponse.getId());
              System.out.println("Answer:");
              System.out.println(responseResponse.outputText());
          }

This file has been truncated. show original

sashirestela · July 15, 2025, 8:31pm

Release 3.22.0 - Several Updates

simple-openai has been updated to support:

In Responses API: Reusable Prompts, Web Search.
In Realtime API: Transcription Session Token, Secret Config, Tracing Config, New Events.
In Images API: New Structure, Background, More Sizes.
In Chat Completions: Web Search.
Other minor fixes.

Take a look at the WebSearch demo code:

github.com/sashirestela/simple-openai

src/demo/java/io/github/sashirestela/openai/demo/ChatDemo.java

main


      
          public void demoCallChatWithWebSearch() {
              chatRequest = ChatRequest.builder()
                      .model("gpt-4o-mini-search-preview")
                      .message(UserMessage.of("What is the most important news in Peruvian politics today?"))
                      .webSearchOptions(WebSearchOptions.builder()
                              .searchContextSize(ContextSize.MEDIUM)
                              .userLocation(UserLocation.of(ApproxLocation.builder()
                                      .country("PE")
                                      .city("Lima")
                                      .build()))
                              .build())
                      .build();
              var chatResponse = chatProvider.chatCompletions().createStream(chatRequest).join();
              chatResponse.forEach(this::processResponseChunk);
              System.out.println();
          }

sashirestela · July 22, 2025, 5:30pm

Who is using Simple-OpenAI❓ - Updated List

Invisible Platforms: A multi-agent platform for industry-agnostics.
Furhat Robotics: A social robot platform with conversational skills.
Sentinel AI: A framework to build and deploy AI Agents.
Java for Programmers, 5/e: A Java book with Generative AI.
ScalerX.ai: A Telegram chatbot factory.
Katie Backend: A question-answering platform.
Woolly: A code generation IntelliJ plugin.
SuperTurtyBot: A multi-purpose discord bot.
OpenOLAT: A learning managment system.
ChatMotor: A framework for OpenAI services.

Topic		Replies	Views
Chat completion api tool call loops API api , tools	15	2268	August 6, 2024
Introducing ChatGPT and Whisper APIs Announcements whisper	77	21107	December 13, 2023
SearchGPT availability in API? API searchgpt	42	19267	March 26, 2025
Google Spreadsheet + GPT3 Community	62	25441	November 30, 2023
AMA on the 17th of December with OpenAI's API Team: Post Your Questions Here Community api , ama , shipmas	193	8085	December 17, 2024

Simple-OpenAI: The OpenAI Java Client

Release 3.20.0 - Responses API

Release 3.21.0 - New Features in Responses API

Release 3.22.0 - Several Updates

Who is using Simple-OpenAI❓ - Updated List

Related topics