跳转到主要内容
POST
流式调用:将 URL 中的 generateContent 替换为 streamGenerateContent,请求体不变,响应逐块返回;可追加 ?alt=sse 获取 SSE 格式。
BaseURL 说明:默认 BaseURL 为 https://direct.evolink.ai,对文本模型支持更好、支持长连接;https://api.evolink.ai 为备用地址。

授权

Authorization
string
header
必填

##所有接口均需要使用Bearer Token进行认证##

获取 API Key:

访问 API Key 管理页面 获取您的 API Key

使用时在请求头中添加:

路径参数

model
enum<string>
必填

选择要调用的 Gemini 文本模型:

可用选项:
gemini-3.6-flash,
gemini-3.5-flash,
gemini-3.5-flash-lite,
gemini-3.1-pro-preview,
gemini-3.1-pro-preview-customtools,
gemini-3.1-flash-lite-preview,
gemini-3-pro-preview,
gemini-3-flash-preview,
gemini-2.5-pro,
gemini-2.5-flash,
gemini-2.5-flash-lite
示例:

"gemini-3.6-flash"

请求体

application/json
contents
object[]
必填

对话内容列表,支持多轮对话和多模态输入

Minimum array length: 1
systemInstruction
object

系统指令(可选),当前以文本为主

tools
object[]

模型可调用的工具列表,如函数调用或代码执行

toolConfig
object

工具调用配置(可选)

safetySettings
object[]

安全设置列表(可选)

generationConfig
object

生成配置参数(可选)

cachedContent
string

缓存内容名称,格式为 cachedContents/{cachedContent}

响应

内容生成成功

响应格式说明

  • 使用 generateContent 端点时,返回 GenerateContentResponse(等待完整响应后一次性返回)
  • 使用 streamGenerateContent 端点时,返回 StreamGenerateContentResponse(流式响应,逐块返回内容)
candidates
object[]

候选响应列表

promptFeedback
object
usageMetadata
object

使用量统计

modelVersion
string

模型版本

示例:

"gemini-3.6-flash"

responseId
string

响应 ID

示例:

"l-LoaPu0BPmo1dkP6ZPHiQc"