> ## Documentation Index
> Fetch the complete documentation index at: https://docs.apiany.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Cursor 연동

> Cursor에서 APIAny.AI API Key, Base URL, 추천 모델을 설정합니다.

[Cursor](https://cursor.com/)는 OpenAI 호환 설정을 통해 APIAny.AI에 연결할 수 있습니다. 설정을 완료하면 동일한 클라이언트에서 대화, 추론, 번역, 멀티모달 모델을 사용할 수 있습니다.

## 준비 사항

* Cursor가 설치되어 있습니다.
* [APIAny.AI 대시보드](https://apiany.ai/ko/dashboard/api-keys)에서 API Key를 생성했습니다.
* `gpt-5.4-mini`나 `gpt-4o-mini`와 같은 사용할 모델 ID를 선택했습니다.

## 설정 값

| 필드                       | 값                         |
| ------------------------ | ------------------------- |
| OpenAI API Key           | 사용자의 APIAny.AI API Key    |
| Override OpenAI Base URL | `https://apiany.ai/v1`    |
| 모델                       | `gpt-5.4-mini`, `gpt-5.5` |

## 설정 단계

1. Cursor 설정에서 Models 영역을 엽니다.
2. OpenAI API Key 설정을 활성화합니다.
3. API Key를 입력하고 OpenAI Base URL을 APIAny.AI 주소로 덮어씁니다.
4. 필요한 모델 ID를 추가하고 Chat 또는 Composer에서 테스트합니다.

## 추천 모델

| 모델 ID               | 적합한 용도                                   |
| ------------------- | ---------------------------------------- |
| `gpt-5.5`           | 복잡한 추론, 코딩, 프로덕션 워크플로에 가장 먼저 추천하는 모델입니다. |
| `gpt-5.4`           | 고급 대화 및 에이전트 작업에 적합한 강력한 범용 모델입니다.       |
| `gpt-5.4-mini`      | 속도, 품질, 비용의 균형이 잡혀 일상적인 사용에 적합합니다.       |
| `gpt-4o-mini`       | 간단한 대화, 번역, 경량 작업에 적합하며 빠르고 경제적입니다.      |
| `claude-sonnet-4-6` | 장문 작성 및 코딩 워크플로를 위한 Claude 호환 모델 ID입니다.  |
| `gemini-3.5-flash`  | 빠른 멀티모달 사용을 위한 Gemini 호환 모델 ID입니다.       |

## 단계별 스크린샷

아래 스크린샷은 Cursor의 주요 설정 화면을 보여줍니다. 스크린샷의 API 주소와 이름은 APIAny.AI에 맞게 조정되어 있습니다.

### 1단계

<img src="https://mintcdn.com/lingquai/Twqr-r52XykGBMod/images/integrations/cursor/main-interface.png?fit=max&auto=format&n=Twqr-r52XykGBMod&q=85&s=917805a45622af61e0e5cd680d3656f1" alt="Cursor setup screenshot 1" width="1200" height="800" data-path="images/integrations/cursor/main-interface.png" />

### 2단계

<img src="https://mintcdn.com/lingquai/Twqr-r52XykGBMod/images/integrations/cursor/settings-models.png?fit=max&auto=format&n=Twqr-r52XykGBMod&q=85&s=4ee3fec725f911675dced3b8247c1421" alt="Cursor setup screenshot 2" width="1200" height="800" data-path="images/integrations/cursor/settings-models.png" />

### 3단계

<img src="https://mintcdn.com/lingquai/Twqr-r52XykGBMod/images/integrations/cursor/api-config.png?fit=max&auto=format&n=Twqr-r52XykGBMod&q=85&s=92b93d3393e3ded201828318ffede58d" alt="Cursor setup screenshot 3" width="1200" height="800" data-path="images/integrations/cursor/api-config.png" />

### 4단계

<img src="https://mintcdn.com/lingquai/Twqr-r52XykGBMod/images/integrations/cursor/api-model.png?fit=max&auto=format&n=Twqr-r52XykGBMod&q=85&s=3873a6652258b5fdc2d69c187ac4ef8c" alt="Cursor setup screenshot 4" width="1200" height="800" data-path="images/integrations/cursor/api-model.png" />

### 5단계

<img src="https://mintcdn.com/lingquai/Twqr-r52XykGBMod/images/integrations/cursor/ai-chat.png?fit=max&auto=format&n=Twqr-r52XykGBMod&q=85&s=f4a0d30ac8b54e71e35c8d240cbb24cd" alt="Cursor setup screenshot 5" width="1200" height="800" data-path="images/integrations/cursor/ai-chat.png" />

### 6단계

<img src="https://mintcdn.com/lingquai/Twqr-r52XykGBMod/images/integrations/cursor/autocomplete.png?fit=max&auto=format&n=Twqr-r52XykGBMod&q=85&s=e8447ebaf4ed2e546cba8abbbbb09a0a" alt="Cursor setup screenshot 6" width="1925" height="1025" data-path="images/integrations/cursor/autocomplete.png" />

### 7단계

<img src="https://mintcdn.com/lingquai/Twqr-r52XykGBMod/images/integrations/cursor/quick-edit.png?fit=max&auto=format&n=Twqr-r52XykGBMod&q=85&s=86f8c8a97c321726b35d385cb6b13474" alt="Cursor setup screenshot 7" width="1920" height="1031" data-path="images/integrations/cursor/quick-edit.png" />

## 문제 해결

### 401 또는 인증 오류

API Key가 완전히 복사되었는지, 앞뒤에 불필요한 공백이 없는지, APIAny.AI 대시보드에서 활성화되어 있는지 확인하세요.

### 모델이 앱에 표시되지 않음

모델 ID를 직접 입력하고 [모델 카탈로그](/ko/models/chat-models)에서 사용 가능한지 확인하세요. 일부 도구는 모델 목록을 자동으로 가져오지 않습니다.

### 어떤 Base URL을 사용해야 하나요?

OpenAI 호환 설정에서는 일반적으로 `https://apiany.ai/v1`을, Claude 호환 설정에서는 일반적으로 `https://apiany.ai`를 사용합니다. 전체 엔드포인트 주소를 요구하는 도구에서는 `https://apiany.ai/v1/chat/completions`를 사용하세요.