com.litongjava.gemini

Class GeminiClient

java.lang.Object

com.litongjava.gemini.GeminiClient

public class GeminiClient
extends Object

Google Gemini 模型客户端示例

Field Summary

Fields

Modifier and Type	Field and Description
static boolean	debug
static okhttp3.OkHttpClient	httpClient

Constructor Summary

Constructors

Constructor and Description
GeminiClient()

Method Summary

Modifier and Type	Method and Description
static String	chatWithModel(String model, String role, String prompt)
static String	chatWithModel(String apiKey, String model, String role, String prompt)
static GeminiCacheVo	createCache(GeminiCreateCacheRequestVo requestVo) Creates a new cached content entry using API key from environment.
static GeminiCacheVo	createCache(String googleApiKey, GeminiCreateCacheRequestVo requestVo) Creates a new cached content entry.
static void	deleteCache(String cacheName) Deletes a cached content entry using API key from environment.
static void	deleteCache(String googleApiKey, String cacheName) Deletes a cached content entry.
static GeminiChatResponseVo	generate(String modelName, GeminiChatRequestVo requestVo)
static okhttp3.Response	generate(String modelName, String bodyString)
static GeminiChatResponseVo	generate(String googleApiKey, String modelName, GeminiChatRequestVo requestVo) 单次生成内容 (同步请求) POST https://generativelanguage.googleapis.com/v1beta/models/{model_name}:generateContent?key={GOOGLE_API_KEY}
static okhttp3.Response	generate(String googleApiKey, String modelName, String bodyString)
static GeminiChatResponseVo	generate(String baseUrl, String googleApiKey, String modelName, GeminiChatRequestVo requestVo)
static GeminiCacheVo	getCache(String cacheName) Gets metadata for a specific cached content entry using API key from environment.
static GeminiCacheVo	getCache(String googleApiKey, String cacheName) Gets metadata for a specific cached content entry.
static GeminiListCachesResponseVo	listCaches() Lists metadata for all cached content entries using API key from environment.
static GeminiListCachesResponseVo	listCaches(String googleApiKey) Lists metadata for all cached content entries.
static String	parseYoutubeSubtitle(String model, String url, String userPrompt)
static okhttp3.Call	stream(String modelName, GeminiChatRequestVo requestVo, okhttp3.Callback callback)
static okhttp3.sse.EventSource	stream(String modelName, GeminiChatRequestVo requestVo, okhttp3.sse.EventSourceListener listener)
static okhttp3.Call	stream(String modelName, String bodyString, okhttp3.Callback callback)
static okhttp3.sse.EventSource	stream(String modelName, String bodyString, okhttp3.sse.EventSourceListener listener)
static okhttp3.Call	stream(String googleApiKey, String modelName, GeminiChatRequestVo requestVo, okhttp3.Callback callback) 流式生成内容 (SSE，异步请求) POST https://generativelanguage.googleapis.com/v1beta/models/{model_name}:streamGenerateContent?alt=sse&key={GOOGLE_API_KEY} 注：请求体还是 JSON，但响应会通过 SSE 分段返回.
static okhttp3.sse.EventSource	stream(String googleApiKey, String modelName, GeminiChatRequestVo requestVo, okhttp3.sse.EventSourceListener listener)
static okhttp3.Call	stream(String googleApiKey, String modelName, String bodyString, okhttp3.Callback callback)
static okhttp3.sse.EventSource	stream(String googleApiKey, String modelName, String bodyString, okhttp3.sse.EventSourceListener listener)
static GeminiCacheVo	updateCache(String cacheName, GeminiUpdateCacheRequestVo updateRequestVo) Updates a cached content entry using API key from environment.
static GeminiCacheVo	updateCache(String googleApiKey, String cacheName, GeminiUpdateCacheRequestVo updateRequestVo) Updates a cached content entry (only ttl or expireTime can be updated).
static FileUploadResponseVo	uploadFile(byte[] bytes) 重载方法，从环境变量中获取 API Key
static String	uploadFile(String googleApiKey, byte[] bytes) 上传文件到 Google Gemini API

Methods inherited from class java.lang.Object

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

Field Detail

debug

public static boolean debug

httpClient

public static final okhttp3.OkHttpClient httpClient

Constructor Detail

GeminiClient

public GeminiClient()

Method Detail

generate

public static GeminiChatResponseVo generate(String googleApiKey,
                                            String modelName,
                                            GeminiChatRequestVo requestVo)

单次生成内容 (同步请求) POST https://generativelanguage.googleapis.com/v1beta/models/{model_name}:generateContent?key={GOOGLE_API_KEY}

Parameters:

googleApiKey - - 你的 Google API Key

modelName - - 要使用的模型名称，如 "gemini-1.5-flash"

requestVo - - 请求体实体

Returns:

GeminiResponseVo - 响应实体

generate

public static GeminiChatResponseVo generate(String baseUrl,
                                            String googleApiKey,
                                            String modelName,
                                            GeminiChatRequestVo requestVo)

generate

public static GeminiChatResponseVo generate(String modelName,
                                            GeminiChatRequestVo requestVo)

generate

public static okhttp3.Response generate(String modelName,
                                        String bodyString)

generate

public static okhttp3.Response generate(String googleApiKey,
                                        String modelName,
                                        String bodyString)

chatWithModel

public static String chatWithModel(String model,
                                   String role,
                                   String prompt)

Parameters:

model -

role -

prompt -

Returns:

chatWithModel

public static String chatWithModel(String apiKey,
                                   String model,
                                   String role,
                                   String prompt)

Parameters:

apiKey -

model -

role -

prompt -

Returns:

stream

public static okhttp3.Call stream(String googleApiKey,
                                  String modelName,
                                  GeminiChatRequestVo requestVo,
                                  okhttp3.Callback callback)

