RouterHub cung cấp gì
RouterHub được giới thiệu như một giải pháp thay thế cho OpenRouter, với danh mục mô hình trực tiếp và quy trình truy cập API. Kho lưu trữ này đóng vai trò là trung tâm tài liệu, bao quát việc tìm kiếm mô hình, sử dụng API, di chuyển, giá, biến thể, trường hợp sử dụng, an toàn và khắc phục sự cố.
Tài liệu được tổ chức thành một chuỗi hướng dẫn chuyên biệt. Bạn có thể đọc từ đầu đến cuối hoặc chuyển thẳng đến chủ đề phù hợp với nhiệm vụ của mình.
Chọn điểm bắt đầu phù hợp
- Đánh giá dịch vụ: Bắt đầu với Giải pháp thay thế OpenRouter là gì? và RouterHub và OpenRouter.
- Lập kế hoạch di chuyển: Đọc Hướng dẫn di chuyển để biết URL cơ sở, khóa API và quy trình ánh xạ mô hình được tài liệu hóa.
- Tìm mô hình: Sử dụng hướng dẫn Danh mục mô hình và danh mục trực tiếp để xem các dòng mô hình, ID và giao thức.
- Thực hiện yêu cầu đầu tiên: Làm theo Hướng dẫn nhanh về API.
- Kiểm tra chi phí: Xem Giá để tham khảo các ví dụ tính theo mỗi token.
- So sánh các biến thể: Xem hướng dẫn Mô hình không kiểm duyệt và abliterated.
Thiết lập quyền truy cập
- Mở trang đăng ký RouterHub và làm theo quy trình hướng dẫn ban đầu để nhận khóa API.
- Xem lại tài liệu danh mục mô hình để xác định chính xác ID mô hình và giao thức được ứng dụng hỗ trợ.
- Nếu đang di chuyển một tích hợp OpenRouter hiện có, hãy tham khảo hướng dẫn di chuyển để biết URL cơ sở, cách xử lý khóa và ánh xạ mô hình được tài liệu hóa.
- Sử dụng hướng dẫn nhanh về API để tạo và gửi yêu cầu đầu tiên.
Giữ bí mật khóa API. Lưu khóa trong biến môi trường hoặc một hệ thống quản lý bí mật khác thay vì đặt trực tiếp trong mã nguồn.
Tìm đúng mô hình
Việc chọn mô hình là một phần quan trọng trong quy trình làm việc với RouterHub. Kho lưu trữ này cung cấp riêng một hướng dẫn danh mục, bao quát các dòng mô hình, ID mô hình và giao thức. Hãy sử dụng hướng dẫn đó cùng với danh mục mô hình trực tiếp thay vì đoán mã định danh.
Quy trình lựa chọn thực tế có thể gồm các bước sau:
- Xác định nhiệm vụ, chẳng hạn như lập trình, quy trình tác vụ của tác nhân, nghiên cứu hoặc viết.
- Duyệt thông tin về các dòng mô hình và biến thể hiện có.
- Sao chép chính xác ID mô hình hiển thị trong danh mục.
- Xác nhận giao thức của mô hình phù hợp với ứng dụng khách hoặc tích hợp bạn định sử dụng.
- Kiểm tra tài liệu giá trước khi gửi lưu lượng sản xuất.
Thực hiện yêu cầu API đầu tiên
Kho lưu trữ hướng người dùng đến hướng dẫn nhanh về API để thực hiện yêu cầu đầu tiên. Vì endpoint và định dạng yêu cầu chính xác được duy trì trong hướng dẫn đó, hãy sử dụng các giá trị hiện tại ở đó thay vì ghi cứng một endpoint từ ví dụ phụ.
Thiết lập yêu cầu thường cần các giá trị được tài liệu hóa sau:
API key: <your RouterHub API key>
Base URL: <value from the RouterHub API quickstart>
Model ID: <exact ID from the model catalogue>
Protocol: <protocol supported by the selected model>Để triển khai cụ thể, hãy mở hướng dẫn nhanh về API, sao chép ví dụ yêu cầu, thiết lập khóa API một cách an toàn và thay giá trị mô hình bằng ID chính xác đã chọn từ danh mục.
Di chuyển một tích hợp OpenRouter hiện có
Nếu ứng dụng của bạn đã sử dụng OpenRouter, hãy làm theo Hướng dẫn di chuyển của kho lưu trữ. README xác định ba vấn đề cần lưu ý khi di chuyển: thay đổi URL cơ sở, sử dụng khóa API RouterHub và ánh xạ mã định danh mô hình.
Hãy dùng danh sách kiểm tra này trước khi thử nghiệm:
- Cập nhật URL cơ sở của nhà cung cấp theo tài liệu di chuyển.
- Thay thông tin xác thực hiện tại bằng khóa API RouterHub.
- Xem lại từng tên mô hình và ánh xạ chúng đến ID mô hình RouterHub chính xác.
- Xác nhận giao thức mà mô hình đã chọn yêu cầu.
- Gửi một yêu cầu thử nghiệm nhỏ trước khi đưa tích hợp vào môi trường sản xuất.
Để hiểu rõ hơn về lý do chuyển đổi, hãy đọc Tại sao nên chuyển đổi, tài liệu đề cập đến các chủ đề về thanh toán trả trước, ID mô hình và các tùy chọn không kiểm duyệt.
Xem xét giá và các biến thể
Giá
Hướng dẫn Giá giải thích các ví dụ tính theo mỗi token. Sử dụng hướng dẫn này để ước tính chi phí cho khối lượng công việc dự kiến và so sánh các mô hình trước khi tăng quy mô yêu cầu.
Mô hình không kiểm duyệt và abliterated
Hướng dẫn Mô hình không kiểm duyệt và abliterated dành cho việc so sánh các biến thể này. Đồng thời đọc hướng dẫn An toàn của kho lưu trữ và sử dụng mọi mô hình một cách hợp pháp, có trách nhiệm.
Khám phá các trường hợp sử dụng thực tế
Sau khi yêu cầu đầu tiên hoạt động, hướng dẫn Trường hợp sử dụng trình bày về lập trình, tác nhân, nghiên cứu và viết. Hãy dùng các ví dụ này để lựa chọn dòng mô hình và giao thức phù hợp với loại ứng dụng bạn đang xây dựng.
Đối với các câu hỏi về vận hành, hãy tham khảo hướng dẫn Khắc phục sự cố. Hướng dẫn này tập trung vào vấn đề xác thực, ID mô hình và các giao thức. Câu hỏi thường gặp cung cấp các câu trả lời chi tiết hơn, trong khi Bảng thuật ngữ giải thích các thuật ngữ được sử dụng trong toàn bộ tài liệu.
Mẹo nâng cao
- Ưu tiên ID chính xác: Sao chép mã định danh mô hình từ danh mục để tránh lỗi do khác biệt về tên.
- Kiểm tra giao thức sớm: Xác thực khả năng tương thích của giao thức trước khi gỡ lỗi mã ứng dụng.
- Tách cấu hình khỏi mã: Để khóa API, URL cơ sở và ID mô hình ở dạng có thể cấu hình nhằm giúp việc chuyển đổi và kiểm thử dễ dàng hơn.
- Ước tính chi phí trước: Sử dụng các ví dụ về giá theo token trước khi chạy khối lượng công việc lớn.
- Sử dụng các đường dẫn tài liệu: Chọn hướng dẫn chuyển đổi, bắt đầu nhanh, giá hoặc khắc phục sự cố thay vì xem mọi vấn đề tích hợp là vấn đề API nói chung.
- Tiến hành đánh giá an toàn: Khi đánh giá các biến thể không kiểm duyệt hoặc đã loại bỏ bộ lọc, hãy đọc hướng dẫn an toàn và chỉ giới hạn việc sử dụng cho các mục đích hợp pháp.
Kết luận
Kho lưu trữ RouterHub là điểm khởi đầu có cấu trúc để đánh giá một giải pháp thay thế cho OpenRouter và tích hợp với API của giải pháp này. Hãy bắt đầu bằng cách lấy khóa API, chọn ID mô hình chính xác từ danh mục, xác minh giao thức và làm theo hướng dẫn bắt đầu nhanh về API. Nếu bạn đang chuyển đổi một ứng dụng hiện có, hãy sử dụng hướng dẫn chuyển đổi chuyên biệt, sau đó xác thực các yếu tố về giá, biến thể, an toàn và khắc phục sự cố trước khi triển khai.