확인일 2026-11-12

Cursor에 API 키와 Base URL 설정하기

Cursor의 OpenAI API Key 칸에 RelaySwitch 키를 넣고 Base URL을 https://api.relayswitch.io/v1로 덮어쓰면, 키로 호출할 수 있는 채팅 모델을 Cursor의 모델 선택기에서 고를 수 있습니다. Agent 모드와 Ask 모드 모두 동작하며 요금은 토큰당 선불 잔액에서 차감됩니다.

01설정 위치와 순서

Cursor는 OpenAI 형식으로 요청을 보내고, 모델 목록의 모든 채팅 모델이 그 형식에 응답합니다. 그래서 키 하나로 Claude, GPT, Gemini, DeepSeek를 같은 선택기에 넣을 수 있고, 각 모델은 실시간 토큰당 단가로 선불 잔액에서 과금됩니다. 설정 순서는 다음과 같습니다.

  • Cursor Settings(Cmd/Ctrl + ,)에서 Models를 엽니다. 키와 Base URL 입력란은 모델 목록 아래에 있습니다.
  • OpenAI API Key를 켜고 콘솔에서 복사한 키 전체를 붙여 넣습니다.
  • Override OpenAI Base URL을 켜고 https://api.relayswitch.io/v1를 입력합니다. 끝에 /v1이 있어야 합니다.
  • Save를 누릅니다. 예전 버전의 Cursor에서는 이 버튼 이름이 Verify입니다.
  • Models 아래에 쓰려는 모델 id를 하나씩 추가한 뒤 채팅 패널에서 하나를 고릅니다.

02입력할 값 세 가지

세 입력란의 역할은 다음과 같고, 표 아래 코드 블록은 값을 채운 모습입니다.

OpenAI API KeyCursor가 요청마다 함께 보내는 인증 정보입니다. 콘솔의 키 전체를 붙여 넣습니다.
Override OpenAI Base URL요청을 OpenAI 대신 https://api.relayswitch.io/v1로 보냅니다.
Models선택기에 표시되는 목록입니다. 쓰려는 id를 모델 목록 페이지에 나온 그대로 추가합니다. 표시 이름이 아니라 id를 넣어야 하며 Claude의 id도 됩니다.
text
1OpenAI API Key: sk-relay-...
2Override OpenAI Base URL: https://api.relayswitch.io/v1
3Models: gpt-6.1-sol

03모델 고르기와 실시간 가격

Agent 요청에는 대화 내용, Cursor가 읽은 파일, 도구 실행 결과가 함께 실리므로 비용의 대부분은 입력 토큰에서 나옵니다. 따라서 입력 단가가 낮은 모델이 요청당 비용이 가장 적습니다. 아래는 주요 모델의 백만 토큰당 달러 가격이며 카탈로그에서 실시간으로 읽습니다.

응답이 캐시된 입력 토큰을 보고하면 그 토큰은 입력 단가 대신 모델의 캐시 입력 단가로 과금됩니다. 같은 앞부분이 반복되는 긴 대화는 새 대화보다 턴당 비용이 낮습니다. 과금 규칙 전체는 가격 페이지에 있습니다.

모델개발사입력출력컨텍스트
Claude Fable 5.2claude-fable-5.2Anthropic$4.00≈ ₩5,455$20.00≈ ₩27,2771,000,000
Claude Opus 5.5claude-opus-5-5Anthropic$2.716≈ ₩3,704$9.70≈ ₩13,2301,000,000
DeepSeek V4.1 Flash 1017deepseek-v4.1-flash-1017DeepSeek$0.2425≈ ₩331$1.164≈ ₩1,5881,048,576
GLM 5.3 Flashglm-5.3-flashZ.ai$0.0873≈ ₩119$0.1455≈ ₩1981,000,000
GPT-6 Lunagpt-6-lunaOpenAI$0.0625≈ ₩85$0.20≈ ₩2731,050,000
Qwen3.8 Maxqwen3.8-maxQwen$0.80≈ ₩1,091$2.40≈ ₩3,273991,000
Minimax M3.1 Flashminimax-m3.1-flashMiniMax$0.105≈ ₩143$0.42≈ ₩5731,000,000
Gemini 3.8 Flashgemini-3.8-flashGoogle$0.4925≈ ₩672$2.25≈ ₩3,0691,048,576
Grok 4.7grok-4.7xAI$0.60≈ ₩818$1.80≈ ₩2,455500,000
Kimi K3kimi-k3Moonshot AI$0.90≈ ₩1,227$4.50≈ ₩6,1371,048,576

백만 토큰당 가격(USD) · ≈ 는 유럽중앙은행 2026-11-13 환율로 환산한 원화 참고 가격이며, 과금은 미국 달러로 이루어집니다

04Agent 모드에서 GPT 모델을 쓸 때

