vastai-api

Vastai-Api スキル

GPU インスタンスの管理、マシン操作、AI/ML ワークフローの自動化に関する、Vast.ai API の包括的なサポートを提供します。このスキルでは、Vast.ai プラットフォームをプログラムから制御するための公式ドキュメントを利用できます。

このスキルを使用する場面

以下の作業を行う際に、このスキルを利用してください。

• GPU インスタンス管理：GPU インスタンスの作成、破棄、起動、停止、管理
• マシン操作：レンタル可能なマシンの一覧表示、料金の設定、メンテナンス時間の管理
• SSH と認証：SSH キー、API キー、インスタンスへの安全な接続の管理
• 請求とクレジット：請求書、収益、入金の確認、またはクレジットの移動
• ネットワークボリューム：ネットワークストレージボリュームの作成、一覧表示、管理
• サーバーレスエンドポイント：Vast.ai のサーバーレスワーカーグループとエンドポイントの操作
• データ転送：インスタンス間、またはクラウドサービスとのデータコピー
• アカウント管理：サブアカウント、環境変数、チームのロールの管理
• CLI 操作：vastai コマンドラインツールの使用
• API 統合：Vast.ai の REST API と連携するアプリケーションの構築

クイックリファレンス

インスタンスの作成と管理

新しい GPU インスタンスを作成する

# Create instance from an offer
vastai create instance <offer_id> \
  --image pytorch/pytorch:latest \
  --disk 50 \
  --ssh

アクティブなインスタンスを一覧表示する

# Show all instances
vastai show instances

# Show specific instance details
vastai show instance <instance_id>

インスタンスの状態を管理する

# Stop an instance (pause GPU billing, storage still charged)
vastai stop instance <instance_id>

# Start a stopped instance
vastai start instance <instance_id>

# Reboot instance without losing GPU priority
vastai reboot instance <instance_id>

# Destroy instance permanently (irreversible)
vastai destroy instance <instance_id>

SSH キーの管理

アカウントに SSH キーを追加する

# Add your public SSH key
vastai create ssh-key "ssh-rsa AAAAB3NzaC1yc2EA... user@host"

# List all SSH keys
vastai show ssh-keys

# Attach SSH key to specific instance
vastai attach ssh <instance_id> <ssh_key>

オファーの検索と絞り込み

GPU オファーを検索する

# Search with filters
vastai search offers \
  --gpu_name RTX_4090 \
  --num_gpus 2 \
  --disk_space 100

# Order by price
vastai search offers --order dph_total

環境変数（シークレット）

環境変数を管理する

# Create encrypted environment variable
vastai create env-var MY_API_KEY "secret_value_here"

# List all environment variables
vastai show env-vars

# Update existing variable
vastai update env-var MY_API_KEY "new_secret_value"

# Delete environment variable
vastai delete env-var MY_API_KEY

請求とクレジット

請求情報を確認する

# Show invoices
vastai show invoices

# Show earnings (for hosts)
vastai show earnings

# Show deposit for specific instance
vastai show deposit <instance_id>

# Transfer credits to another user
vastai transfer credit [email protected] 25.00

インスタンスログ

コンテナログを取得する

# Get last 100 lines of logs
vastai show logs <instance_id> --tail 100

# Filter logs with grep pattern
vastai show logs <instance_id> --filter "error"

# Get daemon system logs
vastai show logs <instance_id> --daemon-logs

データ転送操作

インスタンス間でコピーする

# Copy from one instance to another
vastai copy <src_id> <dst_id> /source/path /destination/path

# Cloud copy using rclone
vastai cloud copy <instance_id> remote:bucket/path /local/path

マシン管理（ホスト向け）

レンタル用のマシンを一覧表示する

# List machine with pricing
vastai list machine <machine_id> \
  --price_gpu 0.50 \
  --price_disk 0.10

# Unlist machine (stop renting)
vastai unlist machine <machine_id>

# Schedule maintenance window
vastai schedule maint <machine_id> \
  --sdate "2025-11-01T10:00:00" \
  --duration 3600

主な概念

インスタンスの種類

• オンデマンドインスタンス：作成して管理する、従量課金制の GPU インスタンス
• 中断可能インスタンス：ホストによって回収される場合がある、低価格のインスタンス
• 予約インスタンス：利用料金の割引（最大 40％）が適用される前払いインスタンス

料金モデル

• GPU 料金：インスタンスの実行中、時間単位で課金されます
• ストレージ料金：インスタンスの停止中もディスク容量に対して課金されます
• ネットワーク転送料金：アップロード／ダウンロードの帯域幅に対する料金です
• 割引：予約インスタンスの前払いで利用できます

