auto_awesome Gemini AI Toolkit

key
open_in_new Lấy key
smart_toy
Xin chào! Mình là Gemini. Nhập tin nhắn bên dưới để bắt đầu trò chuyện — hỗ trợ đa lượt, giữ ngữ cảnh trong phiên.

Mẹo: free tier giữ được ~1M token ngữ cảnh — hội thoại dài sẽ tự cắt bớt khi gần chạm ngưỡng.

0 ký tự

Văn bản dài quá ~4.000 ký tự nên tách nhỏ để tránh chạm hạn mức token/phút của free tier.

Kéo thả file audio vào đây
hoặc bấm để chọn — mp3 / wav / m4a / ogg / flac (tối đa ~18MB)
Kéo thả file vào đây
hoặc bấm để chọn — PDF · ảnh (png/jpg/webp/heic) · txt · md · html · csv · json
PDF hỗ trợ tới ~1.000 trang (file lớn nên chia nhỏ).
Kéo thả ảnh/video vào đây
hoặc bấm để chọn — png · jpg · webp · heic · mp4 · mov · webm (≤18MB)
📷 OCR hóa đơn / CCCD🎞️ Tóm tắt video🔍 Đếm & định vị vật thể
Video dài nên cắt < 2 phút để không vượt token free tier.
Kéo thả file văn bản vào đây — txt · md · csv · json
Gợi ý: biến văn bản tự do / OCR thành dữ liệu có cấu trúc cho n8n, Sheets.

image Tạo ảnh từ mô tả

Nhập prompt tiếng Việt hoặc tiếng Anh. Ảnh được tạo qua proxy Gemini.

Model và quyền tạo ảnh phụ thuộc quota của API key.

menu_book Hướng dẫn gọi API

Backend đặt tại https://gemini.tonghop.io.vn. Mọi endpoint công khai dưới đây do backend Go tự xoay key, bạn chỉ cần gọi JSON.

api 1. Gọi API công khai
• Các endpoint công khai dùng JSON và được proxy xử lý qua pool key của server.
• Với tích hợp bên ngoài, dùng tab Test API hoặc copy ví dụ curl bên dưới.
data_object 2. Endpoints
GET /health · kiểm tra sống → {"status":"ok"}
GET /api/keys/status · xem các key (preview che) và cooldown.
POST /api/chat · body {message, model?, system?, temperature?}
POST /api/tts · body {text, voice?, model?} → audio/wav.
POST /api/stt · multipart file (audio) hoặc {file_base64, mime_type, model?, lang?, srt?, extra?}
POST /api/doc · multipart file (PDF/ảnh/text) hoặc {file_base64, mime_type, model?, action?, custom?}
POST /api/vision · multipart file (ảnh/video) hoặc {file_base64, mime_type, model?, task?, custom?}
POST /api/json · body {input, schema, model?} → JSON theo schema.
POST /api/generate · body {model, body:{contents:[...]}} — proxy xoay key, passthrough (tools, safety, fileData).
POST /api/tokens · đếm token trước khi gọi model.
POST /api/embeddings · biến nội dung thành vector semantic.
POST /api/agent · function calling an toàn: giờ, health, calculate.
POST/GET/DELETE /api/files · upload và quản lý file trên Gemini Files API.
code 4. Ví dụ curl
Chat
curl -sk https://gemini.tonghop.io.vn/api/chat \
  -H "Content-Type: application/json" \
  -d '{"message":"Xin chào, giới thiệu 2 câu","model":"gemini-3-flash-preview"}'
TTS
curl -sk https://gemini.tonghop.io.vn/api/tts \
  -H "Content-Type: application/json" \
  -d '{"text":"Xin chào Việt Nam","voice":"Kore"}' \
  --output speech.wav
Vision (file ảnh)
curl -sk https://gemini.tonghop.io.vn/api/vision \
  -F "file=@photo.jpg" \
  -F "task=describe" \
  -F "model=gemini-3-flash-preview"
JSON có cấu trúc
curl -sk https://gemini.tonghop.io.vn/api/json \
  -H "Content-Type: application/json" \
  -d '{"input":"Số 1, số 2","schema":{"type":"object","properties":{"a":{"type":"number"},"b":{"type":"number"}},"required":["a","b"]}}'
memory 6. Models free-tier ưu tiên
• gemini-3-flash-preview — cân bằng, mặc định cho Chat/Doc/Vision/JSON.
• gemini-3.1-flash-lite — quota thoáng nhất.
• gemini-2.5-flash-preview-tts — TTS ổn định; 30 giọng (Zephyr, Kore, Aoede…).

speed Check limit các model

Probe :countTokens cho từng model bằng key proxy. Trả về status, latency_ms, error nếu bị chặn. Dùng để biết nhanh model nào còn free quota.

— chưa probe —

broadcast_on_personal Live / realtime models

Liệt kê các model từ Gemini API có hỗ trợ liveConnect, bidiGenerateContent, audio realtime hoặc video realtime. Live API streaming sẽ được bật ở phase tiếp theo.

— chưa tải —

terminal Test API

Gọi thử các endpoint công khai bằng ô bên dưới.

Request công khai — không hiển thị thông tin quản trị.
chưa gọi
— chưa có phản hồi —