用途:Vast.ai 主机端(host/provider)命令行工具,命令名为小写 vastai,用于管理你自己在 Vast.ai 市场上托管的 GPU 机器,涵盖上架、定价、维护、自检、收益及市场行情。
主要能力: · 机器清单:vastai show machines、show machine <id>、self-test machine <id>、reports <id>、delete machine <id>。 · 上架与定价:vastai list machine <id> --price_gpu 0.30,可加 --price_inetu、--price_inetd、--price_disk、--price_min_bid、--discount_rate、--min_chunk、--end_date/--duration、--vol_size/--vol_price;vastai unlist machine <id>;vastai set min-bid <id> --price 0.10;set defjob / remove defjob 配置空闲默认任务。 · 维护:vastai schedule maint <id> --sdate <UNIX秒> --duration <小时> --maintenance_category {power|internet|disk|gpu|software|other};cancel maint、show maints。维护开始会终止在线租户。 · 清理与碎片整理:cleanup machine <id>(清理已终止实例的过期存储);defrag machines <id1> <id2>(位置参数,重排 GPU 分配,可能中断运行中实例;帮助里写 defragment,但只有 defrag 能执行)。 · 网络磁盘:show network-disks、add network-disk <machine_id> /mnt/disk1(后续附加用 -d/--disk_id);无 remove network-disk 子命令,需在控制台操作。 · 收益与账单:show earnings(起止日期用下划线 --start_date/--end_date)、show invoices-v1 --limit <N> --latest-first(必须传 --limit,否则即使 --raw 也会弹出翻页提示)、show deposit <id>;show invoices 已弃用。 · 市场指标:metrics gpu / gpu-trends / gpu-locations,需 machine_read 权限组,纯租户账号返回 401;这些用旗标而非查询表达式。 · 账号与密钥:show user、show api-keys、create api-key --name ... --permission_file ./perms.json(传文件路径,非内联 JSON)、delete api-key、reset api-key、show audit-logs、show ipaddrs。2FA:vastai tfa login --method-type {totp,sms,email} --code <CODE>,每 shell 一次。 · 团队:create-team --team-name "ops"、destroy team、show members、invite member --email ... --role ...、create team-role --permissions ./role.json 等。
使用方式:通过 pip install vastai 安装;在 https://console.vast.ai/manage-keys/ 创建 API 密钥后,用 vastai set api-key <KEY> 或 export VAST_API_KEY=<KEY> 配置;vastai show user 验证。密钥优先级:--api-key > $VAST_API_KEY > 已存密钥。解析输出时始终加 --raw。
限制与注意事项:vastai 只能来自 PATH 上的二进制,禁止 pip/pipx 重装或直接调用 REST API;上架、下架、改价、维护、defrag、cleanup 均影响在线租户或收益,执行前须与用户确认并复述命令;schedule maint 会在开始时驱逐在线租户;defrag 具破坏性且中断实例;self-test 应在列表前运行;价格变更仅对新租约生效;无 --explain 等未列明功能时以官方 --help 为准。部分平台、收费等信息暂未提供。