Playground

Playground は、コンソールに組み込まれたモデル検証ツールです。コードを書かずに、チャット、画像生成、テキスト読み上げのモデルを試せます。組み込む前に、モデルの比較やパラメーターとプロンプトの調整に使用してください。

#始める前に

• LLM API サービスが有効になっており、アカウントにクォータがあることを確認してください。
• 有効な API キーが少なくとも一つ必要です。Playground は、有効なキーのいずれかを使って自動的にリクエストを送信し、デフォルトグループのキーを優先します。使用できるキーがない場合、ページに 先に API キーを作成してくださいと表示されます。LLM API → トークン管理 で作成してください。

#Playground の開き方

左側のメニューで LLM API → Playground（/llm/playground）を選択します。左側に 設定 パネルがあり、モード タブで チャット、画像生成、音声 を切り替えられます。右側には、選択したモードに対応する作業領域が表示されます。

#チャット

1. モード で チャット を選択します。
2. モデル ドロップダウンからモデルを選択します。文字を入力して検索できます。
3. 任意: システムプロンプト で、アシスタントの役割と振る舞いを設定します。デフォルトは「あなたは役に立つアシスタントです。」です。
4. 任意: ストリーミング出力 はデフォルトで有効になっており、生成された部分から返信が表示されます。無効にすると、返信全体がまとめて表示されます。
5. 右側の入力欄にメッセージを入力します。Enter で送信し、Shift+Enter で改行します。

詳細パラメーター を展開すると、次の項目を調整できます。

各メッセージをコピー、再生成、削除できます。会話を消去するには、空にする をクリックします。

#画像

1. モード で 画像生成 を選択します。
2. 画像モデルを選択し、生成したい画像を説明します。
3. モデルが対応している場合は、サイズ（1024x1024、1024x1792、1792x1024、512x512、256x256）、品質（標準、または HD）、スタイル（鮮やか、または 自然）を設定します。
4. 送信して結果を待ちます。生成された画像はダウンロードできます。

#音声（テキスト読み上げ）

1. モード で 音声 を選択し、続いて 音声合成（TTS） を選択します。
2. tts-1 や tts-1-hd などのモデルと、声質 を選択します。ボイスは Alloy、Echo、Fable、Nova、Onyx、Shimmer から選べます。
3. スライダーで 速度 を 0.25x から 4x の範囲で設定します。デフォルトは 1x です。
4. テキストを入力して送信します。生成された音声はブラウザーで再生するか、ダウンロードできます。

#Playground の設定をコードで使用する

設定が決まったら、同じパラメーターを API で送信します。たとえば、上記のチャット設定は次のリクエストに対応します。

curl https://llm.yeap.cloud/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $YEAP_LLM_API_KEY" \
  -d '{
    "model": "gpt-4o-mini",
    "messages": [
      {"role": "system", "content": "You are a helpful assistant."},
      {"role": "user", "content": "Hello"}
    ],
    "temperature": 0.7,
    "max_tokens": 2000,
    "top_p": 1
  }'

テキスト読み上げは POST /v1/audio/speech に対応します（パラメーターは model、input、voice、speed）。画像生成は POST /v1/images/generations に対応します。

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

• ドロップダウンのモデルでエラーになる: Playground にはプラットフォーム上のモデルが表示されますが、キーのグループですべてのモデルを利用できるとは限りません。別のモデルを試すか、モデル一覧 ページを確認してキーのグループを変更してください。
• クォータが不足している: アカウントにクォータを移すか、Playground が使用しているキーのクォータ上限を確認してください。
• 特定のキーで検証したい: Playground ではキーが自動選択されます。特定のグループや制限を持つキーを検証するには、curl または SDK を使って API を直接呼び出してください。クイックスタートを参照してください。