Python SDK 快速开始

Python SDK 适用于在脚本、Notebook、CI/CD 或自动化平台中调用人工智能平台能力。完成本文操作后，您可以初始化 SDK 客户端，并继续使用 SDK 管理训练任务、镜像、通用服务、大模型推理服务、资源、存储卷和开发环境。

操作前确认

本地或运行环境已安装 Python 和 pip。
已获取当前账号的 AK/SK。
已确认需要访问的区域和集群。

安装 SDK

SDK 支持通过 WHL 包安装。当前版本为 0.3.24。

在 Linux 环境中，可以使用 wget 下载：

wget https://oss-cn-shanghai.siflow.cn/ai-infra-download/siflow-public/siflow-0.3.24-py3-none-any.whl

在 macOS 或其他已安装 curl 的环境中，可以使用 curl 下载：

curl -LO https://oss-cn-shanghai.siflow.cn/ai-infra-download/siflow-public/siflow-0.3.24-py3-none-any.whl

下载完成后，安装 SDK：

pip uninstall siflow
pip install siflow-0.3.24-py3-none-any.whl

升级前如已安装旧版本，建议先卸载旧版本，再安装新版本。

配置 AK/SK

SDK 需要使用 AK/SK 认证。建议通过环境变量配置凭据，避免在代码中硬编码密钥。

export SIFLOW_ACCESS_KEY_ID="<ACCESS_KEY_ID>"
export SIFLOW_ACCESS_KEY_SECRET="<ACCESS_KEY_SECRET>"

也可以在初始化客户端时直接传入 AK/SK。该方式适合临时验证，不建议用于共享脚本或生产代码。

from siflow import SiFlow

client = SiFlow(
    region="cn-beijing",
    cluster="auriga",
    access_key_id="<ACCESS_KEY_ID>",
    access_key_secret="<ACCESS_KEY_SECRET>",
)

初始化客户端

如果已通过环境变量配置 AK/SK，可以只传入区域和集群。

from siflow import SiFlow

client = SiFlow(
    region="cn-beijing",
    cluster="auriga",
)

初始化后，可以继续调用 client.tasks、client.images、client.generalsvc、client.inference、client.pools、client.volumes 或 client.vscs 等对象。后续 SDK 文档中的代码片段默认已经按上述方式完成 client 初始化。除完整创建示例外，代码片段通常只展示当前操作需要的调用。

安全建议

不要将 AK/SK 提交到代码仓库。
不要把 AK/SK 写入日志、截图、工单或共享文档。
在 CI/CD 中使用密钥变量或凭据管理工具注入 AK/SK。
如果怀疑凭据泄露，请尽快在控制台轮换或停用。

后续操作

完成客户端初始化后，可以继续阅读：

开始使用

资源准备

开发与训练

模型与推理

运维与治理

开发者接入

Python SDK 快速开始

操作前确认

安装 SDK

配置 AK/SK

初始化客户端

安全建议

后续操作

​操作前确认

​安装 SDK

​配置 AK/SK

​初始化客户端

​安全建议

​后续操作

操作前确认

安装 SDK

配置 AK/SK

初始化客户端

安全建议

后续操作