Hướng dẫn OpenRouter API key

Cách lấy OpenRouter API key và dùng mô hình miễn phí

Tạo OpenRouter API key, xem giới hạn của mô hình miễn phí, sửa lỗi 401, 402, 429 và dùng OpenRouter trên iPhone, Android hoặc web.

Cập nhật
  • Cách lấy OpenRouter API key: đăng nhập openrouter.ai, mở openrouter.ai/keys và tạo key; key bắt đầu bằng “sk-or-v1-”. Tạo key thì miễn phí, các mô hình có ID kết thúc bằng “:free” dùng được trong giới hạn mỗi ngày, còn mọi mô hình khác trả bằng credit nạp trước.
  • OpenRouter là một tài khoản và một key cho mô hình của nhiều công ty AI. OpenRouter không phát hành app chat riêng cho iPhone hay Android, nên trên điện thoại bạn dùng một app chat cho nhập key OpenRouter, chẳng hạn Oriveo.
  • Tính đến ngày 18 tháng 11 năm 2026, mô hình miễn phí cho 20 yêu cầu mỗi phút và 50 yêu cầu mỗi ngày, hoặc 1.000 yêu cầu mỗi ngày khi bạn đã mua tổng cộng ít nhất 10 credit. Lỗi 402 nghĩa là bạn đã hết credit.
Oriveo trên iPhone: màn hình nhà cung cấp, liệt kê những nhà cung cấp bạn đã kết nối và chi tiêu tháng này.

OpenRouter là gì, API key là gì?

OpenRouter là dịch vụ cho bạn dùng mô hình của nhiều công ty AI qua cùng một tài khoản. Thay vì đăng ký với từng công ty, bạn nạp credit vào OpenRouter một lần rồi chọn mô hình trong danh sách của họ.

API key là mã bí mật mà app dùng để gửi yêu cầu bằng tài khoản của bạn. OpenRouter kiểm tra key, chuyển tin nhắn tới mô hình bạn chọn và trừ tiền vào credit OpenRouter của bạn.

OpenRouter được làm cho app và nhà phát triển. OpenRouter không phát hành app chat riêng cho iPhone hay Android, vì thế nhiều người đi tìm “app OpenRouter”. Thứ họ thực sự cần là một app chat cho nhập key OpenRouter.

Cách lấy OpenRouter API key

Chỉ mất vài phút trên trang web OpenRouter.

  • Vào openrouter.ai và tạo tài khoản, hoặc đăng nhập.
  • Mở trang key tại openrouter.ai/keys và tạo key mới. Đặt tên theo app hoặc thiết bị bạn sẽ dùng.
  • Sao chép key. Key OpenRouter bắt đầu bằng “sk-or-v1-” và dài 73 ký tự, nên hãy kiểm tra xem đã sao chép đủ chưa.
  • Nếu muốn dùng các mô hình không miễn phí, hãy nạp credit ở trang Credits.
  • Cất key ở chỗ an toàn, ví dụ trình quản lý mật khẩu. Nếu key bị lộ, hãy xóa nó trên trang key và tạo key mới.

OpenRouter API có miễn phí không?

Một phần. Tạo tài khoản và key thì không mất gì, và OpenRouter có các mô hình miễn phí với ID kết thúc bằng “:free”. Những mô hình còn lại trả bằng credit nạp trước. OpenRouter cũng nói người dùng mới được cấp một ít credit miễn phí, nhưng không nói là bao nhiêu.

Mô hình miễn phí có giới hạn. Đây là giới hạn OpenRouter công bố, tính đến ngày 18 tháng 11 năm 2026:

  • Nếu số dư xuống dưới 0, OpenRouter cho biết ngay cả mô hình miễn phí cũng có thể báo lỗi.
  • Trang của OpenRouter cho biết hiện mô hình nào có bản “:free”; hãy kiểm tra ở đó trước khi trông cậy vào một mô hình.
OpenRouter API có miễn phí không?
Tài khoản của bạnSố yêu cầu mô hình miễn phí mỗi phútSố yêu cầu mô hình miễn phí mỗi ngày
Đã mua tổng cộng dưới 10 credit2050
Đã mua tổng cộng ít nhất 10 credit201.000

