# sdk_models

Python API: `hubai_sdk.utils.sdk_models`

公共 SDK 服务返回的稳定响应模型。

HubAI OpenAPI 模式被生成到内部模块中。这里的包装器删除了仅限服务器的所有权字段，并添加了由 SDK 填充的值，从而提供了更小、更准确的公共契约。

所有响应类型都是 Pydantic 模型。当需要字典时，使用正常的属性访问或 `model_dump()`。

## 类

### ConvertResponse

已完成的托管模型转换结果。

#### 属性

##### downloaded_path

下载器创建的本地目录或文件。

##### instance

与作业关联的导出模型实例。

##### job

HubAI 返回的已完成导出作业。

### JobMessageResponse

异步 HubAI 作业的状态和输出元数据。

 * `通用字段：`：`id`、`name` 和 `status` 标识作业及其状态。`queued_at`、`started_at` 和 `finished_at` 描述时间。成功的作业会填充 `result`；失败的作业可能会填充 `exception`
   和 `logs`。

#### 属性

##### team_id

##### user_id

### ModelInstanceFileResponse

附加到模型实例的单个文件的元数据。

 * `通用字段：`：`id` 标识文件记录，`model_instance_id` 标识其所有者，`filepath` 相对于工件根目录，`file_size_bytes` 是其存储大小。

#### 属性

##### team_id

##### user_id

### ModelInstanceResponse

具体模型工件的元数据。

 * `通用字段：`： * `id`、`name` 和 `slug` 标识工件。
    * `model_id` 和 `model_version_id` 标识其父级。
    * `model_type`、`model_precision_type` 和 `input_shape` 描述存储的模型。
    * `parent_id` 将导出的工件链接到其源实例。
    * `status` 报告工件是否可供使用。

#### 属性

##### model_name

明确请求时父模型的名称。

##### model_variant_name

明确请求时父变体的名称。

##### team_id

##### user_id

### ModelResponse

顶级 HubAI 模型资源的元数据。

 * `通用字段：`： * `id`、`name` 和 `slug` 标识模型。
    * `tasks`、`license_type` 和 `is_yolo` 描述其契约。
    * `is_public` 报告其可见性。
    * `platforms` 和 `exportable_to` 总结了工件支持。
    * `versions`、`likes` 和 `downloads` 包含聚合计数。

#### 属性

##### team_id

##### user_id

### ModelVersionResponse

版本化模型变体的元数据。

 * `通用字段：`： * `id`、`name`、`slug` 和 `variant_slug` 标识变体。
    * `model_id` 标识其父模型。
    * `version` 是语义模型版本。
    * `platforms` 和 `exportable_to` 描述了可用的工件和可能的导出目标。

#### 属性

##### model_name

调用者请求时父模型的名称。某些列表操作将其保留为 `None` 以避免额外的 API 请求。

##### team_id

##### user_id
