Dùng Nous Portal với Hermes Agent không cần lấy API key: chạy hermes setup --portal (hoặc hermes model → Nous Portal), đăng nhập trên trình duyệt, Hermes tự lưu thông tin đăng nhập OAuth. Bạn chỉ cần tài khoản Nous Portal và một gói phù hợp; một lần đăng nhập dùng được hơn 300 model và, với gói trả phí, cả Tool Gateway.
Bài thuộc cụm chọn LLM cho Hermes Agent của chuyên mục Hermes Agent. Phần dưới giải thích Nous Portal là gì, cách đăng nhập cho Hermes, cách tạo tài khoản và chọn gói trên Portal, endpoint API cho ứng dụng khác, và các lỗi thường gặp.
Nous Portal là gì?
Nous Portal (portal.nousresearch.com) là trang tài khoản và cổng model của Nous Research, nhóm làm ra Hermes Agent. Tài liệu Hermes gọi đây là cách được khuyến nghị để chạy Hermes: một OAuth cho hơn 300 model, một hoá đơn, kèm Tool Gateway gồm tìm web, tạo ảnh, đọc văn bản và trình duyệt cloud (Hermes Agent: Nous Portal).
- Model: Claude, GPT, Gemini, DeepSeek, Qwen, Kimi, GLM, MiniMax, Grok, Nemotron và các model khác qua cùng một đăng nhập.
- Tool Gateway: chỉ có ở gói trả phí, tính theo mức dùng và trừ vào gói.
- Quản lý gói và credit: trên Portal, hoặc từ terminal bằng
/subscription,/topup(có từ Hermes v0.19). - Không khuyến nghị Hermes 4 cho agent: dòng model chat Hermes 4 có trên Portal nhưng tài liệu Nous khuyên dùng model hướng agent cho Hermes Agent.
Có cần API key Nous Portal cho Hermes Agent không?
Không. Hermes kết nối Nous Portal bằng OAuth: refresh token lưu trong ~/.hermes/auth.json là thông tin đăng nhập Portal lưu trên đĩa, Hermes tự tạo token ngắn hạn cho từng yêu cầu. Bạn không phải tạo key, dán vào .env hay xoay vòng key thủ công.
Cài mới: đăng nhập Portal, chọn model, đặt Nous làm provider và bật Tool Gateway trong một lệnh:
hermes setup --portal
Đã cài Hermes: chạy hermes model, chọn Nous Portal, trình duyệt mở trang đăng nhập; đăng nhập xong là dùng được. Hai lệnh kiểm tra:
hermes portal info
hermes portal open
hermes portal info cho biết đã đăng nhập và đang đi qua Nous; hermes portal open mở trang quản lý gói (Hermes Agent: Nous Portal, 26/10/2026). Trên Hermes Desktop, chọn Nous Portal ở màn hình thiết lập.
Khi một nhóm công cụ của Tool Gateway được đặt dùng Nous, các API key riêng của nhóm đó trong .env bị bỏ qua.
Cần chuẩn bị gì trước khi dùng Nous Portal?
Bạn cần một tài khoản Nous Portal, một gói (Free hoặc trả phí) hoặc credit nạp thêm, và Hermes Agent đã cài trên máy hay VPS. Nếu dùng Portal cho ứng dụng khác ngoài Hermes, cần thêm nơi lưu khoá an toàn như biến môi trường hoặc trình quản lý secret.
- Tài khoản Nous Portal: đăng nhập bằng Google, email, GitHub, Discord hoặc ví điện tử.
- Gói hoặc credit: xem các gói và giá hiện hành tại trang quản lý gói Nous Portal. Tool Gateway chỉ có ở gói trả phí.
- Hermes Agent đã cài: xem cách cài Hermes Agent trên VPS hoặc Hermes Agent Desktop.
Trang Manage subscription của Nous Portal ngày 26/10/2026 ghi bốn gói: Free 0 USD (chỉ model miễn phí, không có credit tháng), Plus 20 USD/tháng (22 USD credit, chuyển sang tháng sau tối đa 10 USD), Super 100 USD/tháng (110 USD credit, tối đa 50 USD) và Ultra 200 USD/tháng (220 USD credit, tối đa 100 USD). Các gói trả phí có dùng công cụ được host (Tool Gateway); trang này ghi 200+ model cho gói trả phí, còn docs Hermes ghi hơn 300 model.

