注釈

こんにちは、SunFounder Raspberry Pi & Arduino & ESP32 Enthusiast Community on Facebookへようこそ！他の愛好家と一緒に、Raspberry Pi、Arduino、ESP32の世界により深く入り込みましょう。

参加する理由

• 専門家サポート: 購入後の問題や技術的な課題を、コミュニティと私たちのチームの助けを借りて解決します。

• 学習と共有: ヒントやチュートリアルを交換して、スキルを向上させましょう。

• 限定プレビュー: 新製品の発表や先行プレビューに早期アクセスできます。

• 特別割引: 最新製品を特別割引でお楽しみいただけます。

• 季節限定キャンペーンとプレゼント: プレゼント企画やホリデーキャンペーンに参加しましょう。

👉 一緒に発見し、創造する準備はできましたか？ [こちら] をクリックして、今すぐ参加しましょう！

5. オンラインLLMへの接続

このレッスンでは、Fusion HAT+（または Raspberry Pi）を、さまざまな オンライン大規模言語モデル（LLM） に接続する方法を学びます。 各プロバイダーは API キーが必要で、選択できるモデルもそれぞれ異なります。

ここでは次の内容を扱います：

• API キーを安全に作成し、保存する方法

• 目的に合ったモデルの選び方

• サンプルコードを実行してモデルとチャットする方法

各プロバイダーごとに、手順を順番に確認していきましょう。

---

OpenAI

OpenAI は GPT-4o や GPT-4.1 などの強力なモデルを提供しており、テキスト処理だけでなくビジョンタスクにも利用できます。

設定手順は以下の通りです：

APIキーの取得と保存

1. OpenAI Platform にアクセスしてログインします。 API keys ページで Create new secret key をクリックします。

   

2. 必要事項（Owner、Name、Project、必要に応じて権限）を入力し、 Create secret key をクリックします。

   

3. キーが作成されたら、すぐにコピーしてください。後から再表示できません。紛失した場合は新しく作成し直す必要があります。

   

4. プロジェクトフォルダ（例： / ）内に secret.py というファイルを作成します：

   cd ~/ai-lab-kit/llm
   sudo nano secret.py
   

5. ファイルにキーを次のように貼り付けます：

   # secret.py
   # Store secrets here. Never commit this file to Git.
   OPENAI_API_KEY = "sk-xxx"
   

請求設定の有効化と利用可能モデルの確認

1. キーを使用する前に、OpenAI アカウントの Billing ページで支払い情報を追加し、少額のクレジットをチャージしてください。

   

2. 続いて Limits ページで、アカウントで利用可能なモデルを確認し、コードで使用する正確なモデルIDをコピーします。

   

サンプルコードで動作確認

1. サンプルコードを開きます：

   cd ~/ai-lab-kit/llm
   sudo nano llm_test.py
   

2. 下のコードに置き換え、 model="xxx" を使用したいモデル（例： gpt-4o ）に変更します：

   from fusion_hat.llm import OpenAI
   from secret import OPENAI_API_KEY
   
   INSTRUCTIONS = "You are a helpful assistant."
   WELCOME = "Hello, I am a helpful assistant. How can I help you?"
   
   llm = OpenAI(
      api_key=OPENAI_API_KEY,
      model="gpt-4o",
   )
   

   保存して終了します（ Ctrl+X → Y → Enter ）。

3. 最後にテストを実行します：

   sudo python3 llm_test.py
   

これでターミナルから Fusion HAT+ と直接チャットできます。

---

Gemini

Gemini は Google の AI モデルファミリーです。高速で、汎用的な用途に適しています。

APIキーの取得と保存

1. Google AI Studio にログインし、API Keys ページへ移動します。

   

2. 右上の Create API key ボタンをクリックします。

   

3. 既存プロジェクト用、または新規プロジェクト用としてキーを作成できます。

   

4. 生成された API キーをコピーします。

   

5. プロジェクトフォルダで：

   cd ~/ai-lab-kit/llm
   sudo nano secret.py
   

6. キーを貼り付けます：

    # secret.py
    # Store secrets here. Never commit this file to Git.
   GEMINI_API_KEY = "AIxxx"
   

利用可能モデルの確認

公式の Gemini Models ページを開くと、モデル一覧、正確な API ID、最適化された用途などを確認できます。

サンプルコードで動作確認

1. テストファイルを開きます：

   cd ~/ai-lab-kit/llm
   sudo nano llm_test.py
   

2. 下のコードに置き換え、 model="xxx" を使用したいモデル（例： gemini-2.5-flash ）に変更します：

   from fusion_hat.llm import Gemini
   from secret import GEMINI_API_KEY
   
   INSTRUCTIONS = "You are a helpful assistant."
   WELCOME = "Hello, I am a helpful assistant. How can I help you?"
   
   llm = Gemini(
      api_key=GEMINI_API_KEY,
      model="gemini-2.5-flash",
   )
   

3. 保存して実行します：

   sudo python3 llm_test.py
   

