Chuyển tới nội dung chính

MiniMax OAuth

Đại lý Hermes hỗ trợ MiniMax thông qua luồng đăng nhập OAuth dựa trên trình duyệt, sử dụng thông tin đăng nhập giống như cổng MiniMax. Không cần khóa API hoặc thẻ tín dụng - đăng nhập một lần và Hermes tự động làm mới phiên của bạn.

Quá trình truyền tải sử dụng lại bộ chuyển đổi anthropic_messages (MiniMax hiển thị điểm cuối tương thích với Anthropic Messages tại /anthropic), vì vậy tất cả các tính năng gọi công cụ, phát trực tuyến và ngữ cảnh hiện có đều hoạt động mà không có bất kỳ thay đổi bộ chuyển đổi nào.

Tổng quan​

ItemValue
Provider IDminimax-oauth
Display nameMiniMax (OAuth)
Auth typeBrowser OAuth (PKCE device-code flow)
TransportAnthropic Messages-compatible (anthropic_messages)
ModelsMiniMax-M2.7, MiniMax-M2.7-highspeed
Global endpointhttps://api.minimax.io/anthropic
China endpointhttps://api.minimaxi.com/anthropic
Requires env varNo (MINIMAX_API_KEY is not used for this provider)

Điều kiện tiên quyết​

  • Python 3.9+
  • Đã cài đặt Đại lý Hermes
  • Tài khoản MiniMax tại minimax.io (toàn cầu) hoặc minimaxi.com (Trung Quốc)
  • Một trình duyệt có sẵn trên máy cục bộ (hoặc sử dụng --no-browser cho các phiên từ xa)

Bắt đầu nhanh​

# Launch the provider and model picker
hermes model
# → Select "MiniMax (OAuth)" from the provider list
# → Hermes opens your browser to the MiniMax authorization page
# → Approve access in the browser
# → Select a model (MiniMax-M2.7 or MiniMax-M2.7-highspeed)
# → Start chatting

Hermes

Sau lần đăng nhập đầu tiên, thông tin xác thực được lưu trữ trong ~/.hermes/auth.json và được làm mới tự động trước mỗi phiên.

Đăng nhập thủ công​

Bạn có thể kích hoạt đăng nhập mà không cần thông qua bộ chọn mô hình:

hermes auth add minimax-oauth

###khu vực Trung Quốc

Nếu tài khoản của bạn chạy trên nền tảng Trung Quốc (minimaxi.com), hãy sử dụng id nhà cung cấp OAuth khu vực Trung Quốc minimax-cn hoặc bỏ qua OAuth và định cấu hình trực tiếp MINIMAX_CN_API_KEY / MINIMAX_CN_BASE_URL. Cờ --khu vực cn được mô tả trong các tài liệu cũ không được kết nối thông qua trình phân tích cú pháp đối số của CLI; thay vào đó hãy sử dụng nhà cung cấp minimax-cn:

hermes auth add minimax-cn --type oauth   # if OAuth is supported on your CN account
# or simpler:
echo 'MINIMAX_CN_API_KEY=your-key' >> ~/.hermes/.env

Phiên từ xa / không đầu​

Trên máy chủ hoặc vùng chứa không có trình duyệt:

hermes auth add minimax-oauth --no-browser

Hermes sẽ in URL xác minh và mã người dùng - mở URL trên bất kỳ thiết bị nào và nhập mã khi được nhắc.

Luồng OAuth​

Hermes triển khai luồng mã thiết bị PKCE dựa trên các điểm cuối MiniMax OAuth:

  1. Hermes tạo cặp xác minh/thách thức PKCE và giá trị trạng thái ngẫu nhiên.
  2. Nó gửi tới {base_url}/oauth/code với thử thách và nhận được user_code và verification_uri.
  3. Trình duyệt của bạn mở verification_uri. Nếu được nhắc, hãy nhập user_code.
  4. Hermes thăm dò {base_url}/oauth/token cho đến khi mã thông báo đến (hoặc hết thời hạn).
  5. Token (access_token, refresh_token, hết hạn) được lưu vào ~/.hermes/auth.json dưới khóa minimax-oauth.

Làm mới mã thông báo (cấp OAuth refresh_token tiêu chuẩn) chạy tự động vào mỗi phiên bắt đầu khi mã thông báo truy cập hết hạn trong vòng 60 giây.

Kiểm tra trạng thái đăng nhập​

hermes doctor

Phần ◆ Nhà cung cấp xác thực sẽ hiển thị:

✓ MiniMax OAuth  (logged in, region=global)

hoặc, nếu chưa đăng nhập:

