> ## 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.

# AI Suite

[AI Suite](https://github.com/andrewyng/aisuite) は、統一されたインターフェースを通じて複数の大規模言語モデル (LLM) へのアクセスを簡素化するフレームワークです。以下の手順に従って、AI Suite のインターフェース経由で SambaNova API を連携・活用します。

## 前提条件

作業を始める前に、以下の環境を準備してください。

* SambaCloud の API キー。[SambaCloud](https://cloud.sambanova.ai/?utm_source=aisuite\&utm_medium=external\&utm_campaign=cloud_signup) アカウントを作成し、API keys タブから取得してください。
* Python 3.9 以上がインストールされていること。

## インストールとセットアップ

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

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

  <Step title="リクエストの送信">
    コード内で SambaNova のモデル名の前に `sambanova:` プレフィックスを付けます (例: `sambanova:Llama-4-Maverick-17B-128E-Instruct`)。下記の [サンプルコード](#サンプルコード) セクションと [対応モデル](/docs/ja/models/sambacloud-models) の一覧をご参照ください。
  </Step>
</Steps>

## サンプルコード

```python theme={}
import aisuite as ai
client = ai.Client()

models = ["sambanova:Llama-4-Maverick-17B-128E-Instruct", "sambanova:DeepSeek-V3.1"]

messages = [
    {"role": "system", "content": "Respond in Pirate English."},
    {"role": "user", "content": "Tell me a joke."},
]

for model in models:
    response = client.chat.completions.create(
        model=model,
        messages=messages,
        temperature=0.75
    )
    print(response.choices[0].message.content)
```

この方法は、同じコードベースで複数プロバイダーの応答速度や精度を比較できる点で便利です。たとえば、モデルのリストに `openai:gpt-4o` を他のモデルと並べて含めることができます。

詳細については、GitHub 上の [AI Suite の README](https://github.com/andrewyng/aisuite/tree/main) をご参照ください。

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

<AccordionGroup>
  <Accordion title="AuthenticationError または API キーの未設定">
    * `SAMBANOVA_API_KEY` がエクスポートされていることを確認します: `echo $SAMBANOVA_API_KEY`
    * 再度エクスポートし、ターミナルまたはスクリプトを再起動します
  </Accordion>

  <Accordion title="モデルが見つからない、またはプレフィックスが不正">
    * モデル名に `sambanova:` プレフィックスが付いていることを確認します (例: `sambanova:Llama-4-Maverick-17B-128E-Instruct`)
    * 利用可能なモデルは [SambaCloud モデルページ](/docs/ja/models/sambacloud-models) でご確認ください
  </Accordion>

  <Accordion title="Python のバージョンエラー">
    * AI Suite には Python 3.9 以上が必要です。`python --version` でご確認ください
  </Accordion>
</AccordionGroup>