调用Label-studio SDK的get_projects时出现401未授权客户端错误

问题还原 #

通过Label Studio SDK连接服务后，check_connection()和get_session()均能正常运行，但调用get_projects()时抛出401未授权错误，请求目标为/api/projects端点。

排查&解决步骤 #

• 检查API密钥绑定用户的权限
  Label Studio的API密钥与用户账号绑定，需确保该用户具备项目访问权限：

  • 管理员账号生成的密钥默认有权限查看所有项目；
  • 普通标注员/审核员账号可能仅能查看自身创建的项目，或完全无项目列表访问权限。可临时将用户角色改为管理员测试，或为用户分配对应项目的访问权限。

• 重新生成API密钥
  若密钥存在复制错误、过期或失效情况，登录Label Studio后台：右上角头像→Account & Settings→API Keys，删除旧密钥后重新生成，替换代码中的API_KEY再次测试。

• 手动验证接口权限
  用curl直接调用接口，排除SDK本身的问题：

  curl -H "Authorization: Token a6eecde17b14b768085a67a6657c44fac5e0244d" http://xx.xxx.xx.xxx:xxxx/api/projects?page_size=10000000
  

  如果curl同样返回401，说明是权限或密钥问题；若curl能正常返回项目数据，尝试升级SDK：

  pip install --upgrade label-studio-sdk
  

• 关键提示
  check_connection()仅验证Label Studio服务是否在线，get_session()仅创建请求会话，这两个接口不需要项目访问权限，因此它们正常不代表你有权限访问项目列表。

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