APIMaster.ai
Tài liệu APIMaster.ai
Quick startAPIMaster.aiMarketplace

Hermes Desktop với APIMaster.ai

Thiết lập khóa API và URL cơ sở tương thích OpenAI trong Hermes Desktop trên Windows hoặc macOS, sau đó chọn mô hình trong Cài đặt.

APIMaster.ai tương thích với OpenAI. Hermes đọc hai biến môi trường, sau đó bạn chọn mô hình trong giao diện desktop.

Thiết lập nhanh

Bước 1 — Lấy khóa API của bạn

  1. Mở bảng điều khiển APIMaster.
  2. Sao chép Khóa API của bạn (thường bắt đầu bằng sk-).
  3. Không bao giờ dán khóa thật vào chat hoặc ảnh chụp màn hình; chỉ sử dụng placeholder your_apimaster_key bên dưới.

Bước 2 — Chỉnh sửa tệp .env

Windows

  1. Nhấn Win + R, dán và nhấn Enter:

    %LOCALAPPDATA%\hermes

  2. Mở .env trong Notepad (tạo tệp nếu chưa có).

  3. Đường dẫn đầy đủ điển hình:

    C:\Users\YourName\AppData\Local\hermes\.env

macOS

Hermes Desktop dùng chung thư mục ~/.hermes với CLI (tài liệu chính thức). Đặt khóa trong ~/.hermes/.env.

Tùy chọn A — Finder (khuyến nghị)

  1. Go → Go to Folder… (Shift + Command + G).

  2. Dán:

    ~/.hermes

    (~ là thư mục home của bạn; .hermes bị ẩn trong Finder trừ khi bạn dùng Go to Folder.)

  3. Mở .env trong TextEdit (tạo mới nếu chưa có).

Tùy chọn B — Terminal

open ~/.hermes

Đường dẫn đầy đủ

/Users/YourName/.hermes/.env

Bước 3 — Thêm các dòng sau

OPENAI_API_KEY=your_apimaster_key
OPENAI_BASE_URL=https://apimaster.ai/v1
  • OPENAI_BASE_URL phải kết thúc bằng /v1 — không chỉ https://apimaster.ai.
  • Không có khoảng trắng xung quanh =, không có dấu ngoặc kép trừ khi tài liệu Hermes yêu cầu khác.
  • Lưu tệp.

Bước 4 — Khởi động lại Hermes Desktop

Thoát hoàn toàn Hermes (bao gồm cả biểu tượng khay hệ thống), sau đó mở lại.

Chọn mô hình trong ứng dụng

  1. Mở Hermes Desktop.

  2. Vào Cài đặt → Model → Main model.

  3. Nhà cung cấp (Provider): Custom endpoint.

  4. Mô hình (Model): chọn một ID mô hình được hỗ trợ, ví dụ:

    • claude-opus-4-8
    • claude-sonnet-4-6
    • gpt-5.5
    • gpt-5.4

    Xem thị trường hoặc hỏi quản trị viên để biết danh sách đầy đủ.

  5. Nhấp Apply, sau đó đóng Cài đặt.

Hermes Desktop: Cài đặt → Model → Main model

Kiểm tra: chọn mô hình và gửi tin nhắn

1. Đặt mô hình chính trong Cài đặt (bắt buộc)

  1. Mở Cài đặt (Settings) (thanh bên hoặc góc dưới bên trái).
  2. Vào Model → Main model.
  3. Nhà cung cấp: Custom endpoint (hoặc openai-api nếu hiển thị).
  4. Mở dropdown Model và nhấp vào một ID (ví dụ gpt-5.4) — không gõ tên hiển thị.
  5. Nhấp Apply và đóng Cài đặt.

Các chat mới sẽ dùng mô hình này sau khi Apply; các chat cũ có thể vẫn dùng mô hình trước đó.

2. Bắt đầu chat mới

  1. Quay lại danh sách chat.
  2. Nhấp New chat (hoặc +).
  3. Dùng phiên mới, không phải luồng cũ.

3. Kiểm tra mô hình đang hoạt động (khuyến nghị)

Gần ô nhập liệu có thể thấy thông tin như openai-api / gpt-5.4. Nếu sai, hãy sửa Main model, Apply, và mở một chat mới khác. Một số bản build còn có dropdown mô hình nhỏ bên cạnh vùng soạn thảo.

4. Gửi tin nhắn thử

Nhập Hello, reply with ok và nhấn Enter. Phản hồi bình thường nghĩa là Key, base URL và mô hình hoạt động tốt.

5. Vẫn không được?

Kiểm tra nội dung lỗi (401, 404, timeout), xác nhận đã khởi động lại Hermes sau khi chỉnh sửa .env, hoặc chạy kiểm tra kết nối API với cùng key.

Câu hỏi thường gặp (FAQ)

Vấn đề Cần kiểm tra gì
Gửi thất bại URL là https://apimaster.ai/v1; key được sao chép đầy đủ; ID mô hình chính xác; Hermes đã khởi động lại sau khi chỉnh sửa .env
Thiếu thư mục Dùng ~/.hermes trên Mac (không phải Application Support); khởi chạy Hermes một lần hoặc mkdir -p ~/.hermes
Không có Custom endpoint Cập nhật Hermes lên phiên bản mới nhất
Sai mô hình Các ID đến từ APIMaster; xem Mô hình được hỗ trợ

Tùy chọn: Kiểm tra kết nối API với cùng key.

Bảo mật

  • Không chia sẻ khóa API trên Slack, email hoặc tài liệu công khai.
  • Chỉ dùng placeholder trong ticket và ảnh chụp màn hình.
  • Nếu bị rò rỉ, thu hồi khóa trong bảng điều khiển, cập nhật .env và khởi động lại Hermes.

Danh sách kiểm tra

  • Sao chép khóa API từ bảng điều khiển (giữ bí mật)
  • Đặt OPENAI_API_KEY trong .env
  • Đặt OPENAI_BASE_URL=https://apimaster.ai/v1 (có /v1)
  • Lưu .env
  • Khởi động lại Hermes hoàn toàn
  • Nhà cung cấp = Custom endpoint, chọn ID mô hình, nhấp Apply
  • Tin nhắn thử hoạt động trong phiên mới

Xem thêm