Skip to main content
TokenLab chỉ cung cấp tuyến này cho mô hình công bố hợp đồng Gemini gốc và có tuyến upstream cùng giao thức; không fallback sang Chat Completions. Tên ProtoJSON lowerCamelCase và tên proto gốc snake_case đều là chính thức và được giữ nguyên, kể cả trong yêu cầu trộn lẫn. Trường chưa biết được chuyển tiếp theo best-effort và upstream quyết định khả năng hỗ trợ.

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_KEY tham 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_datafileData / 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ào contents[].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
Với media inline, dùng 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.

Ví dụ đầu vào hình ảnh

Ví dụ đầu vào âm thanh

Ví dụ đầu vào video

Ví dụ đầu vào video

Ví dụ đầu vào âm thanh