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

# API キーのモデルアクセス

モデルアクセスは、個々の API キーが呼び出せるモデルを制御します。チームで有効になっているモデル範囲は変更されません。その範囲内で、特定のキーが呼び出しを許可されるモデルのセットを絞り込むだけです。キーのアクセス範囲外のモデルへの呼び出しは拒否されます。

<Info>
  この機能は LLM 製品ラインのモデルを対象としています。スタンドアロンの画像および動画のマルチモーダル機能は、現時点ではモデルアクセス設定の対象外です。
</Info>

一般的なユースケース:

* **用途別にキーを分離する**: 本番環境用のキーでは安定したモデルのみを利用できるようにし、実験用のキーでは低コストのモデルのみを利用できるようにします。
* **リスクを迅速に抑える**: キーが予期しない高コストモデルの呼び出しを発生させた場合、そのキーをいくつかの安全なモデルに制限します。
* **外部との共同作業**: 請負業者やパートナーと共有するキーでは、合意済みのモデルのみを公開します。

## アクセスモード

各 API キーには、次の 2 つのアクセスモードのいずれかがあります。

| アクセスモード    | 意味                                                                                                     |
| :--------- | :----------------------------------------------------------------------------------------------------- |
| すべての有効なモデル | デフォルトモードです。キーは、チームで現在有効になっているすべてのモデルと、今後有効になるモデルにアクセスでき、特定のモデルを除外できます。今後有効になるモデルは、除外されない限りアクセス可能なままです。 |
| 選択したモデルのみ  | キーは、選択したモデルのみにアクセスできます。チームで後から有効にしたモデルは自動的に追加されません。自分で追加する必要があります。                                     |

どちらのモードでも、アクセス可能なモデルがチームで有効になっているモデル範囲を超えることはなく、オフラインになったモデルが含まれることもありません。

* すべての有効なモデル: アクセス可能なモデル = チームで有効なモデル（将来のものを含む）− 除外されたモデル。
* 選択したモデルのみ: アクセス可能なモデル = 選択されたモデル（チームで有効なモデルとの積集合）。

## モデルアクセスを設定する

<Note>
  API キーのモデルアクセスを設定できるのはチーム管理者のみです。Developer および Basic メンバーは、アクセス可能なキーについて読み取り専用の概要を確認できますが、編集はできません。Billing メンバーにはモデルアクセスは一切表示されません。
</Note>

<Steps>
  <Step title="Key Management を開く">
    [Key Management](https://novita.ai/settings/key-management) に移動し、設定したい API キーを見つけます。
  </Step>

  <Step title="モデルアクセス設定を開く">
    キーの作成中または編集中に、**Model Access** セクションを開きます。
  </Step>

  <Step title="アクセスモードを選択する">
    **All enabled models** または **Selected models only** を選択します。

    * **All enabled models** の場合、ブロックしたいモデルを **Excluded models** に追加します。
    * **Selected models only** の場合、少なくとも 1 つのモデルを **Accessible models** に追加します。
  </Step>

  <Step title="保存する">
    保存後、新しいモデルアクセス設定が有効になるまでに少し時間がかかる場合があります。
  </Step>
</Steps>

<Tip>
  新しいキーを作成する場合や既存のキーを編集する場合、同じチーム内の別のキーの設定を **Copy config** と **Paste config** で再利用できます。貼り付け後、そのまま保存することも、先に調整することもできます。
</Tip>

## モデルがオフラインになった場合

モデルがプラットフォームによってオフラインにされると、そのモデルは利用可能なモデルのセットから外れます。

* そのモデルへのすべての呼び出しは、直ちに "model unavailable" レスポンスを返します。
* キーの保存済み設定にオフラインのモデルがまだ含まれている場合、そのモデルは表示されたままですがグレーアウトされます。保存する前に削除する必要があります。削除しないと、設定を保存できません。

## 呼び出しが拒否された場合

API キーがアクセス範囲外のモデルを呼び出すと、その呼び出しは HTTP 403 とエラーコード `model_access_denied` を返し、そのキーがそのモデルにアクセスできないことを示します。キーのモデルアクセスを調整するには、チーム管理者に連絡してください。[Common Error Codes](/docs/ja/guides/error) も参照してください。

キーのモデルアクセスをプログラムで管理するには、[Get API Key Model Access Policy](/docs/ja/api-reference/key-get-model-access-policy) を参照してください。