列出提供者和网络模型
使用 provider_models:read 读取 ShareAI Provider API 网络目录、您的提供者目录以及确切的模型详情。
本页面内容
使用网络目录发现可用的模型记录,并使用您的目录检查与已认证提供者相关联的模型。目录条目与主动共享该模型的设备是不同的。


GET
https://api.shareai.now/api/v1/console/provider/model-catalog读取网络模型目录。
- 基础 URL
https://api.shareai.now- 身份验证
- HTTP Basic:提供者 UUID 和提供者访问令牌
- 必需范围
provider_models:read
GET
https://api.shareai.now/api/v1/console/provider/model-catalog/my读取此提供者的模型目录。
- 基础 URL
https://api.shareai.now- 身份验证
- HTTP Basic:提供者 UUID 和提供者访问令牌
- 必需范围
provider_models:read
查询参数#
| 参数 | 使用 |
|---|---|
page | 分页页码,从 1 开始。 |
limit | 请求的页面大小;服务器会应用其支持的范围限制。 |
search | 筛选模型名称或标识符。 |
type | 网络目录中可选支持的目录类型筛选器。 |
cURL
curl --fail-with-body --request GET \
"https://api.shareai.now/api/v1/console/provider/model-catalog/my?page=1&limit=20" \
-u "$PROVIDER_UUID:$PROVIDER_ACCESS_TOKEN"
Python
import json
import os
import urllib.request
import base64
credentials = os.environ["PROVIDER_UUID"] + ":" + os.environ["PROVIDER_ACCESS_TOKEN"]
headers = {"Authorization": "Basic " + base64.b64encode(credentials.encode()).decode()}
request = urllib.request.Request('https://api.shareai.now/api/v1/console/provider/model-catalog/my?page=1&limit=20', headers=headers, method='GET')
with urllib.request.urlopen(request, timeout=60) as response:
print(json.load(response))
TypeScript
const url = "https://api.shareai.now/api/v1/console/provider/model-catalog/my?page=1&limit=20";
const credentials = `${process.env.PROVIDER_UUID}:${process.env.PROVIDER_ACCESS_TOKEN}`;
const headers: Record = {
Authorization: `Basic ${Buffer.from(credentials).toString("base64")}`,
};
const response = await fetch(url, { method: "GET", headers });
if (!response.ok) throw new Error(`${response.status}: ${await response.text()}`);
console.log(await response.json());
读取确切模型#
GET
https://api.shareai.now/api/v1/console/provider/model-catalog/my/model查找精确的 full_model_identifier。
- 基础 URL
https://api.shareai.now- 身份验证
- HTTP Basic:提供者 UUID 和提供者访问令牌
- 必需范围
provider_models:read
cURL
curl --get --fail-with-body https://api.shareai.now/api/v1/console/provider/model-catalog/my/model \
-u "$PROVIDER_UUID:$PROVIDER_ACCESS_TOKEN" \
--data-urlencode "full_model_identifier=$MODEL_IDENTIFIER"
解析响应#
列表响应识别选定的目录并返回其项目。即使某个已知模型尚未添加到提供者,也可以通过精确查找返回。提供定价或共享操作前,请检查返回的关联和权限状态。
保持标识符精确#
不要从模型的显示名称重建标识符。保留其创建者/模型/标签的标点符号,并对查询值进行 URL 编码。在决定是否可以提供服务时,请使用提供者当前的权限和模型的访问条款。
最近更新于 9 月 15, 2026