> ## Documentation Index
> Fetch the complete documentation index at: https://docs.siflow.cn/llms.txt
> Use this file to discover all available pages before exploring further.

# Python SDK 发布记录

> 查看人工智能平台 Python SDK 各版本的功能更新、问题修复和接口兼容性变化。

本文记录 Python SDK 的功能更新、问题修复和接口兼容性变化，按版本从新到旧排列。安装和升级请参见 [Python SDK 快速开始](https://docs.siflow.cn/ai-platform/developer-access/python-sdk-quickstart.md)。

**0.3.27**

2026.11.02

* **自动换机开关**：训练任务自动容错配置新增 `auto_replace_enabled`，用于控制是否启用故障自动换机。
* **通知等待时间**：新增 `replace_pod_notify_max_wait`，用于设置换机通知的最长等待时间。

详见 [配置增强能力](https://docs.siflow.cn/ai-platform/developer-access/manage-training-tasks-with-python-sdk.md#配置增强能力)。

**0.3.26**

2026.10.15

* **资源预检**：支持单独启用或关闭，并支持通过环境变量配置检测项目。
* **多端口指标采集**：训练任务支持从多个端口采集自定义监控指标。

详见 [配置增强能力](https://docs.siflow.cn/ai-platform/developer-access/manage-training-tasks-with-python-sdk.md#配置增强能力)。

**0.3.25**

2026.09.16

* **镜像地址必填**：创建开发环境时，镜像地址由可选项改为必填项。

> [!WARNING]
>
> 升级后，调用 `client.vscs.create()` 时，需要在 `CreateVscsRequest.imageUrl` 中提供镜像地址。配置说明请参见 [创建开发环境](https://docs.siflow.cn/ai-platform/developer-access/manage-development-environments-with-python-sdk.md#创建开发环境)。

**0.3.24**

2026.09.11

* **指标查询**：支持通过 SDK 查询训练任务监控指标。请参见 [查询训练任务指标](https://docs.siflow.cn/ai-platform/developer-access/query-metrics-with-python-sdk.md)。
* **任务可见性**：训练任务的是否公开字段支持在创建时设置，并在查询结果中返回。
* **项目组过滤**：训练任务按项目组过滤的行为与控制台保持一致。

**0.3.23**

2026.08.28

* **闲时任务稳定性**：训练任务支持配置闲时任务稳定性等级。
* **通用服务管理**：新增灰度发布和配置版本历史接口，并支持管理单个服务的分享名单。
* **目录配额**：存储卷支持设置目录配额。

**0.3.22**

2026.08.20

* **节点调度策略**：训练任务支持用户级节点黑白名单调度策略。
* **子目录用户限额**：存储卷支持设置子目录的用户限额。

**0.3.21**

2026.08.13

* **任务子状态**：训练任务列表默认返回子状态标签列表 `sub_status`。
* **checkpoint 通知**：训练任务支持退出时发送 checkpoint 通知。
* **推理服务接口**：补齐大模型推理服务的版本更新与并发控制、灰度发布、模板、引擎及版本管理接口，以及旧版响应模型。
* **压测任务卷挂载**：推理服务压测任务的卷挂载支持子路径 `subPath` 和只读配置 `readOnly`。

**0.3.20**

2026.08.06

* **存储卷挂载**：支持指定子路径 `subPath`，并设置只读权限。
* **系统日志查询**：新增系统日志查询接口。请参见 [查询日志](https://docs.siflow.cn/ai-platform/developer-access/query-logs-with-python-sdk.md)。

**0.3.18**

2026.07.30

* **快速失败**：新增快速失败支持。
* **服务压测**：支持对服务进行压测。

**0.3.16**

2026.07.30

* **用户配额**：支持设置配置模式。

**0.3.15**

2026.07.23

* **服务域名**：新增内部域名和外部域名支持。

**0.3.14**

2026.07.23

* **日志关键词搜索**：`logs.query()` 和各资源的 `query_logs()` 新增可选参数 `keyword`，支持全局关键词搜索；日志下载接口不支持该参数。
* **任务优先级**：训练任务的 `priority` 和 `running_priority` 改为整数，普通任务优先级为 1～9，闲时任务为 0；创建任务时仍兼容原有单词形式的优先级入参。新增 `tasks.update_priority()`，用于更新任务优先级。
* **任务排队信息**：`queue_info` 按资源池和实例类型组织，新增 `direct_group`、`by_instance_type` 和优先级直方图。
* **任务创建参数**：补充 `force_single_pod`，用于禁止跨 Pod 网络组调度；`create()` 的关键字参数支持 `enable_idle_resource`、`prefer_idle_resource` 和 `resource_pool_id`。
* **用户配额**：支持查看和编辑资源池内的负载优先级上限，以及是否允许设置资源保障。
* **资源池配置**：支持查看和设置默认用户优先级上限及资源保障配置。

**0.3.12**

2026.07.09

* **闲时资源降级**：训练任务支持闲时资源降级配置，`enable_idle_resource` 和 `prefer_idle_resource` 默认均为 `false`。
* **任务查询结果**：任务详情和列表新增 `sub_task`，表示是否为子任务；新增 `sub_status`，返回子状态标签列表。

**0.3.11**

2026.07.09

* **网页版 VS Code**：训练任务新增网页版 VS Code 增强配置。
* **开发环境卷挂载**：`VolumeMount` 支持指定子路径 `subPath`。

**0.3.10**

2026.06.24

* **地域与集群支持**：新增 `kunlun` 地域及 `hydra` 集群支持。

**0.3.9**

2026.06.24

* **增量授权管理**：存储卷新增 `share_add_users` 和 `share_delete_users`，支持增量添加或移除授权用户，无需覆盖完整授权名单。

**0.3.8**

2026.06.15

* **通用服务配置**：卷挂载支持指定子路径 `subPath`，并支持设置服务可见性。
* **服务列表查询**：修正通用服务列表的 `showAll` 行为。
* **镜像分享**：支持按项目组名称分享。

**0.3.6**

2026.05.22

* **指标采集配置**：创建训练任务时，支持指定 Prometheus 指标采集端口和路径。
* **RayJob 异构调度**：可为 Head 节点单独指定实例规格。

**0.3.5**

2026.05.14

* **镜像管理**：支持删除构建任务和查看事件列表。

**0.3.4**

2026.04.29

* **资源管理**：补齐资源管理接口。
* **开发环境**：新增开发环境管理接口，并支持将开发环境保存为镜像。
* **存储卷接口**：部分存储卷管理接口存在兼容性变化。

> [!WARNING]
>
> 升级时，请对照 [管理存储卷](https://docs.siflow.cn/ai-platform/developer-access/manage-storage-volumes-with-python-sdk.md) 中的示例调整调用代码。

**0.3.3**

2026.04.13

* **独占资源池**：支持查询独占资源池的节点视图。

**0.3.2**

2026.03.30

* **依赖更新**：升级 `anyio` 依赖。

**0.3.1**

2026.03.26

* **镜像参数校验修复**：修复提交训练任务时已指定 `image_url`，仍要求填写其他镜像参数的问题。

**0.3.0**

2026.03.12

* **RayJob 运行时环境**：支持配置 RayJob 的运行时环境。

**0.2.9**

2026.03.05

* **集群支持**：新增 `vlans` 集群支持。

**0.2.8**

2026.02.26

* **Pod 查询**：任务模块新增 Pod 列表查询接口。
* **节点调度策略**：支持配置节点调度策略。

**0.2.7**

2026.02.03

* **集群支持**：新增 `taihua` 集群支持。

**0.2.6**

2026.01.25

* **RayJob 任务**：支持创建 RayJob 类型的训练任务。

**0.2.5**

2026.01.20

* **通用服务镜像**：支持指定自定义镜像地址。

**0.2.4**

2025.12.24

* **评测任务提交**：模型评测平台支持通过 YAML 提交任务。

**0.2.3**

2025.12.23

* **存储卷查询**：新增存储卷查询接口。

**0.2.2**

2025.12.22

* **模型评测**：新增模型评测平台 SDK 接口。

**0.2.1**

2025.12.16

* **通用服务管理**：支持通用服务上线和下线。

**0.2.0**

2025.12.12

* **集群支持**：新增 `shmaas` 集群支持。

**0.1.9**

2025.12.10

* **集群支持**：新增 `changliu` 集群支持。

**0.1.8**

2025.11.14

* **容错记录**：训练任务查询结果新增容错记录字段。

**0.1.7**

2025.11.13

* **环境变量**：训练任务支持配置环境变量。

**0.1.6**

2025.10.30

* **模型来源配置**：支持配置模型仓库。

**0.1.5**

2025.10.24

* **集群支持**：新增 `zhuoguang` 集群支持。

**0.1.4**

2025.10.23

* **旧版服务发布**：新增旧版服务发布功能的 SDK 接口。

**0.1.3**

2025.09.29

* **集群支持**：新增 `longmen` 集群支持。

**0.1.2**

2025.09.22

* **大模型推理**：新增大模型推理 SDK 接口。

**0.1.1**

2025.09.14

* **工作流推理节点**：工作流支持使用推理节点。

**0.1.0**

2025.09.11

* **通用服务发布**：新增通用服务发布 SDK 接口。

**0.0.8**

2025.09.08

* **镜像参数隐藏**：镜像模块新增参数隐藏功能。

**0.0.7**

2025.08.20

* **集群支持**：新增 `wulanchabu` 集群支持。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.