七个对象几乎能解释 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 会显示为不可用。缺失的值永远不会被写成零。