gemini-3-flash-v1betamodels

POST

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

Streaming Support

The Gemini endpoint returns streaming chunks from streamGenerateContent. Function calling responses appear in candidates[].content.parts[].functionCall.

Streaming Response Format:

Content-Type: text/event-stream or provider stream chunks

Function calls are returned inside parts[].functionCall

Thinking output may be reflected through thoughtSignature and usage metadata

Features

Standard chat with contents.

Google Search grounding with googleSearch.

Function calling with functionDeclarations.

Thinking configuration with generationConfig.thinkingConfig.

Request Notes

Use contents as the primary conversation input.

Use tools.googleSearch to enable Google Search grounding.

Use tools.functionDeclarations to define callable functions.

Use generationConfig.thinkingConfig to control thoughts output and thinking level.

Authentication

Use the auth configuration for X-Goog-Api-Key. Do not add it as a regular request parameter.

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

Request successful.

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

Create Codex Response

gemini-3-flash-v1betamodels

Streaming Support#

Features#