Cursor에서 BeatAPI 사용하기

Cursor는 AI 코드 편집기입니다. 모델 설정에서 OpenAI 호환 엔드포인트를 받으므로 확장 프로그램 없이 BeatAPI를 사용자 지정 제공자로 지정할 수 있습니다.

사전 준비

1. Cursor 설치.
2. BeatAPI API 키 — 대시보드 → API Keys에서 만드세요.

1단계: 모델 설정 열기

오른쪽 위의 톱니바퀴 아이콘이나 Cmd+Shift+J(macOS), Ctrl+Shift+J(Windows, Linux)로 Settings를 연 다음 사이드바에서 Models를 선택하세요.

2단계: BeatAPI로 연결

OpenAI API Key 섹션에서 Override OpenAI Base URL을 켜고 다음을 입력하세요.

설정을 저장한 다음 지원되는 짧은 채팅 요청을 보내고 BeatAPI 사용 기록에서 해당 기록을 확인하세요.

3단계: 사용할 모델 추가

Cursor는 자체 모델 목록을 관리하며, 목록에 있다고 해서 사용자 지정 키로 동작한다는 보장은 없습니다. Cursor의 자체 API 키 사용 가이드는 OpenAI 사용자 지정 키를 지원되는 표준 비추론 채팅 모델로 제한합니다. 현재 Cursor가 허용하는 모델을 확인하고, GET /v1/models에서 BeatAPI 계정으로 사용할 수 있는 정확한 ID를 골라 짧은 채팅 요청을 보낸 뒤 연동을 사용하세요. BeatAPI가 OpenAI 호환 엔드포인트를 제공한다고 해서 Claude 모델이나 추론 모델이 Cursor의 OpenAI 키 재정의로 동작한다고 가정하지 마세요.

사용자 지정 키는 지원되는 채팅 요청에만 적용되며, Cursor Tab 자동 완성은 계속 Cursor 내장 모델을 사용합니다. 사용자 지정 모델 설정에 성공해도 모든 Cursor 기능이 BeatAPI를 쓰는 것은 아닙니다. 실제 요청은 BeatAPI 사용 기록에서 확인하세요.

4단계: 사용하기

• Chat — Cmd+L / Ctrl+L을 누르고 질문하거나 작업을 설명하세요.
• 인라인 편집 — 코드를 선택하고 Cmd+K / Ctrl+K를 누르세요. 선택한 모델과 현재 Cursor 버전에서 이 요청이 사용자 지정 키로 전달되는지 확인하세요.
• Tab 자동 완성 — BeatAPI 사용자 지정 제공자가 아니라 계속 Cursor 내장 모델을 사용합니다.

파일은 @filename, 디렉터리는 @folder로 참조하면 모델이 열린 버퍼에서 추측하지 않고 올바른 컨텍스트를 봅니다.

자주 묻는 질문

Cursor가 BeatAPI에 연결되지 않음

1. Base URL은 정확히 https://api.beatapi.io/v1여야 합니다.
2. 키가 활성 상태여야 합니다. 대시보드 → API Keys에서 확인하세요.
3. 회사 프록시를 사용한다면 api.beatapi.io를 허용하세요.

목록의 모델이 동작하지 않음

Cursor의 목록은 Cursor 자체 목록입니다. 계정에서 실제로 제공하는 ID만 응답합니다. 현재 목록은 가격 페이지를 참고하세요.

402 insufficient_credits

잔액 부족: 잔액이 0이거나 요청 가격보다 적습니다. 대시보드에서 충전하세요.

429 rate_limit_exceeded

키의 요청 속도 한도를 넘었습니다. 이 키의 BeatAPI 사용 기록을 확인하고 지원되는 모델을 선택하거나 대시보드에서 키 한도를 조정하세요. Cursor Tab 자동 완성은 이 사용자 지정 제공자를 쓰지 않습니다.

응답이 느림

지원되는 채팅 요청에서는 더 가벼운 모델을 쓰고, 선택 범위를 좁히고, 큰 코드 블록을 붙여 넣기보다 @file 참조를 사용하세요.

Cursor의 최신 자체 API 키 사용 가이드에 사용자 지정 키를 쓸 수 있는 요청이 설명되어 있습니다. Cursor가 모델 라우팅을 바꾸면 다시 확인하세요.

지원

대시보드에서 지원 티켓을 열고 실패한 응답의 request_id를 함께 보내 주세요.