문제 해결 · Cursor
커스텀 base URL에서 Cursor Invalid API Key — 검증이 실패하는 이유
키와 base URL이 서로 맞지 않거나 오버라이드 필드가 여전히 기본 OpenAI 엔드포인트를 가리키면 Cursor는 검증 단계에서 API 키를 거부합니다. 해결 체크리스트.
표시되는 내용
Invalid API key발생 원인
- 키는 커스텀 엔드포인트용인데 "Override OpenAI Base URL"이 꺼져 있거나 비어 있어, Cursor가 기본 api.openai.com에서 키를 검증합니다 — 그곳은 이 키를 본 적이 없습니다.
- base URL은 설정했지만 키에 공백이 섞였거나, 접두사가 빠졌거나, 아예 다른 프로바이더 형식의 키입니다.
- 키가 폐기되었거나 만료되었습니다.
- 오버라이드 URL에 /v1이 없거나 경로 조각이 더 붙어 있어, 검증 요청이 엔드포인트가 서비스하지 않는 URL로 갑니다.
해결 방법
- 키를 붙여넣기 전에 OpenAI base URL 오버라이드를 켜고 https://router.apitoken.sale/v1로 설정하세요 — 검증은 그 순간 활성화된 URL로 실행됩니다.
- 앞뒤 공백 없이 키를 붙여넣고, 접두사가 대시보드에 표시된 것과 같은지 확인하세요.
- 발급처 대시보드에서 키가 활성 상태인지 확인한 다음 Cursor에서 다시 검증하세요.
이 게이트웨이에서 검증을 통과하는 Cursor 설정
Cursor Settings → Models → OpenAI API Key
API Key: sk-pool-•••
Override OpenAI Base URL: https://router.apitoken.sale/v1
Model: gpt-6.1-terra관련 검색어
cursor openai api key not workingcursor verify api key failed
자주 묻는 질문
curl에서는 되는 키를 Cursor는 왜 유효하지 않다고 하나요?+
Cursor는 그 순간 설정된 base URL로 검증합니다. 오버라이드가 꺼져 있으면 검증이 api.openai.com으로 가고, 그곳은 게이트웨이 키를 거부합니다. 오버라이드를 먼저 설정한 뒤 검증하세요.
커스텀 키로 Cursor에서 GPT 모델을 쓰려면 OpenAI 계정이 필요한가요?+
아니요. OpenAI 프로바이더 필드는 OpenAI 호환 엔드포인트라면 무엇이든 받습니다: 오버라이드 URL을 발급처로 설정하고 그 발급처의 키를 붙여넣으세요.
키 검증 후에는 어떤 모델이 작동하나요?+
오버라이드 뒤의 엔드포인트가 제공하는 GPT와 Gemini 모델입니다. 같은 base URL과 키로 GET /v1/models를 호출해 목록을 확인하고, ID를 커스텀 모델로 추가하세요.