---
outline: [2, 3]
head:
  - - meta
    - name: description
      content: OneGateway Playground で API Key とモデルを選んで対話し、画像やテキストファイルをアップロードして、回答と思考過程を確認し、自分の会話を管理します。
---

# Playground

**Playground** は OneGateway のオンライン AI 対話ワークスペースです。ログイン後、コンソールの **Playground** から開くと、ほかのクライアントを設定しなくても、モデルを選んですぐに質問できます。

対話にはあなた自身の API Key が使われ、呼び出しはそのキーのモデル範囲、クォータ、およびアカウントのクォータによって制約されます。会話一覧には自分の対話だけが表示され、ほかのユーザーがあなたの会話の URL から内容にアクセスすることはできません。

## 対話を始める

1. [API Keys](/ja/user/tokens) でキーを作成して有効にし、アカウントに利用可能なクォータがあることを確認します。
2. OneGateway コンソールから **Playground** を開きます。
3. 上部の API Key セレクター（**Switch API Key**）で現在のキーを確認します。複数のキーがある場合は用途に応じて選択します。
4. 使用するモデルを選択します（**Select model**）。モデル名で検索でき、表示される料金（**Pricing (per 1M tokens)**）、コンテキスト長、能力（**Capabilities**）の情報を確認できます。
5. メッセージ入力欄（**Ask OneGateway**）に質問を入力し、送信ボタンをクリックします。回答は順次表示されます。

モデルの範囲は選択したキーによって変わります。キーを切り替えたら、利用可能なモデルを改めて確認してください。モデルが表示されない場合は、管理者にプロバイダーとグループ料金の確認を依頼してください。

## 回答と複数ターンの対話

同じ会話の中で続けて質問を送信すると、モデルは現在の会話の履歴を踏まえて回答します。新しい話題を始めたいときは、サイドバーの **New chat** をクリックします。

| 操作 | 用途 |
| --- | --- |
| Stop generating | 現在の回答を停止します。生成済みの内容にはすでに使用量が発生している場合があります |
| Copy | 回答のテキストをコピーします |
| コードのコピー | 回答内のコードブロックの内容をコピーします |
| Regenerate | 対応する回答をもう一度生成します。新たにモデルの呼び出しが 1 回発生します |
| Thinking process を展開 | 選択したモデルが思考内容を返した場合に確認できます。そのような内容がない場合は表示されません |

回答の品質と速度は、モデルの能力、入力内容、およびアップストリームのサービスによって異なります。モデルの出力は業務上の必要に応じて確認してください。

## 画像とファイルを追加する

入力欄の横にある追加ボタンから **Add photos & files** をクリックし、添付ファイルを選択してから、質問を補足して送信します。

- 画像は画像理解に使用します。画像入力に対応したモデルを選択する必要があります。
- テキストファイルは、コードの解説、ログの分析、ドキュメントの整理などに使用できます。たとえば `.txt`、`.md`、`.json`、`.csv` やコードファイルです。ファイルはテキスト内容としてリクエストに含まれます。
- 現在、添付ファイルの上限はメッセージ 1 件あたり 6 個です。画像 1 枚は最大 10 MB、テキストファイル 1 個は最大 200 KB です。上限を超えた場合は、画面の案内に従ってファイルを小さくするか、添付ファイルを減らしてください。

送信前に、誤って選択した添付ファイルを削除できます。PDF や Office 文書などのファイルは、先に対応するテキスト形式に変換する必要があります。また、モデルのコンテキスト長にも注意し、長い内容は分割して処理してください。

## 会話を管理する

サイドバーには会話が時間ごとにグループ化されて一覧表示され、タイトルは最初のメッセージから生成されます。会話をクリックすると対話を続けられます。**Search chats** でタイトルから検索でき、古い会話は **Load more** でさらに読み込めます。

会話の URL は、本人が同じ対話を再度開くために使用できます。ほかのユーザーにアクセス権限を与えるものではありません。

削除する前に、その会話が不要であることを確認してください。削除すると復元できません。会話を削除しても、すでに発生したモデルの呼び出しと費用は取り消されません。

## 設定と使用量

サイドバーの **Settings** で、**Appearance** の **Theme** を Light、Dark、System（システムに合わせる）から選択できます。外観の設定は現在のブラウザーに保存されます。プラットフォーム統合環境の言語は OneGateway アカウントの言語設定に従います。変更後は Playground を再読み込みしてください。

対話で呼び出したモデル、Token 使用量、費用は[リクエストログ](/ja/user/usage)で確認できます。記録は少し遅れて表示される場合があります。クォータと最近のトレンドは[個人ダッシュボード](/ja/user/my-dashboard)を参照してください。

## 問題が発生した場合

| 現象 | 対処方法 |
| --- | --- |
| 利用可能な API Key がないと表示される | API Keys ページに戻ってキーを作成し、有効で、期限切れでなく、クォータを使い切っていないことを確認します |
| モデル一覧の読み込みに失敗する、または空になる | 現在のキーのモデル範囲を確認し、再読み込みして再試行します。異常が続く場合は管理者に連絡します |
| ログインの有効期限が切れたと表示される | OneGateway に戻って再ログインし、コンソールから Playground を開き直します |
| 画像を含むリクエストが失敗する | モデルが画像入力に対応しているか確認し、添付ファイルの形式とサイズを確認します |
| 特定の会話を開けない | 元のアカウントを使用しているか確認します。会話が削除されたか、現在のアカウントのものではない可能性があります |
| 回答が空、タイムアウト、または途中で中断される | 発生日時、モデル、エラーメッセージを控え、リクエストログと合わせて調査します。再試行すると新たな呼び出し費用が発生する場合があります |

ローカルのコーディングツールでモデルを使用したい場合は、[よく使うツールとの連携](/ja/guide/tools)を参照してください。
