gogpu 0.1.0__tar.gz

gogpu-0.1.0/.gitignore

@@ -0,0 +1,16 @@
+gogpu.egg-info/
+dist/
+build/
+.venv/
+venv/
+__pycache__/
+*.py[cod]
+.pytest_cache/
+.ruff_cache/
+.mypy_cache/
+*.egg
+.DS_Store
+swagger/*.txt
+swagger/_*.py
+swagger/swagger.*
+getselfinfo.json

gogpu-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 GoGPU
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

gogpu-0.1.0/PKG-INFO

@@ -0,0 +1,93 @@
+Metadata-Version: 2.5
+Name: gogpu
+Version: 0.1.0
+Summary: Python SDK for GoGPU / 捷智算 cloud GPU instances (create, start, stop, reboot, delete).
+Project-URL: Homepage, https://github.com/gogpu/gogpu-sdk
+Project-URL: Documentation, https://github.com/gogpu/gogpu-sdk
+Author: GoGPU
+License: MIT
+License-File: LICENSE
+Keywords: cloud,cvm,gogpu,gpu,sdk
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development :: Libraries
+Requires-Python: >=3.9
+Requires-Dist: httpx>=0.27
+Provides-Extra: dev
+Requires-Dist: pytest>=8.0; extra == 'dev'
+Requires-Dist: ruff>=0.6; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# gogpu
+
+云主机（CVM）Python SDK：选购、下单、开关机、运维。
+
+## Install
+
+```bash
+pip install gogpu
+# 开发中：
+# pip install -e .
+```
+
+## Quick start
+
+```python
+from gogpu import Client
+
+client = Client(
+    base_url="http://192.168.0.17:3001/api",
+    api_key="ak-xxxxxxxx",
+)
+
+# 1) 可购买资源（charging 必填语义，默认 hour）
+offers = client.instances.list_offers(page=1, page_size=20, charging="hour")
+good_id = offers["list"][0]["id"]
+
+# 2) 下单 + 余额支付
+result = client.instances.create_and_pay(
+    good_id=good_id,
+    charging="hour",
+    image_id=28,       # 来自 list_os_images / 控制台
+    image_type=3,      # 3=系统镜像
+    pay_type=1,
+)
+
+# 3) 已购实例生命周期
+vms = client.instances.list(page=1, page_size=10)
+vm_id = vms["list"][0]["id"]
+client.instances.start(vm_id)
+client.instances.stop(vm_id)
+client.instances.reboot(vm_id)
+client.instances.get_ssh_password(vm_id)
+```
+
+## 云主机方法一览
+
+| 类别 | 方法 |
+|---|---|
+| 选购 | `list_offers` `get_offer` `list_gpu_types` `list_regions` `list_os_images` `list_public_images` `list_usable_images` |
+| 订单 | `create` `pay` `create_and_pay` `renew` |
+| 实例 | `list` `get` `statistics` `list_instance_gpu_types` `list_cluster` |
+| 电源 | `start` `stop` `reboot` `delete` `reset_system` `convert_cardless` `stop_cardless` `convert_charging` |
+| 配置 | `edit` `change_password` `change_renew` `change_reserve_disk` `expand` `get_expand_amount` `get_refund_amount` `refund` |
+| 凭据 | `get_ssh_password` `get_vnc_password` `get_rdp_password` `get_jupyter_password` `get_vscode_password` `generate_key` `download_key` |
+| 运维 | `list_ports` `list_default_ports` `update_ports` `get_monitor` `take_screenshot` `create_image` `get_software_config` |
+
+常量见 `gogpu.resources.instances`（如 `STATUS_RUNNING`、`ORDER_TYPE_CVM`）。
+
+## Auth
+
+- `api_key` → 请求头 `x-api-key`
+- `token` → 请求头 `x-token`（JWT）
+
+## Response
+
+接口统一 `{code, data, msg}`。`code==0` 时方法返回 `data`，否则抛 `GoGPUAPIError`。

gogpu-0.1.0/README.md

@@ -0,0 +1,66 @@
+# gogpu
+
+云主机（CVM）Python SDK：选购、下单、开关机、运维。
+
+## Install
+
+```bash
+pip install gogpu
+# 开发中：
+# pip install -e .
+```
+
+## Quick start
+
+```python
+from gogpu import Client
+
+client = Client(
+    base_url="http://192.168.0.17:3001/api",
+    api_key="ak-xxxxxxxx",
+)
+
+# 1) 可购买资源（charging 必填语义，默认 hour）
+offers = client.instances.list_offers(page=1, page_size=20, charging="hour")
+good_id = offers["list"][0]["id"]
+
+# 2) 下单 + 余额支付
+result = client.instances.create_and_pay(
+    good_id=good_id,
+    charging="hour",
+    image_id=28,       # 来自 list_os_images / 控制台
+    image_type=3,      # 3=系统镜像
+    pay_type=1,
+)
+
+# 3) 已购实例生命周期
+vms = client.instances.list(page=1, page_size=10)
+vm_id = vms["list"][0]["id"]
+client.instances.start(vm_id)
+client.instances.stop(vm_id)
+client.instances.reboot(vm_id)
+client.instances.get_ssh_password(vm_id)
+```
+
+## 云主机方法一览
+
+| 类别 | 方法 |
+|---|---|
+| 选购 | `list_offers` `get_offer` `list_gpu_types` `list_regions` `list_os_images` `list_public_images` `list_usable_images` |
+| 订单 | `create` `pay` `create_and_pay` `renew` |
+| 实例 | `list` `get` `statistics` `list_instance_gpu_types` `list_cluster` |
+| 电源 | `start` `stop` `reboot` `delete` `reset_system` `convert_cardless` `stop_cardless` `convert_charging` |
+| 配置 | `edit` `change_password` `change_renew` `change_reserve_disk` `expand` `get_expand_amount` `get_refund_amount` `refund` |
+| 凭据 | `get_ssh_password` `get_vnc_password` `get_rdp_password` `get_jupyter_password` `get_vscode_password` `generate_key` `download_key` |
+| 运维 | `list_ports` `list_default_ports` `update_ports` `get_monitor` `take_screenshot` `create_image` `get_software_config` |
+
+常量见 `gogpu.resources.instances`（如 `STATUS_RUNNING`、`ORDER_TYPE_CVM`）。
+
+## Auth
+
+- `api_key` → 请求头 `x-api-key`
+- `token` → 请求头 `x-token`（JWT）
+
+## Response
+
+接口统一 `{code, data, msg}`。`code==0` 时方法返回 `data`，否则抛 `GoGPUAPIError`。

gogpu-0.1.0/pyproject.toml

@@ -0,0 +1,44 @@
+[build-system]
+requires = ["hatchling>=1.25"]
+build-backend = "hatchling.build"
+
+[project]
+name = "gogpu"
+version = "0.1.0"
+description = "Python SDK for GoGPU / 捷智算 cloud GPU instances (create, start, stop, reboot, delete)."
+readme = "README.md"
+requires-python = ">=3.9"
+license = { text = "MIT" }
+authors = [{ name = "GoGPU" }]
+keywords = ["gpu", "cloud", "cvm", "sdk", "gogpu"]
+classifiers = [
+  "Development Status :: 3 - Alpha",
+  "Intended Audience :: Developers",
+  "License :: OSI Approved :: MIT License",
+  "Programming Language :: Python :: 3",
+  "Programming Language :: Python :: 3.9",
+  "Programming Language :: Python :: 3.10",
+  "Programming Language :: Python :: 3.11",
+  "Programming Language :: Python :: 3.12",
+  "Programming Language :: Python :: 3.13",
+  "Topic :: Software Development :: Libraries",
+]
+dependencies = [
+  "httpx>=0.27",
+]
+
+[project.optional-dependencies]
+dev = ["pytest>=8.0", "ruff>=0.6"]
+
+[project.urls]
+Homepage = "https://github.com/gogpu/gogpu-sdk"
+Documentation = "https://github.com/gogpu/gogpu-sdk"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/gogpu"]
+
+[tool.hatch.build.targets.wheel.sources]
+"src/gogpu" = "gogpu"
+
+[tool.hatch.build.targets.sdist]
+include = ["src/gogpu", "README.md", "LICENSE", "pyproject.toml"]

gogpu-0.1.0/src/gogpu/__init__.py

@@ -0,0 +1,14 @@
+"""gogpu — Python SDK for GoGPU cloud GPU instances."""
+
+from gogpu._version import __version__
+from gogpu.client import Client
+from gogpu.exceptions import GoGPUAPIError, GoGPUError
+from gogpu.resources import instances as cvm
+
+__all__ = [
+    "Client",
+    "GoGPUAPIError",
+    "GoGPUError",
+    "cvm",
+    "__version__",
+]

gogpu-0.1.0/src/gogpu/_version.py

@@ -0,0 +1 @@
+__version__ = "0.1.0"

gogpu-0.1.0/src/gogpu/client.py

@@ -0,0 +1,130 @@
+from __future__ import annotations
+
+from typing import Any, Mapping, MutableMapping, Optional, Union
+
+import httpx
+
+from gogpu.exceptions import GoGPUAPIError
+from gogpu.resources.account import AccountResource
+from gogpu.resources.instances import InstancesResource
+
+
+class Client:
+    """GoGPU API client.
+
+    Parameters
+    ----------
+    base_url:
+        API root, e.g. ``http://host:3001/api`` or ``http://host:9021``.
+    api_key:
+        Account API key, sent as ``x-api-key``.
+    token:
+        Login JWT, sent as ``x-token``.
+    timeout:
+        Request timeout in seconds.
+    """
+
+    def __init__(
+        self,
+        base_url: str,
+        *,
+        api_key: Optional[str] = None,
+        token: Optional[str] = None,
+        timeout: float = 60.0,
+        transport: Optional[httpx.BaseTransport] = None,
+    ) -> None:
+        if not api_key and not token:
+            raise ValueError("Provide at least one of api_key or token")
+
+        self.base_url = base_url.rstrip("/")
+        self.api_key = api_key
+        self.token = token
+        self.timeout = timeout
+
+        headers: MutableMapping[str, str] = {
+            "Accept": "application/json",
+            "Content-Type": "application/json",
+        }
+        if api_key:
+            headers["x-api-key"] = api_key
+        if token:
+            headers["x-token"] = token
+
+        self._http = httpx.Client(
+            base_url=self.base_url,
+            headers=headers,
+            timeout=timeout,
+            transport=transport,
+        )
+
+        self.instances = InstancesResource(self)
+        self.account = AccountResource(self)
+
+    def close(self) -> None:
+        self._http.close()
+
+    def __enter__(self) -> "Client":
+        return self
+
+    def __exit__(self, *args: object) -> None:
+        self.close()
+
+    def request(
+        self,
+        path: str,
+        body: Optional[Mapping[str, Any]] = None,
+        *,
+        raw: bool = False,
+    ) -> Any:
+        """POST JSON to ``path`` and unwrap ``{code, data, msg}``.
+
+        Returns ``data`` when ``code == 0``. Set ``raw=True`` to get the full
+        response dict instead.
+        """
+        url_path = path if path.startswith("/") else f"/{path}"
+        try:
+            resp = self._http.post(url_path, json=dict(body or {}))
+        except httpx.HTTPError as exc:
+            raise GoGPUAPIError(f"HTTP request failed: {exc}", path=url_path) from exc
+
+        try:
+            payload: Union[dict[str, Any], Any] = resp.json()
+        except ValueError as exc:
+            raise GoGPUAPIError(
+                f"Invalid JSON response: {resp.text[:200]}",
+                path=url_path,
+                status_code=resp.status_code,
+            ) from exc
+
+        if resp.status_code >= 400:
+            msg = (
+                payload.get("msg")
+                if isinstance(payload, dict)
+                else None
+            ) or resp.reason_phrase
+            raise GoGPUAPIError(
+                str(msg),
+                code=payload.get("code") if isinstance(payload, dict) else None,
+                data=payload.get("data") if isinstance(payload, dict) else payload,
+                path=url_path,
+                status_code=resp.status_code,
+            )
+
+        if not isinstance(payload, dict) or "code" not in payload:
+            if raw:
+                return payload
+            return payload
+
+        code = payload.get("code")
+        if code != 0:
+            raise GoGPUAPIError(
+                str(payload.get("msg") or "API error"),
+                code=code,
+                data=payload.get("data"),
+                path=url_path,
+                status_code=resp.status_code,
+            )
+
+        if raw:
+            return payload
+        return payload.get("data")

gogpu-0.1.0/src/gogpu/exceptions.py

@@ -0,0 +1,37 @@
+from __future__ import annotations
+
+from typing import Any, Optional
+
+
+class GoGPUError(Exception):
+    """Base error for the gogpu SDK."""
+
+
+class GoGPUAPIError(GoGPUError):
+    """Raised when the API returns a non-success business code or HTTP error."""
+
+    def __init__(
+        self,
+        message: str,
+        *,
+        code: Optional[int] = None,
+        data: Any = None,
+        path: Optional[str] = None,
+        status_code: Optional[int] = None,
+    ) -> None:
+        super().__init__(message)
+        self.message = message
+        self.code = code
+        self.data = data
+        self.path = path
+        self.status_code = status_code
+
+    def __str__(self) -> str:
+        parts = [self.message]
+        if self.code is not None:
+            parts.append(f"code={self.code}")
+        if self.path:
+            parts.append(f"path={self.path}")
+        if self.status_code is not None:
+            parts.append(f"http={self.status_code}")
+        return " | ".join(parts)

gogpu-0.1.0/src/gogpu/resources/__init__.py

@@ -0,0 +1 @@
+"""Resource modules for the gogpu SDK."""

gogpu-0.1.0/src/gogpu/resources/account.py

@@ -0,0 +1,13 @@
+from __future__ import annotations
+
+from typing import Any, Optional
+
+from gogpu.resources.base import BaseResource
+
+
+class AccountResource(BaseResource):
+    """User account helpers."""
+
+    def get_self_info(self, *, id: int = 0) -> Any:
+        """GET current user profile via ``/user/account/GetSelfInfo``."""
+        return self._post("/user/account/GetSelfInfo", {"id": id})

gogpu-0.1.0/src/gogpu/resources/base.py

@@ -0,0 +1,14 @@
+from __future__ import annotations
+
+from typing import TYPE_CHECKING, Any, Mapping, Optional
+
+if TYPE_CHECKING:
+    from gogpu.client import Client
+
+
+class BaseResource:
+    def __init__(self, client: "Client") -> None:
+        self._client = client
+
+    def _post(self, path: str, body: Optional[Mapping[str, Any]] = None, **kwargs: Any) -> Any:
+        return self._client.request(path, body, **kwargs)

gogpu-0.1.0/src/gogpu/resources/instances.py

@@ -0,0 +1,561 @@
+from __future__ import annotations
+
+from typing import Any, Mapping, Optional, Sequence
+
+from gogpu.resources.base import BaseResource
+
+# order_type: 1 容器 / 2 云主机 / 5 裸金属 / 7 商品 / 8 Token套餐
+ORDER_TYPE_CVM = 2
+
+# CVM status: 1创建中 2开机中 3运行中 4异常 5已关机 6重置中 7已过期 9已释放
+STATUS_CREATING = 1
+STATUS_STARTING = 2
+STATUS_RUNNING = 3
+STATUS_ERROR = 4
+STATUS_STOPPED = 5
+STATUS_RESETTING = 6
+STATUS_EXPIRED = 7
+STATUS_RELEASED = 9
+
+# image_type: 1 基础 / 2 模型 / 3 系统 / 7 拷贝云主机 / 9 用户镜像
+IMAGE_TYPE_BASE = 1
+IMAGE_TYPE_MODEL = 2
+IMAGE_TYPE_OS = 3
+IMAGE_TYPE_CVM_COPY = 7
+IMAGE_TYPE_USER = 9
+
+# renew mode: 1 自动 / 2 手动
+RENEW_AUTO = 1
+RENEW_MANUAL = 2
+
+# reserve disk: 1 保留 / 2 不保留
+RESERVE_DISK_YES = 1
+RESERVE_DISK_NO = 2
+
+# monitor mon_type: 1 cpu / 2 内存 / 3 网络 / 4 硬盘
+MON_CPU = 1
+MON_MEMORY = 2
+MON_NETWORK = 3
+MON_DISK = 4
+
+
+class InstancesResource(BaseResource):
+    """云主机（CVM）完整能力：选购 → 下单 → 生命周期 → 运维。"""
+
+    def _by_id(self, path: str, instance_id: int, **extra: Any) -> Any:
+        return self._post(path, {"id": instance_id, **extra})
+
+    # ----- 选购：可购买资源 / 镜像 / 区域 -----
+
+    def list_offers(
+        self,
+        *,
+        page: int = 1,
+        page_size: int = 10,
+        charging: str = "hour",
+        region_id: Optional[int] = None,
+        gpu_id: Optional[int] = None,
+        gpu_number: Optional[int] = None,
+        keyword: Optional[str] = None,
+        server_id: Optional[int] = None,
+        web: bool = False,
+        **extra: Any,
+    ) -> Any:
+        """获取可购买的云主机资源列表。
+
+        返回 ``{"list": [...], "page", "pageSize", "total"}``。
+        列表项 ``id`` 即下单 ``good_id``；``inventory==0`` 表示暂无库存。
+
+        ``charging`` 对可筛选接口是必填语义（默认 ``hour``），可选
+        ``hour`` / ``day`` / ``week`` / ``month`` / ``year``。
+        ``web=True`` 走官网列表（仅分页，无筛选）。
+        """
+        if web:
+            return self._post(
+                "/common/product/GetWebVmServerList",
+                {"page": page, "pageSize": page_size, **extra},
+            )
+
+        body: dict[str, Any] = {
+            "page": page,
+            "pageSize": page_size,
+            "charging": charging,
+            **extra,
+        }
+        if region_id is not None:
+            body["region_id"] = region_id
+        if gpu_id is not None:
+            body["gpu_id"] = gpu_id
+        if gpu_number is not None:
+            body["gpu_number"] = gpu_number
+        if keyword is not None:
+            body["keyword"] = keyword
+        if server_id is not None:
+            body["server_id"] = server_id
+        return self._post("/common/product/GetVmServerList", body)
+
+    def get_offer(self, server_id: int) -> Any:
+        """单个可购买资源详情。"""
+        return self._by_id("/common/product/GetVmServerInfo", server_id)
+
+    def list_gpu_types(self, *, page: int = 1, page_size: int = 100, **extra: Any) -> Any:
+        """云主机可选 GPU 型号（筛选 ``list_offers(gpu_id=...)``）。"""
+        return self._post(
+            "/common/product/GetVmServerGpuTypeList",
+            {"page": page, "pageSize": page_size, **extra},
+        )
+
+    def list_regions(self, *, parent_id: Optional[int] = None, **extra: Any) -> Any:
+        """区域树；传 ``parent_id`` 则查子区域。"""
+        if parent_id is None and not extra:
+            return self._post("/common/product/GetRegionTree", {})
+        body: dict[str, Any] = dict(extra)
+        if parent_id is not None:
+            body["id"] = parent_id
+        return self._post("/common/product/GetRegionChildrenList", body)
+
+    def list_os_images(
+        self,
+        *,
+        image_os_type: int,
+        server_id: Optional[int] = None,
+        server_type: int = 2,
+        scene: Optional[int] = None,
+        **extra: Any,
+    ) -> Any:
+        """系统镜像列表（购买 / 重装时选 ``image_id``）。
+
+        ``image_os_type``：1 windows / 2 ubuntu。
+        ``server_type``：1 容器 / 2 虚拟机（云主机用 2）。
+        """
+        body: dict[str, Any] = {
+            "type": image_os_type,
+            "server_type": server_type,
+            **extra,
+        }
+        if server_id is not None:
+            body["server_id"] = server_id
+        if scene is not None:
+            body["scene"] = scene
+        return self._post("/common/product/GetOsImageList", body)
+
+    def list_public_images(self, **extra: Any) -> Any:
+        """公共镜像列表。"""
+        return self._post("/common/product/GetPublicImageList", dict(extra))
+
+    def list_usable_images(
+        self,
+        *,
+        object_id: int,
+        object_type: int = ORDER_TYPE_CVM,
+        page: int = 1,
+        page_size: int = 10,
+        keyword: Optional[str] = None,
+        **extra: Any,
+    ) -> Any:
+        """创建实例可用的用户镜像列表。``object_type``：1 容器 / 2 云主机。"""
+        body: dict[str, Any] = {
+            "object_id": object_id,
+            "object_type": object_type,
+            "page": page,
+            "pageSize": page_size,
+            **extra,
+        }
+        if keyword is not None:
+            body["keyword"] = keyword
+        return self._post("/user/image/GetUsableImageList", body)
+
+    # ----- 下单 / 支付 / 续费 -----
+
+    def create(
+        self,
+        *,
+        good_id: int,
+        order_type: int = ORDER_TYPE_CVM,
+        image_id: Optional[int] = None,
+        image_type: Optional[int] = None,
+        charging: Optional[str] = None,
+        cycle_number: Optional[int] = None,
+        number: Optional[int] = None,
+        renew: Optional[bool] = None,
+        coupon_id: Optional[int] = None,
+        notes: Optional[str] = None,
+        sub_type: Optional[int] = None,
+        **extra: Any,
+    ) -> Any:
+        """创建云主机新购订单。``order_type`` 默认 2（云主机）。"""
+        body: dict[str, Any] = {
+            "good_id": good_id,
+            "order_type": order_type,
+            **extra,
+        }
+        if image_id is not None:
+            body["image_id"] = image_id
+        if image_type is not None:
+            body["image_type"] = image_type
+        if charging is not None:
+            body["charging"] = charging
+        if cycle_number is not None:
+            body["cycle_number"] = cycle_number
+        if number is not None:
+            body["number"] = number
+        if renew is not None:
+            body["renew"] = renew
+        if coupon_id is not None:
+            body["coupon_id"] = coupon_id
+        if notes is not None:
+            body["notes"] = notes
+        if sub_type is not None:
+            body["sub_type"] = sub_type
+        return self._post("/user/order/CreateOrder", body)
+
+    def pay(
+        self,
+        order_id: int,
+        *,
+        pay_type: int = 1,
+        client: int = 1,
+        **extra: Any,
+    ) -> Any:
+        """支付订单。``pay_type``：1 余额 / 2 微信 / 3 支付宝 / 5 stripe。"""
+        return self._post(
+            "/user/order/PayOrder",
+            {
+                "order_id": order_id,
+                "pay_type": pay_type,
+                "client": client,
+                **extra,
+            },
+        )
+
+    def create_and_pay(
+        self,
+        *,
+        good_id: int,
+        pay_type: int = 1,
+        order_id_key: str = "id",
+        **create_kwargs: Any,
+    ) -> dict[str, Any]:
+        """下单并支付，返回 ``{"order": ..., "payment": ...}``。"""
+        order = self.create(good_id=good_id, **create_kwargs)
+        order_id = None
+        if isinstance(order, dict):
+            order_id = order.get(order_id_key) or order.get("order_id")
+        if order_id is None:
+            raise ValueError(
+                f"Cannot find order id in create response "
+                f"(tried '{order_id_key}' / 'order_id'): {order!r}"
+            )
+        payment = self.pay(int(order_id), pay_type=pay_type)
+        return {"order": order, "payment": payment}
+
+    def renew(
+        self,
+        product_id: int,
+        *,
+        charging: str,
+        renew: bool = True,
+        order_type: int = ORDER_TYPE_CVM,
+        cycle_number: Optional[int] = None,
+        coupon_id: Optional[int] = None,
+        notes: Optional[str] = None,
+        **extra: Any,
+    ) -> Any:
+        """创建续费订单。``product_id`` 为已购云主机实例 id。"""
+        body: dict[str, Any] = {
+            "product_id": product_id,
+            "charging": charging,
+            "renew": renew,
+            "order_type": order_type,
+            **extra,
+        }
+        if cycle_number is not None:
+            body["cycle_number"] = cycle_number
+        if coupon_id is not None:
+            body["coupon_id"] = coupon_id
+        if notes is not None:
+            body["notes"] = notes
+        return self._post("/user/order/RenewOrder", body)
+
+    # ----- 已购实例：列表 / 详情 / 统计 -----
+
+    def list(
+        self,
+        *,
+        page: int = 1,
+        page_size: int = 10,
+        status: Optional[int] = None,
+        keyword: Optional[str] = None,
+        charging: Optional[int] = None,
+        gpu_number: Optional[int] = None,
+        auto_renew: Optional[int] = None,
+        stop_range: Optional[str] = None,
+        **extra: Any,
+    ) -> Any:
+        """已购云主机列表。"""
+        body: dict[str, Any] = {"page": page, "pageSize": page_size, **extra}
+        if status is not None:
+            body["status"] = status
+        if keyword is not None:
+            body["keyword"] = keyword
+        if charging is not None:
+            body["charging"] = charging
+        if gpu_number is not None:
+            body["gpu_number"] = gpu_number
+        if auto_renew is not None:
+            body["auto_renew"] = auto_renew
+        if stop_range is not None:
+            body["stop_range"] = stop_range
+        return self._post("/user/cvm/GetCvmList", body)
+
+    def get(self, instance_id: int) -> Any:
+        """云主机详情。"""
+        return self._by_id("/user/cvm/GetCvmInfo", instance_id)
+
+    def statistics(self) -> Any:
+        """云主机统计。"""
+        return self._post("/user/cvm/GetCvmStatistics", {})
+
+    def list_instance_gpu_types(self) -> Any:
+        """已购列表可筛选的 GPU 类型。"""
+        return self._post("/user/cvm/GetCvmGpuList", {})
+
+    def list_cluster(
+        self,
+        *,
+        vm_server_id: Optional[int] = None,
+        current_cvm_id: Optional[int] = None,
+        **extra: Any,
+    ) -> Any:
+        """同集群内用户云主机。"""
+        body: dict[str, Any] = dict(extra)
+        if vm_server_id is not None:
+            body["vm_server_id"] = vm_server_id
+        if current_cvm_id is not None:
+            body["current_cvm_id"] = current_cvm_id
+        return self._post("/user/cvm/GetClusterCvm", body)
+
+    # ----- 电源 / 生命周期 -----
+
+    def start(self, instance_id: int) -> Any:
+        """开机。"""
+        return self._by_id("/user/cvm/Start", instance_id)
+
+    def stop(self, instance_id: int) -> Any:
+        """关机。"""
+        return self._by_id("/user/cvm/Stop", instance_id)
+
+    def reboot(self, instance_id: int) -> Any:
+        """重启。"""
+        return self._by_id("/user/cvm/Restart", instance_id)
+
+    def delete(self, instance_id: int) -> Any:
+        """删除 / 释放。"""
+        return self._by_id("/user/cvm/Delete", instance_id)
+
+    def reset_system(
+        self,
+        instance_id: int,
+        *,
+        image_id: int,
+        image_type: int,
+        **extra: Any,
+    ) -> Any:
+        """重置系统。``image_type``：1 基础 / 2 模型 / 3 系统 / 7 拷贝 / 9 用户镜像。"""
+        return self._post(
+            "/user/cvm/ResetSystem",
+            {
+                "id": instance_id,
+                "image_id": image_id,
+                "image_type": image_type,
+                **extra,
+            },
+        )
+
+    def convert_cardless(self, instance_id: int) -> Any:
+        """转为无卡模式。"""
+        return self._by_id("/user/cvm/ConvertCardless", instance_id)
+
+    def stop_cardless(self, instance_id: int) -> Any:
+        """停止无卡模式。"""
+        return self._by_id("/user/cvm/StopCardless", instance_id)
+
+    def convert_charging(self, instance_id: int, **extra: Any) -> Any:
+        """包年包月转按量计费。"""
+        return self._by_id("/user/cvm/ConvertCharging", instance_id, **extra)
+
+    # ----- 配置变更 -----
+
+    def edit(self, instance_id: int, *, name: str, **extra: Any) -> Any:
+        """修改云主机名称等信息。"""
+        return self._post(
+            "/user/cvm/EditCvm",
+            {"id": instance_id, "name": name, **extra},
+        )
+
+    def change_password(self, instance_id: int, *, password: str, **extra: Any) -> Any:
+        """修改登录密码。"""
+        return self._post(
+            "/user/cvm/EditPassword",
+            {"id": instance_id, "password": password, **extra},
+        )
+
+    def change_renew(self, instance_id: int, *, mode: int, **extra: Any) -> Any:
+        """修改续费方式。``mode``：1 自动 / 2 手动。"""
+        return self._post(
+            "/user/cvm/ChangeRenew",
+            {"id": instance_id, "mode": mode, **extra},
+        )
+
+    def change_reserve_disk(self, instance_id: int, *, mode: int, **extra: Any) -> Any:
+        """是否保留磁盘。``mode``：1 保留 / 2 不保留。"""
+        return self._post(
+            "/user/cvm/ChangeReserveDisk",
+            {"id": instance_id, "mode": mode, **extra},
+        )
+
+    def expand(
+        self,
+        instance_id: int,
+        *,
+        cpu_expansion: Optional[int] = None,
+        memory_expansion: Optional[int] = None,
+        disk_expansion: Optional[int] = None,
+        sys_disk_expansion: Optional[int] = None,
+        **extra: Any,
+    ) -> Any:
+        """云主机扩容。"""
+        body: dict[str, Any] = {"id": instance_id, **extra}
+        if cpu_expansion is not None:
+            body["cpu_expansion"] = cpu_expansion
+        if memory_expansion is not None:
+            body["memory_expansion"] = memory_expansion
+        if disk_expansion is not None:
+            body["disk_expansion"] = disk_expansion
+        if sys_disk_expansion is not None:
+            body["sys_disk_expansion"] = sys_disk_expansion
+        return self._post("/user/cvm/CvmExpand", body)
+
+    def get_expand_amount(
+        self,
+        instance_id: int,
+        *,
+        cpu_expansion: Optional[int] = None,
+        memory_expansion: Optional[int] = None,
+        disk_expansion: Optional[int] = None,
+        sys_disk_expansion: Optional[int] = None,
+        **extra: Any,
+    ) -> Any:
+        """查询扩容预计金额。"""
+        body: dict[str, Any] = {"id": instance_id, **extra}
+        if cpu_expansion is not None:
+            body["cpu_expansion"] = cpu_expansion
+        if memory_expansion is not None:
+            body["memory_expansion"] = memory_expansion
+        if disk_expansion is not None:
+            body["disk_expansion"] = disk_expansion
+        if sys_disk_expansion is not None:
+            body["sys_disk_expansion"] = sys_disk_expansion
+        return self._post("/user/cvm/GetExpandAmount", body)
+
+    def get_refund_amount(self, instance_id: int, *, type: int = 1, **extra: Any) -> Any:
+        """预计退款金额。``type``：1 退款 / 2 转按量。"""
+        return self._post(
+            "/user/cvm/GetRefundAmount",
+            {"id": instance_id, "type": type, **extra},
+        )
+
+    def refund(self, instance_id: int) -> Any:
+        """包年包月退款。"""
+        return self._by_id("/user/cvm/Refund", instance_id)
+
+    # ----- 密码 / 密钥 / 软件 -----
+
+    def get_ssh_password(self, instance_id: int) -> Any:
+        """查看 SSH 密码。"""
+        return self._by_id("/user/cvm/CatPasswd", instance_id)
+
+    def get_vnc_password(self, instance_id: int) -> Any:
+        """查看 VNC 密码。"""
+        return self._by_id("/user/cvm/CatVncPasswd", instance_id)
+
+    def get_rdp_password(self, instance_id: int) -> Any:
+        """查看 RDP 密码。"""
+        return self._by_id("/user/cvm/CatRdpPasswd", instance_id)
+
+    def get_jupyter_password(self, instance_id: int) -> Any:
+        """查看 Jupyter 密码。"""
+        return self._by_id("/user/cvm/CatJupyterPasswd", instance_id)
+
+    def get_vscode_password(self, instance_id: int) -> Any:
+        """查看 VS Code 密码。"""
+        return self._by_id("/user/cvm/CatVsCodePasswd", instance_id)
+
+    def generate_key(self, instance_id: int) -> Any:
+        """生成 SSH 密钥。"""
+        return self._by_id("/user/cvm/GenerateKey", instance_id)
+
+    def download_key(self, instance_id: int) -> Any:
+        """下载 SSH 密钥。"""
+        return self._by_id("/user/cvm/DownLoadKey", instance_id)
+
+    def get_software_config(self, instance_id: int) -> Any:
+        """软件配置详情。"""
+        return self._by_id("/user/cvm/GetSoftwareConfig", instance_id)
+
+    # ----- 端口 / 监控 / 截图 / 镜像 -----
+
+    def list_ports(self, instance_id: int) -> Any:
+        """端口列表。"""
+        return self._by_id("/user/cvm/GetCvmPortList", instance_id)
+
+    def list_default_ports(self, instance_id: int) -> Any:
+        """默认端口列表。"""
+        return self._by_id("/user/cvm/GetCvmDefaultPortList", instance_id)
+
+    def update_ports(
+        self,
+        instance_id: int,
+        port_list: Sequence[Mapping[str, Any]],
+        **extra: Any,
+    ) -> Any:
+        """更新端口列表。每项可含 ``name`` / ``internal_port`` / ``external_port`` / ``protocol_type``。"""
+        return self._post(
+            "/user/cvm/UpCvmPortList",
+            {"id": instance_id, "port_list": list(port_list), **extra},
+        )
+
+    def get_monitor(
+        self,
+        instance_id: int,
+        *,
+        mon_type: int,
+        time_type: str,
+        time_value: Optional[int] = None,
+        **extra: Any,
+    ) -> Any:
+        """监控数据。
+
+        ``mon_type``：1 cpu / 2 内存 / 3 网络 / 4 硬盘。
+        ``time_type``：``hour`` / ``day`` / ``month``。
+        """
+        body: dict[str, Any] = {
+            "id": instance_id,
+            "mon_type": mon_type,
+            "time_type": time_type,
+            **extra,
+        }
+        if time_value is not None:
+            body["time_value"] = time_value
+        return self._post("/user/cvm/GetMonitor", body)
+
+    def take_screenshot(self, instance_id: int) -> Any:
+        """屏幕截图。"""
+        return self._by_id("/user/cvm/TakeScreenshot", instance_id)
+
+    def create_image(self, instance_id: int, *, name: str, **extra: Any) -> Any:
+        """从云主机创建镜像。"""
+        return self._post(
+            "/user/cvm/CreateImage",
+            {"cid": instance_id, "name": name, **extra},
+        )