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.
/v1beta/models/{model}:streamGenerateContentLiên tục trả về các khối dữ liệu GenerateContentResponse qua SSE.
Xác thực
bearerAuth Sử dụng Bearer your-api-key trong Header Authorization.
Vị trí truyền: header
Tham số đường dẫn
ID mô hình dùng để tạo nội dung. Đường dẫn tự động có dạng models/{model}.
"MODEL_ID"Tham số truy vấn
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.
"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/jsonDù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.
{
"contents": [
{
"role": "user",
"parts": [
{
"text": "Xin chào! Hãy giới thiệu bản thân."
}
]
}
]
}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.