streamGenerateContent

请求参数

Path 参数

Header 参数

Body 参数application/json必填

示例

文字提问传递图片提问

{
  "contents": [
    {
      "role": "user",
      "parts": [
        {
          "text": "你好"
        }
      ]
    }
  ],
  "generationConfig": {
  }
}

请求示例代码

Shell

JavaScript

Java

Swift

Go

PHP

Python

HTTP

C

C#

Objective-C

Ruby

OCaml

Dart

R

cURL

文字提问传递图片提问

curl --location 'https://v1beta/models/:streamGenerateContent' \
--header 'Authorization: Bearer sk-xxxxxxxxxxx' \
--header 'Content-Type: application/json' \
--data '{
  "contents": [
    {
      "role": "user",
      "parts": [
        {
          "text": "你好"
        }
      ]
    }
  ],
  "generationConfig": {
  }
}'

返回响应

🟢200stream响应

text/event-stream

Bodytext/event-stream

示例

data: {"candidates":[{"content":{"parts":[{"text":"你好！请问有什么我可以帮您的？"}],"role":"model"}}],"modelVersion":"gemini-3.8-flash","responseId":"6-36aa4482-845a-4716-ad06-c308ae32ab6f","usageMetadata":{"candidatesTokenCount":9,"promptTokenCount":85,"promptTokensDetails":[{"modality":"TEXT","tokenCount":85}],"thoughtsTokenCount":228,"totalTokenCount":322}}

data: {"candidates":[{"content":{"parts":[{"thoughtSignature":"EoQICoEIARFNMg/gscwGmdm/J6bUaNx+EGJEcfDQiH5NzWASSco3+1hL2kURHn2Xik272lRR1sRYTPuHgOg8O//2jlRffWa4O2Wvaw/eu3LRgIj9J7XFDnzFvk1MUP/IkWhziLJSHlfPevf7mzzKHo2tYTQN7MLGK5C04m7FUAFRmTP1o3L7y5HDUz6ZzoeNDWv/njG6ASxRwnw+Pq1QDbEhte+8Gr3hhapLQbfZvOR8rBZ/JWkMC63uNly9GkMKxd2mVWxSo1coQ+nHrZhCQRBW9NklkfYCit5z8xgpUtudPGLtftGASJ5xGAFPlFZVsojlX7bgLhDbDusRvYd4pxx5TMjS43EPedUx4wIToGA/tz47OEVVQQLk+NuzAdLtXAOK+Yt3oEb5bo6m9FrAbebUWfOWV5VlgNricsiKIZqLxdqE+tKBVc+ws+iVOPGdGXYDxr3HpUkbUYcwcrmczM7M8LpuwEIs67NCRAfG9HkImR1/ikGo3aUv2DWIhUIU4XUbCjkukqnAJ5/IpxMYicYDpYMUO/14z+Sz8FwuK5NyCL1hAu2ux0aeF4MtcQxQw+43ZCJhuXD4L+qyD8w5isUJEqVqRV7+qWXlkaP9IUiUrOfMXx7AJjmBrHnzKd29e13yT+JwY2op3HutE80Jby51zrwg+WnizgBZRk7koOf1EDDMOtn36jtjxFXbRT8HMaHRHb5wnSwk8DaTO7xrLQH1Sc0UMiMigMCKEA9JM5WlsoDuTECgGMuFDKp1XBZP13TJaFT8H70oa6mojScFCTeNsMJ2rkA9xtVXQQDYSOfkQKu/jZMRhJEmRdHPywR7BoqU2xzBzivA2UjDWxv0/FtKkSYWYDXzmUBt4zAAAUqBi49A0Bgw+IVVUMXOTROcSdT54ve+qGr4hqqH6S1Ve27KQmdVxDUt4vvD6re5t1I32N/g/bqLm+fTaZ1eUH7z229rFp8xOo59ADkI9nQGqOa2e+MdMKWs4VA8UDBl6m5F1PO6BtTkKHtDW7IDg/084qE5lXPIv5Ss3EvSCk/acYV+891ur9w0Nv2zVmXcj9sU2e5vPFQPP94I+7dY1l75PDw8+2vuj1KxktIi+iZGehzsrgoyoVxftS7kVvKgiGyBO2Wvo3sF8pQy3d5oTbCn0zYYoFTXgbTKPEly3uE8gz6pPF2ehPNEetBkkCpPuIAFS09mlDkUfP+XHinwRRWrhwn7KAdffDPDTKwrLZWIKNWSA0nIuzlxr7Mmr9ATcYsjD57bQvsOYtEwZfyxLeauyJhDq6SvMqyrq4DRTK0buveC/vVJv6QwJj/7NUWDE2hDv21IoVXe1q5ihbLWYIlJEoj/ruijcIKnxdN0wL/OVBH6En4rMiA="}],"role":"model"},"finishReason":"STOP"}],"modelVersion":"gemini-3.8-flash","responseId":"6-36aa4482-845a-4716-ad06-c308ae32ab6f","usageMetadata":{"candidatesTokenCount":9,"promptTokenCount":85,"promptTokensDetails":[{"modality":"TEXT","tokenCount":85}],"thoughtsTokenCount":228,"totalTokenCount":322}}

data: {"candidates":[{"content":{"parts":[{}],"role":"model"},"finishReason":"STOP"}],"responseId":"6-36aa4482-845a-4716-ad06-c308ae32ab6f","usageMetadata":{"candidatesTokenCount":237,"promptTokenCount":85,"totalTokenCount":322}}