---
title: "核心概念"
description: "Organization、Workspace、Environment、Home Cloud、Pool、API Key 与用量证据。"
---

> Documentation Index
> Fetch the complete documentation index at: https://help.airuntime.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# 核心概念

七个对象几乎能解释 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](/zh-hans/gateway/api-keys/)。

## 用量证据

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

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

Source: https://help.airuntime.dev/zh-hans/getting-started/concepts/index.mdx
