CLI & SDK

命令行工具（CLI)

CLI 让你在终端里搜索报价、拉起与管理实例。它与 Python SDK 一起随 ppcloud 安装。

安装与登录

bash

pip install ppcloud
export PP_API_KEY="你的密钥"

搜索报价

按型号、显存、数量筛选当前可用的 GPU：

terminal

ppcloud search offers --gpu "H100_SXM" --num-gpus 8
# ID     CUDA  Num  Model      VRAM   $/hr
# 8842   12.4  8    H100_SXM   80 GB  1.45
# 9103   12.4  8    H100_SXM   80 GB  1.52

创建实例

terminal

ppcloud create instance 8842 \
  --image ppcloud/vllm:latest \
  --disk 100

管理实例

terminal

ppcloud list instances            # 查看运行中的实例
ppcloud show instance 12847       # 查看详情与费用
ppcloud stop instance 12847       # 停止（保留磁盘）
ppcloud destroy instance 12847    # 销毁（停止计费）

JSON 输出

所有命令都支持 --json，便于脚本与自动化解析。

bash

ppcloud list instances --json | jq '.[] | .id'