Cấu hình nhà cung cấp mô hình & API key

Cập nhật 14 tháng 9, 2026

Trả lời nhanh: Piskes Agent gọi mô hình qua giao thức tương thích OpenAI. Bạn chọn nhà cung cấp trong Cài đặt → Nhà cung cấp, dán API key; key được lưu vào ~/.hermes/.env trên máy bạn. Piskes không giữ key của bạn.

Ba cách cấu hình

Cách	Khi nào dùng	Cần điền
Chọn nhanh: OpenAI	Đã có tài khoản OpenAI	API key
Chọn nhanh: OpenRouter	Muốn đổi qua lại nhiều mô hình (Claude, GPT, Gemini, mô hình mở) với một key	API key
Tuỳ chỉnh	Endpoint riêng: Anthropic qua proxy, Azure OpenAI, hoặc mô hình local	Base URL, tên mô hình, tên biến key, API key

Mô hình chạy local (không cần internet)

Bất kỳ server nào phơi endpoint /v1/chat/completions đều dùng được. Ví dụ:

Ollama: Base URL http://localhost:11434/v1, mô hình qwen2.5:14b (hoặc mô hình bạn đã ollama pull). API key điền giá trị bất kỳ.
LM Studio: bật Local Server, Base URL http://localhost:1234/v1.

Mô hình local cần đủ RAM/VRAM; với việc văn phòng (soạn văn bản, tổng hợp bảng tính) mô hình 7–14B thường đủ, nhưng các bước dùng công cụ nhiều (đọc nhiều file, gọi Gmail) sẽ ổn định hơn với mô hình lớn hơn.

Key lưu ở đâu, ai đọc được

Ghi vào ~/.hermes/.env dưới tên biến bạn chọn (mặc định OPENAI_API_KEY).
Chỉ bộ máy Hermes Agent chạy trên máy bạn đọc biến này khi gọi mô hình.
Gói chẩn đoán (Cài đặt → Hỗ trợ → Gói chẩn đoán) che mọi key trước khi đóng gói.
Khi bạn chưa đăng nhập tài khoản Piskes, request đi thẳng từ máy bạn tới nhà cung cấp — không qua máy chủ Piskes. Xem Giá & phí để biết điều gì đổi khi đăng nhập.

Đổi nhà cung cấp

Lưu cấu hình mới trong Cài đặt là đủ. App ghi lại cấu hình rồi khởi động lại bộ máy Hermes (vài giây) — bộ nhớ và hồ sơ bot được giữ nguyên.

Sự cố thường gặp

“Chưa cấu hình nhà cung cấp mô hình” ở màn trò chuyện: chưa lưu Base URL/API key.
Base URL không hợp lệ: phải bắt đầu bằng http:// hoặc https:// và thường kết thúc bằng /v1.
401/403 từ nhà cung cấp: key sai hoặc hết hạn mức bên đó — kiểm tra ở trang của nhà cung cấp, không phải trong Piskes.

Tiếp theo: Mức tự động.