Skip to content

快速开始

从新建 Workspace 到第一次成功调用:建 Pool、签发 Key、调用 API。

Updated View as Markdown
For humans

这是走到第一次成功调用最短且不掺假的路径。前提是你能登录 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

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

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

5. 发一次请求

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:生命周期、fallback 与预算策略。
  • 请求:所有接口、请求头与错误格式。
  • 用量与计费:钱的部分在哪里看。

Type to search…

↑↓ navigate↵ selectEsc close