com.litongjava.gemini

类 GeminiClient

java.lang.Object

com.litongjava.gemini.GeminiClient

public class GeminiClient
extends Object

Google Gemini 模型客户端示例

字段概要

字段

限定符和类型	字段和说明
static boolean	debug
static okhttp3.OkHttpClient	httpClient

构造器概要

构造器

构造器和说明
GeminiClient()

方法概要

限定符和类型	方法和说明
static String	chatWithModel(String model, String role, String prompt)
static String	chatWithModel(String apiKey, String model, String role, String prompt)
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?
static okhttp3.Response	generate(String googleApiKey, String modelName, String bodyString)
static GeminiChatResponseVo	generate(String baseUrl, String googleApiKey, String modelName, GeminiChatRequestVo requestVo)
static okhttp3.Call	stream(String modelName, GeminiChatRequestVo requestVo, okhttp3.Callback callback)
static okhttp3.Call	stream(String modelName, String bodyString, okhttp3.Callback callback)
static okhttp3.Call	stream(String googleApiKey, String modelName, GeminiChatRequestVo requestVo, okhttp3.Callback callback) 流式生成内容 (SSE，异步请求) POST https://generativelanguage.googleapis.com/v1beta/models/{model_name}:streamGenerateContent?
static okhttp3.Call	stream(String googleApiKey, String modelName, String bodyString, okhttp3.Callback callback)
static FileUploadResponseVo	uploadFile(byte[] bytes) 重载方法，从环境变量中获取 API Key
static String	uploadFile(String googleApiKey, byte[] bytes) 上传文件到 Google Gemini API

从类继承的方法 java.lang.Object

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

字段详细资料

debug

public static boolean debug

httpClient

public static final okhttp3.OkHttpClient httpClient

构造器详细资料

GeminiClient

public GeminiClient()

方法详细资料

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}

参数:

googleApiKey - - 你的 Google API Key

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

requestVo - - 请求体实体

返回:

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)

参数:

model -

role -

prompt -

返回:

chatWithModel

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

参数:

apiKey -

model -

role -

prompt -

返回:

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 分段返回.

参数:

googleApiKey - - 你的 Google API Key

modelName - - 要使用的模型名称

requestVo - - 请求体

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

返回:

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

stream

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

stream

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

stream

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

uploadFile

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

上传文件到 Google Gemini API

参数:

googleApiKey - - 你的 Google API Key

uploadFile

public static FileUploadResponseVo uploadFile(byte[] bytes)

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

参数:

displayName - - 文件的显示名称

file - - 要上传的文件

mimeType - - 文件的 MIME 类型

返回:

String - 上传后文件的 URI