---
title: "快速开始"
description: "从新建 Workspace 到第一次成功调用：建 Pool、签发 Key、调用 API。"
---

> 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.

# 快速开始

这是走到第一次成功调用最短且不掺假的路径。前提是你能登录 `https://console.airuntime.dev` 控制台。

## 1. 选好 Workspace

登录后先选 Organization，再用作用域切换器选 Workspace。生产和开发是两个独立作用域，请在真正要调用
的那一个里操作。

## 2. 建一个 Pool

打开 **Pools** 新建一个：

1. 选能力——第一次做文本调用就选 `text`。
2. 选负责回答的 provider 连接与模型；如果有备用，加上 fallback。
3. 设置每月硬预算和请求速率上限。预算是强制的，不是提醒。
4. 保存后复制 Pool slug，它就是请求里的模型名。

## 3. 签发 Workspace API Key

打开 **API keys**，为当前 Environment 签发一个 Key，并把它授权给你刚建的 Pool。密钥只显示一次，
以 `rk_` 开头。存进你的密钥管理服务，控制台不会再显示它。

## 4. 确认这个 Key 能到哪些 Pool

```bash
curl https://api.airuntime.dev/v1/models \
  -H "Authorization: Bearer $AIRUNTIME_API_KEY"
```

返回的只有这个 Key、Environment、Agreement、Home Cloud、provider 连接与 fallback 策略当下真正能
调用的 Pool。如果你的 Pool 不在列表里，原因一定在上面这几项中，见
[排障](/zh-hans/troubleshooting/)。

## 5. 发一次请求

```bash
curl https://api.airuntime.dev/v1/responses \
  -H "Authorization: Bearer $AIRUNTIME_API_KEY" \
  -H "X-AIRuntime-Route: YOUR_POOL_SLUG" \
  -H "Idempotency-Key: quickstart-request-0001" \
  -H "Content-Type: application/json" \
  -d '{"input": "Summarize our deployment notes", "store": false}'
```

`X-AIRuntime-Route` 用来选 Pool。如果请求体里也写了 `model`，它必须和 Pool 是同一个名字——调用方
永远只发 Pool。

## 6. 看发生了什么

响应头里有 `x-airuntime-request-id`。在控制台打开 **Requests** 能看到那一条记录，打开 **Usage**
能看到它结算进了哪个区间。

## 下一步

- [Pools](/zh-hans/gateway/pools/)：生命周期、fallback 与预算策略。
- [请求](/zh-hans/gateway/requests/)：所有接口、请求头与错误格式。
- [用量与计费](/zh-hans/accounts/usage-and-billing/)：钱的部分在哪里看。

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