⚠ MiniMax OAuth  (not logged in)

Chuyển đổi mô hình​

hermes model
# → Select "MiniMax (OAuth)"
# → Pick from the model list

Hoặc đặt mô hình trực tiếp:

hermes config set model MiniMax-M2.7
hermes config set provider minimax-oauth

Tham khảo cấu hình​

Sau khi đăng nhập, ~/.hermes/config.yaml sẽ chứa các mục tương tự như:

model:
  default: MiniMax-M2.7
  provider: minimax-oauth
  base_url: https://api.minimax.io/anthropic

Điểm cuối khu vực​

Provider idPortalInference endpoint
minimax-oauth (global)https://api.minimax.iohttps://api.minimax.io/anthropic
minimax-cn (China)https://api.minimaxi.comhttps://api.minimaxi.com/anthropic

Bí danh của nhà cung cấp​

Tất cả những điều sau đây đều giải quyết được minimax-oauth:

hermes --provider minimax-oauth    # canonical
hermes --provider minimax-portal   # alias
hermes --provider minimax-global   # alias
hermes --provider minimax_oauth    # alias (underscore form)

Biến môi trường​

Nhà cung cấp minimax-oauth không sử dụng MINIMAX_API_KEY hoặc MINIMAX_BASE_URL. Các biến đó chỉ dành cho nhà cung cấp minimax và minimax-cn dựa trên khóa API.

VariableEffect
MINIMAX_API_KEYUsed by minimax provider only — ignored for minimax-oauth
MINIMAX_CN_API_KEYUsed by minimax-cn provider only — ignored for minimax-oauth

Để buộc nhà cung cấp minimax-oauth trong thời gian chạy:

HERMES_INFERENCE_PROVIDER=minimax-oauth hermes

Người mẫu​

ModelBest for
MiniMax-M2.7Long-context reasoning, complex tool-calling
MiniMax-M2.7-highspeedLower latency, lighter tasks, auxiliary calls

Cả hai mô hình đều hỗ trợ tới 200.000 mã thông báo ngữ cảnh.

MiniMax-M2.7-highspeed cũng được tự động sử dụng làm mô hình phụ trợ cho các nhiệm vụ thị giác và ủy quyền khi minimax-oauth là nhà cung cấp chính.

Khắc phục sự cố​

Mã thông báo đã hết hạn — không tự động đăng nhập lại​

Hermes làm mới mã thông báo vào mỗi lần bắt đầu phiên nếu nó hết hạn trong vòng 60 giây. Nếu mã thông báo truy cập đã hết hạn (ví dụ: sau một thời gian dài ngoại tuyến), quá trình làm mới sẽ tự động diễn ra theo yêu cầu tiếp theo. Nếu làm mới không thành công với refresh_token_reused hoặc invalid_grant, Hermes sẽ đánh dấu phiên này là yêu cầu đăng nhập lại.

Khắc phục: chạy lại hermes auth add minimax-oauth để bắt đầu đăng nhập mới.

Đã hết thời gian ủy quyền​

Luồng mã thiết bị có thời hạn sử dụng hữu hạn. Nếu bạn không phê duyệt đăng nhập kịp thời, Hermes sẽ xuất hiện lỗi hết thời gian chờ.

Khắc phục: chạy lại hermes auth add minimax-oauth (hoặc hermes model). Dòng chảy bắt đầu tươi mới.

Trạng thái không khớp (có thể là CSRF)​

Hermes phát hiện ra rằng giá trị state được máy chủ ủy quyền trả về không khớp với giá trị nó gửi.

Khắc phục: chạy lại thông tin đăng nhập. Nếu tình trạng này vẫn tiếp diễn, hãy kiểm tra proxy hoặc chuyển hướng đang sửa đổi phản hồi OAuth.

Đăng nhập từ máy chủ từ xa​

Nếu hermes không thể mở cửa sổ trình duyệt, hãy sử dụng --no-browser:

hermes auth add minimax-oauth --no-browser

Hermes in URL và mã. Mở URL trên bất kỳ thiết bị nào và hoàn thành quy trình ở đó.

Lỗi "Chưa đăng nhập vào MiniMax OAuth" khi chạy​

Cửa hàng xác thực không có thông tin xác thực cho minimax-oauth. Bạn chưa đăng nhập hoặc tệp thông tin xác thực đã bị xóa.

Khắc phục: chạy hermes model và chọn MiniMax (OAuth), hoặc chạy hermes auth add minimax-oauth.

Đăng xuất​

Để xóa thông tin xác thực MiniMax OAuth đã lưu trữ:

hermes auth remove minimax-oauth

Xem thêm​