インスタンスの状態

• starting：インスタンスを初期化しています
• running：インスタンスが稼働中で、課金対象です
• stopped：コンテナが停止しています（ストレージは引き続き課金対象です）
• exited：コンテナが終了したか、失敗しました
• rebooting：再起動中です
• recycling：新しいイメージから破棄して再作成しています

認証

• API キー：REST API を介したプログラムからのアクセスに使用します
• SSH キー：実行中のインスタンスへのセキュアシェル接続に使用します
• 環境変数：コンテナに注入される暗号化済みシークレットです

テンプレート

以下を含む、事前設定済みの構成です。

• Docker イメージの仕様
• 環境変数
• 起動時スクリプト
• リソース要件
• ポートマッピング

人気のテンプレートには、PyTorch、TensorFlow、Jupyter、ComfyUI、Stable Diffusion があります。

ネットワークボリューム

以下の用途に使用できる共有ネットワークストレージです。

• 複数のインスタンスへの接続
• インスタンスのライフサイクルから独立した永続化
• データセットやモデルの重みの保存
• 個別のスケーリング

サーバーレスアーキテクチャ

• エンドポイント：最上位のルーティングと構成
• ワーカーグループ：自動スケーリングする GPU インスタンスのプール
• テストワーカー：パフォーマンスプロファイリングを行うための試行フェーズ
• 目標稼働率：スケーリングの動作を制御します

リファレンスファイル

このスキルには、references/ に包括的なドキュメントが含まれています。

llms-full.md

カテゴリ別に整理された、すべてのエンドポイントを網羅する完全な API リファレンス：

• Accounts：API キー、SSH キー、ユーザー管理、サブアカウント
• Billing：請求書、収益、入金、クレジットの振替
• Instances：作成、管理、削除、再起動、ログ、SSH
• Machines：レンタル可能なマシンの一覧、料金、メンテナンス、デフォルトジョブ
• Network Volumes：共有ストレージの作成、一覧表示、管理
• Search：オファーの検索、ベンチマーク、GPU の利用可能状況による絞り込み
• Serverless：エンドポイント、ワーカーグループ、自動スケーリングの設定

各エンドポイントには以下が含まれます：

• HTTP メソッドとパス
• 詳細な説明
• CLI の使用例
• パラメーターの仕様
• ソースドキュメントへのリンク

llms-txt.md

以下の内容を扱う、要点を絞ったドキュメント：

• サーバーレスのワーカーグループのパラメーターと設定
• エンドポイント管理
• セットアップ手順を含むクイックスタートガイド
• よくある質問と回答
• 検索性を高める Schema.org の構造化データ

llms.md

すべての API 操作を簡単な説明と CLI の使用例とともにカテゴリ別に整理した、厳選リストです。すばやく参照できます。

このスキルの使い方

初心者向け

まずはこちら：

1. llms-txt.md のクイックスタートセクションを確認します
2. 4 ステップのセットアップ手順（登録、クレジットの追加、SSH の準備、インスタンスの作成）に従います
3. 上記のクイックリファレンスにある基本的な例を試します
4. 主要な概念でインスタンスの状態と料金モデルについて学びます

最初に試すタスク：

• 認証用の API キーを作成する
• SSH 公開鍵をアカウントに追加する
• 利用可能な GPU オファーを検索する
• テンプレートを使用して最初のインスタンスを作成する

中級者向け

重点項目：

• シークレット用の環境変数の管理
• インスタンスとクラウドストレージ間のデータ転送
• インスタンスのライフサイクル管理（一時停止／開始／再起動と削除の使い分け）
• リザーブドインスタンスによる請求の最適化
• ワークフローに合わせたカスタムテンプレートの作成

便利なパターン：

• インスタンスの中断を避けるため、自動課金を設定する
• API キーや認証情報に環境変数を使用する
• copy コマンドで定期的なバックアップをスケジュールする
• 請求書および収益エンドポイントでコストを監視する

上級者向け

高度なトピック：

• サーバーレスのエンドポイントとワーカーグループの設定
• マシンのホスティングとマーケットプレイスの最適化
• 共有データセット向けのネットワークボリュームアーキテクチャ
• チームおよびサブアカウントの管理
• カスタムアプリケーションでの API 統合
• 自動スケーリング戦略

パワーユーザー向けのヒント：

