ShareAI Platform Docs

為 API 請求揀選執行供應商

使用 ShareAI provider 物件,喺所有四個推理端點中,獨立於模型嘅 Creator 選擇執行 provider。

以Markdown檢視
喺呢頁面

設定 model 到精確嘅創作者基礎識別碼。新增 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."
    }
  ]
}'

使用所選模型顯示嘅提供者標籤。 only 係一個嚴格限制:允許後備選項永遠唔會允許喺呢個列表以外嘅提供者。

喺每個推理端點使用相同嘅政策#

端點主要輸入欄位選擇支持嘅模型
/api/v1/chat/completionsmessages聊天完成
/api/v1/responsesinput回應
/api/v1/embeddingsinput嵌入
/api/v1/images/generationsprompt圖像生成

提供者政策喺呢啲端點上有相同嘅意思。模型同提供者嘅功能唔同:一個聊天模型唔會自動成為嵌入或者圖像模型。從目錄複製一個符合資格嘅操作識別碼;原生端點需要配置支持。

優先選擇有名嘅提供者#

JSON

{
  "provider": {
    "order": [
      "PROVIDER_A",
      "PROVIDER_B"
    ],
    "allow_fallbacks": false,
    "sort": {
      "by": "price",
      "direction": "asc"
    }
  }
}

替換 PROVIDER_A 同埋 PROVIDER_B 使用真實嘅小寫提供者標籤。喺呢個有序列表同禁用後備選項嘅情況下,只有列出嘅提供者符合資格,按呢個順序。當第一個提供者不可用時,第二個列出嘅提供者仍然可以被選擇。

保持憑證限制#

你嘅請求可以縮窄 API 密鑰允許嘅模型同提供者範圍,但唔可以授予超出呢啲權限嘅訪問權限。OAuth 同意、計費資格同設備可用性繼續適用。

下一步#

每個提供者欄位 · 排序順序同後備行為

最後更新日期 2026年9月16日

ShareAI平台文檔
所有文檔

按標題或者內容搜尋。

問下關於呢頁嘅問題

選擇一個助手嚟探索呢頁。你亦可以複製呢頁,然後貼喺你嘅對話入面。

Ask ChatGPTAsk ClaudeAsk GrokAsk ShareAI