Ultralytics HUB-SDK

欢迎阅读 Ultralytics HUB-SDK 文档！如果您希望将强大的机器学习工具和服务集成到您的 python 应用程序中，那么您来对地方了。无论您是人工智能爱好者、经验丰富的机器学习从业者，还是希望利用 Ultralytics 服务功能的软件开发人员，我们的 SDK 都能让这一切变得简单高效。

我们友好且专业的文档将引导您从安装到精通HUB-SDK。让我们深入探索，开始在您的项目中充分利用Ultralytics生态系统的强大功能！

从哪里开始

准备好开始使用 HUB-SDK 了吗？我们的快速入门指南提供了一条在您的 Python 环境中启动并运行 SDK 的简单途径。

• 访问 Quickstart 页面，加速您的开发并简化您的设置。

从 PyPI 安装

通过 PyPI 获取 HUB-SDK 的最新稳定版本。只需在您的终端或 shell 中执行以下命令，即可将 SDK 无缝添加到您的 Python 项目中：

pip install hub-sdk

运行此命令后，将下载并安装 SDK，从而在您的应用程序中解锁 Ultralytics 服务的各项功能。

初始化 HUBClient

与 Ultralytics 服务的集成始于初始化一个 HUBClient 对象。这个关键步骤在您的代码和我们的 API 之间建立了一座桥梁，并且需要适当的凭据进行身份验证。您可以选择标准的 API 密钥方法，或者使用您的电子邮件和密码。让我们一起设置它！🚀

选项 1：使用 API 密钥

要利用 API 密钥的简易性，请准备一个包含您的密钥的字典，如下所示：

# Replace <YOUR-API-KEY> with the actual key provided to you by Ultralytics.
credentials = {"api_key": "<YOUR-API-KEY>"}

使用 API 密钥是一种常见的身份验证方法，适用于程序化访问。它非常适合将密钥直接集成到框架中以实现快速、安全的服务交互的场景。该 HUBClient 类 继承身份验证功能 来自 Auth 类。

选项 2：使用电子邮件和密码

想要使用您的账户凭据？请配置 HUBClient 在凭据字典中使用您的电子邮件和密码：

# Replace <YOUR-EMAIL> with your email address and <YOUR-PASSWORD> with your password.
credentials = {"email": "<YOUR-EMAIL>", "password": "<YOUR-PASSWORD>"}

如果您正在寻找传统的登录体验或旨在利用与您的 Ultralytics 帐户相关的个性化功能，则使用您的电子邮件和密码是一个方便的选择。

整合在一起

现在您的凭据已准备就绪，请启动您的 HUBClient:

from hub_sdk import HUBClient

credentials = {"api_key": "<YOUR-API-KEY>"}  # api key
client = HUBClient(credentials)

from hub_sdk import HUBClient

credentials = {"email": "<YOUR-EMAIL>", "password": "<YOUR-PASSWORD>"}  # email and password
client = HUBClient(credentials)

这关键的代码行创建了一个新的实例 HUBClient，将您连接到 Ultralytics 平台提供的广阔服务领域。有了安全就位的身份验证详细信息，您就可以开始探索触手可及的功能了！The login 方法 处理身份验证 使用提供的凭据。

HUB-SDK 功能

Ultralytics HUB-SDK 提供了一系列功能，用于与您的机器学习项目进行交互。以下是您可以执行的一些关键操作：

• 数据集管理: 使用以下方式与数据集交互 dataset 方法，它返回一个 Datasets 对象。您可以 获取, 创建, 更新, 删除, 列表, 获取数据集访问的 URL和 上传 数据集。
• 数据集列表: 使用以下方式获取数据集列表 dataset_list 方法，它返回一个 DatasetList 对象。
• 项目管理：通过获取、创建、更新或删除来管理您的项目。

恭喜您成功设置 Ultralytics HUB-SDK！您现在已准备就绪，可以开始将尖端机器学习服务集成到您的应用程序中。查阅我们的更多文档，以获取有关使用特定 API 的指导，如果您遇到任何障碍，请咨询我们的社区论坛。祝您编程愉快，愿您的项目在 Ultralytics 的强大支持下蓬勃发展！🌟

评论