Skip to content

核心概念

Organization、Workspace、Environment、Home Cloud、Pool、API Key 与用量证据。

Updated View as Markdown
For humans

七个对象几乎能解释 AI Runtime 里的一切。这里一次定义清楚,后面的文档就可以写得很短。

Organization

客户边界。Organization 拥有成员、角色、审计日志和商务 Agreement,并且可以包含多个 Workspace。 成员与角色来自控制台背后的 Clerk 身份体系。

Workspace

隔离单位。Pool、API Key、预算、请求和用量证据都只属于一个 Workspace,同时继承 Organization 的 Home Cloud 与 Agreement。一个 Workspace 里的任何东西都调不到另一个 Workspace 的 Pool。

Environment

production 或 development。API Key 只签发到其中一个 Environment,所以开发用的 Key 永远碰不到 生产流量。控制台的作用域切换是全局的,不是按页面切换。

Home Cloud

这个 Workspace 的客户平面跑在哪里:Google Cloud、AWS、Azure 或共享版。它在 Agreement 里确定,由 归属它的每个 Workspace 继承。为某个 Home Cloud 签发的 Key 不会被另一个接受。

Pool

Pool 就是你的代码要发出去的那个模型名(在 API 契约里叫 Runtime Route)。一个 Pool 固定了:

  • 它服务的能力(文本、结构化输出、embedding、转写、语音、图像、OCR 或隐私过滤);
  • 回答它的 provider 连接与模型,以及可选的安全 fallback;
  • 重试、熔断、限流与硬预算策略;
  • 一个稳定的 slug。这个 slug 就是你请求里的模型名。

Workspace API Key

你的代码用 Authorization: Bearer … 发出去的凭据。一个 Key 绑定一个 Workspace、一个 Environment 和 runtime 作用域,并且只授权给它被指定的 Pool。密钥在签发时只显示一次,见 API Key。

用量证据

每个被接受的请求都会写一条不含内容的记录:Pool、Key、状态、费用和 UTC 时间戳。prompt、输出、 图像、音频、凭据和 provider 响应永远不会进入这条记录。响应头里的 x-airuntime-request-id 能在控制台打开同一条记录。

如果某个时间段还没有证据,AI Runtime 会显示为不可用。缺失的值永远不会被写成零。

Type to search…

↑↓ navigate↵ selectEsc close