排查上传、录音和生成问题

应从问题出现的位置开始排查：数字人图片看数字人详情页，声音克隆看“声音”，生成看“项目”，积分和权益看“账单”或“用量”。不要反复提交同一个失败输入；先识别页面显示的错误或状态，再修正最可能的原因。

照片无法上传或生成效果不好

• 图片应在 10 MB 以内；创建数字人时使用常规 PNG 或 JPG。

• 选择面部清晰、无遮挡、光线均匀且背景干净的照片。

• 浏览器相机无法打开时，检查设备是否有摄像头、是否被其他应用占用，以及浏览器和操作系统的摄像头权限是否被阻止。

• 上传额外数字人形象时，请使用详情页的上传操作，并遵守同样的 10 MB 限制。

麦克风或录音无法使用

• 允许浏览器麦克风权限；必要时也在操作系统中允许。

• 有多个输入设备时，在选择器中选择目标麦克风。

• 关闭可能独占麦克风的应用，重新加载页面后再试。

• 如果已有有效的 WAV、MP3 或 M4A 样本，并能提供实际朗读文本，可以改用“上传音频”。

声音克隆被拒绝、效果差或未就绪

• 多语言样本不得超过 10 秒；单语音样本必须为 15–25 秒。不要混用这两种要求。

• 上传时填写实际语音的完整原文，不要填标题、摘要或另一段脚本。

• 在安静环境中只录一个说话人。带音乐、回声、多人、重度音效或极端表达的音频应替换。

• 正式项目中请等待状态为“就绪”。失败克隆应使用修正后的源音频重新创建。

“生成”被禁用或项目无法启动

• 确认已选择项目名称、至少一个非空脚本片段和声音；视频还需要数字人和套餐允许的分辨率。

• 检查每段长度：视频每段最多 100 个字符，音频每段最多 600 个字符。长文本可用“自动分割”。

• 选择与脚本语言相匹配的声音样本。

• 检查实时预估、积分余额和套餐权益。积分不足和不可用分辨率都会阻止生成。

项目停留在待处理、处理中或失败

• “待处理”和“处理中”是正常进行中状态，列表和预览页会自动刷新；请等待状态变化。

• 已完成项目可以预览和下载。若预览不可用，请确认项目已经是“已完成”，而不是草稿或失败。

• 只在项目标记为“失败”后使用“重试”。重试前应修正发生变化的输入，例如缺失资产、错误语言、超长片段、套餐不支持的选项或积分不足。

• 若修正可见原因后仍持续失败，请保存项目 ID 和错误/状态详情供支持排查，而不要创建大量重复重试。

联系支持前

从操作菜单收集项目、数字人或声音 ID；记录发生时间、状态或错误信息，以及不敏感的浏览器、设备权限、文件格式、时长和大小信息。除非经过验证的支持流程明确要求，否则绝不要发送密码、完整 API 密钥、Webhook 密钥或私有源文件。