SFX v3 故障排查：声音遗漏、杂音与 API 错误

先判断问题发生在哪一步：选择模型、接受请求、生成、下载，还是放入编辑器。再确认处理请求的是哪项服务。本站返回 JSON 任务响应，ElevenLabs 官方音效接口成功时返回音频；混用约定会表现为下载损坏或密钥无效。

如何选择模型与排查列表加载问题

在音频工作台的模型选择器中选择适合任务的模型，填写提示词，再确认参数与积分预估。预填音效描述不会改变所选模型。通过 API 接入时，使用音频目录返回的模型 slug；它与 ElevenLabs 官方模型 ID 不一定相同。

列表加载失败时，先刷新页面；如果仍然失败，请联系支持并提供发生时间与错误信息。不要反复提交生成请求来排查目录加载问题。

请求成功，但遗漏了一部分声音

列出原本期待的事件，再逐项试听。缩短描述、明确顺序，或单独生成遗漏部分。例如，将很长的视觉场景改成：

One drawer slides open, then a small metal object is placed on the wooden surface, followed by the drawer closing.

这是一条建议测试的提示词，不是经过验证的修复。需要独立时间控制时，分别准备抽屉打开、放物体和关闭三个素材，再放到编辑器里。提示词指南提供更多改写例子。

多出音乐、说话声或过多房间反射

先核对所选模型。音乐、语音与音效模型对同一段文字的处理用途不同。如果确实是兼容音效模型，尝试简化到一个声源和动作，使用简单背景，并移除容易暗示配乐的词。

空间反射太多时，可以比较“close and dry”与原始描述。这是生成请求，不是保证生效的去混响滤镜。可用候选还需要处理时，编辑副本，保留源文件。

声音有杂音、刺耳或削波

用适中音量试听，比较原始下载文件与编辑器播放。留意失真是否只在多轨叠加后出现；如果是，先调整混音电平。源文件本身已经失真时，只降低播放音量不会恢复缺失的波形细节。

可以尝试更简单描述或其他候选。改扩展名、提高采样率或转换成 WAV，不能直接修复源文件；不要把未经验证的处理步骤当成保证有效的修正。

循环存在间隙或明显重复

先确认当前模型实际提供循环控件。试听首尾接点，而不只是文件中间。尾声截断、音量跳变或突出事件反复出现，可能需要更换编辑接点、交叉淡化或更稳定的源文件，详见环境氛围指南。

请求一直排队或处理中

保存返回的任务 ID，查询同一个任务。排队或处理中，不等于需要再创建一次生成。采用有上限、逐步增加间隔的等待方式，不要每次结果未就绪就重新提交。

提交超时、还没收到 ID 时，先检查已有作品和请求记录。本站生成接口没有在文档中提供幂等键，重复提交可能创建另一个单独计费的任务。持续延迟时，提交带任务 ID 的支持工单。

按实际 API 判断错误

本站需要同时检查 HTTP 状态与 JSON code：成功为 0，应用错误为 -1 并带 message。部分应用错误使用 HTTP 200，不能只判断状态码。API 指南列出请求与响应细节。

任务失败，或积分余额不符合预期

查看 taskStatus；失败或取消时，查看 taskInfo.userErrorCode。公开代码包括 service_busy、content_safety_rejected、copyright_restricted 和 generation_failed 等，用于说明错误类别，并不提供完整上游响应。

现有服务条款说明失败生成的积分返还。对照任务状态与积分记录，如仍不一致，向支持提供任务 ID 和大致时间。成功完成但不喜欢的结果，与失败任务不同，不会自动触发失败返还。遇到内容拒绝时，应检查描述与素材权利，不要尝试绕过限制。

下载文件无法播放

确认任务成功，并使用完成结果中的音频地址。不要把本站生成接口返回的 JSON 存成 MP3。保留下载的原始格式，编辑器需要其他编码时转换副本。地址失效时先重新打开已保存作品，仍无法访问则提供任务 ID 联系支持。

提交工单时说明页面或接口、任务 ID、大致时间、可见错误和期待行为，不要附 API 密钥、认证请求头或私人参考文件。请求和文件正常后，可继续视频流程或游戏流程。