仙宫云API技能

---

name: xiangongyun-api

description: 仙宫云GPU云服务平台API集成工具，支持实例管理、私有镜像管理、账号管理等全量操作；当用户需要查询或管理仙宫云GPU实例、操作私有镜像、查询账户余额或充值时使用

dependency:

python:

- requests>=2.28.0

---

# 仙宫云API技能

任务目标

前置准备

依赖说明：脚本依赖 requests 库

```

requests>=2.28.0

```

操作步骤

一、实例管理

#### 1. 查询实例

#### 2. 部署实例

#### 3. 实例生命周期操作

#### 4. 镜像保存

二、私有镜像管理

三、账号管理

资源索引

注意事项

示例1：查询账户信息

# 查看用户信息
python scripts/xiangongyun_api.py --action get_user_info

# 查看账户余额
python scripts/xiangongyun_api.py --action get_balance

示例2：管理GPU实例

# 获取所有实例列表
python scripts/xiangongyun_api.py --action list_instances

# 部署新实例（使用PyTorch镜像，2块GPU）
python scripts/xiangongyun_api.py --action deploy_instance --name "my-training" --gpu-count 2 --image "PyTorch 2.0.0"

# 查看实例详情
python scripts/xiangongyun_api.py --action get_instance --instance-id "abc123"

# 关机释放GPU（节省费用）
python scripts/xiangongyun_api.py --action shutdown_release_gpu --instance-id "abc123"

# 开机继续使用
python scripts/xiangongyun_api.py --action boot_instance --instance-id "abc123"

示例3：管理私有镜像

# 保存实例为镜像
python scripts/xiangongyun_api.py --action save_image --instance-id "abc123" --image-name "my-custom-image"

# 查看所有私有镜像
python scripts/xiangongyun_api.py --action list_images

# 删除镜像
python scripts/xiangongyun_api.py --action destroy_image --image-id "img456"

示例4：账户充值

# 创建充值订单（支付宝）
python scripts/xiangongyun_api.py --action create_recharge_order --amount 100 --payment alipay

# 查询订单状态
python scripts/xiangongyun_api.py --action query_recharge_order --trade-no "ORDER123456"