ShareAI Platform Docs

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.

Xem dưới dạng Markdown
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."
    }
  ]
}'

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ốiTrường nhập chínhChọn một mô hình hỗ trợ
/api/v1/chat/completionsmessagesHoàn thành hội thoại
/api/v1/responsesinputPhản hồi
/api/v1/embeddingsinputNhúng
/api/v1/images/generationspromptTạ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_APROVIDER_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

Tài liệu Nền tảng ShareAI
Tất cả tài liệu

Tìm kiếm theo tiêu đề hoặc nội dung.

Hỏi về trang này

Chọn một trợ lý để khám phá trang này. Bạn cũng có thể sao chép trang và dán vào cuộc trò chuyện của mình.

Ask ChatGPTAsk ClaudeAsk GrokAsk ShareAI