纳米AI文档校对需先验证API Key有效性并正确构造请求：登录平台获取含sk-前缀的密钥，用GET /v1/health测试；校对时POST至/v2/check/text，Header含Authorization和JSON Content-Type，text字段传UTF-8纯文本（PDF/DOCX需预解析），可选加source_type等元数据提升准确率。

你需要将PDF或DOCX文档交给纳米AI自动提取文字、识别错别字并返回结构化校对结果，但卡在API Key无法通过认证或请求体格式总报错——这通常是因为密钥未正确注入请求头，或文档内容未按/v2/check/text端点要求做预处理。

获取并验证API Key有效性

第一步：登录纳米AI开发者平台（https://www.php.cn/link/f34d3f5532b0dce1ef66eb6c5a5c7db9），进入「API管理」→「创建新密钥」→勾选「text-check」服务权限→点击确认。

第二步：密钥生成后立即复制完整字符串（含sk-前缀），【该密钥仅首次展示时可完整查看，关闭页面即永久不可恢复】。若已丢失，必须删除旧密钥并新建。

第三步：打开Postman或curl终端，发起一次最简测试请求：

GET https://api.nano-ai.com/v1/health

Headers中添加 Authorization: Bearer sk-xxx

返回200且body含{"status":"ok"}即证明密钥可用；若返回401，说明密钥粘贴错误或权限未生效。

构造文档校对请求体（text字段预处理）

方法一：纯文本直传（适用于小于50KB的TXT/MD内容）

直接将文档正文UTF-8编码后填入JSON的text字段，无需base64编码。

方法二：PDF/DOCX文件解析后传文本（推荐）

先用python-docx或PyPDF2本地解析原始文件→提取纯文本→过滤页眉页脚和空行→确保首尾无BOM字符→再塞入text字段。

注意：纳米AI不接收二进制文件流，【不能把PDF文件base64编码后直接丢进text字段】，否则触发“invalid content format”错误。

方法三：带元数据增强校对精度

在JSON中额外添加source_type（"pdf"/"docx"/"txt"）、page_count（若为PDF）、language（"zh"/"en"）字段。这些字段虽非必填，但启用domain-aware spellcheck时能显著降低“的/地/得”误判率。

发送校对请求并解析响应

① 设置HTTP方法为POST，URL为 https://api.nano-ai.com/v2/check/text

② Headers必须包含：

Content-Type: application/json

Accept: application/json

Authorization: Bearer 后接你复制的完整密钥（中间不留空格）

③ Body示例（严格JSON格式，不可有多余逗号）：

{

"text": "钙钛矿电池效率已突破33.5%，但稳定性仍是产业化瓶颈。",

"check_type": ["grammar", "typo"],

"lang": "zh"

}

④ 成功响应返回200，body中errors数组列出每个错误位置、类型及建议修正。若返回400且message含"missing required field 'text'"，说明JSON结构有语法错误或text值为空字符串。