Hướng dẫn toàn tập OpenRouter: Dùng một API key kết nối 364 mô hình, toàn tập về nạp tiền, định tuyến và tiết kiệm chi phí

Lúc 1 giờ đêm, một nhà phát triển độc lập tại Đài Bắc thở dài nhìn màn hình: Side project (dự án phụ) của anh ta đồng thời phải kết nối với ba mô hình — viết code dùng Claude, tác vụ hàng loạt giá rẻ dùng DeepSeek, và thỉnh thoảng muốn thử các mô hình mã nguồn mở mới ra mắt. Ba nhóm API key, ba bảng điều khiển thanh toán, ba tài liệu SDK khác nhau, việc quản lý khóa API thôi cũng đủ vắt kiệt sức đam mê của anh. Sau đó, anh đã chuyển đổi toàn bộ dự án sang OpenRouter, mã nguồn chỉ cần sửa một dòng base_url, gom ba bên thành một. Bài viết này sẽ hướng dẫn chi tiết từng bước để thực hiện quá trình đó.

OpenRouter là gì

OpenRouter là một "cổng tổng hợp mô hình" (model aggregation gateway): bạn chỉ cần một nhóm API key, một điểm cuối (openrouter.ai/api/v1), là có thể gọi đến hàng trăm mô hình trên đó. Vào cuối tháng 7 năm 2026, tôi đã thực hiện một lệnh gọi API models của nó và nhận về phản hồi gồm 364 mô hình từ 57 nhà phát triển — trong đó có 70 mô hình của OpenAI, 48 của Qwen, 39 của Google, 26 của Anthropic, thậm chí cả các hãng mô hình Trung Quốc như MiniMax, Moonshot cũng có mặt.

Điểm quan trọng nhất: Giá cước suy luận (inference pricing) của nó là "bán lại theo giá gốc", không cộng thêm phí trên cước phí mô hình, lợi nhuận của họ đến từ phí nạp tiền (thẻ tín dụng 5.5%, tiền điện tử 5%). Vì vậy, bạn không cần phải lo lắng về việc "gọi qua đây sẽ đắt hơn", điều duy nhất cần quan tâm là khoản phí giao dịch khi nạp tiền.

Nó có thể làm gì

Đối với các nhà phát triển, nó giải quyết ba vấn đề: Một là loại bỏ việc quản lý nhiều tài khoản, chỉ cần một key duy nhất cho tất cả; Hai là tự động chịu lỗi (auto-failover), khi một nhà cung cấp gặp sự cố, hệ thống sẽ tự động chuyển sang nguồn dự phòng; Ba là chi phí trực quan, mọi phản hồi đều đính kèm trực tiếp thông tin về số token đã dùng và chi phí, không cần phải đối chiếu sổ sách sau đó.

Vì API của nó hoàn toàn tương thích với định dạng của OpenAI, bất kỳ mã nguồn nào bạn viết bằng OpenAI SDK đều có thể sử dụng được chỉ bằng cách thay đổi base_url thành điểm cuối của OpenRouter. Cả dòng mô hình Claude hay ChatGPT đều có thể gọi trực tiếp.

Cách sử dụng: 5 bước cơ bản

1. Đăng ký và nạp tiền: Truy cập openrouter.ai để đăng ký và tiến hành nạp tiền. Ở đây có một ngưỡng thực tế — khi tích lũy nạp từ 10 USD trở lên, hạn mức hàng ngày cho các mô hình miễn phí sẽ nhảy từ 50 lần lên 1.000 lần, khuyến nghị nên nạp ngay 10 USD từ đầu.
2. Tạo API key: Vào trang Keys để tạo một khóa, bạn có thể thiết lập "hạn mức chi tiêu" (spending limit) cho từng key, side project nếu vượt ngân sách sẽ tự động ngắt kết nối, tính năng này cực kỳ đáng khuyến nghị.
3. Chọn mô hình: Mã định danh mô hình có định dạng "tên_tác_giả/tên_mô_hình", ví dụ openai/gpt-5.1. Nếu muốn thử nghiệm miễn phí, hãy tìm các mô hình có hậu tố :free, hiện có 14 mô hình như vậy.
4. Gửi yêu cầu đầu tiên: Gửi yêu cầu POST tới openrouter.ai/api/v1/chat/completions, kèm theo Bearer token là được; nếu dùng Python thì có thể dùng trực tiếp OpenAI SDK và thay đổi base_url là xong.
5. Kiểm tra mức sử dụng: Đối tượng phản hồi (response object) đi kèm với đối tượng usage, chứa số lượng token và chi phí thực tế; bảng điều khiển trên website cũng cho phép xem chi phí theo key và theo mô hình.

