Cloud 服务端 SDK

在可信后端使用 Cloud 服务端 SDK 2.0.0 和 bsk_ 服务端 Key。BEEOS_CLOUD_API_URL 使用当前环境的 /v1 URL。TypeScript @beeos-ai/cloud-sdk、Python 发行包 beeos-cloud-sdk（导入 beeos_cloud_sdk）和 Go github.com/beeos-ai/beeos-cloud-sdks/go/v2 均来自 beeos-cloud-sdks 仓库。参阅语言设置。

Python 安装：pip install beeos-cloud-sdk==2.0.0。

import { BeeOSClient } from "@beeos-ai/cloud-sdk";

const cloud = new BeeOSClient({
  baseURL: process.env.BEEOS_CLOUD_API_URL!, // https://api.cloud.beeos.ai/v1
  apiKey: process.env.BEEOS_API_KEY!, // bsk_…, backend only
}).withExternalUser(process.env.BEEOS_EXTERNAL_USER_ID!);

const discovery = await cloud.catalog.getDiscovery();
console.log(discovery);

强类型资源方法

BeeOSClient 通过 catalog、instances、harnesses 和 responses 提供强类型入参与结果。产品用户请求使用 withExternalUser(id)（Python：with_external_user；Go：WithExternalUser）。每次变更传入稳定的幂等 Key；SDK 自动设置请求头，非成功响应会抛出 API 错误。

instances.create 接收 variant_id 和 BYOK llm.providers / llm.models。无模型的 AgentBay、BeeOS 浏览器/移动端 variant 省略 llm。强类型创建结果包含 data.id 和 operation；Response 有独立的 id、status 和 output。参阅快速开始。

SDK 自动将 harness、Responses 和 discovery 路由到同 host 的 /uhp/v1，普通服务端资源使用 /v1。版本化写入传入资源版本。参阅资源方法、运行时方法和语言设置。