纳寻选择服务商并填写对应密钥
打开“设置 → AI 服务”。使用云端服务时，选择实际使用的服务商，并填写它签发的 API 密钥。本地日期、前缀和编号规则无需配置 AI。
- 在该服务商后台检查 API 访问权限和可用额度。不同服务商的密钥不能混用，Pro 也不包含服务商额度；不确定费用归属时可查看价格说明。
- 使用官方服务时保留对应预设；只有确实使用网关时，才按该服务文档配置地址和兼容的 API 协议。不要把聊天网页地址当作接口地址，也不要把密钥发给不熟悉的端点。
- 确认密钥编辑后，再保存设置。密钥保存在 Mac 钥匙串；出现保存错误时先处理错误，再重新打开设置，确认服务商和模型已保留。
让模型能力与输入匹配
选择当前账号有权使用的模型。自定义模型请填写服务商提供的准确模型标识，不要照抄聊天应用里的展示名称。
- 可读文本可以使用兼容的文本模型。“图片描述”和需要发送 PDF 页面图像的分析，需要能接收图片的模型。文本请求成功不能证明视觉能力可用。
- 使用未知或自定义模型时，先向服务商确认它支持的输入类型；修改视觉能力设置，不能让纯文本模型获得图片能力。即使模型兼容，文件提取和读取范围仍有限制。
先测连接，再测一个文件
点击“测试连接”并等待结果。测试可能发送请求并产生服务商费用；对云端服务，它检查的是小型请求，不是完整的 PDF 或图片工作流。
- 测试失败时，按下方排错表对照提示。先修正对应设置或账号问题，不要连续点击测试或直接提交整批文件。
- 保存设置后，选择“内容标题”等内置 AI 规则，添加一个不含敏感内容的短文本文件，并先核对下方的数据共享范围，再点击“生成名称”。
- 将建议名称与原文对照。生成建议不会改变文件名，核对后才执行重命名。连接正常但文件失败时，继续查看下方的文件专项检查。
发送前核对内容范围与目的地
首次向某个目的地发送请求前，核对地址和数据共享确认。所需文本、元数据或预览直接发送给你配置的服务；只有开启对应选项后，才会包含原文件名。
- 在“设置 → AI 内容”中核对 PDF 文字页码、页面图像和文字识别。标题位于所选页码之外时，模型可能根本看不到；扫描件还应检查清晰度和文字识别，不能默认 PDF 一定有可读文本。
- 检查图片分析质量和文档文本读取范围，先保留完成命名任务所需的内容，再用小型练习文件验证。缩小输入可以帮助排查大小限制，但删掉关键页面或文字，也会让模型失去命名依据。
排查连接或请求错误
先按错误提示选择检查方向。不同服务商对同一问题的表述可能不同；每次只调整一个因素，修正后再用一个小型练习文件重试。
可横向滚动查看完整对照 →
| 提示或现象 | 核对什么 | 恢复步骤 |
|---|---|---|
| 认证失败或拒绝访问 | 服务商、密钥、账号权限与接口地址是否匹配。 | 填写该服务对应的密钥，保存后重测。拒绝访问时，向服务商核对模型与 API 权限；重复请求不能获得权限。 |
| 额度或余额不足 | 服务商的 API 余额与账号用量限制，与纳寻 Pro 分开核对。 | 先在服务商处处理额度或账号问题，再重试。缩小批次不能恢复已经耗尽的额度。 |
| 限流或请求过多 | 服务商请求限制，以及同一账号上的其他任务。 | 等服务商的限流窗口恢复后，先重试一个文件。如果当前版本提供并发设置，可降低并发数；不要连续重复提交整批。 |
| 模型不可用或拒绝图片 | 准确模型标识、账号权限，以及是否支持图片输入。 | 选择账号可用且适合输入的模型。先测文本，需要时再测小图；视觉选项不能让纯文本模型理解图片。 |
| 超时、网络或服务错误 | 服务是否可达、小型请求是否正常；可查看服务商状态信息。 | 临时故障恢复后重试一个小文件。输入过大时，可减少读取页数或文本，但保留关键内容；连连接测试也失败时，重新核对服务地址。 |
| 返回格式错误或无法解析 | 服务与模型是否支持应用预期的 API 响应，以及内置规则能否工作。 | 使用内置 AI 规则测试一个短文本文件。仍失败时，记录服务商、模型和完整提示交给支持；不要原因未变就重复提交大批文件。 |
连接成功，文件分析仍失败
连接测试不能证明文件可读、关键内容已被选中，或模型支持实际输入。
- 用同一条 AI 规则测试一个短小、可读的文本文件。如果它也失败，重新核对已保存的服务商、模型和请求排错表；如果它正常，重点检查原文件及其输入范围。
- PDF 需要检查加密、可读文本或文字识别、所选页码，以及是否发送了页面图像；图片需要确认文件能正常打开、模型能接收图片。提取限制见支持格式说明；导入成功本身不能证明 AI 分析可用。
- 小型有效输入仍失败时，请向支持提供服务商、模型、文件类型、所选规则、完整报错，以及连接测试是否成功。尽量使用脱敏样本，不要附上 API 密钥或私人文档。
继续完成 PDF 或图片命名
小型请求正常后，可进入 PDF 指南选择已有元数据或正文命名，或进入图片指南选择本地尺寸编号与视觉描述。先核对每个建议并执行小型练习，结果符合预期后再增加文件。