这是走到第一次成功调用最短且不掺假的路径。前提是你能登录 https://console.airuntime.dev 控制台。
1. 选好 Workspace
登录后先选 Organization,再用作用域切换器选 Workspace。生产和开发是两个独立作用域,请在真正要调用 的那一个里操作。
2. 建一个 Pool
打开 Pools 新建一个:
- 选能力——第一次做文本调用就选
text。 - 选负责回答的 provider 连接与模型;如果有备用,加上 fallback。
- 设置每月硬预算和请求速率上限。预算是强制的,不是提醒。
- 保存后复制 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
能看到它结算进了哪个区间。