これでターミナルから Fusion HAT+ と直接チャットできます。

---

Qwen

Qwen は Alibaba Cloud が提供する大規模言語／マルチモーダルモデルのファミリーです。 テキスト生成、推論、画像解析などのマルチモーダル理解に対応しています。

APIキーの取得

Qwen モデルを呼び出すには API Key が必要です。 海外ユーザーの多くは DashScope International（Model Studio） コンソールを利用してください。 中国本土のユーザーは代わりに Bailian（百炼） コンソールを利用できます。

• 海外ユーザー向け

  1. Alibaba Cloud の公式 Get API Key ページへアクセスします。

  2. Alibaba Cloud アカウントでサインイン、または新規作成します。

  3. Model Studio に移動します（Singapore または Beijing リージョンを選択）。

     • ページ上部に「Activate Now」の表示がある場合はクリックして有効化し、無料枠を受け取ります（Singapore のみ）。

     • 有効化は無料で、無料枠を使い切った後にのみ課金されます。

     • 有効化の案内が表示されない場合、すでにサービスは有効です。

  4. Key Management ページへ移動します。 API Key タブで Create API Key をクリックします。

  5. 作成後、API Key をコピーして安全に保管します。

  

  注釈

  香港・マカオ・台湾のユーザーも International（Model Studio） を選択してください。

• 中国本土ユーザー向け

  中国本土の場合は Alibaba Cloud Bailian（百炼） コンソールを利用できます：

  1. Bailian console （百炼コンソール）にログインし、アカウント認証を完了します。

  2. Create API Key を選択します。モデルサービス未開通の案内が出た場合は Activate をクリックし、規約に同意して無料枠を受け取ります。有効化後に Create API Key ボタンが利用可能になります。

     

  3. 再度 Create API Key をクリックし、アカウントを確認して Confirm をクリックします。

     

  4. 作成後、API Key をコピーします。

     

APIキーの保存

1. プロジェクトフォルダで：

   cd ~/ai-lab-kit/llm
   sudo nano secret.py
   

2. 次のようにキーを貼り付けます：

   # secret.py
   # Store secrets here. Never commit this file to Git.
   
   QWEN_API_KEY = "sk-xxx"
   

サンプルコードで動作確認

1. テストファイルを開きます：

   cd ~/ai-lab-kit/llm
   sudo nano llm_test.py
   

2. 下のコードに置き換え、 model="xxx" を使用したいモデル（例： qwen-plus ）に変更します：

   from fusion_hat.llm import Qwen
   from secret import QWEN_API_KEY
   
   INSTRUCTIONS = "You are a helpful assistant."
   WELCOME = "Hello, I am a helpful assistant. How can I help you?"
   
   llm = Qwen(
      api_key=QWEN_API_KEY,
      model="qwen-plus",
   )
   

3. 次のコマンドで実行します：

   sudo python3 llm_test.py
   

これでターミナルから Fusion HAT+ と直接チャットできます。

Grok (xAI)

Grok は xAI が提供する会話型AIで、Elon Musk のチームによって開発されています。xAI API を通じて接続できます。

APIキーの取得と保存

1. xAI Cloud Console でアカウント登録を行います。事前にクレジットを追加してください。クレジットがない場合、API は動作しません。

2. API Keys ページへ移動し、 Create API key をクリックします。

   

3. キーの名前を入力し、 Create API key をクリックします。

   

4. 生成されたキーをコピーして安全に保管します。

   

5. プロジェクトフォルダで：

   cd ~/ai-lab-kit/llm
   sudo nano secret.py
   

6. 次のようにキーを貼り付けます：

   # secret.py
   # Store secrets here. Never commit this file to Git.
   
   GROK_API_KEY = "xai-xxx"
   

利用可能モデルの確認

xAI コンソールの Models ページで、チームで利用可能なモデル一覧と正確な API ID を確認できます。これらの ID をコードで使用します。

サンプルコードで動作確認

1. テストファイルを開きます：

   cd ~/ai-lab-kit/llm
   sudo nano llm_test.py
   

2. 下のコードに置き換え、 model="xxx" を使用したいモデル（例： grok-4-latest）に変更します：

   from fusion_hat.llm import Grok
   from secret import GROK_API_KEY
   
   INSTRUCTIONS = "You are a helpful assistant."
   WELCOME = "Hello, I am a helpful assistant. How can I help you?"
   
   llm = Grok(
      api_key=GROK_API_KEY,
      model="grok-4-latest",
   )
   

3. 次のコマンドで実行します：

   sudo python3 llm_test.py
   

これでターミナルから Fusion HAT+ と直接チャットできます。

---

DeepSeek

DeepSeek は中国の LLM プロバイダーで、手頃な価格で実用的なモデルを提供しています。

APIキーの取得と保存

1. Deepseek Platform にログインします。

2. 右上メニューから API Keys → Create API Key を選択します。

   

3. 名前を入力して Create をクリックし、キーをコピーします。

   

