AGTCloud API Docs
Hướng dẫnAPI ReferenceTích hợp và tài nguyênCập nhật và hỗ trợ
Văn bản và hội thoại

Gemini Stream Generate Content

Nhận kết quả tạo nội dung qua luồng SSE bằng API Gemini Stream Generate Content.

API Stream Generate Content dùng cùng Content, Parts, xác thực Bearer và cấu hình tạo nội dung với API thông thường, đồng thời liên tục trả về các khối dữ liệu GenerateContentResponse qua SSE một chiều. API này khác với Live API hai chiều dựa trên WebSocket.

Phía máy khách cần phân tích từng SSE data: theo ranh giới dòng trống, rồi ghép các đoạn văn bản hoặc Structured Output theo thứ tự; không chạy JSON.parse một lần cho toàn bộ luồng phản hồi. Khối dữ liệu trung gian có thể không có finishReason; khi usageMetadata xuất hiện, lưu giá trị mới nhất. Cùng responseId dùng để liên kết các khối dữ liệu của cùng một lần tạo nội dung; nếu không có candidates, kiểm tra promptFeedback.

POST/v1beta/models/{model}:streamGenerateContent

Liên tục trả về các khối dữ liệu GenerateContentResponse qua SSE.

Xác thực

bearerAuth
Xác thựcBearer <token>

Sử dụng Bearer your-api-key trong Header Authorization.

Vị trí truyền: header

Tham số đường dẫn

model*string

ID mô hình dùng để tạo nội dung. Đường dẫn tự động có dạng models/{model}.

Giá trị mặc định"MODEL_ID"

Tham số truy vấn

alt*"sse"

Chọn định dạng truyền SSE. Tham số này nằm trong truy vấn URL, không thuộc nội dung yêu cầu GenerateContentRequest.

Giá trị mặc định"sse"

Giá trị được phép

  • "sse"

Nội dung yêu cầu

Gemini biểu diễn văn bản, đa phương thức, công cụ và cấu hình tạo nội dung bằng Content và Parts.

application/json
Hội thoại văn bản

Dùng Content với vai trò user và model để tổ chức hội thoại văn bản một hoặc nhiều lượt.

contents[]
Nội dung hội thoại theo thứ tự.
parts[].text
Nội dung văn bản trong mỗi tin nhắn.
role
Bên tạo tin nhắn, giá trị thường dùng là user hoặc model.
application/json
{
  "contents": [
    {
      "role": "user",
      "parts": [
        {
          "text": "Xin chào! Hãy giới thiệu bản thân."
        }
      ]
    }
  ]
}
Tham khảo trườngTập trường đầy đủ không thay đổi; phần mô tả nhấn mạnh tình huống sử dụng hiện tại.

Dùng Content và text Part để tổ chức hội thoại văn bản một hoặc nhiều lượt.

Nội dung phản hồi

text/event-stream

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

Cấu trúc dữ liệu SSE

Các trường dưới đây mô tả JSON trong một sự kiện data:, không phải toàn bộ luồng văn bản SSE.

Tài liệu chính thức Google Gemini Stream Generate ContentXem định nghĩa giao thức dạng luồng phía nhà cung cấp và các thay đổi trường mới nhất.