使用 Playground 测试
功能概述
Playground 是无量AI开放平台提供的交互式 API 测试工具，无需编写代码即可快速测试 API 接口。通过 Playground，您可以：
- 从分组的接口列表中选择 API 接口
- 选择可用的模型
- 使用现有的 API Key 发起测试请求
- 动态构建请求参数
- 查看结构化的响应结果
- 获取对应请求的代码示例（Python、Node.js、cURL）
- 查看调用历史记录
- 使用提示词优化功能改进 Prompt
前提条件
- 已创建至少一个 API Key（且处于启用状态）
- 账户余额充足
操作步骤
进入 Playground
在左侧导航栏中，点击 资源 分组下的 Playground 菜单。
进入 Playground 页面，页面分为左右两个主要区域。
选择 API 接口
在页面左侧的接口列表中，浏览按功能分组的 API 接口。
接口按能力类型分组展示，例如：
- 文本生成（Chat Completion）
- 图像生成（Image Generation）
- 向量嵌入（Embedding）
- 语音合成（TTS）
- 语音识别（STT）
点击目标接口，右侧将加载该接口的测试面板。
选择模型和 API Key
选择模型
在测试面板的模型选择下拉菜单中，选择要测试的模型。下拉菜单仅展示所选接口支持的模型。
选择 API Key 和应用
在 API Key 选择下拉菜单中，选择一个处于启用状态的 API Key。
选择 API Key 后，系统自动关联该 Key 所属的应用。
如果账户余额不足，页面顶部将显示余额警告横幅，提醒您充值后再进行测试。
构建请求参数
根据所选接口，页面动态展示对应的请求参数表单。
填写必要的请求参数，常见参数包括：
参数 说明 是否必填 messages 对话消息列表，包含角色和内容 是（文本生成） prompt 文本提示内容 视接口而定 temperature 控制输出的随机性，范围 0~2 否 max_tokens 最大生成 Token 数 否 top_p 核采样参数 否 stream 是否启用流式输出 否 
对于文本生成类接口，可以在消息编辑器中添加多条消息（system / user / assistant），模拟多轮对话。
发起请求并查看响应
确认参数无误后，点击 发送 按钮。
如果启用了流式输出（stream），响应内容将逐步呈现；否则等待完整响应后展示。
响应以结构化格式展示，包含以下信息：
- 响应内容：模型生成的文本或其他输出
- Token 统计：输入 Token 数、输出 Token 数
- 延迟：请求响应时间
- 原始响应：完整的 JSON 响应体
查看代码示例
在响应区域下方，切换至 代码示例 标签页。
选择编程语言标签查看对应的代码：
- Python（基于 OpenAI SDK）
- Node.js（基于 OpenAI SDK）
- cURL
点击 复制 按钮将代码复制到剪贴板，可直接用于您的项目中。
查看调用历史
在 Playground 页面中，点击 调用历史 标签页。
查看您在 Playground 中发起的历史调用记录。
点击某条历史记录可查看详细的请求和响应信息，并可以重新发送相同的请求。
使用提示词优化
在文本生成类接口的消息编辑区域，点击 优化提示词 按钮。
系统将分析当前提示词并提供优化建议，帮助您获得更好的生成效果。
您可以选择采纳优化建议，或手动调整后发送请求。
注意事项
- Playground 中的请求会实际消耗账户余额，请注意控制测试频率和参数设置。
- 流式输出模式适合测试实时生成效果，但在大量请求场景下可能增加网络开销。
- 代码示例中的 API Key 以占位符形式展示，实际使用时请替换为您的真实 Key。
- 调用历史仅保留在当前浏览器会话中，关闭页面后将清除。
- 如果请求返回错误，请检查 API Key 的权限配置（能力类型和模型范围）是否匹配当前接口。
- Playground 适用于功能测试和快速验证，不建议用于压力测试或大规模调用。
相关文档
- 管理 API Key - 创建和配置 API Key
- 发起 API 调用 - 在代码中调用 API 的完整指南
- 模型列表与定价 - 浏览可用模型和定价
- API 文档浏览 - 查看完整的 API 接口文档