在线体验

「在线体验」是 Rise 智算平台的大模型 Playground，不用写代码就能快速验证模型效果。页面按能力拆成 6 个页签：对话、图像、视频、语音、嵌入、重排。每个页签都遵循同一套使用范式：左侧配置模型与参数，右侧交互输入与查看结果。

入口路径：左侧菜单 大模型服务 > 在线体验，页面路由 /admin/model-x/playground/index。 如从模型广场点击「去体验」，系统会自动选中对应模型并跳转到匹配页签。

前置准备

1. 确认模型可访问：左侧模型选择器中能看到目标模型（来自模型广场或已部署的推理服务）。
2. 准备 API Key：在 个人中心 > 账号安全 > API 密钥 创建并启用一个 Key；回到 Playground 时点击「创建 API Key」可直达该页面。
3. 确认权限：当前账号需要有所选模型/API Key 的调用权限，未授权的 Key 会被置灰不可选。

通用操作说明

无论进入哪个页签，左侧配置面板都包含：

配置项	说明
Model	按工作空间/提供方分组展示可用模型。无模型时可点击底部「创建推理服务」去部署。
API Key	选择已启用的 Key。Key 不足时点击「创建 API Key」。
页面专属参数	每个页签会在下方展示对应参数（见各页签说明）。

右侧交互区：

• 顶部显示当前选中的模型名。
• 中间展示历史记录/结果。
• 底部输入框发送请求；生成过程中可随时停止或清空。

---

对话体验

页面路由：/admin/model-x/playground/text-chat

单模型对话

1. 进入「对话」页签，左侧 Model 选择要体验的模型。
2. 选择 API Key。
3. （可选）在 System Prompt 中输入系统提示词，例如「你是一个严谨的代码助手」。
4. 在下方 参数表单 中调整模型参数。参数根据模型协议动态展示，常见字段包括：
   • temperature：取值范围由模型决定，值越低输出越稳定。
   • top_p
   • max_tokens
   • 部分模型还提供 JSON 对象参数或布尔开关。
5. 在底部输入框输入问题，按 Enter 或点击发送按钮。
6. 模型会流式输出回答；如需中断，点击「停止生成」。
7. 点击对话卡片头部的「清空」可删除当前会话历史。

双模型对比

1. 配置好主模型后，点击左侧「添加对比模型」。
2. 在弹出的对比配置区选择 对比模型、API Key、System Prompt 与参数。
3. 页面会左右并排展示两个模型的回答。
4. 如需让对比模型使用与主模型完全相同的参数，点击「同步参数」。
5. 点击「取消对比」可恢复单模型模式。

双模型模式下，同一个问题会同时发给两个模型，便于对比回答质量与速度。

---

图像生成

页面路由：/admin/model-x/playground/image-gen

适合快速验证文生图模型效果。

1. 左侧选择 Model 与 API Key。
2. 设置画面比例：点击 1:1、4:3、3:4、16:9、9:16 快捷按钮。
3. 选择 分辨率：比例切换后，分辨率下拉会给出推荐尺寸。
4. （可选）设置 Seed：
   • 手动输入 0 ~ 2147483647 之间的整数。
   • 或点击右侧刷新按钮随机生成一个 Seed。
   • 固定 Seed 可复现相似结果。
5. 调整 CFG（提示词相关度）：0 ~ 20，数值越高生成结果与提示词越相关。
6. 调整 推理步数：1 ~ 100，步数越多通常画质越高、耗时越长。
7. （可选）填写 Negative Prompt，描述不希望出现在画面里的元素。
8. 在底部输入框填写提示词，按 Enter 或点击发送按钮生成图片。
9. 生成后：
   • 鼠标悬浮可查看模型优化后的实际提示词（revised_prompt）。
   • 点击「下载」保存图片到本地。
   • 点击「清空历史」可删除当前页所有生成记录。

如果收到「image size must be at least … pixels」类报错，说明当前分辨率低于模型下限，请换成更高分辨率。

---

视频生成

页面路由：/admin/model-x/playground/video-gen

1. 左侧选择 Model 与 API Key。
2. 设置 时长：1 ~ 15 秒。
3. 打开/关闭 水印 开关。
4. 在底部输入框输入视频描述提示词，按 Enter 或点击发送按钮。
5. 生成过程中会显示占位动画；完成后可在播放控件中预览。
6. 点击「下载」保存 MP4；若视频 URL 已过期，点击「重新加载视频」可尝试重新获取。
7. 点击「清空历史」删除当前页记录。

