CLI & SDK

Python SDK

SDK 适合把算力编排逻辑写进你的应用：几行代码完成搜索、拉起、查询与调用。

安装

bash

pip install ppcloud

搜索并拉起实例

python

from ppcloud import Client

client = Client()  # 读取 PP_API_KEY 环境变量

offers = client.search_offers(gpu="RTX 4090", num_gpus=1)
best = offers[0]

instance = client.create_instance(
    offer_id=best.id,
    image="ppcloud/pytorch:latest",
    disk=50,
)
print("实例已创建:", instance.id)

查询与销毁

python

info = client.get_instance(instance.id)
print(info.status, info.cost_per_hour)

# 用完即销毁，停止计费
client.destroy_instance(instance.id)

调用推理（OpenAI 兼容）

python

from openai import OpenAI

oai = OpenAI(base_url=instance.endpoint + "/v1", api_key="PP")
resp = oai.chat.completions.create(
    model="qwen36-35b",
    messages=[{"role": "user", "content": "你好"}],
)
print(resp.choices[0].message.content)