LangChain UnstructuredLoader所需API Key说明及401报错排查

一、UnstructuredLoader的apiKey说明 #

• 密钥类型：不是LangChain或AWS等服务商的密钥，是Unstructured.io的API密钥，该Loader本质是调用Unstructured的文档解析服务来处理文件。
• 获取途径：
  • 注册Unstructured.io账号
  • 登录后进入用户控制台，找到API密钥管理板块生成专属密钥
• 配置注意事项：
  • 密钥需妥善保管，禁止硬编码到代码中，建议通过环境变量传递，示例：

    import { UnstructuredLoader } from "langchain/document_loaders/fs/unstructured";
    
    const options = {
      apiKey: process.env.UNSTRUCTURED_API_KEY,
    };
    
    const loader = new UnstructuredLoader(
      "src/document_loaders/example_data/notion.md",
      options
    );
    const docs = await loader.load();
    

  • 免费账号有调用额度限制，超出后需升级付费套餐才能继续使用

二、401错误排查方案 #

根据报错信息"API key is malformed, please type the API key correctly in the header."，按以下步骤排查：

• 检查密钥是否填错：确认你填入的是Unstructured.io的密钥，而非OpenAI的API密钥（你提到使用OpenAI Key时出现此错误，大概率是把OpenAI密钥误填到了UnstructuredLoader的配置里）
• 校验密钥格式：
  • 确保复制的密钥无多余空格、换行符或特殊字符
  • Unstructured的API密钥格式通常为unstructured_sk_xxxxxx，核对格式是否匹配
• 环境变量加载检查：如果用环境变量存储密钥，确认变量名拼写正确，且已在运行环境中正确设置（比如在Node.js中需通过dotenv加载.env文件，或在服务器环境中配置环境变量）
• 密钥有效性验证：登录Unstructured.io控制台，检查该密钥是否处于启用状态，是否过期或被撤销

内容的提问来源于stack exchange，提问作者Lloukas