# hubai_client

Python API: `hubai_sdk.hubai_client`

HubAI Python API 的认证入口点。

## 类

### HubAIClient

使用 HubAI 进行身份验证并公开其高级服务模块。

客户端不持有单独的 HTTP 会话。其服务属性是模块，其函数使用存储在 SDK 环境中的 API 密钥。因此，创建另一个客户端会替换后续服务调用使用的进程范围密钥。

> **示例**
> 构造函数会自动查找 `HUBAI_API_KEY`。

```python
from hubai_sdk import HubAIClient

client = HubAIClient()
models = client.models.list_models(is_public=True)
```

> **注意**
> 已安装的 `hubai.plugins` 入口点可以添加更多属性。插件不能替换内置服务属性之一。

#### 方法

##### init

```python
def __init__(api_key: str | None = None):
```

初始化 HubAI SDK 客户端。

参数

 * `api_key` (`str | None`): HubAI API 密钥。如果省略，客户端将回退到 `HUBAI_API_KEY` 环境变量，然后回退到从安全凭据存储加载的密钥。

引发

 * `ValueError`: 如果没有可用的 API 密钥或提供的密钥无效。

#### 属性

##### convert

托管模型转换函数。

##### instances

模型工件及其文件的函数。

##### models

模型资源的函数。

##### variants

版本化模型变体的函数。
