Skip to main content
POST
对话补全

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
model
enum<string>
required

用于补全的 Gemini 模型 ID。

Available options:
gemini-3.1-pro-preview,
gemini-3.1-flash-image-preview,
gemini-3.1-flash-lite-preview,
gemini-3-pro-preview,
gemini-3-pro-image-preview,
gemini-3-flash-preview,
gemini-2.5-pro,
gemini-2.5-flash,
gemini-2.5-flash-lite,
gemini-2.0-flash
Example:

"gemini-2.5-pro"

messages
object[]
required

组成当前对话的消息列表。

Minimum array length: 1
Example:
max_tokens
integer

对话补全中生成的最大 token 数。

Required range: x >= 1
temperature
number
default:1

采样温度,范围 0 到 2。

Required range: 0 <= x <= 2
Example:

1

top_p
number

核采样阈值。

Required range: 0 <= x <= 1
frequency_penalty
number
default:0

根据新 token 在文本中的现有频率进行惩罚。

Required range: -2 <= x <= 2
presence_penalty
number
default:0

根据新 token 是否已出现在文本中进行惩罚。

Required range: -2 <= x <= 2
stream
boolean
default:false

如果为 true,将通过 SSE 流式发送部分消息。

stop

API 将在生成这些序列时停止继续生成。

n
integer
default:1

为每条输入消息生成多少个补全选项。

Required range: x >= 1
response_format
object

指定模型必须输出的格式。设置为 {"type": "json_object"} 可启用 JSON 模式。

Response

补全生成成功

id
string
required
Example:

"chatcmpl-abc123"

object
string
required
Example:

"chat.completion"

created
integer
required

补全创建时的 Unix 时间戳。

model
string
required
Example:

"gemini-2.5-pro"

choices
object[]
required
usage
object