Hướng dẫn RikkaHub kết nối API trung gian: Cấu hình ứng dụng chat AI trên Android

发布时间2026年9月16日 04:44
语言vi

Hướng dẫn kết nối RikkaHub (ứng dụng chat AI mã nguồn mở cho Android): tạo khóa sk-, chọn loại Provider theo nhóm mô hình và nhập Base URL để dễ dàng gọi các mô hình Gemini / Claude / GPT.

I. RikkaHub là gì

RikkaHub là một ứng dụng chat AI mã nguồn mở trên Android, hỗ trợ kết nối với nhiều kênh mô hình như Anthropic (Claude), OpenAI (GPT), Google (Gemini), v.v. Bạn chỉ cần trỏ Provider (Nhà cung cấp) của ứng dụng tới gateway trung gian, nhập khóa sk- là có thể sử dụng hạn mức của nền tảng để gọi các mô hình và thanh toán theo token.

II. Chuẩn bị

Đăng nhập vào bảng điều khiển API, tạo khóa sk-xxxxxx trong mục "API Keys" (khóa chỉ hiển thị một lần, vui lòng lưu lại).
Xác nhận slug của mô hình bạn muốn dùng (ví dụ: gemini-3.7-flash, claude-sonnet-5, gpt-5.5). Bạn có thể xem trong mục "Model ID" ở góc trên bên phải trang "Tokens" trong bảng điều khiển.
Xác nhận địa chỉ gateway: https://www.relay-api.com.

III. Cấu hình trong RikkaHub

Mở RikkaHub →「Cài đặt」→「Nhà cung cấp (Provider)」→ Nhấn dấu "+" ở góc trên bên phải để thêm mới, chọn loại Provider tùy theo mô hình bạn muốn sử dụng:

① Gọi Gemini (Loại Google, khuyến nghị)

Loại Provider : Google / Gemini
Base URL      : https://www.relay-api.com/v1beta
API Key       : sk-khóa_của_bạn
Model ID      : gemini-3.7-flash

Base URL bắt buộc phải có /v1beta. RikkaHub sẽ tự động nối /models/{model}:generateContent vào sau Base URL. Nếu thiếu /v1beta, yêu cầu sẽ gửi đến /models/... dẫn đến lỗi 404 (Không tìm thấy trang).

② Gọi Claude (Loại Anthropic)

Loại Provider : Anthropic / Claude
Base URL      : https://www.relay-api.com
API Key       : sk-khóa_của_bạn
Model ID      : claude-sonnet-5

Đối với loại Anthropic, đừng thêm /v1 vào Base URL, ứng dụng sẽ tự thêm /v1/messages. Nếu bạn nhập thêm, đường dẫn sẽ trở thành /v1/v1/messages.

③ Gọi GPT (Loại tương thích OpenAI)

Loại Provider : OpenAI tương thích / OpenAI Compatible
Base URL      : https://www.relay-api.com/v1
API Key       : sk-khóa_của_bạn
Model ID      : gpt-5.5

IV. Đối chiếu địa chỉ giao diện (API)

Nhóm mô hình	Loại Provider	Base URL	Giao thức
Gemini	Google / Gemini	`https://www.relay-api.com/v1beta`	Google generateContent
Claude	Anthropic	`https://www.relay-api.com`	Anthropic Messages
GPT	OpenAI tương thích	`https://www.relay-api.com/v1`	OpenAI Chat Completions

V. Lưu ý quan trọng: Mô hình được tách biệt theo nhóm, không thể gọi chéo

Ba giao thức trên trang này là các cổng truy cập nguyên bản độc lập, các mô hình được phân tách theo nhóm:

Các mô hình trong nhóm Gemini (như gemini-3.7-flash) chỉ có thể chạy qua loại Google / Gemini + /v1beta.
Nếu điền tên mô hình Gemini vào loại Anthropic, hệ thống sẽ trả về 400 Mô hình Claude không được kích hoạt hoặc không tồn tại: gemini-xxx.
Nếu điền tên mô hình Gemini vào loại OpenAI, hệ thống sẽ trả về 400 Mô hình OpenAI không được kích hoạt hoặc không tồn tại: gemini-xxx.

Vì vậy, "Model ID" và "Loại Provider" phải khớp nhau: Dùng mô hình của nhóm nào thì chọn loại Provider tương ứng.

VI. Khắc phục sự cố thường gặp

Hiện tượng	Nguyên nhân và cách xử lý
Trả về `404` (Trang web/HTML)	Base URL thiếu hậu tố phiên bản (ví dụ: Gemini thiếu `/v1beta`), yêu cầu đã gửi đến đường dẫn không tồn tại. Hãy bổ sung `/v1beta` hoặc `/v1`.
Đường dẫn xuất hiện `/v1beta/v1beta/` hoặc `/v1/v1/`	Base URL bị trùng lặp số phiên bản. Chỉ nên nhập phiên bản một lần trong Base URL.
`400 Mô hình Claude/OpenAI không được kích hoạt hoặc không tồn tại: gemini-xxx`	Nhóm mô hình không khớp với loại Provider—đã điền mô hình Gemini vào loại Claude/OpenAI. Hãy đổi sang loại Google / Gemini.
`401 / 403`	Khóa không hợp lệ, chưa được kích hoạt, không đủ số dư hoặc token không có quyền truy cập lộ trình/mô hình này. Vui lòng kiểm tra khóa và số dư tài khoản.
`400 Request contains an invalid argument`	Dịch vụ thượng nguồn kiểm tra nghiêm ngặt một số tham số nhất định (ví dụ: chữ hoa/thường của mức suy luận, gọi công cụ tools); thỉnh thoảng do biến động ngắn hạn từ thượng nguồn, chỉ cần thử lại.
Lỗi lấy danh sách mô hình	Một số ứng dụng khách phân tích danh sách mô hình trả về từ trung gian khá khắt khe, hãy chuyển sang "Tự nhập ID mô hình (Manually enter model ID)".

VII. Khuyến nghị bảo mật

Không lưu khóa trong các kho lưu trữ công khai hoặc ảnh chụp màn hình, khuyến nghị dùng biến môi trường hoặc lưu trữ cục bộ an toàn.
Tạo khóa riêng cho từng thiết bị hoặc từng công cụ để dễ dàng thống kê mức sử dụng và vô hiệu hóa khi cần.