Tham chiếu chính sách nhà cung cấp
Tham khảo các trường, mặc định, giới hạn và lỗi của nhà cung cấp ShareAI để chọn nhà cung cấp thực thi trong các yêu cầu suy luận.
Trên trang này
Tùy chọn provider đối tượng thuộc cấp cao nhất của yêu cầu suy luận, cùng với model. Một đối tượng trống sử dụng các giá trị mặc định. Nó tách biệt với Truy cập Từ xa Nhà cung cấp và thông tin xác thực quản lý của nó.
| Trường | Loại | Hành vi |
|---|---|---|
only | mảng các thẻ nhà cung cấp | Hạn chế thực thi đối với các nhà cung cấp này. |
ignore | mảng các thẻ nhà cung cấp | Loại trừ các nhà cung cấp này, bao gồm cả từ dự phòng. |
order | mảng các thẻ nhà cung cấp | Xếp hạng các nhà cung cấp này trước theo thứ tự được cung cấp; sau đó áp dụng sắp xếp. |
allow_fallbacks | boolean; mặc định là true | Cho phép các nhà cung cấp đủ điều kiện khác. Với false và danh sách thứ tự không rỗng, chỉ các nhà cung cấp được liệt kê còn lại; không có thứ tự, chỉ nhà cung cấp được xếp hạng đầu tiên còn lại. |
networks | mảng | Hạn chế các loại nhà cung cấp đối với cộng đồng, công ty và/hoặc shareai. |
sort | chuỗi hoặc đối tượng | Sử dụng giá, độ trễ hoặc thông lượng, hoặc một đối tượng với by và direction. |
JSON
{
"provider": {
"ignore": [
"PROVIDER_TO_EXCLUDE"
],
"networks": [
"company",
"shareai"
],
"sort": {
"by": "throughput",
"direction": "desc"
},
"allow_fallbacks": true
}
}
Thay thế chỗ giữ bằng một thẻ nhà cung cấp viết thường thực tế, hoặc xóa trường ignore. Các loại mạng chọn danh mục cơ sở hạ tầng; chúng không xác định người tạo mô hình.
Mặc định sắp xếp#
| Sắp xếp | Hướng mặc định | Đảo ngược rõ ràng |
|---|---|---|
price | asc — thấp nhất trước | desc — cao nhất trước |
latency | asc — thời gian trôi qua ngắn nhất trước | desc — dài nhất trước |
throughput | desc — số lượng token đầu ra mỗi giây nhiều nhất trước | asc — ít nhất trước |
Đối với một đối tượng, đặt by đến một trong những tên này và direction đến asc hoặc desc. Xem cách đo lường và dự phòng hoạt động.
Xác thực và lỗi#
- Sử dụng các boolean JSON và mảng các thẻ nhà cung cấp viết thường. Không gửi null cho nhà cung cấp hoặc sắp xếp.
- Chỉ các trường được liệt kê được chấp nhận; đây không phải là một triển khai đầy đủ tham số OpenRouter.
- Chính sách bị giới hạn ở 8 KiB. Các danh sách only, ignore và order mỗi danh sách chấp nhận tối đa 100 thẻ.
- Các chính sách không hợp lệ trả về HTTP 400. Phạm vi thông tin xác thực bị cấm trả về HTTP 403. Không có nhà cung cấp đủ điều kiện nào khả dụng trả về HTTP 503.
Một chính sách tối thiểu#
JSON
{
"provider": {
"sort": "price"
}
}
Khi hoàn toàn bỏ qua, việc chọn nhà cung cấp cũng sẽ mặc định theo xếp hạng giá tăng dần. Các ràng buộc luôn được áp dụng trước khi xếp hạng.
Cập nhật lần cuối Tháng 9 16, 2026