Credit OpenRouter hoạt động thế nào?

OpenRouter dùng hình thức trả trước. Bạn mua credit ở trang Credits bằng thẻ hoặc một trong các phương thức thanh toán khác được liệt kê ở đó, và mỗi yêu cầu sẽ trừ dần vào số credit này. Tính đến ngày 18 tháng 11 năm 2026, điều khoản của OpenRouter quy định mỗi lần mua tối thiểu $5, có cộng thêm phí thanh toán, và credit chưa dùng có thể hết hạn sau 365 ngày kể từ lúc mua. Xem chi tiết hiện hành tại openrouter.ai/terms.

Mỗi mô hình có giá theo token riêng, ghi trên trang của mô hình đó ở OpenRouter. Chúng tôi không chép giá vào đây vì giá thay đổi. Oriveo hiện chi phí ước tính trên từng câu trả lời; trang Activity và trang thanh toán của OpenRouter mới là số liệu cuối cùng.

Cách dùng OpenRouter trên iPhone, Android hoặc web

Vì OpenRouter không có app di động chính thức, bạn cần một app client của bên thứ ba. Trong Oriveo, OpenRouter là một trong 15 nhà cung cấp có sẵn, nằm trong nhóm Nền tảng tổng hợp, nên bạn không phải gõ địa chỉ.

  • Mở Nhà cung cấp: một tab trên iPhone và Android, hoặc ở thanh bên trên web.
  • Bấm nút + (Thêm nhà cung cấp), rồi chọn OpenRouter. Chip Nền tảng tổng hợp giúp thu gọn danh sách.
  • Dán key vào phần “Kết nối OpenRouter” rồi bấm Tiếp tục.
  • Chờ dòng “Đang xác thực các mô hình kết nối và đồng bộ hóa...”. Oriveo sẽ tải danh sách mô hình của OpenRouter.
  • Chọn một mô hình và bắt đầu chat. Nếu chưa có credit, hãy chọn mô hình có ID kết thúc bằng “:free”.
Màn hình chính của Oriveo với ô nhập tin nhắn, mô hình đang chọn hiện bên dưới và các cuộc trò chuyện hôm nay, mỗi cuộc kèm chi phí
Kết nối key xong, bạn chọn mô hình ngay dưới ô nhập tin nhắn. Mỗi cuộc trò chuyện trong danh sách đều hiện chi phí ước tính.

Key OpenRouter của tôi được lưu ở đâu?

Trên iPhone và Android, yêu cầu đi thẳng từ thiết bị của bạn tới nhà cung cấp, và key được giữ trong vùng lưu trữ bảo mật của điện thoại (Keychain trên iPhone, Keystore trên Android). Trên bản web, yêu cầu đi qua một lớp chuyển tiếp thời gian thực trên máy chủ Oriveo: key chỉ được dùng cho đúng yêu cầu đó, không bị lưu thành dữ liệu tài khoản, và cuộc trò chuyện BYOK không bị lưu thành nhật ký chat. Đồng bộ đám mây không tải key lên. Muốn dùng OpenRouter trên thiết bị thứ hai, hãy dán key ở đó nữa, hoặc tạo một key riêng cho thiết bị đó.

Bạn trả thẳng cho OpenRouter theo giá của họ. Oriveo không cộng thêm phí.

Vì sao OpenRouter API key không hoạt động?

Trang lỗi của OpenRouter (openrouter.ai/docs/api-reference/errors) liệt kê ý nghĩa của từng mã. Các lỗi hay gặp, tính đến ngày 18 tháng 11 năm 2026:

  • Trong Oriveo, lỗi 402 hiện thành “Đã hết hạn mức của nhà cung cấp”, còn lỗi 429 hiện thành “Tỷ lệ giới hạn” trên web hoặc “Tỷ lệ nhà cung cấp có giới hạn” trên iPhone và Android.
  • Không thấy một mô hình trong danh sách: đồng bộ lại danh sách mô hình và kiểm tra xem OpenRouter có còn cung cấp mô hình đó không.
