Gemini 3.8 Flash

POST

/gemini/v1/models/gemini-3-8-flash: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.

Bodyapplication/json

🟠400

🟠401

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://api.kie.ai/gemini/v1/models/gemini-3-8-flash:streamGenerateContent' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "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": {
                                "laboref": true
                            },
                            "name": "get_weather_forecast",
                            "id": "gp737npz"
                        },
                        "thoughtSignature": "Es8CCswCAb4example",
                        "text": "Attollo video solium centum atque beatae."
                    }
                ]
            },
            "finishReason": "STOP"
        },
        {
            "content": {
                "role": "model",
                "parts": [
                    {
                        "functionCall": {
                            "args": {
                                "nisi_d": "non"
                            },
                            "name": "get_weather_forecast",
                            "id": "gp737npz"
                        },
                        "thoughtSignature": "Es8CCswCAb4example",
                        "text": "Vomito cresco aurum tempore arca minus defluo aegre. Confero urbanus aegrotatio ait venia currus triduana accendo cumque."
                    },
                    {
                        "functionCall": {
                            "args": {
                                "aute_5": 68657222,
                                "et8": 83540687,
                                "dolored5": -57007334,
                                "non062": "qui consectetur",
                                "cupidatat3": 874597.755033046
                            },
                            "name": "get_weather_forecast",
                            "id": "gp737npz"
                        },
                        "thoughtSignature": "Es8CCswCAb4example",
                        "text": "Vallum caritas turpis aegre tenuis ratione. Earum suscipit dicta utpote. Excepturi succurro cohaero amita vinculum ante ventosus.\nCattus creta quae aut possimus nam. Peccatus alveus aptus adinventitias. Quod depono terebro libero vomica allatus.\nCunabula saepe ter. Corrumpo accusantium quae. Paulatim adamo tutamen agnosco recusandae solitudo vesica."
                    }
                ]
            },
            "finishReason": "STOP"
        },
        {
            "content": {
                "role": "model",
                "parts": [
                    {
                        "functionCall": {
                            "args": {
                                "aliquip_400": 22065568.52843286,
                                "et_a": 4002533,
                                "sed_f3": -13790412.27446793
                            },
                            "name": "get_weather_forecast",
                            "id": "gp737npz"
                        },
                        "thoughtSignature": "Es8CCswCAb4example",
                        "text": "Adipisci varietas crustulum. Tamquam apparatus aestivus basium. Vivo natus conculco centum adulatio defaeco truculenter.\nDegusto molestiae quaerat suggero dignissimos. Coniuratio tolero adeptio contigo quibusdam tabella confido umquam caute velit. Consuasor angulus apostolus voco cuppedia urbanus voluptatum suus.\nVivo delibero arma vallum. Neque succedo compono audacia suppellex dignissimos. Degero voluptatem deleo substantia conforto bos tollo accusantium facilis."
                    },
                    {
                        "functionCall": {
                            "args": {
                                "laborum37": 39058633
                            },
                            "name": "get_weather_forecast",
                            "id": "gp737npz"
                        },
                        "thoughtSignature": "Es8CCswCAb4example",
                        "text": "Subvenio abscido denique volup viridis candidus theologus."
                    },
                    {
                        "functionCall": {
                            "args": {
                                "incididunt665": true
                            },
                            "name": "get_weather_forecast",
                            "id": "gp737npz"
                        },
                        "thoughtSignature": "Es8CCswCAb4example",
                        "text": "Peccatus suffragium ancilla tactus coniuratio cribro crepusculum victoria. Acceptus utrimque denego conor. Adfero audentia atrox arbitro."
                    }
                ]
            },
            "finishReason": "STOP"
        }
    ],
    "modelVersion": "gemini-3-8-flash",
    "usageMetadata": {
        "candidatesTokenCount": 18,
        "thoughtsTokenCount": 55,
        "totalTokenCount": 325,
        "promptTokenCount": 252
    },
    "credits_consumed": 0.01,
    "responseId": "xRS0aZC5BNHVz7IPuaO42Qk"
}

Gemini 3.7 Flash (openai)

Gemini 3.8 Flash (openai)

Gemini 3.8 Flash

Streaming Support#

Features#