Mẹo nâng cao

• Tự động chọn mô hình: Sử dụng openrouter/auto-beta để hệ thống giúp bạn chọn mô hình dựa trên loại tác vụ, đồng thời có thể dùng tham số cost_quality_tradeoff để điều chỉnh cân bằng giữa chất lượng và chi phí (0 ưu tiên chất lượng nhất, 10 tiết kiệm chi phí nhất). Mô hình cũ openrouter/auto đã lỗi thời, đừng làm theo các hướng dẫn cũ nữa.
• Định tuyến nhà cung cấp (Supplier routing): Thêm đối tượng provider vào yêu cầu để chỉ định thứ tự nhà cung cấp, sắp xếp theo giá hoặc độ trễ; phiên bản lười biếng là thêm :nitro (tăng tốc độ) hoặc :floor (săn giá rẻ) vào sau mã định danh mô hình.
• Kiểm soát quyền riêng tư: Đặt data_collection: "deny" hoặc zdr: true để chỉ định tuyến đến các điểm cuối không lưu trữ dữ liệu, điều này rất quan trọng khi xử lý dữ liệu nhạy cảm.
• BYOK (Bring Your Own Key): Bạn đang có sẵn hạn mức doanh nghiệp của OpenAI hoặc Anthropic? Có thể liên kết khóa của riêng bạn, 1 triệu lượt yêu cầu đầu tiên mỗi tháng sẽ được miễn phí giao dịch, sau đó tính phí 5%. Chi tiết có thể tham khảo thêm Hướng dẫn quản lý khóa API BYOK của chúng tôi.

Lưu ý

Phí nạp tiền là "chi phí ẩn" duy nhất, bắt đầu từ 5%, mức tối thiểu cho thẻ tín dụng là 0.8 USD, việc nạp tiền số lượng nhỏ thường xuyên sẽ rất thiệt thòi, khuyến nghị nạp đủ một lần. Ngoài ra, khi số dư bị âm, hệ thống sẽ trả về lỗi 402 trên diện rộng — thậm chí không dùng được cả mô hình miễn phí, đây là điểm mà khá nhiều người hay vướng phải. Thêm nữa, độ chính xác lượng hóa (quantization precision) của cùng một mô hình tại các điểm cuối của nhà cung cấp khác nhau có thể khác nhau, dẫn đến chất lượng đầu ra có sự chênh lệch, nếu bạn quan tâm đến điều này hãy dùng tham số quantizations để khóa lại. Nếu bạn thích giải pháp cổng tự xây dựng (self-hosted gateway), LiteLLM và Portkey là những con đường khác, nhưng bạn sẽ phải tự gánh chịu chi phí vận hành.

Đánh giá và Tổng kết từ TheAI學院

Đánh giá: Đối với các nhà phát triển độc lập và các nhóm nhỏ tại Đài Loan, OpenRouter hiện là lựa chọn có ma sát "kết nối đa mô hình" thấp nhất — chỉ một dòng base_url đổi lấy 364 mô hình và khả năng tự động chịu lỗi, phí nạp tiền coi như tiền bảo kê.

Lời khuyên của tôi: Hãy nạp trước 10 USD để mở khóa hạn mức mô hình miễn phí, dùng mô hình :free để chạy thử quy trình trước khi chuyển sang mô hình chính thức. Hãy đặt giới hạn ngân sách cho mọi API key, thói quen này sớm muộn gì cũng sẽ cứu nguy cho bạn một lần.