> For the complete documentation index, see [llms.txt](https://orbitron.gitbook.io/orbitron-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://orbitron.gitbook.io/orbitron-docs/documentation/ko/user-guide/registering-an-api-key.md).

# API 키 등록

Orbitron의 AI 기능을 사용하려면 로그인 후 지원되는 모델 제공업체에서 **최소 하나의 API 키를 등록해야 합니다**.

유효한 API 키가 없으면 Orbitron은 AI 서비스와 통신할 수 없으며 다음과 같은 경고가 표시될 수 있습니다:

```
API 키를 찾을 수 없습니다. 계속하려면 유효한 API 키를 추가하세요.
```

***

### 🧭 언제 어디서 등록하나요

처음 로그인 후 Orbitron이 자동으로 **API 키 등록 다이얼로그**를 엽니다.

언제든지 수동으로 이 다이얼로그를 열 수도 있습니다:

* `Ctrl + p` 누르기
* 또는 명령어 입력:

  ```bash
  /provider
  ```

거기서 **선호하는 AI 제공업체의 API 키를 입력**합니다.

<div align="left"><figure><img src="/files/HImBBplARJHeEutu6VRu" alt="" width="563"><figcaption></figcaption></figure></div>

<div align="left"><figure><img src="/files/ULzsTqNtU0exI65k75QW" alt="" width="563"><figcaption></figcaption></figure></div>

<div align="left"><figure><img src="/files/TftOUvaHvVolFfsu7KLT" alt="" width="563"><figcaption></figcaption></figure></div>

***

### 🛠 API 키 추가 방법

1. API 키 다이얼로그 열기 (자동 또는 수동)
2. 사용하려는 **제공업체** 선택 (예: OpenAI, Claude, Gemini 등)
3. 필드에 API 키 붙여넣기
4. 키 저장

> 💡 여러 제공업체에 대해 여러 API 키를 등록할 수 있습니다.

***

### 📡 지원되는 모델 제공업체

다음 AI 플랫폼에 대해 API 키를 등록할 수 있습니다:

| 제공업체                       | 지원되는 모델                                                                                                                                                                                             |
| -------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Anthropic**              | - Claude 4 Opus- Claude 4 Sonnet- Claude 3.7 Sonnet- Claude 3.5 Sonnet- Claude 3.5 Haiku- Claude 3 Haiku- Claude 3 Opus                                                                             |
| **OpenAI**                 | - GPT-4.1 family (`gpt-4.1`, `gpt-4.1-mini`, `gpt-4.1-nano`)- GPT-4.5 Preview- GPT-4o family (`gpt-4o`, `gpt-4o-mini`)- O1 family (`o1`, `o1-pro`, `o1-mini`)- O3 family (`o3`, `o3-mini`)- O4 Mini |
| **Google (Gemini)**        | - Gemini 2.5 Pro- Gemini 2.5 Flash- Gemini 2.0 Flash- Gemini 2.0 Flash Lite                                                                                                                         |
| **AWS Bedrock**            | - Claude 4 Opus- Claude 4 Sonnet- Claude 3.7 Sonnet- Claude 3.5 Sonnet- Claude 3.5 Haiku- Claude 3 Haiku- Claude 3 Opus                                                                             |
| **Google Cloud Vertex AI** | - Claude 4 Opus- Claude 4 Sonnet- Claude 3.7 Sonnet- Claude 3.5 Haiku                                                                                                                               |
| **Groq**                   | - LLaMA 4 Maverick (17b-128e-instruct)- LLaMA 4 Scout (17b-16e-instruct)- Qwen QWQ-32B- Deepseek R1 distill LLaMA 70B- LLaMA 3.3 70B Versatile                                                      |

> 각 제공업체마다 청구 설정과 특정 API 토큰 범위가 필요할 수 있습니다.

***

### 🧠 모델 선택 동작

기본적으로 Orbitron은 사용자가 명시적으로 제공업체나 모델을 선택하지 않는 한 **내부 제공업체 우선순위를 기반으로** AI 모델을 선택합니다.

* 여러 API 키가 등록된 경우 플랫폼이 내장된 우선순위 로직을 사용하여 **자동으로 기본 모델을 할당**합니다.
* 런타임에 수동으로 모델이나 제공업체를 선택하여 이 동작을 재정의할 수 있습니다.

#### 🧭 모델 선택 방법

다음을 사용하여 **모델 선택 다이얼로그**를 열 수 있습니다:

* **`Ctrl + O`** 누르기
* 또는 명령어 입력:

  ```bash
  /model
  ```

다이얼로그가 나타나면 사용 가능한 제공업체와 모델 목록에서 선호하는 모델을 선택할 수 있습니다 (예: OpenAI GPT-4, Claude 3, Gemini Pro 등).

> 💡 이를 통해 다양한 작업이나 세션에 사용되는 모델을 세밀하게 제어할 수 있습니다.