• 検索でフィルター演算子（eq、neq、gt、lt、gte、lte、in、nin）を使用する
• launch_args を活用してインスタンスを高度にカスタマイズする
• logs API で監視とアラートを実装する
• 入札価格を調整してコストを最適化する
• クラウドコピーを使用して、データパイプラインのワークフローを構築する

ナビゲーションのヒント

API エンドポイントを探す：

• すべてのエンドポイントの詳細は llms-full.md に記載されています
• カテゴリ（アカウント、請求、インスタンス、マシンなど）別に整理されています
• それぞれに CLI の使用例が含まれています

すばやく参照する：

• llms.md にすべての操作を簡潔にまとめたリストがあります
• ブラウザーの検索（Ctrl+F）を使用して、特定のコマンドを探します
• コマンド構文は「CLI Usage:」セクションを確認します

概念を理解する：

• 用語については上記の主要な概念を参照します
• 利用を始めるには llms-txt.md のクイックスタートを参照します
• サーバーレスの設定については、ワーカーグループのパラメーターセクションを参照します

よくあるワークフロー

新しい開発環境のセットアップ

1. 適切な権限を持つ API キーを作成します
2. アクセス用の SSH キーをアカウントに追加します
3. シークレット用の環境変数を作成します
4. 要件に合う GPU オファーを検索します
5. テンプレートからインスタンスを作成します
6. SSH で接続し、セットアップを確認します

長時間実行するトレーニングジョブの管理

1. 十分なディスク容量を持つインスタンスを作成します
2. 中断を防ぐため、自動課金を設定します
3. 割引を受けるため、前払いでリザーブドインスタンスを利用します
4. logs エンドポイントで監視します
5. モデルのチェックポイントをクラウドストレージにコピーします
6. 一時停止するときは、コストを節約するため削除せずに停止します

利益を得るためのマシンのホスティング

1. list コマンドでマシンの価格を設定します
2. 最低入札額のしきい値を定義します
3. バックグラウンド作業用のデフォルトジョブを設定します
4. 必要に応じてメンテナンス時間をスケジュールします
5. 収益を監視し、期限切れの契約を整理します
6. 市場の状況に応じて価格を調整します

ベストプラクティス

コスト管理

• 破棄と停止：短時間の休止には停止、長期間の休止には破棄を使用します
• ディスク容量：後から変更できないため、慎重に選択します
• リザーブドインスタンス：長時間実行する作業では、前払いして40％の割引を受けます
• 自動請求：中断を防ぐため、しきい値を1日の支出額より高く設定します
• 残高不足の通知：バックアップとしてメール通知を有効にします

セキュリティ

• API キー：権限の範囲を設定し、定期的にローテーションします
• SSH キー：用途ごとに異なるキーを使用します
• 環境変数：シークレットは暗号化された環境変数として保存します
• サブアカウント：アクセスを制限したチームメンバー用に使用します

パフォーマンス

• テンプレートのキャッシュ：事前にプルしたイメージを使うと、起動が大幅に速くなります（数分ではなく数秒）
• ネットワークボリューム：インスタンス間で共有する大規模なデータセットに使用します
• 入札価格：入札額を高くすると、より高性能なハードウェアを利用しやすくなります
• テストワーカー：スケールアップする前に、サーバーレスで検証します

信頼性

• ログ：定期的に監視してエラーを確認します
• ヘルスチェック：アプリケーションに実装します
• データのバックアップ：重要なデータは定期的にインスタンス外へコピーします
• 冗長性：重要な作業では、複数のインスタンスで実行します

リソース

公式リンク

• コンソール：https://cloud.vast.ai/
• API ドキュメント：https://docs.vast.ai/
• Postman コレクション：https://www.postman.com/vast33/vast-ai-public-api-docs
• テンプレート：https://cloud.vast.ai/templates/
• 検索：https://cloud.vast.ai/create/

サポート

• 最低入金額：$5
• 残高はダッシュボードの右上に表示されます
• レンタルまたはチーム作成にはメール認証が必要です
• 自動請求を設定すると、中断を防げます

注意事項

• このスキルは、Vast.ai の公式ドキュメントから自動生成されました
• 参照ファイルには、元のドキュメントの構造と例が保持されています
• CLI の例では、vastai コマンドラインツールを使用します
• API エンドポイントは REST API と CLI の両方から利用できます
• 価格はすべて USD で、コンピューティングとストレージについて時間単位で請求されます

更新

更新されたドキュメントでこのスキルを更新するには：

1. 同じ設定でスクレイパーを再実行します
2. 最新の API 情報を使用してスキルが再構築されます
3. API バージョンの変更や非推奨のエンドポイントがないか確認します