Mang key của bạn — mọi nhà cung cấp sau một API

Bring Your Own Key (BYOK) cho phép gắn key nhà cung cấp upstream của bạn — OpenAI, Anthropic, Google, và hàng chục nhà nữa — vào tài khoản AnyRouter. Khi request khớp mô hình một key của bạn phục vụ được, AnyRouter chuyển cuộc gọi trên key đó. Bạn giữ mọi tính năng AnyRouter — một API thống nhất, log, analytics, preset, routing, gắn attribution app — và trả nhà cung cấp trực tiếp theo giá niêm yết.

Nếu đã có tài khoản nhà cung cấp với credit, giá thương lượng, quyền preview, hoặc gói coding flat-rate, BYOK là cách đơn giản nhất để đặt tất cả sau một endpoint tương thích OpenAI và Anthropic. Chỉ client hiện có vào base URL AnyRouter, giữ model id, key của bạn làm việc.

BYOK biến đống tài khoản nhà cung cấp rời thành một endpoint bền:

• Không markup trên key của bạn. AnyRouter không tính phí traffic BYOK — không phí mỗi request, không phụ phí, không tối thiểu. Bạn chỉ trả nhà cung cấp.
• Giữ rate limit của bạn. Bạn route trên quota tài khoản, không phải pool chung — limit đúng những gì nhà cung cấp cho.
• Failover tự động. Thêm hơn một key mỗi nhà cung cấp thì AnyRouter trải traffic, cách ly key trả 401 hoặc 429 và chuyển key tiếp — một key cháy không còn điểm chết đơn.
• Chiến lược cân tải. Chọn Fallback (thứ tự ưu tiên), Round Robin, Weighted, hoặc Random cho pool key mỗi nhà cung cấp.
• Fallback sang credit. Nếu mọi key BYOK của một nhà cung cấp cạn, request có thể rơi xuống credit trả theo用量 — việc vẫn chảy.

AnyRouter mở BYOK cho hơn 60 nhà cung cấp. Một số phổ biến, kèm định dạng key mỗi bên kỳ vọng:

Endpoint doanh nghiệp như Azure OpenAI, Amazon Bedrock, và Vertex AI nhận credential có cấu trúc — dialog hiện định dạng khi bạn chọn nhà cung cấp. Hướng dẫn từng nhà, gồm nơi tạo key, ở /docs/features/byok-providers.

Thêm key là dán-và-lưu trên trang BYOK:

1. Mở trang BYOK tại /byok (hoặc Dashboard → BYOK) và bấm Add key trên nhà cung cấp bạn muốn.
2. Dán API key nhà cung cấp. Giá trị chỉ ghi — sau khi lưu, AnyRouter không hiện lại.
3. Tùy chọn alias, ưu tiên và trọng số cân tải, hoặc giới hạn cho key AnyRouter cụ thể.
4. Bấm Save. AnyRouter chạy một cuộc gọi xác thực live; nếu key bị từ chối, lỗi hiện và không lưu gì.

Khi đã thêm một hoặc nhiều key, ba model id dựng sẵn route trên tất cả mà không cần tên mô hình cụ thể — AnyRouter chọn mô hình mạnh nhất sẵn có và fallback phần còn lại nếu nhà cung cấp bận:

Dùng bất cứ nơi nào bạn dùng model id thường. Thêm key nhà cung cấp mới thì mô hình của họ vào pool tự động — không đổi config:

curl https://anyrouter.dev/api/v1/chat/completions \
-H "Authorization: Bearer $ANYROUTER_API_KEY" \
-H "Content-Type: application/json" \
-d '{
  "model": "anyrouter/coding",
  "messages": [{ "role": "user", "content": "Refactor this function" }]
}'

Vì chúng chỉ dùng key của bạn, chúng không tiêu credit AnyRouter. Gọi một cái mà không có key khớp thì bạn nhận lỗi rõ bảo thêm key — không bao giờ trừ lặng vào dung lượng trả phí.

Phần lớn quota nhà cung cấp nằm nhàn hầu hết thời gian. Chương trình donate-to-pool để dung lượng đó làm việc: bật một công tắc trên key BYOK đủ điều kiện, và mỗi request AnyRouter route qua nó cộng tới 8% chi phí token vào số dư pending bạn claim thành credit.

• Nhận tới 8%. Mỗi token phục vụ qua key đã góp cộng tới 8% chi phí danh nghĩa vào số dư pending — 5% trên Go, 8% trên Pro/Max, trần $1 mỗi key mỗi ngày UTC.
• Đủ điều kiện là chuyện routing, không phải ToS. Công tắc hiện khi AnyRouter có chỗ route traffic nhà cung cấp đó — không phải tuyên bố Điều khoản cho phép chia key. Bạn tự chịu trách nhiệm xác nhận.
• Đồng ý rõ. Góp cần xác nhận một lần, được ghi lại, rằng key có thể phục vụ request người khác — không tự xảy ra.
• Tắt ngay. Tắt trên dashboard thì key rời pool lập tức, không request treo.

Pool đang live trên mọi nhà cung cấp đủ điều kiện — thêm key và bật công tắc để bắt đầu góp, hoặc xem chi tiết tại /pool.

Key BYOK là credential nhạy cảm, AnyRouter đối xử như vậy:

• Mã hóa at rest với muối từng hàng — rò ciphertext một key không làm yếu key khác.
• Chỉ ghi trên UI — sau lưu chỉ hiện alias và định danh che; giá trị đầy đủ không lấy lại được.
• Không bao giờ log — key nhà cung cấp bị lột khỏi log request và response, chỉ giữ alias và nhà cung cấp để biết credential nào phục vụ request.
• Xác thực live lúc lưu, rồi bỏ response xác thực.
• Không chia bên thứ ba — key chỉ gửi tới nhà cung cấp upstream nó thuộc về.

Mở /byok để nối key nhà cung cấp đầu tiên, rồi chỉ mọi client tương thích OpenAI hoặc Anthropic vào https://anyrouter.dev/api/v1 và bắt đầu route trên tài khoản của bạn không phí thêm.

Tham chiếu tính năng đầy đủ: /docs/features/byok. Hướng dẫn từng bước tạo key từng nhà: /docs/features/byok-providers.