Dashboard
Tổng quan kết nối Gemini
Trò chuyện với Gemini
Enter để gửi · Shift+Enter xuống dòng · 📎 đính kèm ảnh/video/tệp
Tài khoản Gemini Pro 0
Base URL cho phần mềm thứ ba
—Phần mềm bên thứ ba chỉ cần nhập Base URL + API key (kiểu OpenAI). Nó sẽ tự lấy được danh sách model qua /v1/models rồi gọi /v1/chat/completions.
Đang bind localhost. Khi đưa lên VPS, đặt gateway_host: "0.0.0.0" trong config.json và thay Base URL bằng http://<IP-hoặc-domain-VPS>:8082/v1 (nên đặt sau HTTPS/tunnel).
API keys
Tạo key riêng cho từng phần mềm tích hợp. Key chỉ hiện một lần khi tạo — lưu lại ngay. Có thể thu hồi bất cứ lúc nào.
Hướng dẫn tích hợp
Tương thích OpenAI. Ví dụ với curl:
Các endpoint hỗ trợ:
- GET /v1/modelsLiệt kê model
- GET /v1/models/{id}Chi tiết 1 model
- POST /v1/chat/completionsChat (stream & non-stream)
- GET /healthKiểm tra sống (không cần key)
Gửi kèm ảnh / video / tệp (multimodal): đặt content là mảng gồm phần text và phần tệp — nhận cả data URI base64 hoặc URL http. Nên dùng model gemini-3.1-pro.
{
"model": "gemini-3.1-pro",
"messages": [{ "role": "user", "content": [
{ "type": "text", "text": "Mô tả giúp tôi ảnh này" },
{ "type": "image_url", "image_url": { "url": "data:image/png;base64,iVBOR..." } },
{ "type": "input_file", "filename": "bao-cao.pdf", "file_data": "data:application/pdf;base64,JVBERi..." }
]}]
}
Loại phần hỗ trợ: image_url (ảnh), video_url (video), input_file (pdf/tệp khác). Cũng hoạt động với API Google-native qua inlineData.
Mã trạng thái & lỗi (envelope kiểu OpenAI {"error":{"message","type","code"}}):
- 200Thành công
- 400 invalid_request_errorJSON sai / thiếu messages
- 401 authentication_errorThiếu / sai / key bị thu hồi
- 404 invalid_request_errorSai endpoint / model không tồn tại
- 405 invalid_request_errorSai HTTP method
- 429 rate_limit_errorVượt giới hạn/phút (có Retry-After)
- 502 upstream_errorGemini nội bộ lỗi/không phản hồi
- 503/health khi upstream chết
Tài khoản
Đăng nhập với tên admin. Phiên đăng nhập hết hạn sau 24 giờ.
Kết nối Telegram (thông báo)
Chưa kết nốiKết nối bot Telegram để nhận cảnh báo khi tài khoản Pro gặp sự cố (lỗi khi dùng, cookie hết hạn, bị khóa, đăng xuất). Cảnh báo gửi vào nhóm theo Chat ID bên dưới.
Cách lấy: tạo bot với @BotFather để có Token. Thêm bot vào nhóm, rồi lấy Chat ID nhóm (VD dùng @RawDataBot hoặc @getidsbot) — Chat ID nhóm thường bắt đầu bằng -100….