---
title: "MIDI Agent 文档 | VST 插件指南"
description: "了解如何安装 MIDI Agent，以及如何通过 ChatGPT 账户、提供商 API 密钥、本地模型或 MIDI Agent Pro 使用它。"
canonical_url: "https://www.midiagent.com/zh-hans/%E6%96%87%E6%A1%A3"
md_url: "https://www.midiagent.com/zh-hans/%E6%96%87%E6%A1%A3.md"
author: "MIDI Agent"
author_url: "https://www.midiagent.com/about"
last_updated: "2026-10-11"
date_basis: "manualReviewed"
generated_at: "2026-10-12T00:00:00.000Z"
---

1. [首页](https://www.midiagent.com/zh-hans)
2. 文档

# MIDI Agent 插件文档

  概览 安装 主要功能 用户界面 工作流程 使用建议 故障排查

## 概览

MIDI Agent 插件是一款强大的工具，旨在利用人工智能，直接在数字音频工作站（DAW）内生成和处理 MIDI，改善音乐制作流程。您可以通过文本提示生成原创 MIDI 旋律、和声及节奏，将音频转换为 MIDI，并使用支持的 AI 模型补全已有 MIDI 序列。

## 安装与激活

MIDI Agent 提供 VST3 插件，也提供 AU、AAX 和独立应用格式。运行安装程序并选择需要的格式；使用独立应用不需要 DAW。

1. **下载：**从账户页面获取适用于您操作系统的安装程序。
 2. **安装：** 运行安装程序，选择独立应用和所需插件格式。默认安装路径：
     - **独立应用：**
      - C:\Program Files\MIDI Agent\MIDI Agent.exe
      - /Applications/MIDI Agent.app
      - **VST3：**
      - C:\Program Files\Common Files\VST3
      - /Library/Audio/Plug-Ins/VST3
      - **AU（macOS）：**
      - /Library/Audio/Plug-Ins/Components
      - **AAX（Pro Tools）：**
      - C:\Program Files\Common Files\Avid\Audio\Plug-Ins
      - /Library/Application Support/Avid/Audio/Plug-Ins
 3. **启动 MIDI Agent：**从开始菜单或“应用程序”文件夹打开独立应用，或启动 DAW，在 MIDI 或乐器轨道上加载 MIDI Agent。
 4. **许可证：**在设置面板中输入许可证密钥。
 5. **验证：**点击“保存”以在线验证许可证。
 6. **选择 AI 使用方式：**连接 ChatGPT 账户、添加提供商 API 密钥、连接本地模型，或订阅 MIDI Agent Pro。
 7. **开始生成：**选择 API 提供商（Pro 订阅用户也可选择 MIDI Agent）和模型，输入提示词并点击发送，即可开始生成音乐。使用独立应用时，可将生成的 .mid 文件直接拖入任意 DAW。

## 主要功能

- **AI MIDI 生成：**通过文本提示生成独特且富有启发性的 MIDI 模式。
 - **音频转 MIDI：**将音频录音转换为 MIDI 数据。
 - **MIDI 补全：**扩展并完善已有 MIDI 序列。
 - **灵活选择 AI 模型：** 可选择不同的 AI 提供商：
    - ChatGPT 账户
     - [OpenAI](https://platform.openai.com/api-keys)
     - [Anthropic](https://console.anthropic.com/account/keys)
     - [DeepSeek](https://platform.deepseek.com/settings)
     - [Gemini](https://makersuite.google.com/app/apikey)
     - [OpenRouter](https://openrouter.ai/keys)
 - **音乐参数控制：**精细调整调性、音阶、记谱类型等参数。
 - **跨平台兼容：**提供 Windows 和 macOS 的 VST3 插件，并在支持的平台上提供 AU、AAX 和独立应用格式。
 - **深色／浅色主题：**选择喜欢的界面主题。

## 界面与控件

### AI 设置

- **提供商选择：**从多个 AI 提供商中选择
 - **模型选择：**选择具体的 AI 模型
 - **使用方式：**连接 ChatGPT、提供商密钥、本地 LLM 或 Pro

### 音乐参数

- 调性选择
 - 音阶选择
 - 记谱类型
 - 音符时值
 - 长度（小节）
 - 流派

## 工作流程与使用方法

MIDI Agent 专为融入 DAW 工作流程而设计：

1. 在 DAW 中安装 VST 插件
 2. 选择 ChatGPT 账户、提供商 API 密钥、本地 LLM 或 MIDI Agent Pro
 3. 新建 MIDI 轨道并添加 MIDI Agent 插件
 4. 通过插件界面生成或修改 MIDI
 5. 将生成的 MIDI 拖到 DAW 通道中，或保存为文件

## 使用建议

### 编写有效的音乐生成提示词

- 给出具体的音乐指示
 - 描述音符模式和节奏，例如“交替使用长持续音和快速断奏乐句”
 - 指定旋律走向，例如“创建一段从低音开始、上行两拍后再下行的旋律”
 - 加入节奏指示，例如“使用强调反拍的切分节奏”
 - 定义和声元素，例如“使用包含七和弦的 I-vi-IV-V 进行”或“每个和弦使用 4 个声部”
 - 避免笼统地引用风格或流派，改用具体描述，例如“摇滚歌曲中电吉他的强力和弦”

### 续写与变奏 MIDI

- 使用清晰的 MIDI 乐句或段落来确定和声与节奏
 - 说明需要续写、变奏、回应乐句、加花还是过渡
 - 选择适合当前所创作声部的生成长度
 - 重新生成，并在 DAW 中组合、编辑最好的结果
 - 尝试不同的提示词和参数，找到最适合输入文件的方式

### 音频转 MIDI 使用建议

为获得最佳转录效果：

- 使用高质量音频录音
 - 确保各乐器清晰分离，尽量减少串音和混响
 - 为获得最佳效果，使用时长少于 30 秒、体积较小的文件
 - 最适合：
    - 钢琴独奏录音
     - 清晰的吉他录音
     - 分离良好的多轨录音
     - 效果处理较少的原声乐器
 - 应避免或谨慎使用：
    - 经过大量处理或失真的音频
     - 环境噪声较大的现场录音
     - 多个声部重叠的复杂管弦乐作品
     - 经过强压缩或限制处理的音频

### 通用建议

- **使用当前最强的可用模型**——为获得最佳效果，我们推荐 Anthropic（Claude）和 Google（Gemini）的最新模型
 - **针对流派进行调整**——在设置面板中尝试符合音乐风格的自定义指令
 - **提供示例**——在设置面板中添加符合流派或偏好的 MIDI 示例文件，帮助引导特定任务的输出
 - **经常开始新对话**——较长的对话历史可能积累过时上下文，导致模型表现下降
 - **拆分复杂任务**——将大任务分成小步骤，每次生成一个声部，评估结果后再继续扩展

## 故障排查

### 常见问题

#### API 连接问题

- 检查设置中的 API 密钥是否输入正确
 - 检查网络连接
 - 确保 API 额度充足

#### 插件无法加载

- 确认已安装适合工作流程的 VST3、AU、AAX 或独立应用格式
 - 尝试重新扫描插件文件夹
 - 检查系统是否满足最低要求
 - 如果不使用 DAW，请从 Windows 开始菜单或 macOS 的 /Applications/MIDI Agent.app 打开独立应用

#### Pro Tools 用户（AAX）

- 确认 AAX 插件安装于 C:\Program Files\Common Files\Avid\Audio\Plug-Ins（Windows）或 /Library/Application Support/Avid/Audio/Plug-Ins（macOS）
 - 重新启动 Pro Tools，并等待首次插件扫描完成
 - MIDI Agent 显示在乐器轨道上

#### 独立应用工作流程

- 独立应用可让您在没有 DAW 的情况下生成 MIDI
 - 将生成的 .mid 文件直接拖入任意 DAW 的时间线或 MIDI 轨道
 - 如果 DAW 不支持直接拖放，请使用“保存 MIDI”
 - 速度与播放控制使用 MIDI Agent 的默认值，不存在 DAW 播放头

#### macOS 兼容性问题

- 较旧的 macOS 版本可能无法识别插件，请升级到最新 macOS 版本
 - 如果同时安装 AU 和 VST3 后插件仍未显示，请尝试只安装一种格式
 - 某些 macOS DAW 在两种插件格式同时存在时可能发生冲突

#### Logic Pro 用户

- 插件位于软件乐器通道条的 MIDI FX 插槽，处于乐器和音频效果插槽上方

#### 升级至 MIDI Agent Pro

- 如果在插件打开时升级至 MIDI Agent Pro，请重启插件以识别订阅

#### MIDI 生成问题

- 尝试使用更具体的提示词
 - 调整温度及其他参数
 - 确保提示词遵循使用建议

#### 音频转 MIDI 问题

- 使用高质量音频录音
 - 确保音频没有削波
 - 尝试每次只处理一种乐器

### 错误消息

#### “API 密钥无效”

再次检查设置面板中的 API 密钥，确保没有多余空格。

#### “超出请求速率限制”

等待几分钟后重试，或升级 API 套餐以提高限额。

#### “生成失败”

尝试调整提示词或参数。如果问题仍然存在，请检查 API 状态。

### 获取帮助

如果问题仍未解决：

- 查看文档是否有更新
 - 通过联系表单与我们联系
 - 提供您的配置和问题的详细信息

 ![MIDI Agent](https://www.midiagent.com/midi-agent-icon-black-bg.jpeg?v=20260623) 作者：[MIDI Agent](https://www.midiagent.com/zh-hans/%E5%85%B3%E4%BA%8E) / 最后更新 2026年10月11日 / MIDI Agent 为希望在 DAW 内生成音乐创意的制作人、作曲家和节拍制作人开发 AI 工具。

本内容译自 MIDI Agent 的英文原文，方便您以简体中文阅读。 [查看英文原文。](https://www.midiagent.com/docs)