You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

使用DeepL API创建术语表时遇“无效或缺失授权头”问题求助

解决DeepL术语表API授权头错误的方案

以下是针对你遇到的授权头问题的排查和解决步骤:

  • 确保授权头的正确添加方式
    不要在Postman的「Authorization」标签页选择任何授权类型(比如Bearer、Basic Auth),直接切换到「Headers」标签页,手动添加键值对:

    • 键:DeepL-Auth-Key
    • 值:你的Pro账户API密钥
      误选Authorization标签的其他类型会导致Postman自动生成额外授权头,和你手动添加的DeepL-Auth-Key冲突,进而引发错误。
  • 禁用查询参数授权方式
    不要同时使用DeepL-Auth-Key请求头和auth_key查询参数,二者选其一即可。官方明确推荐使用请求头方式,所以直接删除URL中的auth_key参数,仅保留请求头授权。

  • 确认请求体格式为multipart/form-data
    创建术语表的POST请求必须使用multipart/form-data编码格式:

    1. 在Postman的「Body」标签页选择「form-data」
    2. 添加以下必填字段:
      • name:术语表名称(字符串)
      • source_lang:源语言代码(比如EN)
      • target_lang:目标语言代码(比如ZH)
      • entries:可选择「Text」类型,输入TSV格式的术语(每行格式:源术语\t目标术语);或选择「File」类型上传符合格式的TSV/TXT文件
        请求体格式错误可能间接导致授权验证逻辑异常,返回错误的授权提示。
  • 验证API密钥和域名的匹配性
    再次确认:

    • Pro账户的API域名是https://api.deepl.com/v2/glossaries,不要使用免费版的api-free.deepl.com域名
    • 复制API密钥时确保无前后空格、大小写错误,完全匹配DeepL账户后台的密钥内容
  • 测试简化请求
    先发送极简请求排除干扰:

    1. 仅保留DeepL-Auth-Key请求头
    2. 请求体只填写name、source_lang、target_lang和一行简单的术语条目
      若该请求成功,再逐步添加其他内容排查问题。

内容的提问来源于stack exchange,提问作者Kanchan Kumbhar

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.06.20 06:35:05