如何安装和使用 Hugging Face Unity API

news2025/10/31 15:54:57

Hugging Face Unity API 提供了一个简单易用的接口，允许开发者在自己的 Unity 项目中方便地访问和使用 Hugging Face AI 模型，已集成到 Hugging Face Inference API 中。本文将详细介绍 API 的安装步骤和使用方法。

安装步骤

打开您的 Unity 项目
导航至菜单栏的 Window -> Package Manager
在弹出窗口中，点击 +，选择 Add Package from git URL
输入 https://github.com/huggingface/unity-api.git
安装完成后，将会弹出 Unity API 向导。如未弹出，可以手动导航至 Window -> Hugging Face API Wizard

在向导窗口输入您的 API 密钥。密钥可以在您的 Hugging Face 帐户设置中找到或创建
输入完成后可以点击 Test API key 测试 API 密钥是否正常
如需替换使用模型，可以通过更改模型端点实现。您可以访问 Hugging Face 网站，找到支持 Inference API 的任意模型端点，在对应页面点击 Deploy -> Inference API，复制 API_URL 字段的 url 地址
如需配置高级设置，可以访问 unity 项目仓库页面 https://github.com/huggingface/unity-api 查看最新信息
如需查看 API 使用示例，可以点击 Install Examples。现在，您可以关闭 API 向导了。

API 设置完成后，您就可以从脚本中调用 API 了。让我们来尝试一个计算文本句子相似度的例子，脚本代码如下所示:

using HuggingFace.API;

/* other code */

// Make a call to the API
void Query() {
    string inputText = "I'm on my way to the forest.";
    string[] candidates = {
        "The player is going to the city",
        "The player is going to the wilderness",
        "The player is wandering aimlessly"
    };
    HuggingFaceAPI.SentenceSimilarity(inputText, OnSuccess, OnError, candidates);
}

// If successful, handle the result
void OnSuccess(float[] result) {
    foreach(float value in result) {
        Debug.Log(value);
    }
}

// Otherwise, handle the error
void OnError(string error) {
    Debug.LogError(error);
}

/* other code */