Gemini 3.8 Flash
POST
/gemini/v1/models/gemini-3-8-flash:streamGenerateContent
WARNING
⚠️ 仅支持对话调用
该模型目前仅支持对话调用，暂未适配 Agent 场景。若将其接入 Agent 使用，可能会出现请求报错或结果异常。
Streaming Support
Gemini 端点使用 streamGenerateContent 返回流式结果。函数调用结果会出现在 candidates[].content.parts[].functionCall 中。
Streaming Response Format:
- Content-Type：text/event-stream。最后一个数据块带 usageMetadata 与 credits_consumed，随后是 data: [DONE]。
- 函数调用会在
parts[].functionCall中返回 - 思考输出可能通过
thoughtSignature和 usage 信息体现
Features
- 使用
contents进行标准对话。 - 使用
googleSearch启用联网搜索。 - 使用
functionDeclarations进行函数调用。 - 使用
generationConfig.thinkingConfig控制思考配置。
Request Notes
- 使用
contents作为主要输入字段。 - 使用
tools.googleSearch开启 Google Search。 - 使用
tools.functionDeclarations定义可调用函数。 - 使用
generationConfig.thinkingConfig控制思考输出与 thinking level。
Authentication
鉴权：请求头携带 Authorization: Bearer YOUR_API_KEY。
错误响应
错误以 HTTP 200 返回，响应体为 {"code": , "msg": "<原因>"}。读取 choices/candidates 前请先判断 code（200 为成功）。
Request
Body Params application/jsonRequired
Responses
Request 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 Response Example
{
"candidates": [
{
"content": {
"role": "model",
"parts": [
{
"text": "Hello! How can I help you today?"
}
]
},
"finishReason": "STOP"
}
],
"usageMetadata": {
"promptTokenCount": 5,
"candidatesTokenCount": 9,
"thinkingTokenCount": 0,
"totalTokenCount": 14
},
"credits_consumed": 0.01
}