ProsperPower
指南CLI & SDKAPI主机
Overview

API Hello World

原始 REST API 面向进阶用户，提供最大灵活性、但需要你自己处理集成的方方面面。多数用户使用 CLI 或 SDK 体验会更好——它们已经帮你封装好这些细节。如果不确定是否需要直接调 API，建议先从 CLI 或 SDK 开始。

ProsperPower REST API 让你以编程方式管理 GPU 实例，适合自动化、CI/CD 流水线，或在平台之上构建你自己的工具。

本教程走完一次完整的实例生命周期：认证 → 搜索 GPU → 拉起 → 等待启动 → 连接 → 清理。读完你就掌握了无需打开控制台、纯用 API 管理实例的核心调用。

前置条件

  • 一个有余额的 ProsperPower 账户（跑完本教程约 $0.01–0.05，取决于实例运行时长）
  • 已安装 curl

1. 获取 API 密钥

在控制台的密钥页点击「新建」生成一个 API 密钥。复制它——调用时会用到，且只显示一次。

把它导出为环境变量：

bash
export PP_API_KEY="你的密钥"

2. 验证认证

确认密钥可用。下面的调用应返回一个（可能为空的）实例列表：

bash
curl -H "Authorization: Bearer $PP_API_KEY" \
  https://api.prosperpower.cloud/v1/instances

3. 搜索 GPU

按型号与数量筛选当前可用的报价，拿到一个 offer_id：

bash
curl -H "Authorization: Bearer $PP_API_KEY" \
  "https://api.prosperpower.cloud/v1/offers?gpu=RTX_4090&num_gpus=1"
json
{
  "offers": [
    { "id": 8842, "gpu": "RTX 4090", "vram": 24, "price_per_hour": 0.19 }
  ]
}

4. 创建实例

用上一步的 offer_id 拉起实例，指定镜像与磁盘：

bash
curl -X POST https://api.prosperpower.cloud/v1/instances \
  -H "Authorization: Bearer $PP_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "offer_id": 8842, "image": "ppcloud/pytorch:latest", "disk": 50 }'

5. 等待就绪

轮询实例状态，直到 status 变为 running：

bash
curl -H "Authorization: Bearer $PP_API_KEY" \
  https://api.prosperpower.cloud/v1/instances/12847

6. 连接实例

实例就绪后，用返回的 SSH 信息连接：

bash
ssh root@12847.prosperpower.cloud -p 22

7. 清理

用完记得销毁实例——按秒计费，销毁即停止计费。
bash
curl -X DELETE https://api.prosperpower.cloud/v1/instances/12847 \
  -H "Authorization: Bearer $PP_API_KEY"

下一步