Google AI Studio 문제 해결
Google AI Studio 문제 해결
Google AI Studio를 사용하다 문제가 생겼을 때 참고할 수 있는 트러블슈팅 제안들을 모아 놓은 문서예요.
출처: 원문
본문
이 페이지는 Google AI Studio를 사용할 때 문제가 발생하면 참고할 수 있는 트러블슈팅 제안을 제공해요.
403 Access Restricted 오류 이해하기
403 Access Restricted 오류가 보인다면, 이용약관을 따르지 않는 방식으로 Google AI Studio를 사용하고 있다는 뜻이에요. 흔한 원인 중 하나는 지원되는 지역에 있지 않은 경우예요.
Google AI Studio의 No Content 응답 해결하기
어떤 이유로 콘텐츠가 차단되면 Google AI Studio에 No Content 경고 메시지가 표시돼요. 자세한 내용을 보려면 No Content 위에 포인터를 올리고 Safety 경고를 클릭하세요.
응답이 안전 설정 때문에 차단됐고, 사용 사례의 안전 위험을 검토했다면, 안전 설정을 수정해서 반환되는 응답에 영향을 줄 수 있어요.
안전 설정 때문이 아니라 응답이 차단됐다면, 쿼리나 응답이 이용약관을 위반하거나 다른 이유로 지원되지 않는 것일 수 있어요.
토큰 사용량과 한도 확인
프롬프트를 열어두면 화면 하단의 Text Preview 버튼이 현재 프롬프트 콘텐츠에 사용된 토큰과 사용 중인 모델의 최대 토큰 수를 보여줘요.
AI Studio용 Google Cloud IAM 권한
Google Cloud 프로젝트의 구성원은 Google AI Studio에서 작업을 수행하려면 특정 Identity and Access Management(IAM) 권한이 필요해요. 이 Identity에 대한 자세한 내용은 IAM principals 개요를 참고하세요.
연결된 Google Cloud 프로젝트에서 Editor 또는 Owner 역할을 가진 사용자는 대시보드 보기와 Gemini API 키 관리를 위한 전체 권한을 가져요. Viewer 역할을 가진 사용자는 대시보드와 API 키를 볼 수는 있지만, 만들고·수정하고·삭제할 수는 없어요.
더 세분화된 제어를 원한다면 아래 표에서 각 AI Studio 기능에 필요한 특정 권한을 확인하세요. 권한 부여 방법은 Google Cloud 문서의 리소스에 대한 액세스 권한 부여, 변경, 취소를 참고하세요.
| AI Studio 기능 | 필요한 IAM 권한 | 추가 요구사항 |
|---|---|---|
| 프로젝트 검색 (프로젝트 가져오기) | resourcemanager.projects.get | |
| 프로젝트 이름 변경 | resourcemanager.projects.update | |
| 할당량 티어 표시 | N/A | |
| API 키 생성 | 프로젝트 검색 권한 필요, 추가로: apikeys.keys.create, serviceusage.services.enable, iam.serviceAccountApiKeyBindings.create, iam.serviceAccounts.create | |
| API 키 목록 | 프로젝트 검색 권한 필요, 추가로: apikeys.keys.list, serviceusage.services.get | Google Cloud 프로젝트에 Generative Language API가 활성화되어 있어야 함 |
| API 키 이름 변경 | apikeys.keys.update | |
| API 키 삭제 | apikeys.keys.delete | |
| 사용량 대시보드 | 프로젝트 검색 권한 필요, 추가로: monitoring.timeSeries.list | |
| 속도 제한 대시보드 | 사용량 대시보드 권한 필요, 추가로: cloudquotas.quotas.get | |
| 지출 (결제 상한) | billing.resourceCosts.get (지출 보기), billing.resourcebudgets.read (상한 보기), billing.resourcebudgets.write (상한 설정) | |
| 결제 대시보드 | billing.accounts.get |
기타 액세스 확인
Google Cloud IAM 권한 외에도 AI Studio는 보안 및 규정 준수 확인을 수행해요. 다음 요구사항을 충족하지 못하면 AI Studio 인터페이스나 API 응답에서 PERMISSION_DENIED 또는 액세스 제한 오류가 발생할 수 있어요:
- 보안 확인: 요청이 자동 보안 확인을 통과해야 해요.
- 이용약관: Google 서비스 약관과 생성형 AI 추가 서비스 약관에 동의해야 해요.
- 지원 지역: 지원되는 지역에 있어야 해요.
- 신뢰와 안전: Google Cloud 프로젝트가 남용으로 플래그되지 않아야 해요.