> ## 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，配置 AK/SK 认证，并初始化 SDK 客户端。

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

## 操作前确认

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

## 安装 SDK

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

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

```bash theme={null}
wget https://oss-cn-shanghai.siflow.cn/ai-infra-download/siflow-public/siflow-0.3.24-py3-none-any.whl
```

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

```bash theme={null}
curl -LO https://oss-cn-shanghai.siflow.cn/ai-infra-download/siflow-public/siflow-0.3.24-py3-none-any.whl
```

下载完成后，安装 SDK：

```bash theme={null}
pip uninstall siflow
pip install siflow-0.3.24-py3-none-any.whl
```

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

## 配置 AK/SK

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

```bash theme={null}
export SIFLOW_ACCESS_KEY_ID="<ACCESS_KEY_ID>"
export SIFLOW_ACCESS_KEY_SECRET="<ACCESS_KEY_SECRET>"
```

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

```python theme={null}
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，可以只传入区域和集群。

```python theme={null}
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 管理训练任务](./manage-training-tasks-with-python-sdk)
* [使用 Python SDK 查询日志和指标](./query-logs-and-metrics-with-python-sdk)
* [使用 Python SDK 管理镜像](./manage-images-with-python-sdk)
* [使用 Python SDK 管理通用服务](./manage-general-services-with-python-sdk)
* [使用 Python SDK 管理大模型推理服务](./manage-llm-inference-services-with-python-sdk)
* [使用 Python SDK 管理实例资源](./manage-compute-resources-with-python-sdk)
* [使用 Python SDK 管理存储卷](./manage-storage-volumes-with-python-sdk)
* [使用 Python SDK 管理开发环境](./manage-development-environments-with-python-sdk)