验证提供者 API
启用提供者远程访问,并使用提供者 UUID 和范围限定的访问令牌进行目录和定价请求。
本页面内容
提供者 API 管理提供者账户的目录和定价。在提供者设置中创建其凭证。这些凭证与推理 API 密钥以及为单个设备创建的令牌是分开的。
创建访问#
- 在 Console 中选择拥有提供者的工作区。
- 打开提供者的设置并启用 远程访问.
- 创建一个命名的提供者访问令牌并安全保存密钥。
- 使用提供者 UUID 作为 HTTP Basic 用户名,令牌作为其密码。


GET
https://api.shareai.now/api/v1/console/provider验证提供者级别的访问。
- 基础 URL
https://api.shareai.now- 身份验证
- HTTP Basic:提供者 UUID 和提供者访问令牌
- 必需范围
provider_models:read
cURL
curl --fail-with-body --request GET \
"https://api.shareai.now/api/v1/console/provider" \
-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', 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";
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());
命名范围#
| 范围 | 允许的操作 |
|---|---|
provider_models:read | 阅读提供者摘要、目录、模型详情和允许的结算信息。 |
provider_models:write | 更新允许的模型定价和允许的备用目录/共享配置。 |
provider_incentives:write | 更改提供者支持路由的激励设置。 |
范围会根据路由和 HTTP 方法进行检查。目前发出的提供者令牌会暴露其配置的范围;令牌永远不会授予对其他提供者的所有权。在诊断 403 响应时,请记住启用状态和令牌状态。
设备控制是另一层#
启动或停止设备需要为该设备关系创建的令牌。启用提供者远程访问是前提,但提供者目录令牌本身不是设备控制凭证。继续使用 设备 API 认证.
撤销访问#
当自动化不再需要令牌时撤销令牌。删除或撤销一个集成的令牌可以让您退役该集成,而无需替换不相关的令牌。关闭远程访问会禁用该提供者的远程访问路径。
最近更新于 9 月 15, 2026