Ảnh chụp trang công khai Manage subscription của Nous Portal ngày 26/10/2026, không đăng nhập. Giá do Nous quyết định và có thể đổi.
Tạo tài khoản và chọn gói trên Nous Portal
Tạo tài khoản và kích hoạt gói mất khoảng năm bước trên trang Portal: đăng nhập, mở Billing, chọn gói hoặc nạp credit, thanh toán qua Stripe, kiểm tra số dư. Sau đó quay lại Hermes và đăng nhập OAuth như mục trên.
Ảnh chụp tháng 6/2026. Tên gói, giá và credit đi kèm trong ảnh là của thời điểm đó; xem giá hiện hành trên trang quản lý gói của Nous trước khi đăng ký.
Bước 1: Truy cập portal.nousresearch.com. Tại màn hình đăng nhập, chọn Google, Email, GitHub, Discord hoặc More options (đăng nhập bằng ví điện tử).

Bước 2: Đăng nhập xong, bạn vào giao diện quản trị Nous Portal. Menu bên trái có các mục Billing, API keys, Usage, Local Dashboards, Account Settings và Info.
Bước 3: Chọn Billing để kiểm tra số dư. Tài khoản mới hiển thị $0.00 hoặc No funds thì cần kích hoạt gói hoặc nạp credit trước.

Bước 4: Trong Billing có hai lựa chọn.
Subscription: chọn một gói trong danh sách (Free hoặc các gói trả phí). Mỗi gói có credit hằng tháng; nhấn Subscribe via Stripe để kích hoạt.

Trang thanh toán cho chọn loại tiền, xem tổng tiền và có thể yêu cầu xác minh số điện thoại. Với gói Free, tổng tiền hiển thị 0đ nhưng vẫn cần hoàn tất bước xác nhận.

Top-up Credits: nạp credit không hết hạn. Nhấn Top up now nếu muốn nạp thêm số dư thủ công.


Bước 5: Thanh toán xong, quay lại Billing. Nếu tài khoản đã có credit, phần Balance hiển thị số dư, ví dụ $0.10.

Phần Balance Breakdown gồm:
- Top-up Credits: credit nạp thêm, không hết hạn.
- Subscription Credits: credit đi kèm gói, đặt lại theo chu kỳ.
- Spent This Period: credit đã dùng trong chu kỳ hiện tại.
Trang API keys trên Nous Portal dùng để làm gì?
Trang API keys dành cho ứng dụng khác ngoài Hermes muốn gọi model của Nous qua endpoint tương thích OpenAI, ví dụ script, backend hay công cụ không hỗ trợ OAuth của Nous. Hermes Agent không cần bước này. Ảnh dưới chụp tháng 6/2026; hãy đối chiếu giao diện hiện tại trên Portal.
Bước 6 (chỉ khi cần cho ứng dụng khác): ở menu bên trái, chọn API keys rồi nhấn Create key.

Bảng key hiển thị tên, chuỗi key rút gọn (dạng sk-nous-…), ngày tạo, lần dùng cuối, tổng chi tiêu và nút Revoke để thu hồi. Nhấn biểu tượng sao chép để lấy key và lưu ở nơi an toàn.

