使用自己的 API Key，通过 OpenAI 兼容模型辅助写音乐提示词

MusicPrompt 的可选 AI 助手负责起草文字和音乐选择，音频生成仍是另一个步骤。服务商、模型与 API 凭据由你选择；没有 Key 时，本地编译器也可以继续使用。

配置你掌握的连接

在工作台编辑器下方打开 AI 写作助手，选择 OpenAI、DeepSeek 或 OpenAI 兼容服务，填写你的账户有权限使用的 Chat Completions 模型 ID。不要从套餐名称或营销公告猜模型参数。

接口基础地址以服务商提供的信息为准，例如以 /v1 结尾的地址。转发服务会追加 /chat/completions，也接受已经包含该路径的地址。当前托管转发支持 443 端口的公网 HTTPS，不连接 localhost、内网或含内嵌用户名密码的地址。

把 Key 放在密码输入框里。更换服务商会清空原来的 Key，也可以点击“清除 Key”。刷新页面后会话中的密钥值会清空。不要把密钥写进创作简报，也不要使用属于无关账户的密钥。

选择最小而有用的任务

歌词已经合适时，使用“仅建议声音选项”，它会保留标题与歌词。想保留声音方向时，使用“仅改写歌词与结构”。“按简报起草歌曲”和“修改完整草稿”可以调整标题、语言、声音、歌词与排除项。

要求尽量具体，例如“保留副歌文字，缩短主歌，减少装饰填充”。生成前可展开数据预览，检查当前草稿。助手发送的是标题、简报、音乐选择、歌词和这次要求，不包括整个项目的试听历史。

请求经本站发往你填写的接口。Key 仅保留在页面内存，不写入项目、备份、分享链接或分析事件；应用不存储请求正文。服务商自身的收费与数据政策仍然适用。请只使用你愿意将密钥和草稿交给它的接口。

采用之前先预览

预览区把变化字段与原文放在一起。结果必须符合 MusicPrompt 的格式合同，并通过错误检查，才能保存为新版本。仅修改声音的建议可以在尚未写歌词时保存，但导出人声提示词前仍需补上歌词。采用建议后旧版本仍会保留。如果等待期间修改了草稿或切换项目，旧建议会被丢弃，避免覆盖新工作。

取消操作会在此停止等待并中断请求，但不能保证服务商尚未处理或计费。超时也不应该直接触发自动重试。

有针对性地处理兼容问题

默认使用 JSON 模式。若服务商不支持，可在兼容选项里选择仅通过提示词要求 JSON。两条路径都会校验返回对象。输出预算为 4,096 Token；消耗较多推理 Token 的模型可能需要更短的任务或不同配置。

输出 Token 参数可选 max_tokens 或 max_completion_tokens，应以服务商文档为准。OpenAI 提供了 JSON 返回处理和凭据处理说明，DeepSeek 也有 JSON 输出文档。密钥被拒绝、额度受限或输出被截断时，项目不会被改写。

本地运行时，在应用目录使用 npm run dev。Vercel 部署会包含 api/assist.js；只复制静态 HTML 到其他主机，不会自动得到该接口。开发者还可以采用Agent 工作流，通过进程环境传入凭据。