---
outline: [2, 3]
head:
  - - meta
    - name: description
      content: 在 OneGateway 工作室中选择 API Key 和模型进行对话，上传图片或文本文件，查看回答与思考过程，并管理自己的会话。
---

# 工作室

**工作室** 是 OneGateway 的在线 AI 对话工作台。登录后，从控制台的 **工作室** 入口进入，即可选择模型进行提问，无需先配置其他客户端。

对话使用你自己的 API Key，调用受该密钥的模型范围、配额及账号额度约束。会话列表只显示自己的对话，其他用户无法通过你的会话地址访问内容。

## 开始对话

1. 在 [API Keys](/user/tokens) 中创建并启用密钥，确认账号有可用额度。
2. 从 OneGateway 控制台打开 **工作室**。
3. 在顶部的 API Key 选择器中确认当前密钥；有多个密钥时按用途选择。
4. 选择需要使用的模型。可搜索模型名称，并查看显示的价格、上下文与能力信息。
5. 在消息框输入问题，点击 **发送消息**。回答会逐步显示。

模型范围随所选密钥变化。切换密钥后，重新确认可用模型；没有模型时，请管理员核对供应商和分组定价。

## 回答与多轮对话

在同一会话中继续发送问题，模型会结合当前会话的历史内容回答。需要开始新的主题时，点击侧栏的 **新对话**。

| 操作 | 用途 |
| --- | --- |
| 停止生成 | 停止当前回答，已生成内容可能已产生用量 |
| 复制 | 复制回答文本 |
| 复制代码 | 复制回答中代码块的内容 |
| 重新生成 | 再次生成对应回答，会产生一次新的模型调用 |
| 展开思考过程 | 选定模型返回思考内容时查看；没有此类内容时不会显示 |

回答质量和速度取决于模型能力、输入内容及上游服务。模型输出应按业务需要核对。

## 添加图片与文件

点击输入框旁的 **添加内容 → 添加图片或文件**，选择附件，再补充问题并发送。

- 图片用于图片理解，需选用支持图片输入的模型。
- 文本文件可用于解释代码、分析日志或整理文档，例如 `.txt`、`.md`、`.json`、`.csv` 和代码文件；文件会以文本内容参与请求。
- 当前附件上限为每条消息 6 个；单张图片最多 10 MB，单个文本文件最多 200 KB。超限时按页面提示缩小文件或减少附件。

发送前可移除选错的附件。PDF、Office 文档等文件需要先转换成支持的文本格式；同时注意模型上下文长度，较长内容应分段处理。

## 管理会话

侧栏按时间分组列出会话，标题根据首条消息生成。点击会话继续对话；使用 **搜索对话** 按标题查找，较早会话可通过 **加载更多** 继续载入。

会话地址可用于本人重新打开同一对话。它不会向其他用户授予访问权限。

删除前确认不再需要该会话，删除后无法恢复。删除会话不会撤销已经发生的模型调用和费用。

## 设置与用量

通过侧栏 **设置** 调整浅色、深色或跟随系统的主题；外观偏好保存在当前浏览器。平台集成环境的语言跟随 OneGateway 账号语言设置，修改后刷新工作室。

在[日志](/user/usage)查看对话调用的模型、Token 用量和费用，记录可能稍后才出现。额度与近期趋势见[个人看板与统计](/user/my-dashboard)。

## 遇到问题

| 现象 | 处理方式 |
| --- | --- |
| 提示没有可用的 API Key | 返回 API Keys 页面创建密钥，确认已启用、未过期且配额未耗尽 |
| 模型列表加载失败或为空 | 确认当前密钥的模型范围，刷新后重试；持续异常时联系管理员 |
| 提示登录已过期 | 回到 OneGateway 重新登录，再从控制台进入工作室 |
| 图片请求失败 | 确认模型支持图片输入，检查附件格式与大小 |
| 无法打开某个会话 | 确认使用原账号，会话可能已删除或不属于当前账号 |
| 回答为空、超时或中断 | 保存发生时间、模型和错误提示，结合日志排查；重试可能产生新的调用费用 |

需要在本地编码工具中使用模型时，参阅[接入常用工具](/guide/tools)。