一、快速开始
新手就记住一句话：先拿到 API令牌，再选模型，再点启动，其余不用急着管。
1. 填写 API令牌先登录 yunwuai.cc，复制后台里生成的 API令牌，粘贴到工具顶部。
2. 获取并测试模型点“一键获取模型”，再点“测试当前模型”，确认能正常使用。
3. 开始生成选好模块、填好内容，直接点“启动”，软件会自动保存结果。
二、API令牌获取与配置
- 先打开软件，软件会自动跳出云悟AI登录页。
- 登录或注册后，进入网站后台，找到 API令牌 或 API Key 的位置。
- 手动新建一个令牌，复制完整内容。
- 回到软件，把令牌粘贴进顶部的“API令牌”输入框，再点“保存配置”。
- 接着点“一键获取模型”，等列表出来后，选一个模型再点“测试当前模型”。
注意：API令牌就像账号钥匙，不要随便发给别人。接口地址已经固定好了，工具里不用改。
三、各模块图文说明
1. 提示词写作
标题提示词内容提示词文章提示词图片提示词视频提示词
适合批量生成不同用途的提示词。可以直接输入需求描述，也可以导入图片或视频作为参考素材。
- “生成数量”控制一次生成多少条提示词。
- “详细程度”可选简约、中度、详细或自定义字数。
- 点击“一键清空”会清空参考预览和下方生成结果。
- 生成后可点击“导出提示词TXT”批量保存。
2. 文字/文档生成
支持生成标题、标题生成文章、纯提示词生成、同风格仿写。输出格式可选择 TXT、MD、HTML、PDF、WORD、EXCEL、PPTX 等。
- 生成标题：可导入关键词库，并设置每个关键词生成多少个标题。
- 标题生成文章：导入标题后按提示词要求生成文章。
- 纯提示词生成：不需要标题，直接根据提示词生成单篇或多篇。
- 同风格仿写：上传案例文章或填写指定链接，再结合提示词要求生成同风格内容。
- 已使用关键词/标题会移动到已使用库，避免重复使用。
3. 图片生成
用于批量生成图片，可设置图片比例、尺寸、画质、数量和参考图。
- 在“图片提示词”中每行输入一条图片需求。
- 选择 PNG 或 JPG 输出格式。
- 设置 1:1、9:16、16:9 等比例时，工具会把选项带入请求条件。
- 参考图可辅助模型理解产品、风格或构图。
4. 表格处理
用于生成表格、整理表格数据、分类、补全、统计和分析。
- 可直接粘贴 CSV、TSV、Markdown 表格或普通文本数据。
- 处理要求越明确，输出表格越稳定。
- 常用导出格式包括 XLSX、CSV、TXT、MD。
- 适合商品清单、关键词整理、数据分类、运营统计等。
5. 音频生成
用于文本转语音、音频文案、旁白生成和常见音频处理场景。
- 输入要生成语音的文本或音频处理要求。
- 根据模型支持情况选择音色、语速和输出格式。
- 适合短视频旁白、课程配音、产品介绍音频等。
- 如果某个音频模型测试失败，请换用模块中已筛选出的可用模型。
四、任务明细、日志和失败处理
工具会在左侧显示任务状态和运行日志，底部显示任务明细与失败清单。运行日志较多时，可以点击“放大查看”打开完整日志详情。
- 成功日志会显示成功标记，失败日志会显示失败标记。
- 批量生成时，某一条失败会自动重试 1 次。
- 再次失败后会进入失败清单，可点击“重跑失败项”继续处理。
- 不需要保留的失败记录，可以点击“一键清空”。
五、保存目录和导出格式
| 类型 | 支持格式 | 说明 |
|---|---|---|
| 文字/文档 | TXT、MD、HTML、PDF、WORD、EXCEL、PPTX | 选择什么格式，就只输出对应格式内容。 |
| 图片 | PNG、JPG | 按任务自动分文件夹保存。 |
| 表格 | XLSX、CSV、TXT、MD | 适合数据整理和表格生成。 |
| 音频 | 按所选模型支持格式输出 | 建议先测试模型，再批量生成。 |
生成结果会自动按任务分文件夹保存。建议在开始前先设置固定保存目录，方便后续查找。
六、常见问题和注意事项
获取模型失败怎么办？
先看看令牌有没有填对，网络有没有通，再点一次“一键获取模型”。如果还是不行，就重新登录云悟AI后台复制新的令牌。
生成失败怎么办？
先看运行日志和失败清单，里面会写原因。常见情况有：模型不适合当前模块、网络忙、额度不够、提示词太长。
图片比例设置后没有生效怎么办？
先确认图片模块里选的是不是你想要的比例。工具会把这个选项带进去，但不同模型表现可能不完全一样，可以换个模型试试。
视频模块为什么标注开发中？
视频接口限制比较多，所以先保留入口。正式用之前，最好先测试当前模型能不能生成视频。
重要提醒：不要把 API令牌或后台账号密码发给他人，以免造成不必要损失。