Chọn nhà cung cấp thực thi cho một yêu cầu API
Sử dụng đối tượng nhà cung cấp ShareAI để chọn nhà cung cấp thực thi độc lập với Creator của mô hình trên tất cả bốn điểm cuối suy luận.
Trên trang này
Đặt model đến đúng định danh dựa trên người tạo. Thêm provider khi bạn muốn giới hạn hoặc xếp hạng cơ sở hạ tầng đủ điều kiện để thực hiện yêu cầu. Bỏ qua sẽ sử dụng chính sách mặc định theo thứ tự giá tăng dần.
Sử dụng một Provider#
cURL
curl --fail-with-body --request POST \
"https://api.shareai.now/api/v1/chat/completions" \
-H "Authorization: Bearer $SHAREAI_API_KEY" \
-H "Content-Type: application/json" \
--data '{
"provider": {
"only": [
"shareai"
],
"allow_fallbacks": false
},
"model": "openai/gpt-5.4",
"messages": [
{
"role": "user",
"content": "Explain model routing in one sentence."
}
]
}'
Python
import json
import os
import urllib.request
headers = {"Authorization": "Bearer " + os.environ["SHAREAI_API_KEY"]}
headers["Content-Type"] = "application/json"
payload = {'provider': {'only': ['shareai'], 'allow_fallbacks': False}, 'model': 'openai/gpt-5.4', 'messages': [{'role': 'user', 'content': 'Explain model routing in one sentence.'}]}
data = json.dumps(payload).encode()
request = urllib.request.Request('https://api.shareai.now/api/v1/chat/completions', data=data, headers=headers, method='POST')
with urllib.request.urlopen(request, timeout=60) as response:
print(json.load(response))
TypeScript
const url = "https://api.shareai.now/api/v1/chat/completions";
const headers: Record = {
Authorization: `Bearer ${process.env.SHAREAI_API_KEY}`,
};
headers["Content-Type"] = "application/json";
const payload = {
"provider": {
"only": [
"shareai"
],
"allow_fallbacks": false
},
"model": "openai/gpt-5.4",
"messages": [
{
"role": "user",
"content": "Explain model routing in one sentence."
}
]
};
const response = await fetch(url, { method: "POST", headers, body: JSON.stringify(payload) });
if (!response.ok) throw new Error(`${response.status}: ${await response.text()}`);
console.log(await response.json());
Sử dụng các thẻ Provider được hiển thị cho mô hình đã chọn. only là một hạn chế cứng: cho phép phương án thay thế không bao giờ cho phép một Provider ngoài danh sách này.
Sử dụng cùng một chính sách trên mỗi endpoint suy luận#
| Điểm cuối | Trường nhập chính | Chọn một mô hình hỗ trợ |
|---|---|---|
/api/v1/chat/completions | messages | Hoàn thành hội thoại |
/api/v1/responses | input | Phản hồi |
/api/v1/embeddings | input | Nhúng |
/api/v1/images/generations | prompt | Tạo hình ảnh |
Chính sách Provider có ý nghĩa tương tự trên các endpoint này. Khả năng của mô hình và Provider khác nhau: một mô hình hội thoại không tự động là mô hình nhúng hoặc hình ảnh. Sao chép một định danh đủ điều kiện cho hoạt động từ danh mục; các endpoint gốc yêu cầu hỗ trợ được cấu hình.
Ưu tiên các Provider được đặt tên#
JSON
{
"provider": {
"order": [
"PROVIDER_A",
"PROVIDER_B"
],
"allow_fallbacks": false,
"sort": {
"by": "price",
"direction": "asc"
}
}
}
Thay thế PROVIDER_A và PROVIDER_B với các thẻ nhà cung cấp viết thường thực tế. Với danh sách được sắp xếp này và các phương án dự phòng bị vô hiệu hóa, chỉ những nhà cung cấp được liệt kê mới đủ điều kiện, theo thứ tự đó. Nhà cung cấp thứ hai trong danh sách vẫn có thể được chọn nếu nhà cung cấp đầu tiên không khả dụng.
Giữ các hạn chế thông tin xác thực#
Yêu cầu của bạn có thể thu hẹp các mô hình và Provider được phép của khóa API. Nó không thể cấp quyền truy cập ngoài các quyền đó. Sự đồng ý OAuth, đủ điều kiện thanh toán và khả dụng của thiết bị vẫn được áp dụng.
Tiếp theo#
Mỗi trường của Provider · Thứ tự sắp xếp và hành vi phương án thay thế
Cập nhật lần cuối Tháng 9 16, 2026