Endpoint API của Nous Research
Endpoint gốc tương thích OpenAI là https://inference-api.nousresearch.com/v1. Danh sách model công khai tại /v1/models; ngày 26/10/2026, endpoint này trả về 428 model, kèm giá theo token và độ dài context (inference-api.nousresearch.com/v1/models).
curl https://inference-api.nousresearch.com/v1/models
Gọi chat completion thì đặt key trong header Authorization: Bearer <key>. Với SDK tương thích OpenAI, đặt base_url là endpoint gốc, không gồm /chat/completions.
Các lỗi thường gặp khi dùng Nous Portal
Phần lớn lỗi khi dùng Nous Portal đến từ ba nguồn: đăng nhập OAuth hết hạn hoặc chưa đăng nhập, tài khoản hết credit, và tên model sai. Với Hermes, chạy hermes portal info trước để biết mình đang ở trường hợp nào.
Lỗi Nguyên nhân thường gặp Cách xử lý 401 Unauthorized Chưa đăng nhập hoặc phiên OAuth hết hạn; với ứng dụng ngoài: key sai, thiếu header, key đã thu hồi Trong Hermes chạy lại hermes model → Nous Portal; ứng dụng ngoài kiểm header Bearer và tạo key mới402 hoặc báo hết credit Hết credit gói hoặc credit nạp Kiểm Billing; nạp thêm bằng Top-up hoặc /topupKhông tìm thấy model Tên model sai hoặc model đã đổi tên, ngừng cung cấp Lấy đúng ID trong /v1/models hoặc trong danh sách hermes modelGọi sai endpoint Đặt cả /chat/completions vào base_urlDùng base_url https://inference-api.nousresearch.com/v1Chạy trên máy cá nhân được, lên server lỗi Server chưa đăng nhập Portal hoặc chưa có biến môi trường Đăng nhập Portal trên chính server; khởi động lại dịch vụ sau khi đổi cấu hình
Bảo mật thông tin đăng nhập Nous Portal
Thông tin đăng nhập Nous Portal mở quyền dùng credit của bạn, nên cần giữ như mật khẩu: file ~/.hermes/auth.json với Hermes, và key sk-nous-… với ứng dụng khác. Ai có một trong hai thứ này đều gọi model và tiêu credit được dưới tên bạn cho tới khi bạn thu hồi.
Nên làm:
- Giữ quyền đọc file
auth.jsonvà.envchỉ cho chủ sở hữu (ví dụchmod 600). - Lưu key của ứng dụng khác trong biến môi trường hoặc secret manager; đặt tên mô tả cho từng key.
- Xem Usage định kỳ để phát hiện mức dùng bất thường.
Không nên làm:
- Commit key hoặc file
auth.jsonlên GitHub hay repository công khai. - Chia sẻ key qua Slack, email, nhóm chat; gọi API bằng key từ frontend.
- Để key nằm trong file
.envđược Git theo dõi.
Nghi key bị lộ thì thu hồi bằng Revoke trên Portal và tạo key mới; nghi lộ auth.json thì đăng xuất bằng hermes auth và đăng nhập lại.
Lưu ý khi chọn model trên Nous Portal
Khi chọn model trên Nous Portal cho Hermes Agent, ưu tiên model gọi tool tốt và có context từ 64K, rồi mới so giá. Dòng Hermes 4 của Nous mạnh về chat nhưng không phải lựa chọn khuyến nghị cho agent.
- Context: Hermes cần từ 64.000 token khi dùng công cụ.
- Giá prompt và completion: xem trong danh sách model; phần prompt của agent lớn nên giá prompt ảnh hưởng nhiều.
- Gọi tool: chọn model hướng agent; chạy thử với tác vụ thật.
- Trạng thái model: model có thể đổi tên, chỉ có thời hạn (ví dụ bản
:freekhuyến mãi) hoặc ngừng; kiểm lại trước khi dùng lâu dài. Tham khảo cách chọn LLM cho Hermes Agent.
Khi nào không nên dùng Nous Portal?
Nous Portal tiện khi bạn muốn một hoá đơn cho model và công cụ, nhưng không phải lúc nào cũng hợp. Nếu bạn đã trả tiền cho một hãng khác hoặc chỉ dùng một model giá thấp, thêm một gói nữa có thể làm tổng chi phí cao hơn. Ba trường hợp nên cân nhắc cách khác:
- Đã có gói hoặc hợp đồng với một hãng (ChatGPT, Claude, cloud doanh nghiệp): dùng trực tiếp đường đó để khỏi trả hai nơi.
- Chỉ dùng một model giá thấp: so giá trên Portal với API của hãng hoặc OpenRouter trước khi chọn.
- Dữ liệu không được rời máy: dùng model local (xem model AI miễn phí cho Hermes Agent).
Bài viết liên quan trong cụm Model & chi phí Hermes:
- Nên chọn LLM nào cho Hermes Agent
- Đổi model LLM cho Hermes Agent
- Chi phí chạy Hermes Agent mỗi tháng
- Kết nối Hermes Agent với OpenRouter
- Model AI miễn phí cho Hermes Agent
Kết luận
Với Hermes Agent, Nous Portal là đường kết nối không cần API key: một lệnh hermes setup --portal, một lần đăng nhập, rồi chọn model. Trang API keys chỉ cần khi ứng dụng khác ngoài Hermes gọi endpoint của Nous. Trước khi chọn gói, xem giá hiện hành trên trang quản lý gói của Nous.
Muốn chạy Hermes Agent 24/7 mà không tự cài? VPS Hermes Agent của Tino cài sẵn Hermes Agent trên VPS NVMe đặt tại Việt Nam; bạn vẫn có quyền root để cấu hình. Xem cấu hình và giá trên trang sản phẩm.
Những câu hỏi thường gặp
Nous Portal có miễn phí không?
Có gói Free để đăng nhập và dùng các model cho phép ở gói này; Tool Gateway chỉ có ở gói trả phí. Model miễn phí theo đợt khuyến mãi có thời hạn, nên không coi là miễn phí lâu dài. Giá các gói xem tại trang quản lý gói Nous Portal.
Quản lý gói Nous subscription ở đâu?
Tại portal.nousresearch.com/manage-subscription: đổi gói, xem mức dùng, huỷ gói. Từ Hermes có thể mở trang này bằng hermes portal open, hoặc dùng /subscription và /topup trong phiên chat.
API của Nous Portal có tương thích với SDK của OpenAI không?
Có. Endpoint https://inference-api.nousresearch.com/v1 theo chuẩn OpenAI, nên chỉ cần đổi api_key và base_url khi khởi tạo client.
Có dùng Hermes Agent mà không cần Nous Portal được không?
Được. Nous Portal chỉ là một trong nhiều provider; bạn có thể dùng OpenRouter, Anthropic, OpenAI, Gemini, DeepSeek hoặc model local qua Ollama.
