Google Gemini API
  1. Text generation
Google Gemini API
  • Get API key
  • Release notes
  • Libraries
  • Run Gemini on Google Cloud
  • Model Capabilities
    • Overview
    • Long context
    • Structured output
    • Document understanding
    • Image understanding
    • Video understanding
    • Audio understanding
    • Text generation
      • Text input
        POST
      • Image input
        POST
      • Streaming output
        POST
      • Multi-turn conversations
        POST
      • Multi-turn conversations (Streaming)
        POST
      • Configuration parameters
        POST
    • Generate images
      • Generate images using Gemini
      • Image editing with Gemini
      • Generate images using Imagen 3
    • Gemini thinking
      • Use thinking models
      • Set budget on thinking models
    • Function calling
      • Function Calling with the Gemini API
  • models
    • All Model
    • Pricing
    • Rate limits
    • Billing info
  • Safety
    • Safety settings
    • Safety guidance
  • Schemas
    • Streaming output
  1. Text generation

Streaming output

POST
/v1beta/models/gemini-2.5-flash:streamGenerateContent
By default, the model returns a response after completing the entire text generation process. You can achieve faster interactions by using streaming to return instances of GenerateContentResponse as they're generated.

Request

Authorization
Add parameter in header
x-goog-api-key
Example:
x-goog-api-key: ********************
Query Params

Body Params application/json

Examples

Responses

🟢200成功
text/event-stream
Body

Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://generativelanguage.googleapis.com/v1beta/models/gemini-2.5-flash:streamGenerateContent?alt=sse' \
--header 'x-goog-api-key: <api-key>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "contents": [
      {
        "parts": [
          {
            "text": "Explain how AI works"
          }
        ]
      }
    ]
  }'
Response Response Example
data: {"candidates":[{"content":{"parts":[{"text":"Caput abduco decens aegrotatio circumvenio compello adduco tum."},{"text":"Demulceo allatus turba officiis conventus acies. Perspiciatis cervus titulus bonus combibo doloribus sodalitas. Validus adaugeo tollo eum.\nAbeo molestias dapifer candidus utpote concedo defleo unus cruciamentum. Aperio suasoria somniculosus ustulo tandem sordeo taceo voluptates conscendo. Ter totam sint calamitas.\nVacuus caput cogito corona crinis. Vindico tremo supplanto valetudo. Quisquam carbo perspiciatis vulgo coepi caute accedo clam conforto inventore."}],"role":"pariatur adipisicing"},"index":65727653}],"usageMetadata":{"promptTokenCount":-25592903,"candidatesTokenCount":-46248727,"totalTokenCount":4227987,"promptTokensDetails":[{"modality":"dolore","tokenCount":-59659863},{"modality":"mollit","tokenCount":-1455877},{"modality":"nisi eiusmod Excepteur","tokenCount":-9389861}],"thoughtsTokenCount":11903770},"modelVersion":"fugiat enim consectetur minim","responseId":"17"}

data: {"candidates":[{"content":{"parts":[{"text":"Tersus cras compono eius sophismata voluntarius conicio tibi vulariter."},{"text":"Tam appello tersus catena civis. Voluntarius caveo sonitus. Cultura venia cubicularis cilicium cariosus sit laboriosam sollicito perferendis.\nUtrum curriculum valens explicabo testimonium cursus aestivus vomica tabella. Anser cum textus sum verbera alienus autem vigilo tergeo demo. Vallum beatus talio sortitus ad volva id paens creator.\nUtrum aegrotatio consequatur cornu deporto crepusculum creber. Debilito temporibus acsi acies carcer aer varius aestivus soluta astrum. Ter denique tracto abundans curvo."},{"text":"Pariatur impedit cursus eligendi certus sulum verecundia bibo. Amoveo tabgo repellendus aegre volo tum varius. Magnam damnatio demonstro decor consequatur tenax carpo. Aeternus esse quas cupiditas arcus non celo. Bene succurro cohaero umbra cinis."}],"role":"veniam Lorem laborum"},"index":-71682085}],"usageMetadata":{"promptTokenCount":-29554216,"candidatesTokenCount":-53571051,"totalTokenCount":67145317,"promptTokensDetails":[{"modality":"in ut sit","tokenCount":-92883001},{"modality":"anim consequat","tokenCount":-30259885}],"thoughtsTokenCount":27913052},"modelVersion":"officia nisi laboris cillum proident","responseId":"100"}

...

data: {"candidates":[{"content":{"parts":[{"text":"Voluntarius tricesimus contego claustrum. Campana talus culpa ultra degusto dolorem ter magni blandior. Adulescens nostrum deleniti conitor.\nLaborum crux stabilis beatus vere decipio. Tristis possimus suppono. Sponte alius socius acerbitas desidero vorago sub tenax alius dens.\nRepellendus sponte acervus termes thymum crinis demergo. Neque aggero valeo supplanto contigo textilis supellex mollitia vado caelum. Vigilo demitto modi aureus."}],"role":"aute esse tempor"},"index":-20298674},{"content":{"parts":[{"text":"Ipsum adflicto sulum subito."}],"role":"ad sunt Excepteur velit"},"index":-48769023}],"usageMetadata":{"promptTokenCount":64769996,"candidatesTokenCount":91404234,"totalTokenCount":-76861353,"promptTokensDetails":[{"modality":"do","tokenCount":-94489197},{"modality":"do laborum in","tokenCount":13937012},{"modality":"irure","tokenCount":-26695444}],"thoughtsTokenCount":-81661437},"modelVersion":"nulla","responseId":"94"}

Modified at 2026-01-05 08:10:52
Previous
Image input
Next
Multi-turn conversations
Built with