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

# 専用モデルのデプロイを接続

> ワークスペースのモデルカタログに、プライベートな OpenAI 互換エンドポイントを追加します。

プライベートモデルを使うと、チームは通常の Phaseo API を通じて専用またはセルフホストのデプロイを呼び出せます。モデルはワークスペースの認証済みメンバーにのみ表示され、公開モデル ID を指定できる場所で利用できます。

一般的な接続先には、Baseten、Modal、RunPod、Fireworks、Together の専用デプロイや、vLLM または別の OpenAI 互換サーバーを実行するサービスがあります。

## 始める前に

デプロイには以下が必要です。

* 公開された HTTPS ベース URL。
* OpenAI 互換の `/chat/completions` エンドポイント。
* Bearer トークン認証。
* そのエンドポイントが受け付ける提供元のモデル ID またはデプロイ ID。

`/responses` への対応は任意です。デプロイがそのエンドポイントを明示的に実装していない限り、無効のままにしてください。

<Warning>
  プライベートモデルは、プロバイダー独自のプロトコルやカスタム認証方式を変換しません。そうしたデプロイには OpenAI 互換のレイヤーを追加するか、Phaseo が対応するプロバイダー連携を使用してください。
</Warning>

## デプロイを接続

<Steps>
  <Step title="プライベートモデルを開く">
    **ダッシュボード → 設定 → ワークスペース → プライベートモデル**を開き、**モデルを追加**を選択します。ワークスペースのオーナーまたは管理者である必要があります。
  </Step>

  <Step title="モデルに名前を付ける">
    既存のカタログモデルを選んでこのデプロイをそのプロバイダー一覧に追加するか、`legal-assistant` のような短いモデルスラッグを入力します。その一意のスラッグを持つカタログモデルがなければ、Phaseo は信頼されたワークスペースの名前空間と組み合わせます。

    ```text theme={null}
    acme/legal-assistant
    ```

    ワークスペースの名前空間は選択や変更ができません。カタログの正確な ID を指定すると、公開上の識別情報を変えずにそのモデルに接続されます。
  </Step>

  <Step title="エンドポイントを設定">
    推論パスを含めずにベース URL を入力します。例：

    ```text theme={null}
    https://model.example.com/v1
    ```

    `/chat/completions` や `/responses` は含めないでください。提供元の正確なモデル ID またはデプロイ ID は別途入力します。Phaseo はリクエストを転送する際にその ID を使用します。
  </Step>

  <Step title="認証情報を保存">
    デプロイの API キーを入力します。Phaseo は認証情報を暗号化し、保存後に返すことはありません。後からモデルの設定ページで変更できます。
  </Step>

  <Step title="モデルを呼び出す">
    生成されたモデル ID を通常の Chat Completions エンドポイントで使用します。

    ```bash cURL theme={null}
    curl https://api.phaseo.app/v1/chat/completions \
      -H "Authorization: Bearer $PHASEO_API_KEY" \
      -H "Content-Type: application/json" \
      -d '{
        "model": "acme/legal-assistant",
        "messages": [{"role": "user", "content": "Summarize this contract."}]
      }'
    ```

    呼び出しに使う API キーは、プライベートモデルと同じワークスペースに属している必要があります。
  </Step>
</Steps>

## ルーティングの仕組み

プライベートモデルはカタログモデルと同じ Phaseo リクエストインターフェースを使用します。独立したワークスペースモデルは、設定されたエンドポイントにのみルーティングされます。カタログモデルに接続されたエンドポイントは、**優先**、**通常プール**、**フォールバックのみ**のポリシーに従って、そのモデルのプロバイダー一覧に追加されます。Phaseo は保存された認証情報を Bearer トークンとして送信し、設定された提供元のモデル ID を使用します。

プライベートモデルが公開プロバイダールートになることはなく、他のワークスペースには表示されません。有効なプライベートモデルは認証済みのモデルカタログに含まれ、**プライベート**フィルターに表示されます。

<Note>
  既存のカタログモデルにプライベートデプロイを追加または有効化した後は、API レイヤーに変更が反映されるまで 5～10 秒待ってからルーティングをテストしてください。その間、リクエストは既存の公開プロバイダーを使い続ける場合があります。すでに処理中のリクエストは再ルーティングされません。
</Note>

## プロバイダーの例

| デプロイ | 入力する内容 |
| - | - |
| Baseten の専用エンドポイント | OpenAI 互換のベース URL、デプロイのモデル ID、API キー |
| Modal の Web エンドポイント | OpenAI Chat Completions の仕様を実装した公開 HTTPS エンドポイント |
| RunPod のサーバーレスエンドポイント | OpenAI 互換のプロキシ URL と Bearer 認証情報 |
| Fireworks または Together の専用デプロイ | 専用の OpenAI 互換 URL とプロバイダーのモデル ID |
| vLLM | `/v1` で終わる公開 URL と vLLM が提供するモデル名 |

プロバイダーの製品や URL 形式は変更される場合があります。提供元の最新のデプロイドキュメントで、ベース URL、モデル ID、認証方式、対応エンドポイントを確認してください。

## API でプライベートモデルを管理

サーバー側の管理では、必要に応じて `private_models:read`、`private_models:write`、`private_models:delete` を持つ管理キーを使って[プライベートモデル API](../api-reference/endpoint/private-models-list)を利用できます。

作成・更新リクエストの `model_reference` には、カタログの正確なモデル ID または短いスラッグを指定できます。Phaseo が `model_id` を導出するため、クライアントから直接指定することはできません。既存の Phaseo プロバイダーには `host_provider_id` を使い、別の運営者には `custom_provider_name` と任意の `custom_provider_url` を指定してください。

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

* \*\*プロバイダーから 404 が返る：\*\*ベース URL に推論パスが含まれていないことを確認してください。
* **モデルが不明：**提供元のデプロイ ID を**提供元のモデル ID**にコピーしてください。ここには Phaseo ワークスペースのモデル ID を使わないでください。
* \*\*提供元で認証エラー：\*\*保存された認証情報を更新し、プロバイダーが Bearer 認証を受け付けることを確認してください。
* \*\*Chat は動作するが Responses が失敗する：\*\*プロバイダーが `/responses` をネイティブに実装していない限り、**Responses API**を無効にしてください。
* \*\*カタログにモデルが表示されない：\*\*モデルが有効であり、呼び出し元が同じワークスペースで認証されていることを確認してください。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.