AGTCloud API Docs
РуководстваСправочник APIИнтеграции и ресурсыОбновления и помощь
Текст и диалог

Gemini Stream Generate Content

Получайте результаты потоковой генерации SSE через Gemini Stream Generate Content.

API Stream Generate Content использует те же Content, Parts, Bearer-аутентификацию и настройки генерации, что и обычная генерация, и непрерывно возвращает блоки GenerateContentResponse через однонаправленный SSE. Он отличается от двунаправленного Live API на основе WebSocket.

Клиент должен разбирать каждое SSE data: по границам пустых строк, затем последовательно объединять текст или фрагменты Structured Output. Нельзя выполнять JSON.parse один раз для всего потока ответа. Промежуточные блоки могут не содержать finishReason; при появлении usageMetadata сохраняйте последнее значение. Одинаковый responseId связывает блоки одной генерации; если отсутствует candidates, проверьте promptFeedback.

POST/v1beta/models/{model}:streamGenerateContent

Непрерывно возвращает блоки GenerateContentResponse через SSE.

АутентификацияBearer <token>

Используйте Bearer your-api-key в Header Authorization.

Расположение: header

Параметры пути

model*string

ID модели для генерации. Путь автоматически формируется как models/{model}.

По умолчанию"MODEL_ID"

Параметры строки запроса

alt*"sse"

Выбирает транспортный формат SSE. Это параметр запроса URL, а не поле тела GenerateContentRequest.

По умолчанию"sse"

Допустимые значения

  • "sse"

Тело запроса

Gemini использует Content и Parts для текста, мультимодального ввода, инструментов и настроек генерации.

application/json
Текстовый диалог

Используйте Content user и model для одноходового или многоходового текстового диалога.

contents[]
Содержимое диалога по порядку.
parts[].text
Текст каждого сообщения.
role
Автор сообщения, обычно user или model.
application/json
{
  "contents": [
    {
      "role": "user",
      "parts": [
        {
          "text": "Здравствуйте! Представьтесь, пожалуйста."
        }
      ]
    }
  ]
}
Справочник полейВсе поля сохранены; описания выделяют особенности текущего сценария.

Используйте Content и text Part для одноходового или многоходового текстового диалога.

Тело ответа

text/event-stream

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

Структура данных SSE data

Следующие поля описывают JSON одного события data:, а не весь текстовый поток SSE.

Официальная документация Google Gemini Stream Generate ContentОпределение потокового протокола поставщика и последние изменения полей.