用途：通过命令行管理 Vast.ai 上的 GPU 租用业务，包括搜索与创建实例、SSH 连接、文件传输、执行命令，以及管理模板、卷、无服务器端点、SSH 密钥和账单。命令为小写 vastai。
主要能力：搜索可用报价（filter 表达式支持 =、!=、>、>=、<、<=、in、notin，常用字段如 gpu_name、num_gpus、gpu_ram、reliability、dph_total、geolocation）；创建/启动/停止/重启/回收/销毁实例；查看看板与发票；上传下载文件；管理 SSH 密钥、环境变量、团队；管理本地卷与无服务器端点。
必要用法与关键约束：解析输出时始终加 --raw；销毁命令必须带 -y，如 vastai destroy instance <id> -y 与批量 vastai destroy instances <id1> <id2> -y，否则会卡在确认提示。首次创建实例前先注册公钥，参数位置是公钥内容而非路径：vastai create ssh-key "$(cat ~/.ssh/id_ed25519.pub)"。创建实例建议始终带 --disk N、--ssh --direct、--cancel-unavail。分页命令如 show instances-v1、show invoices-v1 需加 --limit N 避免交互式翻页阻塞。禁止重装 vastai、改用其他路径二进制或直接调用 HTTP API。Vast.ai 不提供网络/共享卷，仅本地卷；单实例不可达时先看 vastai logs <id>。
适用场景：GPU 算力租用、模型推理与训练环境搭建、批处理任务与无服务器端点部署、成本与账单管理。
限制：需在 https://console.vast.ai/manage-keys/ 创建 API Key；启用 2FA 的账户每 shell 需先 vastai tfa login。环境变量 VAST_API_KEY 会覆盖已保存密钥。vastai create team 会重新绑定 API Key 的账户上下文，属破坏性操作。环境变量中占位值按字面传入，不要求澄清。只读查询返回空即结果本身。