Hugging Face Unity APIのインストールと使用方法

Hugging Face Unity APIのインストールと使用方法

Hugging Face Unity APIは、Hugging Face Inference APIの簡単に使用できる統合です。これにより、開発者はUnityプロジェクトでHugging Face AIモデルにアクセスして使用することができます。このブログ投稿では、Hugging Face Unity APIのインストールと使用方法について説明します。

インストール

1. Unityプロジェクトを開きます
2. Window -> Package Managerに移動します
3. +をクリックし、Add Package from git URLを選択します
4. https://github.com/huggingface/unity-api.gitを入力します
5. インストールが完了すると、Unity APIウィザードが表示されます。表示されない場合は、Window -> Hugging Face API Wizardに移動します

1. APIキーを入力します。APIキーはHugging Faceアカウントの設定で作成できます。
2. APIウィザードでTest API keyをクリックしてAPIキーをテストします。
3. 必要に応じて、モデルのエンドポイントを変更して使用するモデルを変更します。推論APIをサポートするモデルのモデルエンドポイントは、Hugging Faceのウェブサイトのモデルに移動し、Deploy -> Inference APIをクリックし、API_URLフィールドからURLをコピーすることで見つけることができます。
4. 必要に応じて詳細な設定を構成します。最新の情報については、プロジェクトのリポジトリをhttps://github.com/huggingface/unity-apiで確認してください。
5. APIの使用例を確認するには、Install Examplesをクリックします。それではAPIウィザードを閉じることができます。

APIの設定が完了したので、スクリプトからAPIに対して呼び出しを行うことができます。以下は、センテンス類似度のタスクを実行する例です:

• StarCoder：コードのための最先端のLLM
• テキストからビデオへのモデルの深掘り
• スターコーダーでコーディングアシスタントを作成する

using HuggingFace.API;

/* 他のコード */

// APIに呼び出しを行う
void Query() {
    string inputText = "私は森に向かっています。";
    string[] candidates = {
        "プレイヤーは都市に向かっています",
        "プレイヤーは野生地域に向かっています",
        "プレイヤーは彷徨っています"
    };
    HuggingFaceAPI.SentenceSimilarity(inputText, OnSuccess, OnError, candidates);
}

// 成功した場合の処理
void OnSuccess(float[] result) {
    foreach(float value in result) {
        Debug.Log(value);
    }
}

// エラーの場合の処理
void OnError(string error) {
    Debug.LogError(error);
}

/* 他のコード */

サポートされているタスクとカスタムモデル

Hugging Face Unity APIは、以下のタスクも現在サポートしています:

• 会話
• テキスト生成
• テキストから画像へ
• テキスト分類
• 質問応答
• 翻訳
• 要約
• 音声認識

これらのタスクを実行するには、HuggingFaceAPIクラスが提供する対応するメソッドを使用します。

Hugging Face上でホストされている独自のカスタムモデルを使用するには、APIウィザードでモデルエンドポイントを変更します。

使用上の注意点

1. APIは非同期で呼び出しを行い、コールバックを介して応答またはエラーを返します。
2. 応答時間の遅さやパフォーマンスの問題に対処するには、リソースの少ないモデルへのモデルエンドポイントの変更を行います。

結論

Hugging Face Unity APIは、AIモデルをUnityプロジェクトに簡単に統合する方法を提供します。このチュートリアルがお役に立てたことを願っています。質問がある場合やHugging Face for Gamesの使用に関してもっと深く関わりたい場合は、Hugging Face Discordに参加してください。

We will continue to update VoAGI; if you have any questions or suggestions, please contact us!