# Vast.ai 监控该用哪种 API 密钥，密钥填在哪里？

密钥放在账户连接里，不要填进 Machine ID。只读监控需要能查看机器和收入的权限。转账和上下架属于写入权限，不应配给这把钥匙。报告被拒绝时合计保持未知。

- Canonical: https://iotahome.site/zh/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/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/learn/vast-host-revenue-vs-balance)。

## 接下来怎么处理

- 看不到机器：补 machine_read，确认这把钥匙属于 Host 账户，而不是客户账户。

- 看得到机器、看不到收入：补 billing_read，不要打开 billing_write。

- 想改价或下架：那是 Host 机器页或带 machine_write 的另一把钥匙的事，不是这把只读钥匙。占用仍看 [报价与租约](https://iotahome.site/zh/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)