> ## 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.
# Hugging Face
[Hugging Face](https://huggingface.co/) は、オープンソースモデルの構築、学習、デプロイを行うためのプラットフォームです。SambaNova を推論プロバイダーとして利用することで、Hugging Face 経由で SambaNova のモデルにアクセスできます。
## 前提条件
* [SambaCloud アカウント](https://cloud.sambanova.ai?utm_source=huggingface\&utm_medium=external\&utm_campaign=cloud_signup)
* [SambaNova API キー](https://cloud.sambanova.ai/apis?utm_source=huggingface\&utm_medium=external\&utm_campaign=cloud_signup)
* [Hugging Face アカウント](https://huggingface.co/)
## セットアップ
Hugging Face のアカウント設定を開き、**Inference Providers** に移動して SambaNova を有効化します。
プロバイダー設定に SambaCloud API キーを入力します。
API キーは [SambaCloud ポータル](https://cloud.sambanova.ai/apis?utm_source=huggingface\&utm_medium=external\&utm_campaign=cloud_signup)から取得できます。
## 利用方法
Inference API の利用方法は 2 通りあります。
* **Custom key**: リクエストはお持ちの API キーを使用して SambaNova に直接送信されます。利用料金は SambaNova アカウントに請求されます。
* **Routed by HF**: リクエストは Hugging Face 経由でルーティングされるため、プロバイダーの API キーを別途用意する必要はありません。利用料金は Hugging Face アカウントに請求されます。
## Python SDK の利用
必要なパッケージをインストールします。
```bash theme={}
pip install "huggingface_hub>=0.28.0"
```
以下の例は、SambaNova を推論プロバイダーとしてモデルを実行する方法を示しています。認証には SambaCloud API キーを使用できます。
```python theme={}
from huggingface_hub import InferenceClient
client = InferenceClient(
provider="sambanova",
api_key="your-sambanova-api-key" # SambaNova API key, not your Hugging Face token
)
messages = [
{
"role": "user",
"content": "What is the capital of France?"
}
]
completion = client.chat.completions.create(
model="meta-llama/Llama-3.3-70B-Instruct",
messages=messages,
max_tokens=500
)
print(completion.choices[0].message.content)
```
## 参考情報
* [Hugging Face Inference Providers ドキュメント](https://huggingface.co/docs/inference-providers/index)
## トラブルシューティング
Hugging Face アカウントが認証済みで、サードパーティの推論プロバイダーを利用できる状態であることを確認してください。詳細は [Hugging Face Inference Providers ドキュメント](https://huggingface.co/docs/inference-providers/index)をご確認ください。
SDK の `api_key` パラメータに指定するのは、Hugging Face トークンではなく **SambaNova API キー** です。これが 401 エラーの最も一般的な原因です。
1. コード内のキーが [SambaNova API ダッシュボード](https://cloud.sambanova.ai/apis?utm_source=huggingface\&utm_medium=external\&utm_campaign=cloud_signup)のキーと一致していることを確認してください。
2. キーが期限切れまたは失効している場合は、ダッシュボードから新しいキーを生成し、Hugging Face の **Inference Providers** 設定とコードの両方を更新してください。
`pip install --upgrade "huggingface_hub>=0.28.0"` でアップグレードしてください。