注：视频生成能力依赖上游模型提供方是否开放该接口；若当前环境未上架视频生成模型，「视频」页签可能不会显示或无法生成。

---

语音体验

页面路由：/admin/model-x/playground/voice

顶部页签可在 文字转语音（TTS） 与 语音转文字（ASR） 之间切换。

TTS 文字转语音

1. 切换至 TTS 页签。
2. 选择 Model 与 API Key。
3. 填写 声音（voice）：不同提供方支持的音色名称不同，需按模型文档填写，例如 alloy、zh-CN-XiaoxiaoNeural。
4. 选择 输出格式：mp3 或 wav。
5. （可选）勾选底部 自动播放，生成完成后会自动播放音频。
6. 在底部输入框输入要合成的文本，按 Enter 或点击发送按钮。
7. 生成完成后：
   • 使用播放器试听。
   • 点击「下载」保存音频文件。
   • 点击「清空历史」删除记录。

声音字段为必填项，未填写时发送按钮不会提交，并会在输入框下方提示。

ASR 语音转文字

1. 切换至 ASR 页签。
2. 选择 Model 与 API Key。
3. 选择 响应格式：json、text、verbose_json。
4. 拖拽或点击上传音频文件（单文件大小限制 5 MB）。
5. 点击发送按钮开始识别。
6. 识别结果展示在右侧，点击「复制」可复制文本。
7. 点击「清空历史」删除记录。

---

嵌入（Embedding）体验

页面路由：/admin/model-x/playground/embedding-chat

用于快速查看文本向量化的结果与可视化分布。

1. 选择 Model 与 API Key。
2. 在右侧输入待向量化的文本：
   • 逐行模式：每行一个文档条目，可点击「添加/删除」调整条数。
   • 多行批量模式：在大文本框中一次性粘贴多段文本。
3. 点击发送按钮提交。
4. 结果区会展示：
   • 高维向量经 PCA 降维后的 二维散点图，悬浮到点可查看原文与坐标。
   • 切换到 JSON 可查看完整向量数组，便于开发者复制。
5. 点击「清空」可清空输入与结果。

---

重排（Rerank）体验

页面路由：/admin/model-x/playground/rerank-chat

用于验证 Reranker 模型对候选文档的相关性排序能力。

1. 选择 Model 与 API Key。
2. 设置 Top N：1 ~ 20，表示最终返回最相关的文档数量。
3. 在 Query 输入框中填写查询文本。
4. 在候选文档区输入若干文档：
   • 可切换为批量模式一次性粘贴。
   • 可逐行添加/删除条目。
5. 点击发送按钮。
6. 右侧结果区按相关性分数从高到低展示文档，包含：排名、原文、分数与可视化进度条。
7. 点击「清空」可清空输入与结果。

---

常见问题

Q：模型选择器为空怎么办？ A：说明当前没有可用的已部署模型。可点击选择器底部的「创建推理服务」，前往 AI 智算开发 > 算力服务 > 推理服务 部署一个模型，或让管理员在模型广场上架模型。

Q：API Key 被置灰无法选择？ A：该 Key 可能被当前模型禁用，或 Key 状态为停用/锁定。请检查 个人中心 > 账号安全 > API 密钥 中的 Key 状态。

Q：为什么对话参数与别人不一样？ A：参数表单根据所选模型的协议动态生成。不同提供方（OpenAI、Anthropic、智谱等）暴露的参数不同，平台仅展示模型声明支持的字段。

Q：语音模型的声音名称填什么？ A：声音字段完全由上游模型决定，平台不做枚举限制。常见参考：OpenAI TTS 可填 alloy、echo、fable；Azure/火山等需按其官方文档填写。

Q：生成图片/视频后历史记录找不到了？ A：Playground 的历史记录保存在浏览器本地。换浏览器、清缓存或使用隐身模式会导致历史丢失；重要结果请及时下载到本地。

Q：切换页签后之前选的模型和参数还在吗？ A：各页签的模型、API Key、参数与历史记录相互独立，切换页签不会互相影响。

Q：在线体验会收费吗？ A：生成类操作会消耗 Token 或按次计费，具体费用可在页面右上角用量入口查看（如权限开放）。