문제 해결 · 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 working
  • cursor 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를 커스텀 모델로 추가하세요.

잘못된 설정에 시간 낭비하지 마세요

apiToken.sale은 OpenAI 호환, Messages(Anthropic 형식), 네이티브 Gemini 엔드포인트로 GPT와 Gemini 모델을 제공합니다 — 표준 SDK, 하나의 키, 하나의 선불 잔액. 도구의 base URL만 지정하면 이 페이지의 설정이 적힌 그대로 작동합니다.