# Vast.aiモニターにはどのAPIキーを使い、どこに入れますか？

キーはアカウント接続に入れ、Machine ID欄には入れません。読取専用モニターにはマシンと収入を見る権限が要ります。送金や掲載の変更は書き込み権限なので、このキーには付けません。報告が拒否されると合計は不明のままです。

- Canonical: https://iotahome.site/ja/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マシンページからコピーします。書き込み権限は空のままにします。

## キー権限とモニターに要るか

| 権限カテゴリ | Vastが書いているできること | このモニターのキーに付けるか |
| --- | --- | --- |
| machine_read | マシンと報告の閲覧 | 要る。無いとマシン一覧が見えない |
| billing_read | インボイスと収入の閲覧 | 要る。収入はこのカテゴリのShow Earnings |
| billing_write | クレジットの移動 | 付けない。読取ではない |
| machine_write | 掲載、非掲載、保守、クリーンアップ | 付けない。モニターはマシンを代わりに操作しない |
| instance_read / instance_write | 顧客インスタンスの閲覧や作成 | 顧客用キーをHost用キーの代わりにしない |

モニターに要るのはHost側の読取専用キーで、[Vast.ai モニター](https://iotahome.site/ja/projects/vast) のアカウント接続に置きます。Machine ID欄が受け取るのはマシン番号だけです。顧客インスタンスを起動するキーや、クレジットを移し、掲載や非掲載ができるキーは、この読取には向きません。

## 権限ページの読み方

Vastはカテゴリで権限を渡します。machine_readはマシンと報告の閲覧です。billing_readはインボイスと収入で、Show Earningsを含みます。billing_writeはクレジットの移動です。machine_writeは掲載、非掲載、保守、クリーンアップです。instance_readとinstance_writeは顧客インスタンスであり、Hostのマシン一覧ではありません。

権限ページが書いているのは動作名です。すべてのURLを一行ずつは書いていません。期待したパスが無いからといって、送金や掲載変更を有効にしません。

## 接続したあと確認すること

- マシン一覧にMachine IDが見え、GPU名がマシンページと一致します。

- 当日合計は4行が揃ったときだけ出ます。1行が無い、または報告が戻らないときは合計は不明です。

- 口座残高はこのマシンへコピーされません。[収入と残高](https://iotahome.site/ja/learn/vast-host-revenue-vs-balance)を見ます。

## 次にすること

- マシンが見えない: machine_readを足し、キーが顧客アカウントではなくHostアカウントのものか確認します。

- マシンは見えて収入が無い: billing_readを足します。billing_writeはオンにしません。

- 価格変更や非掲載は、Hostマシンページか、machine_writeを持つ別のキーの仕事です。この読取専用キーでは行いません。占有は [オファーと契約](https://iotahome.site/ja/learn/vast-gpu-occupancy-and-offers) にあります。

## 例示

例示であり、実際の権限試験ではありません。machine_readとbilling_readだけを有効にします。マシン一覧が番号12001を返し、1.20、0.30、0.10、0.05の合計は1.65 USDです。今回収入が拒否されると合計は不明になり、マシン記録は残り得ます。0に書き換えたり、40 USDの残高で置き換えたりしません。

## 限界

キーを接続できたことは、今回の読取が受け付けられたという意味です。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 はオンにしません。

### キーは使えるのに当日合計が不明です。マシンの故障ですか？

必ずしも故障ではありません。不明は、このマシンの4行が揃っていないか、今回の収入報告が戻ってこなかったことを意味します。オフライン、未検証、契約なしはマシンページ上の別の事実です。不明を0に書き換えたり、残高で置き換えたりしないでください。

## 情報源と実装

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