close

Nous Portal: cách đăng nhập cho Hermes Agent, chọn gói và lấy API key

Tác giả: Đông Tùng Ngày đăng: 24/06/2026 Chuyên mục: Model AI & API
Disclosure
Website Tino blog được cung cấp bởi Tino Group. Truy cập và sử dụng website đồng nghĩa với việc bạn đồng ý với các điều khoản và điều kiện trong chính sách bảo mật - điều khoản sử dụng nội dung. Tino Group có thể thay đổi điều khoản sử dụng bất cứ lúc nào. Việc bạn tiếp tục sử dụng Tino blog sau khi thay đổi có nghĩa là bạn chấp nhận những thay đổi đó.
Why Trust Us
Các bài viết với hàm lượng tri thức cao tại Tino blog được tạo ra bởi các chuyên viên Marketing vững chuyên môn và được kiểm duyệt nghiêm túc theo chính sách biên tập bởi đội ngũ biên tập viên dày dặn kinh nghiệm. Mọi nỗ lực của chúng tôi đều hướng đến mong muốn mang đến cho cộng đồng nguồn thông tin chất lượng, chính xác, khách quan, đồng thời tuân thủ các tiêu chuẩn cao nhất trong báo cáo và xuất bản.

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.

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 Manage subscription của Nous Portal: gói Free 0 USD chỉ model miễn phí; Plus 20 USD mỗi tháng với 22 USD credit; Super 100 USD với 110 USD credit; Ultra 200 USD với 220 USD credit; các gói trả phí có 200+ model và hosted tool usage

Ả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ử).

Màn hình Welcome to Nous Portal với các cách đăng nhập Google, email, GitHub, Discord và More options

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.

Trang Billing của Nous Portal với số dư $0.00 và thông báo No funds

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.

Khung Subscription của Nous Portal với danh sách gói, credit hằng tháng và nút Subscribe via Stripe, ảnh chụp tháng 6/2026

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.

Trang thanh toán Stripe đăng ký Nous Subscription Monthly, tổng tiền 0đ cho gói Free và bước xác minh số điện thoại

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.

Khung Top-up Credits của Nous Portal với nút Top up now và tuỳ chọn Auto-refill
Hộp Select Top-up Amount của Nous Portal: chọn số tiền nạp và thanh toán qua Stripe

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.

Trang Billing của Nous Portal sau khi kích hoạt gói: số dư $0.10 và Balance Breakdown

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.

Trang API của Nous Portal khi chưa có key, nút Create key, ảnh chụp tháng 6/2026

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.

Bảng API key của Nous Portal: tên, key rút gọn sk-nous, ngày tạo, Last Used, Total Spend và nút Revoke

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ỗiNguyên nhân thường gặpCách xử lý
401 UnauthorizedChư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ồiTrong Hermes chạy lại hermes model → Nous Portal; ứng dụng ngoài kiểm header Bearer và tạo key mới
402 hoặc báo hết creditHết credit gói hoặc credit nạpKiểm Billing; nạp thêm bằng Top-up hoặc /topup
Không tìm thấy modelTên model sai hoặc model đã đổi tên, ngừng cung cấpLấy đúng ID trong /v1/models hoặc trong danh sách hermes model
Gọi sai endpointĐặt cả /chat/completions vào base_urlDùng base_url https://inference-api.nousresearch.com/v1
Chạy trên máy cá nhân được, lên server lỗiServer 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.json và .env chỉ 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.json lê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 :free khuyế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:

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.

Đông Tùng

Senior Technology Writer

Là cử nhân Quản trị kinh doanh của Trường Đại học Tài chính - Marketing, Tùng bắt đầu làm việc tại Tino Group từ năm 2021 ở vị trí Content Marketing để thỏa mãn niềm đam mê viết lách của bản thân. Sở hữu khả năng sáng tạo đặc biệt, anh cùng đội ngũ của mình đã tạo nên những chiến dịch quảng cáo độc đáo cùng vô số bài viết hữu ích về nhiều chủ đề khác nhau. Sự tỉ mỉ, kiên trì và tinh thần sáng tạo của Tùng đã góp phần lớn vào thành công của Tino Group trong lĩnh vực marketing trực tuyến.

Xem thêm bài viết

Bài viết liên quan