Skill: chsengni/xiangongyun-api (version 1.0.1)

--- name: xiangongyun-api description: 仙宫云GPU云服务平台API集成工具，支持实例管理、私有镜像管理、账号管理等全量操作；当用户需要查询或管理仙宫云GPU实例、操作私有镜像、查询账户余额或充值时使用 dependency: python: - requests>=2.28.0 --- # 仙宫云API技能 ## 任务目标 - 本技能用于：集成仙宫云开放平台API，实现对GPU云服务实例的完整生命周期管理 - 能力包含：实例管理（创建/启停/销毁）、私有镜像管理、账户信息查询与充值 - 触发条件：用户需要管理仙宫云GPU实例、操作镜像、查询账户信息时 ## 前置准备 依赖说明：脚本依赖 requests 库 ``` requests>=2.28.0 ``` - 依赖说明：脚本使用Python标准库和requests包，无需额外安装依赖 - 凭证配置：需要仙宫云API访问令牌，已在技能配置中完成授权 ## 操作步骤 ### 一、实例管理 #### 1. 查询实例 - **获取实例列表**：调用 `scripts/xiangongyun_api.py --action list_instances` - **获取单个实例详情**：调用 `scripts/xiangongyun_api.py --action get_instance --instance-id <实例ID>` - **获取实例储存的镜像**：调用 `scripts/xiangongyun_api.py --action list_instance_images --instance-id <实例ID>` #### 2. 部署实例 - **部署新实例**：调用 `scripts/xiangongyun_api.py --action deploy_instance --name <实例名称> --gpu-count <GPU数量> --image <镜像名称> [--data-center <数据中心>] [--ssh-key <SSH密钥>] [--password <密码>]` - 参数说明详见 [references/api_reference.md](references/api_reference.md) #### 3. 实例生命周期操作 - **开机**：`--action boot_instance --instance-id <实例ID>` - **关机保留GPU**：`--action shutdown_instance --instance-id <实例ID>` - **关机释放GPU**：`--action shutdown_release_gpu --instance-id <实例ID>` - **关机并销毁**：`--action shutdown_destroy --instance-id <实例ID>` - **销毁实例**：`--action destroy_instance --instance-id <实例ID>` #### 4. 镜像保存 - **储存镜像**：`--action save_image --instance-id <实例ID> --image-name <镜像名称>` - **储存镜像并销毁**：`--action save_image_destroy --instance-id <实例ID> --image-name <镜像名称>` ### 二、私有镜像管理 - **获取镜像列表**：`--action list_images` - **获取镜像详情**：`--action get_image --image-id <镜像ID>` - **销毁镜像**：`--action destroy_image --image-id <镜像ID>` ### 三、账号管理 - **获取用户信息**：`--action get_user_info` - **获取账户余额**：`--action get_balance` - **创建充值订单**：`--action create_recharge_order --amount <金额> --payment <alipay|wechat>` - **查询充值订单**：`--action query_recharge_order --trade-no <订单号>` ## 资源索引 - API脚本：见 [scripts/xiangongyun_api.py](scripts/xiangongyun_api.py)（封装所有API调用） - API参考：见 [references/api_reference.md](references/api_reference.md)（完整的接口参数与响应说明） ## 注意事项 - 所有异步操作（部署、销毁、启停等）请求成功后会立即返回，实际执行状态需通过查询实例信息确认 - 关机释放GPU后，系统盘按已使用空间计费（¥0.00003/GB/小时） - 充值订单的微信支付链接需转换为二维码扫码使用 - 公共镜像列表、实例状态说明详见API参考文档 ### 示例1：查询账户信息 ```bash # 查看用户信息 python scripts/xiangongyun_api.py --action get_user_info # 查看账户余额 python scripts/xiangongyun_api.py --action get_balance ``` ### 示例2：管理GPU实例 ```bash # 获取所有实例列表 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：管理私有镜像 ```bash # 保存实例为镜像 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：账户充值 ```bash # 创建充值订单（支付宝） 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" ```


Security scan verdicts — ClawScan: suspicious | static analysis: clean | VirusTotal: clean | SkillSpector: suspicious (MEDIUM)