Gemini gốc
Tạo nội dung dạng Stream
Tạo nội dung dạng stream bằng định dạng Google Gemini API
Phiên bản SSE của Gemini generateContent. Các event có thể chỉ chứa metadata hoặc nội dung trung gian mà không có finishReason. Stream kết thúc tại EOF tự nhiên và không thêm ký hiệu [DONE].
Tham số đường dẫn
Tên model (ví dụ: gemini-2.5-pro, gemini-3.5-flash).
Tham số Query
API key (phương thức thay thế cho xác thực qua header).
Xác thực
Tương tự như Tạo nội dung: ?key=, x-goog-api-key, hoặc Authorization: Bearer.
Phần thân yêu cầu (Request Body)
Tương tự như Tạo nội dung. Bao gồm các mảng parts đa phương thức với các phần hình ảnh inline_data có cấu trúc cho các request vision.
Khả năng hỗ trợ cho generationConfig.candidateCount, tools, loại media và các trường tùy chọn khác phụ thuộc vào model được chọn.
Phản hồi
Trả về Server-Sent Events của Gemini. Các event chỉ chứa metadata, các chunk trung gian không có finishReason và EOF tự nhiên đều hợp lệ. Stream không thêm ký hiệu kết thúc [DONE] của Chat Completions. Mỗi event là một dòng data: chứa một chunk JSON. Phản hồi luôn ở dạng SSE; alt=sse được chấp nhận nhưng không bắt buộc.
Lỗi xảy ra trước event đầu tiên sẽ trả về lỗi JSON Gemini với các mã tương tự như Tạo nội dung.
Yêu cầu
curl -N -X POST "https://api.tokenlab.sh/v1beta/models/gemini-2.5-pro:streamGenerateContent?key=sk-your-api-key" \
-H "Content-Type: application/json" \
-d '{
"contents": [
{
"parts": [{"text": "Tell me a story"}]
}
]
}'Phản hồi
{
"candidates": [
{
"content": {
"role": "model",
"parts": [
{"text": "Once upon a time"}
]
}
}
]
}Ví dụ đầu vào Vision
Các request vision dạng stream sử dụng cùng cấu trúc contents[].parts[] như endpoint không stream.
{
"contents": [
{
"role": "user",
"parts": [
{ "text": "Please describe this image." },
{
"inline_data": {
"mime_type": "image/jpeg",
"data": "/9j/4AAQSkZJRgABAQ..."
}
}
]
}
]
}Xác thực bằng Khóa API. Tạo hoặc quản lý khóa API trong Dashboard > API > API Keys.
Vị trí: header
Tham số đường dẫn
Tên model (ví dụ: gemini-2.5-pro)
Tham số truy vấn
API key (thay thế cho xác thực bằng header)
Header
Chính sách phân phối theo yêu cầu. Ghi đè các mặc định của API key và Workspace. Tự động thử TokenLab Verified trước và có thể chuyển đổi một lần sang Official chỉ trước khi xuất, chấp nhận yêu cầu hoặc tạo tài nguyên cố định.
Giá trị hợp lệ
- "auto"
- "verified"
- "official"
Nội dung yêu cầu
application/json
Yêu cầu GenerateContent Gemini gốc. Cả tên ProtoJSON lowerCamelCase và tên proto snake_case gốc đều được chấp nhận và bảo toàn, bao gồm cả các yêu cầu hỗn hợp. Nếu cả hai cách viết của một trường đều có mặt, TokenLab không hợp nhất chúng hoặc chọn ưu tiên cục bộ. Các trường không xác định được chuyển tiếp trên cơ sở nỗ lực tốt nhất.
Phản hồi
text/event-stream
application/json
application/json
application/json
application/json
application/json