跳转到主要内容
GET
/
api
/
v1
/
providers
列出可用 Provider(目录)
curl --request GET \
  --url https://openapi.beeos.ai/api/v1/providers \
  --header 'Authorization: Bearer <token>'
{
  "success": true,
  "data": [
    {
      "meta": {
        "id": "<string>",
        "name": "<string>",
        "description": "<string>",
        "version": "<string>"
      },
      "capabilities": {
        "longRunning": true,
        "browserUse": true,
        "codeExec": true,
        "fileSystem": true,
        "customImage": true,
        "maxDurationSec": 123,
        "costModel": "<string>",
        "device": true
      }
    }
  ]
}

授权

Authorization
string
header
必填

通过 Authorization: Bearer <token> header 传用户 JWToag_ User API Key。两者都由 openapi-gateway 对 Auth service 验证。

JWT 与 API Key 都是 user-scoped:每个 key(以及每个 JWT) 绑定到唯一 owner,所有路由都自动放开该 owner 名下的全部资源。 跨租户访问由 handler 内的 owner-ACL 拦截 —— API 表面没有 per-route scope 词汇。

v1.1.0 已移除: 历史 scope 词汇(agents:* / tasks:* / files:* / instances:*)以及 403 insufficient_scope 错误码已下线。已签发的 oag_ key 自动获得 owner 全权限, 无需重建。之前显式传 scopes 调用 createAPIKey 的 SDK 客户端可以直接删除该参数。详见文末 changelog 迁移说明。

响应

标准 { success, data } 信封;dataProviderCatalogItem 数组,每项含一个 meta 块(idnamedescriptionversion)和一个 capabilities 块(camelCase 布尔字段加 maxDurationSec / costModel)。 Mintlify 默认把外层渲染成 object[],展开 "Show child attributes" 就能看到完整字段树 —— item 本身是强类型的。

success
boolean
必填
data
ProviderCatalogItem · object[]
必填