流式生成内容 (SSE，异步请求) POST https://generativelanguage.googleapis.com/v1beta/models/{model_name}:streamGenerateContent?alt=sse&key={GOOGLE_API_KEY} 注：请求体还是 JSON，但响应会通过 SSE 分段返回.

Parameters:

googleApiKey - - 你的 Google API Key

modelName - - 要使用的模型名称

requestVo - - 请求体

callback - - 用于处理 SSE 流式回调

Returns:

OkHttp Call 对象，可根据需求执行取消等操作

stream

public static okhttp3.sse.EventSource stream(String googleApiKey,
                                             String modelName,
                                             GeminiChatRequestVo requestVo,
                                             okhttp3.sse.EventSourceListener listener)

stream

public static okhttp3.Call stream(String modelName,
                                  GeminiChatRequestVo requestVo,
                                  okhttp3.Callback callback)

stream

public static okhttp3.sse.EventSource stream(String modelName,
                                             GeminiChatRequestVo requestVo,
                                             okhttp3.sse.EventSourceListener listener)

stream

public static okhttp3.Call stream(String modelName,
                                  String bodyString,
                                  okhttp3.Callback callback)

stream

public static okhttp3.sse.EventSource stream(String modelName,
                                             String bodyString,
                                             okhttp3.sse.EventSourceListener listener)

stream

public static okhttp3.Call stream(String googleApiKey,
                                  String modelName,
                                  String bodyString,
                                  okhttp3.Callback callback)

stream

public static okhttp3.sse.EventSource stream(String googleApiKey,
                                             String modelName,
                                             String bodyString,
                                             okhttp3.sse.EventSourceListener listener)

uploadFile

public static String uploadFile(String googleApiKey,
                                byte[] bytes)

上传文件到 Google Gemini API

Parameters:

googleApiKey - - 你的 Google API Key

parseYoutubeSubtitle

public static String parseYoutubeSubtitle(String model,
                                          String url,
                                          String userPrompt)

uploadFile

public static FileUploadResponseVo uploadFile(byte[] bytes)

重载方法，从环境变量中获取 API Key

Parameters:

displayName - - 文件的显示名称

file - - 要上传的文件

mimeType - - 文件的 MIME 类型

Returns:

String - 上传后文件的 URI

createCache

public static GeminiCacheVo createCache(String googleApiKey,
                                        GeminiCreateCacheRequestVo requestVo)

Creates a new cached content entry. POST https://generativelanguage.googleapis.com/v1beta/cachedContents?key={GOOGLE_API_KEY}

Parameters:

googleApiKey - - Your Google API Key

requestVo - - The request body for creating the cache

Returns:

GeminiCacheVo - The created cache metadata

createCache

public static GeminiCacheVo createCache(GeminiCreateCacheRequestVo requestVo)

Creates a new cached content entry using API key from environment.

Parameters:

requestVo - - The request body for creating the cache

Returns:

GeminiCacheVo - The created cache metadata

getCache

public static GeminiCacheVo getCache(String googleApiKey,
                                     String cacheName)

Gets metadata for a specific cached content entry. GET https://generativelanguage.googleapis.com/v1beta/{cache_name}?key={GOOGLE_API_KEY}

Parameters:

googleApiKey - - Your Google API Key

cacheName - - The full name of the cache (e.g., "cachedContents/12345")

Returns:

GeminiCacheVo - The cache metadata

getCache

public static GeminiCacheVo getCache(String cacheName)

Gets metadata for a specific cached content entry using API key from environment.

Parameters:

cacheName - - The full name of the cache (e.g., "cachedContents/12345")

Returns:

GeminiCacheVo - The cache metadata

listCaches

public static GeminiListCachesResponseVo listCaches(String googleApiKey)

Lists metadata for all cached content entries. GET https://generativelanguage.googleapis.com/v1beta/cachedContents?key={GOOGLE_API_KEY}

Parameters:

googleApiKey - - Your Google API Key

Returns:

GeminiListCachesResponseVo - A list of cache metadata

listCaches

public static GeminiListCachesResponseVo listCaches()

Lists metadata for all cached content entries using API key from environment.

Returns:

GeminiListCachesResponseVo - A list of cache metadata

updateCache

public static GeminiCacheVo updateCache(String googleApiKey,
                                        String cacheName,
                                        GeminiUpdateCacheRequestVo updateRequestVo)

Updates a cached content entry (only ttl or expireTime can be updated). PATCH https://generativelanguage.googleapis.com/v1beta/{cache_name}?key={GOOGLE_API_KEY}

Parameters:

googleApiKey - - Your Google API Key

cacheName - - The full name of the cache (e.g., "cachedContents/12345")

updateRequestVo - - The request body containing the fields to update (ttl or expireTime)

Returns:

GeminiCacheVo - The updated cache metadata

updateCache

public static GeminiCacheVo updateCache(String cacheName,
                                        GeminiUpdateCacheRequestVo updateRequestVo)

Updates a cached content entry using API key from environment.

Parameters:

cacheName - - The full name of the cache (e.g., "cachedContents/12345")

updateRequestVo - - The request body containing the fields to update (ttl or expireTime)

Returns:

GeminiCacheVo - The updated cache metadata

deleteCache

public static void deleteCache(String googleApiKey,
                               String cacheName)

Deletes a cached content entry. DELETE https://generativelanguage.googleapis.com/v1beta/{cache_name}?key={GOOGLE_API_KEY}

Parameters:

googleApiKey - - Your Google API Key

cacheName - - The full name of the cache (e.g., "cachedContents/12345")

deleteCache

public static void deleteCache(String cacheName)

Deletes a cached content entry using API key from environment.

Parameters:

cacheName - - The full name of the cache (e.g., "cachedContents/12345")