Skip to main content
POST

授权

Authorization
string
header
必填

使用来自 https://omniall.ai/dashboard 的 Authorization: Bearer sk-...

请求头

x-goog-api-key
string

可选的 Gemini 风格 API Key 请求头。

路径参数

model
string
必填

Gemini 模型 ID(见模型广场 / GET /v1/models)。

示例:

"gemini-3.1-flash-image-preview"

查询参数

key
string

可选的 Gemini 风格 API Key 查询参数。

请求体

application/json

Gemini 原生 generateContent 请求体(由 Omniall AI 转发)。最少包含一个 contents 轮次;生图时请设置 generationConfig.responseModalities 包含 IMAGE。

contents
object[]
必填

发给 Gemini 的有序对话轮次。每项为 user 或 model 的一条消息。

systemInstruction
object

可选系统级指令,用于引导整次请求的模型行为(人设、输出

tools
object[]

模型可调用的可选工具。例如启用时用 { "googleSearch": {} } 做接地/联网,或用 { "functionDeclarations": [ ... ] } 声明自有 Agent 函数。是否可用取决于模型/渠道。

toolConfig
object

控制工具选择方式(如函数调用模式)。透传为 Gemini toolConfig

generationConfig
object

本次生成的采样与输出控制。

safetySettings
object[]

按类别的安全阈值(骚扰、仇恨、色情、危险内容等)。需要时使用

响应

Gemini 响应 JSON(streamGenerateContent 时为 SSE)。

Gemini generateContent 响应。从第一个 candidate 的 content.parts 读取回答文本/图像。

candidates
object[]

一个或多个候选回复。通常使用 candidates[0]。

usageMetadata
object

用于计费/排查的 token 用量。