文本对话 - 流式输出（Gemini 格式）

POST

/v1beta/models/{model}:streamGenerateContent

与 generateContent 接口相同，但以流式（SSE）方式返回结果。

请求参数与 generateContent 完全一致。

请求参数

Path 参数

Body 参数application/json必填

示例

{
    "contents": [
        {
            "role": "user",
            "parts": [
                {
                    "text": "string",
                    "inlineData": {
                        "mimeType": "string",
                        "data": "string"
                    }
                }
            ]
        }
    ],
    "systemInstruction": {
        "role": "user",
        "parts": [
            {
                "text": "string",
                "inlineData": {
                    "mimeType": "string",
                    "data": "string"
                }
            }
        ]
    },
    "generationConfig": {
        "temperature": 0,
        "topP": 0,
        "topK": 0,
        "maxOutputTokens": 0,
        "stopSequences": [
            "string"
        ],
        "responseMimeType": "text/plain",
        "thinkingConfig": {
            "thinkingBudget": 0
        }
    },
    "safetySettings": [
        {
            "category": "string",
            "threshold": "string"
        }
    ],
    "tools": [
        {}
    ]
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location 'https://jiniu.ai/v1beta/models/:streamGenerateContent' \
--header 'Content-Type: application/json' \
--data '{
    "contents": [
        {
            "role": "user",
            "parts": [
                {
                    "text": "string",
                    "inlineData": {
                        "mimeType": "string",
                        "data": "string"
                    }
                }
            ]
        }
    ],
    "systemInstruction": {
        "role": "user",
        "parts": [
            {
                "text": "string",
                "inlineData": {
                    "mimeType": "string",
                    "data": "string"
                }
            }
        ]
    },
    "generationConfig": {
        "temperature": 0,
        "topP": 0,
        "topK": 0,
        "maxOutputTokens": 0,
        "stopSequences": [
            "string"
        ],
        "responseMimeType": "text/plain",
        "thinkingConfig": {
            "thinkingBudget": 0
        }
    },
    "safetySettings": [
        {
            "category": "string",
            "threshold": "string"
        }
    ],
    "tools": [
        {}
    ]
}'

返回响应

🟢200成功

text/event-stream

流式返回生成结果（SSE）

Bodytext/event-stream

示例

null

修改于 2026-05-25 14:37:10

文本对话（Gemini 格式）

生成图像（文生图）