⚠️The Answers, Classifications, and Searches APIs are deprecated, and will stop working on December 3rd, 2022.

⚠️OpenAI has deprecated all Engine-based APIs. See Deprecated Endpoints below for more info.

Java libraries for using OpenAI's GPT-3 api.

Includes the following artifacts:

• api : request/response POJOs for the GPT-3 engine, completion, and search APIs.
• client : a basic retrofit client for the GPT-3 endpoints, includes the api module

as well as an example project using the client.

• Models
• Completions
• Edits
• Embeddings
• Files
• Fine-tunes
• Moderations

• Searches
• Classifications
• Answers
• Engines

implementation 'com.theokanning.openai-gpt3-java:api:<version>'
or
implementation 'com.theokanning.openai-gpt3-java:client:<version>'

If you're looking for the fastest solution, import the client and use OpenAiService.

OpenAiService service = new OpenAiService(your_token)
CompletionRequest completionRequest = CompletionRequest.builder()
        .prompt("Somebody once told me the world is gonna roll me")
        .echo(true)
        .build();
service.createCompletion("ada", completionRequest).getChoices().forEach(System.out::println);

If you're using retrofit, you can import the client module and use the OpenAiApi.
You'll have to add your auth token as a header (see AuthenticationInterceptor) and set your converter factory to use snake case and only include non-null fields.

If you want to make your own client, just import the POJOs from the api module.
Your client will need to use snake case to work with the OpenAI API.

All the example project requires is your OpenAI api token

export OPENAI_TOKEN="sk-XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX"
./gradlew example:run

OpenAI has deprecated engine-based endpoints in favor of model-based endpoints. For example, instead of using v1/engines/{engine_id}/completions, switch to v1/completions and specify the model in the CompletionRequest. The code includes upgrade instructions for all deprecated endpoints.

I won't remove the old endpoints from this library until OpenAI shuts them down.

Published under the MIT License