Package org.springframework.ai.openai.api

Class OpenAiApi

java.lang.Object

org.springframework.ai.openai.api.OpenAiApi

public class OpenAiApi
extends Object

Single class implementation of the OpenAI Chat Completion API and OpenAI Embedding API.

Author:

Christian Tzolov, Michael Lavelle, Mariusz Bernacki, Thomas Vitale, David Frizelle, Alexandros Pappas, Filip Hrisafov

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static final class	OpenAiApi.Builder
static final record	OpenAiApi.ChatCompletion	Represents a chat completion response returned by model, based on the provided input.
static final record	OpenAiApi.ChatCompletionChunk	Represents a streamed chunk of a chat completion response returned by model, based on the provided input.
static enum	OpenAiApi.ChatCompletionFinishReason	The reason the model stopped generating tokens.
static final record	OpenAiApi.ChatCompletionMessage	Message comprising the conversation.
static final record	OpenAiApi.ChatCompletionRequest	Creates a model request for the given chat conversation.
static enum	OpenAiApi.ChatModel	OpenAI Chat Completion Models.
static final record	OpenAiApi.Embedding	Represents an embedding vector returned by embedding endpoint.
static final record	OpenAiApi.EmbeddingList<T>	List of multiple embedding responses.
static enum	OpenAiApi.EmbeddingModel	OpenAI Embeddings Models: Embeddings.
static final record	OpenAiApi.EmbeddingRequest<T>	Creates an embedding vector representing the input text.
static class	OpenAiApi.FunctionTool	Represents a tool the model may call.
static final record	OpenAiApi.LogProbs	Log probability information for the choice.
static enum	OpenAiApi.OutputModality	The type of modality for the model completion.
static enum	OpenAiApi.ServiceTier	Specifies the processing type used for serving the request.
static final record	OpenAiApi.Usage	Usage statistics for the completion request.

Field Summary

Fields

Modifier and Type	Field	Description
static final OpenAiApi.ChatModel	DEFAULT_CHAT_MODEL
static final String	DEFAULT_EMBEDDING_MODEL
static final String	HTTP_USER_AGENT_HEADER
static final String	SPRING_AI_USER_AGENT

Constructor Summary

Constructors

Constructor	Description
OpenAiApi(String baseUrl, ApiKey apiKey, org.springframework.util.MultiValueMap<String,String> headers, String completionsPath, String embeddingsPath, org.springframework.web.client.RestClient.Builder restClientBuilder, org.springframework.web.reactive.function.client.WebClient.Builder webClientBuilder, org.springframework.web.client.ResponseErrorHandler responseErrorHandler)	Create a new chat completion api.

Method Summary

Modifier and Type	Method	Description
static OpenAiApi.Builder	builder()
org.springframework.http.ResponseEntity<OpenAiApi.ChatCompletion>	chatCompletionEntity(OpenAiApi.ChatCompletionRequest chatRequest)	Creates a model response for the given chat conversation.
org.springframework.http.ResponseEntity<OpenAiApi.ChatCompletion>	chatCompletionEntity(OpenAiApi.ChatCompletionRequest chatRequest, org.springframework.util.MultiValueMap<String,String> additionalHttpHeader)	Creates a model response for the given chat conversation.
reactor.core.publisher.Flux<OpenAiApi.ChatCompletionChunk>	chatCompletionStream(OpenAiApi.ChatCompletionRequest chatRequest)	Creates a streaming chat response for the given chat conversation.
reactor.core.publisher.Flux<OpenAiApi.ChatCompletionChunk>	chatCompletionStream(OpenAiApi.ChatCompletionRequest chatRequest, org.springframework.util.MultiValueMap<String,String> additionalHttpHeader)	Creates a streaming chat response for the given chat conversation.
<T> org.springframework.http.ResponseEntity<OpenAiApi.EmbeddingList<OpenAiApi.Embedding>>	embeddings(OpenAiApi.EmbeddingRequest<T> embeddingRequest)	Creates an embedding vector representing the input text or token array.
static String	getTextContent(List<OpenAiApi.ChatCompletionMessage.MediaContent> content)	Returns a string containing all text values from the given media content list.
OpenAiApi.Builder	mutate()	Returns a builder pre-populated with the current configuration for mutation.

Methods inherited from class java.lang.Object

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

Field Details

HTTP_USER_AGENT_HEADER

public static final String HTTP_USER_AGENT_HEADER

