# Vast.ai 監控該用哪種 API 密鑰，密鑰填在哪裡？

密鑰放在帳戶連接裡，不要填進 Machine ID。唯讀監控需要能查看機器和收入的權限。轉帳和上下架屬於寫入權限，不應配給這把鑰匙。報告被拒絕時合計保持未知。

- Canonical: https://iotahome.site/zh-TW/learn/vast-api-key-read-only-monitoring
- Publisher: IOTA Watch
- Topics: Vast.ai
- Published: 2026-10-24
- Updated: 2026-10-24

## 先看結論

用一把唯讀密鑰連接 Host 帳戶，再用 Machine ID 指定機器。客戶實例密鑰、轉帳權限或上下架權限都不是這把鑰匙該有的範圍。連上密鑰也不等於機器已通過 Vast 驗證。

## 密鑰放進連接，編號放進 Machine ID

建立只含 machine_read 和 billing_read 的密鑰，填進帳戶連接。Machine ID 仍從 Host 機器頁複製。寫入權限留空。

## 密鑰權限和監控要不要它

| 權限類別 | 官方說明它能做的事 | 給監控這把鑰匙嗎 |
| --- | --- | --- |
| machine_read | 查看機器和報告 | 要。沒有它就看不到你的機器列表 |
| billing_read | 查看發票和收入 | 要。收入屬於這一類裡的 Show Earnings |
| billing_write | 轉移信用 | 不要。這不是讀取 |
| machine_write | 上下架、維護、清理機器 | 不要。監控不代替你操作機器 |
| instance_read / instance_write | 查看或建立客戶實例 | 不要拿客戶鑰匙代替 Host 鑰匙 |

監控要的是一把 Host 側的唯讀密鑰，放在 [Vast.ai 監控](https://iotahome.site/zh-TW/projects/vast) 的帳戶連接裡。Machine ID 那一欄只接受機器編號。客戶用來開實例的密鑰，和能轉移信用、能上下架的密鑰，都不適合拿來做這個唯讀查看。

## 權限頁怎麼讀

Vast 的權限按類別授予。machine_read 對應查看機器和報告。billing_read 對應查看發票和收入，其中包含 Show Earnings。billing_write 是轉移信用。machine_write 包含上架、下架、維護和清理。instance_read 與 instance_write 是客戶實例，不是 Host 機器列表。

權限頁列出的是動作名稱，沒有把每一條 URL 都寫出來。因此不要因為頁面上沒有出現某個路徑，就改去勾選轉帳或上下架。

## 連接之後檢查什麼

- 機器列表裡能看見你的 Machine ID，GPU 型號與機器頁一致。

- 四項齊全時才出現當日合計。少一項或報告沒有返回，合計保持未知。

- 帳戶餘額沒有被抄進這台機器。見 [收入與餘額](https://iotahome.site/zh-TW/learn/vast-host-revenue-vs-balance)。

## 接下來怎麼處理

- 看不到機器：補 machine_read，確認這把鑰匙屬於 Host 帳戶，而不是客戶帳戶。

- 看得到機器、看不到收入：補 billing_read，不要打開 billing_write。

- 想改價或下架：那是 Host 機器頁或帶 machine_write 的另一把鑰匙的事，不是這把唯讀鑰匙。占用仍看 [報價與租約](https://iotahome.site/zh-TW/learn/vast-gpu-occupancy-and-offers)。

## 舉例

舉例，不是一次真實的權限實驗：只打開 machine_read 和 billing_read。機器列表返回編號 12001，四項為 1.20、0.30、0.10、0.05，當日合計 1.65 美元。若收入這一次被拒絕，合計變為未知，機器登記資訊仍可保留；不要改記成 0，也不要改用餘額 40 美元。

## 界限

連上密鑰只說明這次讀取被接受，不說明機器已通過 Vast 的自動驗證，也不說明租金一定會到帳。密鑰不要發到公開場合。Agent 不能用這把鑰匙開關 Vast 租約；它只操作 Mac 上的 Train at Home。當機分析不另收費。

## 常見問題

### API 密鑰可以貼在 Machine ID 那一欄嗎？

不能。Machine ID 是機器編號。密鑰只放在 Vast 專案的帳戶連接裡，由服務端用來讀取你的機器和收入。不要把密鑰寫進公開備註、機器名稱或這篇指南的評論裡。

### 權限頁沒有寫出 machine-earnings 這個路徑，我該勾哪幾項？

按權限頁的動作名稱來勾：查看機器用 machine_read，查看收入用 billing_read 裡的 Show Earnings。頁面沒有把每個 URL 逐條寫死。若連上後仍看不到機器或收入，只補充這兩類讀取，不要順手打開 billing_write 或 machine_write。

### 密鑰可用，但當日合計是未知，機器是不是壞了？

不一定。未知只表示這台機器的四項沒有齊，或收入報告這次沒有返回。機器離線、未驗證、沒有租約，是機器頁上另一組事實。不要把未知改成 0，也不要用餘額代替。

## 資料來源與本站實現

- [Vast.ai API permissions](https://docs.vast.ai/api-reference/permissions)
- [Vast.ai hosting overview](https://docs.vast.ai/host/hosting-overview)