ShareAI Platform Docs

为 API 请求选择执行提供者

使用ShareAI提供者对象独立选择执行提供者,而无需依赖模型创作者,在所有四个推理端点中均可实现。

查看为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_APROVIDER_B 使用真实的小写提供者标签。使用此排序列表并禁用回退,仅列出的提供者有资格,按顺序排列。如果第一个提供者不可用,第二个列出的提供者仍然可以被选择。

保持凭证限制#

您的请求可以缩小 API 密钥允许的模型和提供者范围。它不能授予超出这些权限的访问权限。OAuth 同意、计费资格和设备可用性仍然适用。

下一步#

每个提供者字段 · 排序顺序与回退行为

最后更新于 2026 年 9 月 16 日

ShareAI平台文档
所有文档

按标题或内容搜索。

询问关于此页面的问题

选择一个助手来探索此页面。您也可以复制页面并将其粘贴到您的对话中。

Ask ChatGPTAsk ClaudeAsk GrokAsk ShareAI