Claude visitors: new accounts receive $1.00 in bonus API credit within 30 days. One per person; usage credits only.
Cursor IDE에서 자체 API 키 사용하는 방법
자신의 API 키로 Cursor를 RunAPI에 연결하세요. 스크린샷을 따라 Base URL을 설정하고, 모델을 선택한 뒤 사용량을 확인하세요.
자체 API 키로 Cursor를 설정하는 방법
-
-
API 키와 Base URL 복사하기
In the RunAPI dashboard, go to API Keys and generate a key. Copy it right away and note the base URL — it is https://runapi.ai/v1.
Dashboard — keysAPI keyrunapi_•••••••• CopyBase URLhttps://runapi.ai/v1 Copy -
Cursor 설정 열기
Cursor 설정에서 Models를 선택하고 API Keys를 펼치세요.
-
Base URL 입력하기
Override OpenAI Base URL을 켜서 입력란을 표시한 다음 https://runapi.ai/v1 을 입력하세요.
-
Paste your key and click Enable
OpenAI API Key에 RunAPI 키를 붙여 넣고 저장한 뒤 해당 스위치를 켜세요. Override OpenAI Base URL도 켜 두세요.
-
모델 선택 및 테스트
채팅 모델 메뉴에서 GPT-5.6 Sol(API ID: gpt-5.6-sol)을 선택하세요. 없으면 Settings > Models에서 ID를 검색하고, Add Custom Model이 표시되고 요금제가 지원할 때만 추가하세요. Auto는 선택하지 마세요. 짧은 메시지를 보낸 뒤 해당 RunAPI 사용 기록을 확인하세요. 응답만으로는 요청 경로를 확인할 수 없습니다.
Reply with exactly: Hello from RunAPI.
Cursor의 'unauthorized user api key' 오류 해결하기
Base URL 누락
RunAPI 키와 https://runapi.ai/v1 은 지원되는 OpenAI API 요청에 사용합니다. Auto와 Cursor 전용 기능은 이 키를 통해 요청하지 않습니다.
여분의 공백이 포함된 키 복사
Paste the key and look for a leading or trailing space. Some terminals and browsers add invisible whitespace when you copy. Delete the field and paste again if in doubt.
만료되거나 취소된 키
RunAPI 키는 대시보드에서 취소할 수 있습니다. 최근에 키를 재생성했다면 이전 값은 401 오류를 반환합니다. Dashboard > API Keys에서 새 키를 복사합니다.
잘못된 모델 슬러그
키와 URL이 올바르지만 특정 모델에서 오류가 발생하면, 모델 이름이 RunAPI 카탈로그와 일치하지 않을 수 있습니다. runapi.ai/pricing에서 정확한 슬러그를 확인하고 Cursor의 모델 필드에 붙여넣습니다.
RunAPI가 Cursor Pro보다 저렴한가요?
Cursor 구독료와 RunAPI API 사용료는 별도로 청구됩니다. BYOK는 필요한 Cursor 구독을 대체하지 않습니다. 두 서비스의 현재 가격과 제한을 확인하세요. 일정한 할인율이나 무제한 사용은 보장되지 않습니다.
Cursor API 키 설정 FAQ
Base URL, 키, 잔액 및 모델 접근 권한을 확인하세요. RunAPI 키에는 https://runapi.ai/v1 을 사용합니다. 인증 오류는 원인 확인이 필요하며 URL 변경만으로 해결이 보장되지는 않습니다.
Cursor 지원팀에 따르면 Agent 또는 Composer에서 개인 API 키와 사용자 지정 Base URL을 사용하려면 유료 요금제가 필요합니다. 무료 계정은 설정을 저장해도 전송이 차단될 수 있습니다. API 서비스를 구매하기 전에 요금제 권한을 확인하세요.
Settings > Models와 Cursor의 API Keys 문서에서 지원 범위를 확인하세요. 표시 이름은 API ID와 다를 수 있으며 GPT-5.6 Sol은 gpt-5.6-sol에 해당합니다. 사용 가능 여부는 Cursor 요금제와 연동 지원에 따라 달라집니다.
Cursor 구독료와 RunAPI API 사용료는 별도로 청구됩니다. BYOK는 필요한 Cursor 구독을 대체하지 않습니다. 두 서비스의 현재 가격과 제한을 확인하세요. 일정한 할인율이나 무제한 사용은 보장되지 않습니다.
네. RunAPI 키 하나로 Cursor, Windsurf, Claude Code, Codex 및 사용자 지정 OpenAI 호환 엔드포인트를 허용하는 모든 도구에서 사용할 수 있습니다. 사용량과 지출이 하나의 RunAPI 대시보드에 통합되므로 도구별로 별도의 키나 잔액을 관리할 필요가 없습니다.
RunAPI 키와 https://runapi.ai/v1 은 지원되는 OpenAI API 요청에 사용합니다. Auto와 Cursor 전용 기능은 이 키를 통해 요청하지 않습니다.
Cursor API 키 연동이 지원하는 모델과 기능만 사용하세요. OpenAI 호환 형식만으로 Cursor 호환성이 보장되지는 않습니다. Auto는 개인 API 키를 사용하지 않으며 Cursor 전용 기능은 자체 서비스를 사용합니다.
짧은 테스트 메시지를 보낸 다음 RunAPI 대시보드에서 해당 모델과 사용 기록을 확인하세요. Cursor가 “Free plans can only use Auto”를 표시하면 현재 Cursor 요금제가 사용자 지정 API 키를 지원하는지 확인하세요.
더 알아보기
지금 바로 자체 API 키로 Cursor 사용 시작하기
팀과 함께 구축하고 계신가요?
엔터프라이즈 설정, 통합, 기술 문의를 도와드립니다.