Vào gateway và đăng nhập
Truy cập portal chính trước, sau đó đăng nhập để quản lý Virtual Keys.
Mở trang chủ Eons AI Gateway
Vào https://llm.eonsr.net. Kiểm tra trạng thái Online ở góc phải để chắc chắn gateway đang hoạt động.
Mở Login và đăng nhập
Nhấn Login và đăng nhập bằng tài khoản nội bộ được cấp quyền.
Tạo Virtual Key mới
Virtual Key là key bạn dùng để gọi API OpenAI-compatible của Eons AI Gateway.
Vào Virtual Keys → Create New Key
Trong sidebar bên trái, chọn Virtual Keys, sau đó nhấn nút + Create New Key.
Thiết lập các trường cần thiết
Điền đúng Team, Key Name, Models và Key Type để key có quyền gọi model phù hợp.
- Owned By
- You — key thuộc về tài khoản đang đăng nhập.
- Organization
- EONSR — organization mặc định của hệ thống.
- Team
- Chọn team được cấp quyền, ví dụ Tech.
- Key Name
- Đặt tên dễ nhận biết, ví dụ
project-name-devhoặcautomation-prod. - Models
- Chọn All Team Models nếu cần dùng tất cả model team được cấp.
- Key Type
- Giữ AI APIs để gọi chat completions/embeddings/images.
Thiết lập fallback chain trong Optional Settings
Fallback giúp request tự động chuyển sang model dự phòng khi model chính lỗi, quá tải hoặc timeout.
Mở Optional Settings → Router Settings → Fallbacks
Trong form tạo key, mở Optional Settings, vào phần Router Settings và chọn tab Fallbacks.
Tạo key và lưu ngay lập tức
Sau khi cấu hình xong, tạo key và copy Virtual Key trước khi đóng popup.
Nhấn Create Key
Kiểm tra lại các trường, sau đó nhấn Create Key ở góc dưới bên phải modal.
Copy Virtual Key trong popup Save your Key
Khi popup Save your Key xuất hiện, nhấn Copy Virtual Key và lưu key vào nơi an toàn.
Sử dụng key để gọi API
Eons AI Gateway tương thích với OpenAI API. Dùng Base URL https://llm.eonsr.net/v1.
curl https://llm.eonsr.net/v1/chat/completions \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "model": "gemini-3-flash", "messages": [{"role": "user", "content": "Hello!"}], "temperature": 0.7 }'
from openai import OpenAI client = OpenAI( api_key="YOUR_API_KEY", base_url="https://llm.eonsr.net/v1", ) response = client.chat.completions.create( model="gemini-3-flash", messages=[{"role": "user", "content": "Hello!"}], ) print(response.choices[0].message.content)
Checklist bảo mật trước khi dùng
API key là credential nhạy cảm. Hãy lưu và sử dụng theo nguyên tắc tối thiểu quyền truy cập.
.env đã nằm trong .gitignore.