> ## Documentation Index
> Fetch the complete documentation index at: https://docs.sambanova.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Gradio

Gradio は、機械学習モデル、API、Python 関数を披露するインタラクティブな Web アプリケーションを構築するための、オープンソースの Python ライブラリです。[sambanova-gradio](https://github.com/gradio-app/sambanova-gradio) パッケージは、SambaNova モデルの統合を簡素化することで Gradio の機能を拡張します。開発者が SambaNova モデルをアプリケーションに接続するための、使いやすいインターフェースを提供します。

sambanova-gradio パッケージの依存関係は OpenAI と Gradio の 2 つです。組み込みのレジストリ関数 `sambanova_gradio.registry` によってセットアップ手順が簡素化され、さまざまなモデルへのシームレスな接続が容易になります。レジストリ関数は `name` パラメータとして `model ID` を受け取ります。スクリプトを実行すると、指定したモデルを使用するアプリケーションインターフェースが自動的に生成されます。

実装の詳細と追加の設定については、[sambanova-gradio の GitHub リポジトリ](https://github.com/gradio-app/sambanova-gradio)をご参照ください。

## 前提条件

* [SambaCloud](https://cloud.sambanova.ai?utm_source=gradio\&utm_medium=external\&utm_campaign=cloud_signup) アカウント
* [SambaNova API キー](https://cloud.sambanova.ai/apis?utm_source=gradio\&utm_medium=external\&utm_campaign=cloud_signup)

## インストール

以下の手順に従って、SambaNova モデルを Gradio と連携させます。

<Steps>
  <Step title="sambanova-gradio パッケージのインストール">
    ```bash theme={}
    pip install sambanova-gradio
    ```
  </Step>

  <Step title="SambaNova API キーの設定">
    ```bash theme={}
    export SAMBANOVA_API_KEY="your-api-key"
    ```
  </Step>
</Steps>

## Gradio インターフェースの作成

以下のように `sambanova_gradio.registry` 関数を使用して、Gradio アプリケーションを構築・起動します。

<Note>
  この Python スクリプトを実行すると、Meta-Llama-3.3-70B-Instruct モデルに接続された Gradio インターフェースが起動します。
</Note>

```python theme={}
import gradio as gr
import sambanova_gradio

gr.load(
    name='Meta-Llama-3.3-70B-Instruct',
    src=sambanova_gradio.registry,
).launch()
```

### インターフェースのカスタマイズ

以下のように、モデルや入出力コンポーネント、その他の設定を `gr.Interface` に指定することで、インターフェースをカスタマイズできます。

```python theme={}
import gradio as gr
import sambanova_gradio

gr.load(
    name='Meta-Llama-3.3-70B-Instruct',
    src=sambanova_gradio.registry,
    title='Sambanova-Gradio Integration',
    description="Chat with Meta-Llama-3.3-70B-Instruct model.",
    examples=["Explain quantum gravity to a 5-year old.", "How many R are there in the word Strawberry?"]
).launch()
```

#### 画面イメージ

上記のコードスニペットを実行すると、以下のようなインターフェースが生成されます。

<Frame>
  <img src="https://mintcdn.com/sambanova-systems/jKa4XES-ZFicbKbW/images/docs/integrations/gradio/gradio1_light.png?fit=max&auto=format&n=jKa4XES-ZFicbKbW&q=85&s=ca7a358113615a31a84ff9bfc1b4361b" alt="Meta-Llama-3.3-70B-Instruct を使った Gradio のチャットインターフェース" className="block dark:hidden" width="2784" height="1710" data-path="images/docs/integrations/gradio/gradio1_light.png" />

  <img src="https://mintcdn.com/sambanova-systems/jKa4XES-ZFicbKbW/images/docs/integrations/gradio/gradio1_dark.png?fit=max&auto=format&n=jKa4XES-ZFicbKbW&q=85&s=9db212c362fd7cfefd0781aabd157b60" alt="Meta-Llama-3.3-70B-Instruct を使った Gradio のチャットインターフェース" className="hidden dark:block" width="2806" height="1712" data-path="images/docs/integrations/gradio/gradio1_dark.png" />
</Frame>

Gradio アプリケーションのその他の例については、[SambaNova の Hugging Face Spaces](/docs/ja/build/hf-spaces) をご覧ください。

## トラブルシューティング

<AccordionGroup>
  <Accordion title="ModuleNotFoundError: No module named 'sambanova_gradio'">
    パッケージがインストールされていないか、別の環境にインストールされています。`pip install sambanova-gradio` を実行し、`pip show sambanova-gradio` でインストール状態を確認してください。
  </Accordion>

  <Accordion title="認証エラーまたは 401 Unauthorized">
    API キーが未設定か無効です。`echo "${SAMBANOVA_API_KEY:0:10}..."` で `SAMBANOVA_API_KEY` が設定されているか確認し、空の場合は再度 export してください。
  </Accordion>

  <Accordion title="モデルが見つからない、またはモデル ID が無効">
    モデル ID が正しいか確認してください。有効な ID は[対応モデル](/docs/ja/models/sambacloud-models)をご参照ください。
  </Accordion>
</AccordionGroup>