1. 产品文档
智星云开放接口
  • OpenAPI v2
    • 开始使用
    • 更新日志
    • 常见问题Q&A
    • 产品文档
      • 关于计费
      • 关于实例
      • 关于租用
      • 实例访问
      • 实例状态
      • 实例费用
    • 接入文档
      • 接口约定
      • 接口签名
      • 接口顺序
      • 参考代码（Golang版）
      • 参考代码（Python3版）
      • 参考代码（Java版）
      • 签名调试工具
    • 1.0 账号模块
      • 1.1 获取apikey信息
      • 1.2 获取主账户信息
    • 2.0 算力市场（租用市场）
      • 如何接入CPU和云主机实例租用
      • 旧接口如何迁移至按实例规格租用
      • 2.1 算力列表展示页
        • 获取云主机租用选项
        • 获取基础配置项
        • 获取价格信息
        • 获取实例规格列表（CPU租用和GPU租用均适用）
      • 2.2 租用确认页
        • 查询GPU相关信息
        • 查询CPU内存规格信息
        • 查询镜像详细信息
        • 创建云主机询价
        • 查询云主机库存调度状态
        • 创建云主机
    • 3.0 自主实例
      • 3.1 实例信息
        • 获取实例状态统计
        • 获取自主实例列表
        • 获取自主实例详情
        • 获取web端访问vnc和ssh的链接
        • 获取windows远程访问rdp文件
        • 获取屏幕截图（截屏）
      • 3.2 实例费用
        • 获取自主实例费用汇总
        • 获取自主实例费用明细
      • 3.3 变更实例
        • 修改实例到期处理模式
        • 修改实例访问密码（改密码）
      • 3.4 实例续费&退费
        • 手动续费实例询价
        • 手动续费实例
        • 设置实例自动续费
        • 实例启动错误，手动退费
        • 提前退租询价
        • 提前退租(退款至算力券账户)
      • 3.5 实例升级&扩容
        • 旧接口（待废弃）
          • 查询资源池剩余CPU
          • 添加CPU
          • 查询资源池剩余内存
          • 添加内存
        • 升级实例规格/CPU/内存
          • 获取升级规格选项
          • 升级规格询价
          • 升级规格
        • 修改实例带宽询价
        • 修改实例带宽
        • 查询资源池剩余磁盘
        • 添加磁盘询价
        • 添加磁盘
      • 3.6 实例迁移
        • 获取迁移条件（迁移检查）
        • 一键迁移实例
      • 3.7 实例捞回
        • 捞回条件检查并询价
        • 捞回实例
      • 3.8 重置系统
        • 获取本地可用镜像
        • 重置系统
      • 3.9 重启实例
        • 从保留磁盘创建实例（会将磁盘重启为新实例）
        • 从保留磁盘创建实例询价
        • 重启实例(将实例关机&开机)
        • 启动实例(关机状态下开机)
      • 3.10 其他
        • 释放保留的磁盘
        • 修改实例备注
    • 4.0 自定义镜像
      • 4.1 制作镜像-准备过程
        • 获取创建镜像可用的实例列表
        • 挂起实例
        • 恢复挂起实例
      • 4.2 创建镜像
        • 创建自定义镜像-询价
        • 从实例创建自定义镜像
      • 4.3 自定义镜像列表
        • 获取用户自定义镜像列表
        • 更新镜像信息
        • 获取引用该镜像的实例列表
        • 获取镜像扣费明细
      • 4.4 镜像续订
        • 镜像续费询价
        • 镜像续费
      • 4.5 提前退订
        • 镜像提前退租退款询价
        • 镜像提前退租退款并删除
      • 4.6 创建失败
        • 镜像创建失败退款
        • 镜像创建失败重试
      • 获取镜像详情
    • 5.0 账单模块
      • 获取充值订单列表
      • 获取余额变更明细
    • 6.0 共享盘（AI模型库）
      • 共享盘（AI模型库）接口接入参考
      • 是否有新共享盘
      • 获取共享盘列表
      • 获取共享盘详情
      • 挂载共享盘询价
      • 挂载共享盘
      • 卸载共享盘询价（退费）
      • 卸载共享盘
    • 其他模块
      • 合同实例（仅获取）
        • 获取合同实例列表
        • 获取合同实例详情
        • 获取合同实例费用明细
      • 获取子账号列表
  1. 产品文档

关于实例

功能一览#

支持的功能列表：
租用
退租
续租
自动续租
资源管理：
重启实例
关机后重启（KVM）
重置系统
实例迁移：将实例从当前宿主机迁移到另一台宿主机
实例救援：实例启动异常时，尝试修复恢复
资源升级：
可增加内存配置，不可降配
可增加CPU配置，不可降配
可添加数据盘，不可删除
系统盘无法更改大小
数据盘可以添加最多16块
支持按规格升级CPU/内存配置
访问开放：
可通过外部ssh登录；可通过web端ssh登录
可通过vnc登录
可通过rdp登录
可通过 API 获取 VNC/SSH 链接 (get_vnc_and_ssh)
可通过 API 下载 RDP 文件 (get_rdp_file)
可通过 API 获取实例截图 (get_screenshot)
无独立ip，有10个端口

关于实例费用字段#

实例详情接口 有如下字段：
Total_cost：实例基础费用（包含初始GPU+CPU+内存、添加CPU、添加内存，续费等）
BandwidthCost：带宽费用：收费带宽大小 × 带宽单价 × 小时时长
AddDiskCost：添加磁盘的费用 × 磁盘单价 × 此刻到实例到期的小时时长
KeeppedDiskCost：保留磁盘费用：（系统盘大小+数据盘大小）× 磁盘单价 × 小时时长
ReturnMoney：已退费的金额
最终实例已产生的总费用 = Total_cost + BandwidthCost + AddDiskCost + KeeppedDiskCost

关于实例时间字段#

实例详情接口 有如下字段：
Ctime：创建时间
Due_time：到期时间
End_time：实际结束时间
DiskReleaseTime：磁盘释放时间
LastRestartTime：上一次重启时间（可为空）
LastAbnoramlTime：上一次发生异常时间（可为空）
AbornormalTime：异常时长（秒）

关于实例资源相关字段#

实例详情接口 有如下字段：
Cpu_num、Memory、Gpu_num：为初始状态下的资源大小；其中系统盘大小字段没有，固定为（Linux 200GB，Windows 350GB）
AddCpu、AddMemory、AddDisk：为已经添加的资源大小
AddingCpu、AddingMemory、AddingDisk：为正在添加的资源大小（状态未完成的话不扣费）
Bandwidth、MaxBandwidth、NoFreeBandwidth：为带宽相关，分别是当前带宽大小、可设置的最大带宽、收费带宽大小；每小时扣费

迁移功能说明#

实例迁移用于将当前实例从原宿主机迁移到另一台宿主机，适用于宿主机故障或资源紧张场景：
1.
获取迁移条件：/instance/get_migration_conditions — 返回可迁移到的目标主机列表
2.
执行迁移：/instance/migrate_instance — 传入 target_host 执行迁移
迁移过程分两阶段：①停止当前实例并保留磁盘 ②在新宿主机从磁盘启动新实例

救援功能说明#

救援功能用于实例启动异常（Status=-1 且 IsAbnormal==1）时的恢复尝试：
1.
查询救援价格：/instance/get_salvage_instance_conditions_and_query_price
2.
执行救援：/instance/salvage_instance
救援会在当前宿主机上尝试重新启动实例。
修改于 2026-07-13 08:25:11
上一页
关于计费
下一页
关于租用
Built with