Vì sao OpenRouter API key không hoạt động?
LỗiNghĩa là gìCần làm gì
401 Invalid credentialsKey sai, đã bị tắt hoặc đã bị xóaSao chép lại toàn bộ key, hoặc tạo key mới
401 “this is not an OpenRouter API key”Bạn dán nhầm key của nhà cung cấp khácDùng key lấy từ openrouter.ai/keys; key bắt đầu bằng sk-or-v1-
402 insufficient creditsTài khoản hoặc key này đã hết creditNạp thêm credit, hoặc nâng hạn mức của key; chờ đợi không giúp được gì
403 ForbiddenBị chặn do quyền truy cập, kiểm duyệt nội dung, guardrail hoặc giới hạn ngân sáchKiểm tra cài đặt và hạn mức của key, hoặc sửa lại tin nhắn
429 rate limitedQuá nhiều yêu cầu, do OpenRouter hoặc nhà cung cấp của mô hình giới hạnChờ rồi thử lại; với mô hình miễn phí, xem lại giới hạn ở trên
502 hoặc 503Mô hình hoặc các nhà cung cấp của nó hiện không khả dụngThử lại sau hoặc chọn mô hình khác

Dùng OpenRouter hay key riêng của từng nhà cung cấp?

OpenRouter tiện khi bạn muốn nhiều mô hình với một key và một số dư. Key lấy thẳng từ nhà cung cấp như OpenAI hay Anthropic hợp với bạn khi bạn muốn có tài khoản và hóa đơn riêng của nhà cung cấp đó. Oriveo nhận cả hai, nên bạn có thể giữ OpenRouter cạnh các key trực tiếp và đổi lần lượt giữa các mô hình trong cùng một cuộc trò chuyện.

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

OpenRouter có miễn phí không?
Một phần. Key thì miễn phí, và các mô hình có ID kết thúc bằng “:free” không mất tiền trong giới hạn mỗi ngày: tính đến ngày 18 tháng 11 năm 2026 là 50 yêu cầu mỗi ngày, hoặc 1.000 khi bạn đã mua ít nhất 10 credit. Các mô hình khác cần credit nạp trước.
OpenRouter API key lấy ở đâu?
Tại openrouter.ai/keys sau khi đăng nhập. Tạo key, đặt tên và sao chép toàn bộ; key bắt đầu bằng “sk-or-v1-”.
OpenRouter có app cho iPhone hay Android không?
OpenRouter không phát hành app chat di động riêng. Hãy dùng một app chat cho nhập key OpenRouter: trong Oriveo, mở Nhà cung cấp, bấm +, chọn OpenRouter, dán key rồi bấm Tiếp tục.
Lỗi 402 của OpenRouter nghĩa là gì?
Tài khoản hoặc key bạn đang dùng không đủ credit. Nạp thêm credit trên OpenRouter, hoặc nâng hạn mức của key nếu bạn có đặt, rồi thử lại. Lỗi này không tự hết.
Vì sao OpenRouter API key không hoạt động?
Hãy xem mã lỗi. 401 nghĩa là key sai hoặc không phải key OpenRouter; 402 nghĩa là hết credit; 429 nghĩa là quá nhiều yêu cầu hoặc đã chạm giới hạn của mô hình miễn phí. Bài hướng dẫn về lỗi API key của chúng tôi giải thích từng mã.
OpenRouter API key trông như thế nào?
Key bắt đầu bằng “sk-or-v1-”, theo sau là 64 chữ cái và chữ số, tổng cộng 73 ký tự. Nếu key của bạn ngắn hơn, nghĩa là có một phần chưa được sao chép.

Bài liên quan

Từ blog

Dùng key OpenRouter ngay trên điện thoại

Mở bản web hoặc tải Oriveo cho iPhone hay Android, dán key OpenRouter và đổi qua lại giữa các mô hình, kèm chi phí ước tính trên từng câu trả lời.

Chưa có API key? Hãy bắt đầu với Oriveo Free.