跳转到内容

排障参考

展开全局任务浮窗查看完整错误。

失败任务可以普通重试。仍处于运行或排队状态但长时间没有进展时,使用 强制重试。

请阅读具体的错误信息,然后查看以下排障信息。

如果无法解决,请联系开发人员。

这通常表示网络不稳定,或供应商服务暂时不可用。可以尝试:

  • 检查网络连接是否稳定
  • 稍后再试

错误信息类似:

API returned status 401: {"error":{"message":"Authentication Fails, Your api key: ****u2sd is invalid","type":"authentication_error","param":null,"code":"invalid_request_error"}}

说明您提供的 API Key 无效,请检查:

  1. API Key 是否完整复制,没有多余空格
  2. 供应商和 API URL 是否匹配

这通常表示供应商限流或并发过高。可以尝试:

  • 尝试手动再次运行缺失项
  • 修改速率限制设置(请参考供应商文档)
  • 降低并发数
  • 增加请求间隔

不建议直接选择全部重跑,这样可能会让情况更糟糕,可能会进一步触发供应商限流。

表示API的请求有误,原因多种多样,需要看错误内容具体分析。

如果错误信息类似:

API returned status 400: {"error":{"message":"The supported API model names are deepseek-v4-pro or deepseek-v4-flash, but you passed deepseek-v4-pro1111.","type":"invalid_request_error","param":null,"code":"invalid_request_error"}}

说明模型的标识符错误,请检查:

  1. 请检查标识符是否输入错误,请使用供应商提供的标识符而不是模型显示名称
  2. 供应商有可能删除了过时的模型,请尝试换用其他模型

如果错误信息类似:

API returned status 400: {"error":{"message":"Failed to deserialize the JSON body into the target type: messages[0]: unknown variant `image_url`, expected `text` at line 1 column 3061412","type":"invalid_request_error","param":null,"code":"invalid_request_error"}}

可能是配置服务时,为模型指定了不正确的“模型能力”,例如:

  • 为非视觉模型指定了视觉相关的任务

提示“Expected X translations but got Y”

Section titled “提示“Expected X translations but got Y””

比如:

Expected 6 translations but got 7. The Al likely returned malformed content, please
try again.

说明模型没有按照系统提示词逐条给出翻译,您可以:

  • 修改模型配置,调高思考强度
  • 改用其他模型
  • 过一阵子再尝试相同模型

如果频发,通常意味着模型能力不胜任此任务,其遵循指令的能力不足

「选择供应商」界面中,加载失败

Section titled “「选择供应商」界面中,加载失败”

可能您的网络有问题,请检查你的设备是否能连接到猫译员的主站

实在无法解决网络连接的问题,您也可以使用「手动添加」模式来新增您期望使用的供应商的配置。

文本块没检测出来,或者原文没有提取出来

Section titled “文本块没检测出来,或者原文没有提取出来”
  • 请确认源语言是否设置正确
  • 检查原图是否清晰,文字是否过小、倾斜、遮挡或与背景融合
  • 可以尝试使用不同的检测服务
  • 一些难以识别的文字,如手写字、拟声词、装饰字体容易识别错误,您可以手动新增文本块,并人工输入原文

翻译至少需要一个有原文的文本块,并且需要配置了 翻译 能力的模型。

若原文为空,请先运行文字提取或手动输入原文。

请按如下顺序排查

  1. 先检查文本块的框选范围
  2. 检查提取出的原文文本是否正确,不正确请重新识别(如改用能力更强的视觉模型)或手动录入
  3. 尝试删除图片摘要信息再翻译,图片摘要信息可能提取错误,误导了翻译的模型
  4. 尝试改用能力更强的模型

如果应用提示选择文件名编码,请切换编码并检查名称预览,确认名称正常且没有解码错误或重名后再继续。

工作区打开失败时,界面上会提供的排查步骤,请先根据提示的步骤自行排查。

若仍无法解决,请联系开发人员获得帮助。

  • 检查磁盘空间和网络
  • 导入 ZIP 失败、Hash 校验失败表示压缩包可能不完整、或者被篡改