一、快速开始
首次使用建议按“填写 API令牌 → 获取模型 → 测试模型 → 选择模块 → 启动任务”的顺序操作。
1. 填写 API令牌从云雾AI后台复制 API令牌，粘贴到工具顶部。
2. 获取并测试模型点击“一键获取模型”，再点击“测试当前模型”确认连通。
3. 启动批量生成选择对应模块、填写提示词或导入素材，点击“启动”。
二、API令牌获取与配置
- 打开软件后，如果 API令牌为空，工具会自动打开云雾AI网站登录页。
- 登录或注册云雾AI账号后，进入网站后台的 API令牌 / API Key 管理页面。
- 手动创建新的 API令牌，复制完整令牌。
- 回到工具顶部，把令牌粘贴到“API令牌”输入框，点击“保存配置”。
- 点击“一键获取模型”，等待模型列表刷新；选择模型后点击“测试当前模型”。
注意：API令牌相当于账号调用凭证，不要发给无关人员。接口地址固定为 https://www.yunwuai.cc/v1，工具内无需修改。
三、各模块图文说明
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 | 适合数据整理和表格生成。 |
| 音频 | 按所选模型支持格式输出 | 建议先测试模型，再批量生成。 |
生成结果会自动按任务分文件夹保存。建议在开始前先设置固定保存目录，方便后续查找。
六、常见问题和注意事项
获取模型失败怎么办？
先确认 API令牌是否正确、网络是否正常，再点击“一键获取模型”。如果仍失败，可以重新登录云雾AI后台复制新的令牌。
生成失败怎么办？
查看运行日志和失败清单中的原因。常见原因包括模型不支持当前模块、接口繁忙、余额不足、提示词过长或网络超时。
图片比例设置后没有生效怎么办？
确认在图片模块中选择了正确比例或尺寸，工具会把菜单选项加入请求条件；部分模型可能仍会按自身规则输出，可换用其他图片模型测试。
视频模块为什么标注开发中？
视频接口受账号、模型和平台能力限制较大，当前仅保留界面入口。正式使用前请先测试当前模型是否支持视频生成。
重要提醒：不要把 API令牌或后台账号密码发给他人，以免造成不必要损失。