Cherry Studio

Cherry Studio에서 401 또는 유효하지 않은 API 키가 반환될 때 해결 방법

401은 요청이 AI Code With 서버에 도달했지만 인증에 실패했음을 의미합니다. 문제는 API 주소나 모델이 아니라 API 키 자체, 키의 유효성 또는 계정 상태에 있습니다.

다음 검사부터 시작하세요

요청이 서버에 도달했지만 인증에 실패했습니다.

  • Cherry Studio에서 메시지를 보낸 뒤 401, Unauthorized 또는 Invalid API Key가 표시됩니다.
  • 붙여넣은 API 키가 불완전하거나, 여분의 공백이 있거나, 잘못된 키입니다
  • Cherry Studio 설정 → 모델 서비스에서 New API를 선택합니다
401UnauthorizedInvalid API Key

01

요청이 서버에 도달했는지 확인

401 / Unauthorized는 요청이 AI Code With 엔드포인트에 도달했지만 인증 단계에서 거부되었음을 의미합니다. API 주소나 모델을 변경하지 말고 API 키를 먼저 확인하세요.

02

API 키를 다시 붙여넣고 확인

Cherry Studio 설정 → 모델 서비스에서 New API를 선택하고 API 키 필드에 전체 API 키를 붙여넣습니다. 복사할 때 끝의 줄바꿈이나 공백이 포함되지 않도록 하세요.

  1. 1Cherry Studio 설정 → 모델 서비스에서 New API를 선택합니다
  2. 2API Key 필드에 전체 API 키를 여분의 공백 없이 다시 붙여넣습니다

03

키와 계정 확인

AI Code With API 키 페이지에서 키가 활성 상태이고 계정에 잔액이 있는지 확인합니다. 저장한 뒤 짧은 메시지를 보내고, 더 이상 401이 없으면 자격 증명 체인이 정상입니다.

  1. 1API Key 필드에 전체 API 키를 여분의 공백 없이 다시 붙여넣습니다
  2. 2키가 유효한 AI Code With API 키인지 확인합니다(API 키 페이지 참조)

그래도 해결되지 않으면

출처

다시 구성

통합 센터로 돌아가 설정 단계를 계속하세요.

관련 설정 단계로 돌아가기

Related problems

모델을 찾을 수 없음 / 잘못된 모델 ID · API 주소 오류 · 모델 동기화가 비어 있음

Back to Cherry Studio