聊天接口

参数说明参考 Gemini 官方文档：https://ai.google.dev/gemini-api/docs
目前支持模型 gemini-2.0-flash，gemini-2.0-flash-lite 和 gemini-2.0-flash-lite-preview-02-05。

请求参数

Header 参数

Content-Type

string

必需

默认值:

application/json

Authorization

string

必需

Bearer 你的forwardKey/customKey/API Token

默认值:

Bearer fk....

Body 参数application/json

model

enum<string>

必需

枚举值:

gemini-2.0-flashgemini-2.0-flash-lite-preview-02-05

messages

array [object {2}]

必需

<= 1 items

role

string

必需

content

string

必需

safe_mode

boolean

可选

默认为 false，为 true 时会尝试让 GPT 自己审查内容，不输出违规结果。由于 GPT 的调性，效果好坏比较随机。总的来说对暴力、色情内容效果较好，政治类效果一般。开启后会每次访问会增加约 1P 的消耗

默认值:

false

moderation

boolean

可选

默认为 false，为 true 时会调用文本安全接口对内容进行判定，并将审核结果添加到返回值中的 moderation 字段，开发者可以根据值自行判断如何处理。审核输出的详细解释：https://cloud.tencent.com/document/product/1124/51860 开启后每 9000 字符会增加 10P 的消耗

默认值:

false

moderation_stop

boolean

可选

默认为 false，在 moderation 为 true 且自身也为 true 时，如果审核结果不是 Pass，将自动进行内容拦截，对流也生效

默认值:

false

stream

boolean

可选

流方式返回，兼容官方参数，但因为有计费和审核逻辑，比官方流慢。

默认值:

false

max_tokens

integer

可选

如果不指定，每次请求会预先冻结模型支持的最大个数 Token，如果是 3.5 也就是 41P ，在请求完成后按 usage 字段多退少补。如果账户余额少于 41P 就会报错，此时可以指定 max_tokens，这样就会按 max_tokens 来冻结

示例

{
  "model": "gemini-2.0-flash",
  "messages": [
    {
      "role": "string",
      "content": "string"
    }
  ],
  "safe_mode": "false",
  "moderation": "false",
  "moderation_stop": "false",
  "stream": "false",
  "max_tokens": 0
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

请求参数

示例代码

返回响应