Package org.mockserver.llm.codec

Class GeminiCodec

java.lang.Object

org.mockserver.llm.codec.GeminiCodec

All Implemented Interfaces:

ProviderCodec

public class GeminiCodec
extends Object
implements ProviderCodec

Codec for Google Gemini generateContent API (version v1beta-2025). Encodes MockServer Completion objects into Gemini-format HTTP responses for both non-streaming and streaming (SSE) paths.

Gemini uses candidates with content.parts instead of the OpenAI choices structure. Streaming sends SSE data: chunks each containing a partial candidates array.

Constructor Summary

Constructors

Constructor	Description
GeminiCodec()

Method Summary

Modifier and Type	Method	Description
String	apiVersion()
ParsedConversation	decode(HttpRequest request)
HttpResponse	encode(Completion completion, String model)
HttpResponse	encodeEmbedding(EmbeddingResponse embedding, String input)	Encodes a Gemini embedContent response (POST /v1beta/models/{model}:embedContent).
List<SseEvent>	encodeStreaming(Completion completion, String model, StreamingPhysics physics)
Provider	provider()

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.mockserver.llm.ProviderCodec

encodeEmbedding, encodeRerank, streamingFormat

Constructor Details

GeminiCodec

public GeminiCodec()

Method Details

provider

public Provider provider()

Specified by:

provider in interface ProviderCodec

apiVersion

public String apiVersion()

Specified by:

apiVersion in interface ProviderCodec

encode

public HttpResponse encode(Completion completion,
 String model)

Specified by:

encode in interface ProviderCodec

encodeStreaming

public List<SseEvent> encodeStreaming(Completion completion,
 String model,
 StreamingPhysics physics)

Specified by:

encodeStreaming in interface ProviderCodec

decode

public ParsedConversation decode(HttpRequest request)

Specified by:

decode in interface ProviderCodec

encodeEmbedding

public HttpResponse encodeEmbedding(EmbeddingResponse embedding,
 String input)

Encodes a Gemini embedContent response (POST /v1beta/models/{model}:embedContent). The response carries a single embedding object with a values array ({"embedding":{"values":[...]}}). The Gemini default dimensionality for text-embedding-004 is 768.

Specified by:

encodeEmbedding in interface ProviderCodec