Aggeee Gemini AI Gateway

API Documentation
Cổng API Sẵn Sàng (Port 8001) • Tài Liệu Hướng Dẫn Tích Hợp Dành Cho Khách Hàng
Đăng Nhập Quản Trị (Admin Portal)
Khách Hàng & Nhà Phát Triển Zero-Config REST API

Tài Liệu Hướng Dẫn Setup & Tích Hợp API

Hệ thống Aggeee AI Gateway cung cấp cổng kết nối tốc độ cao (~1.6s) đến các mô hình AI Gemini tiên tiến nhất. Khách hàng có thể tích hợp trực tiếp vào ứng dụng của mình (Web App, Mobile App, Backend .NET, Python, Microservice) thông qua chuẩn OpenAI SDK hoặc Google Gemini REST API chỉ trong vài phút.

ENDPOINT BASE URL:
http://localhost:8001
Hoặc LAN IP: http://127.0.0.1:8001
1

Xác Thực & Khóa API Key Của Khách Hàng

Mỗi dự án/khách hàng được cấp một khóa API riêng biệt để xác thực

Định dạng API Key:
gemi-YOUR_ASSIGNED_API_KEY_HERE

💡 Khách hàng liên hệ với Quản trị viên hệ thống để nhận Khóa API hoặc yêu cầu cấp mới.

Phương thức gửi Header xác thực:
  • Chuẩn OpenAI: Authorization: Bearer gemi-...
  • Chuẩn Google: x-goog-api-key: gemi-...
  • URL Parameter: ?key=gemi-...
2

Cấu Hình Biến Môi Trường (.env)

Khai báo vào file .env trong dự án của khách hàng

.env (Client Configuration) 
# Cấu hình kết nối tới Aggeee AI Gateway
AI_GATEWAY_URL=http://localhost:8001
AI_GATEWAY_KEY=gemi-YOUR_ASSIGNED_API_KEY_HERE

# Model AI đề xuất mặc định (Siêu tốc ~1.6s)
AI_DEFAULT_MODEL=gemini-3.5-flash-lite
3

Code Mẫu Tích Hợp Đa Ngôn Ngữ

Chọn ngôn ngữ tương ứng với hệ sinh thái của dự án bạn

cURL Request
4

Danh Mục Mô Hình Khả Dụng & Mức Suy Luận

Chọn model phù hợp với yêu cầu về tốc độ và chiều sâu tư duy của ứng dụng

Gemini 3.5 Flash-Lite SIÊU TỐC (~1.6s)

Độ trễ thấp nhất trong hệ thống. Phù hợp nhất cho tác vụ bóc tách dữ liệu, phân loại nhanh, trích xuất thông tin và chat thời gian thực.

Mức suy luận: Thấp (Low)
Gemini 3.7 Flash TOÀN DIỆN (~4s)

Cân bằng hoàn hảo giữa tốc độ và chiều sâu phân tích. Xử lý đa phương thức (văn bản & hình ảnh), tạo nội dung và lập luận logic.

Mức suy luận: Trung bình (Medium)
Gemini 3.1 Pro SUY LUẬN SÂU (~25s)

Mô hình suy luận sâu nhiều tầng (Chain-of-Thought). Giải quyết các bài toán hóc búa, phân tích logic đa chiều và giảm thiểu sai sót tối đa.

Mức suy luận: Cao (High)
5

Bảng Đặc Tả Toàn Bộ API Endpoints

Chi tiết phương thức, URL và tính năng hỗ trợ

Method Endpoint URL Chuẩn Mô tả & Chức năng Streaming SSE
POST /v1/chat/completions OpenAI Spec Hội thoại AI chuẩn OpenAI, System prompt, Chat message. Hỗ trợ stream: true trả về token thời gian thực. ✓ Hỗ trợ
POST /v1beta/models/{model}:generateContent Gemini REST Chuẩn payload Google Gemini, hỗ trợ Text và Multimodal (ảnh Base64 qua inline_data). Chunk JSON
GET /v1beta/models Model Catalog Trả về danh mục các model khả dụng (Flash-Lite, Flash, Pro) kèm thông tin reasoningLevel và token limit. -
GET /v1beta/reasoning-levels Extension Danh sách 3 cấp độ suy luận: Thấp (~1.6s), Trung bình (~4s), Cao (~25s) để client render UI động. -