# API Key

本頁說明 ToriiDB 依序從哪裡尋找 OpenAI API key，以及找不到時的行為。

## 查找順序

`openai.New` 依下列順序查找 key，每一步都會去除空白：

| 順序 | 來源 |
|---|---|
| 1 | `store.New(dir, apiKey)` / `daemon.New(dir, apiKey)` 的選用 `apiKey` 參數 |
| 2 | `OPENAI_API_KEY` 環境變數 |
| 3 | 作業系統 keychain 中 service `ToriiDB` 下的 `OPENAI_API_KEY` |

傳入超過一個 `apiKey` 會讓 `store.New` 失敗：`just one api key`。找不到 key 時 store 仍會開啟；向量操作回傳 `ErrNoEmbedder`（`no embedder: OPENAI_API_KEY not provided`）。可用 `Session.HasEmbedder()` 或 `Daemon.HasEmbedder(ctx)` 檢查。

## 相關頁面

- [設定](/zh/configuration)
- [附加向量](/zh/vector-search)
- [openai](/zh/api-reference-openai)