gemini-3-flash-v1betamodels

POST

/gemini/v1/models/gemini-3-flash-v1betamodels:streamGenerateContent

Streaming Support

Gemini 端点使用 streamGenerateContent 返回流式结果。函数调用结果会出现在 candidates[].content.parts[].functionCall 中。

Streaming Response Format:

Content-Type: text/event-stream 或提供方分块流

函数调用会在 parts[].functionCall 中返回

思考输出可能通过 thoughtSignature 和 usage 信息体现

Features

使用 contents 进行标准对话。

使用 googleSearch 启用联网搜索。

使用 functionDeclarations 进行函数调用。

使用 generationConfig.thinkingConfig 控制思考配置。

Request Notes

使用 contents 作为主要输入字段。

使用 tools.googleSearch 开启 Google Search。

使用 tools.functionDeclarations 定义可调用函数。

使用 generationConfig.thinkingConfig 控制思考输出与 thinking level。

Authentication

该接口使用鉴权配置中的 X-Goog-Api-Key，不作为普通请求参数填写。

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Body Params application/jsonRequired

Examples

Responses

🟢200

application/json

请求成功。

Body

🟠400

🟠401

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://api.kie.ai/gemini/v1/models/gemini-3-flash-v1betamodels:streamGenerateContent' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "stream": true,
    "contents": [
        {
            "role": "user",
            "parts": [
                {
                    "text": "What is the weather in Beijing today?"
                }
            ]
        }
    ],
    "tools": [
        {
            "functionDeclarations": [
                {
                    "name": "get_weather_forecast",
                    "description": "Get the weather forecast for a given location",
                    "parameters": {
                        "type": "OBJECT",
                        "properties": {
                            "location": {
                                "type": "STRING",
                                "description": "The city name, e.g. Beijing"
                            }
                        },
                        "required": [
                            "location"
                        ]
                    }
                }
            ]
        }
    ],
    "generationConfig": {
        "thinkingConfig": {
            "includeThoughts": true,
            "thinkingLevel": "high"
        }
    }
}'

Response Example

200 - 成功示例

{
    "candidates": [
        {
            "content": {
                "role": "model",
                "parts": [
                    {
                        "functionCall": {
                            "args": {
                                "location": "Beijing"
                            },
                            "name": "get_weather_forecast",
                            "id": "gp737npz"
                        },
                        "thoughtSignature": "Es8CCswCAb4example"
                    }
                ]
            },
            "finishReason": "STOP"
        }
    ],
    "modelVersion": "gemini-3-flash",
    "usageMetadata": {
        "candidatesTokenCount": 18,
        "thoughtsTokenCount": 55,
        "totalTokenCount": 325,
        "promptTokenCount": 252
    },
    "credits_consumed": 0.01,
    "responseId": "xRS0aZC5BNHVz7IPuaO42Qk"
}

Gemini 3 Flash

创建 Codex 响应

gemini-3-flash-v1betamodels

Streaming Support#

Features#