See Also:

• Constant Field Values

SPRING_AI_USER_AGENT

public static final String SPRING_AI_USER_AGENT

See Also:

• Constant Field Values

DEFAULT_CHAT_MODEL

public static final OpenAiApi.ChatModel DEFAULT_CHAT_MODEL

DEFAULT_EMBEDDING_MODEL

public static final String DEFAULT_EMBEDDING_MODEL

Constructor Details

OpenAiApi

public OpenAiApi(String baseUrl,
 ApiKey apiKey,
 org.springframework.util.MultiValueMap<String,String> headers,
 String completionsPath,
 String embeddingsPath,
 org.springframework.web.client.RestClient.Builder restClientBuilder,
 org.springframework.web.reactive.function.client.WebClient.Builder webClientBuilder,
 org.springframework.web.client.ResponseErrorHandler responseErrorHandler)

Create a new chat completion api.

Parameters:

baseUrl - api base URL.

apiKey - OpenAI apiKey.

headers - the http headers to use.

completionsPath - the path to the chat completions endpoint.

embeddingsPath - the path to the embeddings endpoint.

restClientBuilder - RestClient builder.

webClientBuilder - WebClient builder.

responseErrorHandler - Response error handler.

Method Details

mutate

public OpenAiApi.Builder mutate()

Returns a builder pre-populated with the current configuration for mutation.

builder

public static OpenAiApi.Builder builder()

getTextContent

public static String getTextContent(List<OpenAiApi.ChatCompletionMessage.MediaContent> content)

Returns a string containing all text values from the given media content list. Only elements of type "text" are processed and concatenated in order.

Parameters:

content - The list of OpenAiApi.ChatCompletionMessage.MediaContent

Returns:

a string containing all text values from "text" type elements

Throws:

IllegalArgumentException - if content is null

chatCompletionEntity

public org.springframework.http.ResponseEntity<OpenAiApi.ChatCompletion> chatCompletionEntity(OpenAiApi.ChatCompletionRequest chatRequest)

Creates a model response for the given chat conversation.

Parameters:

chatRequest - The chat completion request.

Returns:

Entity response with OpenAiApi.ChatCompletion as a body and HTTP status code and headers.

chatCompletionEntity

public org.springframework.http.ResponseEntity<OpenAiApi.ChatCompletion> chatCompletionEntity(OpenAiApi.ChatCompletionRequest chatRequest,
 org.springframework.util.MultiValueMap<String,String> additionalHttpHeader)

Creates a model response for the given chat conversation.

Parameters:

chatRequest - The chat completion request.

additionalHttpHeader - Optional, additional HTTP headers to be added to the request.

Returns:

Entity response with OpenAiApi.ChatCompletion as a body and HTTP status code and headers.

chatCompletionStream

public reactor.core.publisher.Flux<OpenAiApi.ChatCompletionChunk> chatCompletionStream(OpenAiApi.ChatCompletionRequest chatRequest)

Creates a streaming chat response for the given chat conversation.

Parameters:

chatRequest - The chat completion request. Must have the stream property set to true.

Returns:

Returns a Flux stream from chat completion chunks.

chatCompletionStream

public reactor.core.publisher.Flux<OpenAiApi.ChatCompletionChunk> chatCompletionStream(OpenAiApi.ChatCompletionRequest chatRequest,
 org.springframework.util.MultiValueMap<String,String> additionalHttpHeader)

Creates a streaming chat response for the given chat conversation.

Parameters:

chatRequest - The chat completion request. Must have the stream property set to true.

additionalHttpHeader - Optional, additional HTTP headers to be added to the request.

Returns:

Returns a Flux stream from chat completion chunks.

embeddings

public <T>
org.springframework.http.ResponseEntity<OpenAiApi.EmbeddingList<OpenAiApi.Embedding>> embeddings(OpenAiApi.EmbeddingRequest<T> embeddingRequest)

Creates an embedding vector representing the input text or token array.

Type Parameters:

T - Type of the entity in the data list. Can be a String or List of tokens (e.g. Integers). For embedding multiple inputs in a single request, You can pass a List of String or List of List of tokens. For example:

List.of("text1", "text2", "text3") or List.of(List.of(1, 2, 3), List.of(3, 4, 5)) 

Parameters:

embeddingRequest - The embedding request.

Returns:

Returns list of OpenAiApi.Embedding wrapped in OpenAiApi.EmbeddingList.