4. プロジェクトフォルダで：

   cd ~/ai-lab-kit/llm
   sudo nano secret.py
   

5. キーを追加します：

   # secret.py
   DEEPSEEK_API_KEY = "sk-xxx"
   

課金の有効化

まずアカウントへのチャージが必要です。少額（例：10元程度）から始めるのがおすすめです。

利用可能モデル

執筆時点（2025-09-12）で、DeepSeek が提供しているモデルは次の通りです：

• deepseek-chat

• deepseek-reasoner

サンプルコードで動作確認

1. テストファイルを開きます：

   cd ~/ai-lab-kit/llm
   sudo nano llm_test.py
   

2. 下のコードに置き換え、 model="xxx" を使用したいモデル（例： deepseek-chat ）に変更します：

   from fusion_hat.llm import Deepseek
   from secret import DEEPSEEK_API_KEY
   
   INSTRUCTIONS = "You are a helpful assistant."
   WELCOME = "Hello, I am a helpful assistant. How can I help you?"
   
   llm = Deepseek(
      api_key=DEEPSEEK_API_KEY,
      model="deepseek-chat",
      max_messages=20,
   )
   

3. 実行します：

   sudo python3 llm_test.py
   

これでターミナルから Fusion HAT+ と直接チャットできます。

---

Doubao

Doubao は ByteDance の AI モデルプラットフォーム（Volcengine Ark）です。

APIキーの取得と保存

1. Volcengine にログインします。

2. 左メニューを下にスクロールし、 API Key Management → Create API Key を選択します。

   

3. 名前を設定して Create をクリックします。

   

4. Show API Key アイコンをクリックしてコピーします。

   

5. プロジェクトフォルダで：

   cd ~/ai-lab-kit/llm
   sudo nano secret.py
   

6. キーを追加します：

   # secret.py
   DOUBAO_API_KEY = "xxx"
   

モデルの選択

1. モデルマーケットプレイスに移動してモデルを選択します。

   

2. 例として Doubao-seed-1.6 を選択し、 API 接入 をクリックします。

   

3. API Key を選択し、 Use API をクリックします。

   

4. Enable Model をクリックします。

   

5. モデルIDにカーソルを合わせてコピーします。

   

サンプルコードで動作確認

1. テストファイルを開きます：

   cd ~/ai-lab-kit/llm
   sudo nano llm_test.py
   

2. 下のコードに置き換え、 model="xxx" を使用したいモデル（例： doubao-seed-1-6-250615 ）に変更します：

   from fusion_hat.llm import Doubao
   from secret import DOUBAO_API_KEY
   
   INSTRUCTIONS = "You are a helpful assistant."
   WELCOME = "Hello, I am a helpful assistant. How can I help you?"
   
   llm = Doubao(
      api_key=DOUBAO_API_KEY,
      model="doubao-seed-1-6-250615",
   )
   

3. 次のコマンドで実行します：

   sudo python3 llm_test.py
   

これでターミナルから Fusion HAT+ と直接チャットできます。

General

このプロジェクトは、統一されたインターフェースを通じて複数の LLM プラットフォームへ接続できるように設計されています。 標準で次のプラットフォームに対応しています：

• OpenAI （ChatGPT / GPT-4o、GPT-4、GPT-3.5）

• Gemini （Google AI Studio / Vertex AI）

• Grok （xAI）

• DeepSeek

• Qwen（通义千问）

• Doubao（豆包）

さらに、 OpenAI API 互換フォーマット に対応した 他の任意の LLM サービス にも接続できます。 その場合は、該当プラットフォームの API Key と正しい base_url を手動で用意してください。

APIキーの取得と保存

1. 利用したいプラットフォームから API Key を取得します（詳細は各社の公式コンソールを参照してください）。

2. プロジェクトフォルダで新しいファイルを作成します：

   cd ~/ai-lab-kit/llm/
   nano secret.py
   

3. secret.py にキーを追加します：

   # secret.py
   API_KEY = "your_api_key_here"
   

警告

API Key は必ず非公開にしてください。 secret.py を公開リポジトリへアップロードしないでください。

サンプルコードで動作確認

1. テストファイルを開きます：

   cd ~/ai-lab-kit/llm/
   sudo nano llm_others.py
   

2. 以下の例に置き換え、プラットフォームに合わせて正しい base_url と model を入力します：

   注釈

   base_url について： 本プロジェクトは OpenAI API 形式 、およびそれと 互換 のある API をサポートします。 base_url はプロバイダーごとに異なるため、各社ドキュメントを確認してください。

   from fusion_hat.llm import LLM
   from secret import API_KEY
   
   INSTRUCTIONS = "You are a helpful assistant."
   WELCOME = "Hello, I am a helpful assistant. How can I help you?"
   
   llm = LLM(
      base_url = f"",
      api_key=API_KEY,
      model="",
   )
   

3. プログラムを実行します：

   sudo python3 llm_others.py