Tham số đường dẫn
string
bắt buộc
Tên mô hình (ví dụ:
gemini-2.5-pro, gemini-3.5-flash).Tham số truy vấn
string
API key (phương thức thay thế cho xác thực qua header).
Xác thực
Các endpoint của Gemini hỗ trợ nhiều phương thức xác thực:?key=YOUR_API_KEYtham số truy vấn- tiêu đề
x-goog-api-key: YOUR_API_KEY - tiêu đề
Authorization: Bearer YOUR_API_KEY
Thân yêu cầu
array
bắt buộc
Nội dung hội thoại. Giá trị
role và mọi parts được giữ nguyên như đã gửi; TokenLab không trim/lowercase, viết lại Base64 hay suy luận MIME. inlineData / inline_data và fileData / file_data đều là cách viết chính thức, và TokenLab không bắt buộc fileData.mimeType ở cục bộ. ID Files/Cache do TokenLab tạo được kiểm tra quyền sở hữu và giữ binding upstream ban đầu; nhà cung cấp quyết định các quy tắc media và tool khác.object
Chỉ dẫn hệ thống cho mô hình.
object
Cấu hình tạo nội dung gốc. Tên lowerCamelCase như
maxOutputTokens, candidateCount, thinkingConfig và tên snake_case tương ứng được chấp nhận không thay đổi. TokenLab không xóa thinkingConfig sau lỗi hoặc áp giới hạn cục bộ cho candidateCount khi streaming; upstream quyết định phạm vi và tổ hợp.array
Cài đặt bộ lọc an toàn.
Phản hồi
array
Các ứng viên nội dung được tạo.
object
Thông tin sử dụng token.
Ví dụ đầu vào đa phương thức
Với các yêu cầu Gemini đa phương thức, hãy đặt media vàocontents[].parts[] bằng byte inline hoặc tham chiếu tệp dựa trên URL.
Các loại media hiện được hỗ trợ trong model details Gemini:
- hình ảnh
- âm thanh
- video
inlineData hoặc inline_data và truyền byte tệp được mã hoá Base64.
Với media qua URL, dùng fileData hoặc file_data và truyền một URL công khai https.