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": "你是一个有帮助的助手。"},
      {"role": "user", "content": "你好"}
    ],
    "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 调用，参见 快速开始。