# Streaming output

## OpenAPI Specification

```yaml
openapi: 3.0.1
info:
  title: ''
  description: ''
  version: 1.0.0
paths:
  /v1beta/models/gemini-2.5-flash:streamGenerateContent:
    post:
      summary: Streaming output
      deprecated: false
      description: >-
        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`](https://ai.google.dev/api/generate-content#v1beta.GenerateContentResponse)
        as they're generated.
      tags:
        - Model Capabilities/Text generation
      parameters:
        - name: alt
          in: query
          description: ''
          required: true
          example: sse
          schema:
            type: string
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                contents:
                  type: array
                  items:
                    type: object
                    properties:
                      parts:
                        type: array
                        items:
                          type: object
                          properties:
                            text:
                              type: string
              required:
                - contents
            example:
              contents:
                - parts:
                    - text: Explain how AI works
      responses:
        '200':
          description: ''
          content:
            text/event-stream:
              schema:
                type: object
                properties: {}
                x-apidog-orders: []
              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"}

          headers: {}
          x-apidog-name: 成功
      security: []
      x-apidog-folder: Model Capabilities/Text generation
      x-apidog-status: released
      x-run-in-apidog: https://app.apidog.com/web/project/892755/apis/api-16240702-run
components:
  schemas: {}
  securitySchemes:
    apikey-header-x-goog-api-key:
      type: apiKey
      in: header
      name: x-goog-api-key
servers:
  - url: https://generativelanguage.googleapis.com
    description: Prod Env
security:
  - apikey-header-x-goog-api-key: []

```