Base URL 덮어쓰기를 켠 상태에서 Cursor의 Agent 모드는 GPT 모델에 Responses API 형식의 본문을 Chat Completions 경로로 보냅니다. Cursor는 이를 자사 포럼에서 알려진 문제로 안내하고 있습니다.

게이트웨이는 그 본문을 원래 의도한 Chat Completions 요청으로 읽고 Chat Completions 형식으로 응답하며, 스트리밍 여부와 관계없이 동작합니다. 따라서 GPT id는 Agent 모드와 Ask 모드에서 똑같이 쓸 수 있고 가격도 같습니다. Cursor는 기본으로 스트리밍을 사용하고 이를 끄는 설정이 없으며, 카탈로그의 모든 모델이 스트리밍을 지원합니다.

05연결 확인

Cursor가 보내는 것과 같은 방식으로 요청 하나를 직접 보내 확인합니다. 응답이 돌아오면 키와 주소가 맞는 것입니다.

그다음 Cursor에서 추가한 id 하나를 선택하고 메시지를 보내십시오. 요청은 콘솔의 Usage 페이지에 토큰 수, 차감 금액과 함께 나타납니다.

bash
1curl https://api.relayswitch.io/v1/chat/completions \
2 -H "Authorization: Bearer sk-relay-..." \
3 -H "content-type: application/json" \
4 -d '{"model": "gpt-6.1-sol", "messages": [{"role": "user", "content": "Reply with ok"}]}'

06과금과 Cursor 요금제

  • 요청은 모델의 단가에 따라 토큰 단위로 선불 잔액에서 차감됩니다.
  • Cursor의 Teams와 Enterprise 요금제에서는 자체 키로 보낸 요청도 Cursor가 사용량에 포함하고 자체 토큰당 수수료를 더합니다. 이 수수료는 Cursor가 청구하는 것이며 RelaySwitch의 과금과는 별개입니다. 개인 요금제는 해당하지 않습니다(Cursor의 API 키 문서 기준).
  • 충전은 카드(Apple Pay, Google Pay) 또는 암호화폐로 하며 절차는 결제 페이지에 있습니다.

07오류와 해결

401 invalid_api_key키가 틀렸거나 폐기되었습니다. 콘솔에서 다시 복사하십시오.
404 model_not_found선택기에 넣은 id가 모델 목록에 없습니다. 오타이거나 id 자리에 표시 이름을 넣은 경우입니다.
402 insufficient_balance콘솔에서 충전하면 키가 바로 다시 동작합니다.
Save(Verify) 단계 실패Base URL에서 /v1이 빠진 경우가 가장 흔합니다. 같은 컴퓨터에서 위의 curl을 실행해 확인하십시오.

자주 묻는 질문

Cursor에서 Base URL에 /v1을 넣어야 하나요?
넣습니다. Override OpenAI Base URL에 https://api.relayswitch.io/v1 를 입력하면 Cursor가 그 뒤에 /chat/completions를 붙입니다. Verify가 실패하는 가장 흔한 원인이 /v1 누락입니다.
Cursor에서 Claude 모델도 쓸 수 있나요?
쓸 수 있습니다. Cursor는 OpenAI 형식으로 요청을 보내고 카탈로그의 모든 채팅 모델이 그 형식에 응답하므로, Models에 Claude의 id를 추가하면 선택기에 나타납니다. GPT, Gemini, DeepSeek도 같은 키로 추가합니다.
Agent 모드에서도 동작하나요?
동작합니다. Ask 모드와 Agent 모드 모두 쓸 수 있습니다. Agent 모드에서 Cursor가 GPT 모델에 Responses 형식의 본문을 보내는 경우에도 게이트웨이가 Chat Completions 요청으로 읽어 응답하며 가격은 같습니다.
Cursor에 스트리밍을 켜는 설정이 있나요?
없습니다. Cursor는 기본으로 스트리밍을 사용하며 끄는 설정이 없습니다. 카탈로그의 모든 모델이 스트리밍을 지원합니다.
Cursor 요금제와 별도로 비용이 드나요?
RelaySwitch 쪽 비용은 모델 단가에 따라 선불 잔액에서 토큰 단위로 차감되는 금액입니다. Cursor의 Teams와 Enterprise 요금제에서는 자체 키 요청도 Cursor가 사용량에 포함하고 자체 토큰당 수수료를 더하며, 이는 Cursor가 청구합니다. 개인 요금제는 해당하지 않습니다.
결제는 어떻게 하고 최소 금액은 얼마인가요?
카드(Apple Pay, Google Pay) 또는 암호화폐(USDT, USDC, BTC, ETH, SOL)로 충전하며 최소 $10입니다. 잔액은 달러로 표시되고 만료되지 않으며 구독은 없습니다.

Cursor 선택기에 모든 모델을

키 하나, 선불 잔액, 카드 또는 암호화폐.