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

# API 설정

> SoloEnt에서 AI 모델 API Key 설정하기

API Key를 설정하여 SoloEnt의 AI 집필 기능을 활성화하세요.

## 설정 진입점

### 대화에서 빠르게 설정

<Steps>
  <Step title="대화 창 하단의 모델 이름 클릭">
    Agent 대화 하단의 모델 이름을 클릭하면 모델 설정 페이지가 열립니다.
  </Step>
</Steps>

<img src="https://mintcdn.com/soloent/4RpSHkUFmW5kEqcF/assets/images/apikey_1.png?fit=max&auto=format&n=4RpSHkUFmW5kEqcF&q=85&s=a380930952d0ba22b51d93be0f9a74f3" alt="대화에서 빠르게 API 설정" style={{ width: '70%', maxWidth: '400px', display: 'block' }} width="686" height="272" data-path="assets/images/apikey_1.png" />

### 설정 패널을 통해

<Steps>
  <Step title="Agent 설정 열기">
    Agent 패널의 설정 아이콘을 클릭합니다.
  </Step>

  <Step title="모델 설정으로 이동">
    공식 모델을 바로 사용할지, 자체 모델(BYOK)을 설정할지 선택할 수 있습니다.
  </Step>
</Steps>

<img src="https://mintcdn.com/soloent/4RpSHkUFmW5kEqcF/assets/images/apikey_3.png?fit=max&auto=format&n=4RpSHkUFmW5kEqcF&q=85&s=261ac83f5e7036db95d25d509c2cc432" alt="설정 패널을 통해 API 설정" style={{ width: '70%', maxWidth: '400px', display: 'block' }} width="812" height="1072" data-path="assets/images/apikey_3.png" />

## 공식 API

SoloEnt는 공식 API를 제공하며, 계정에 로그인하면 바로 사용할 수 있습니다. 서드파티 Key를 직접 신청할 필요가 없습니다.

### 무료 모델

공식에서 무료 모델을 제공하며, 로그인하면 바로 사용할 수 있습니다. 사용 가능한 무료 모델과 할인은 운영 이벤트에 따라 지속적으로 업데이트됩니다.

<Note>
  모든 등록 사용자에게 **\$0.5** 의 체험 크레딧이 제공됩니다. [플랫폼 이벤트](https://soloent.ai/ko/activities)에 참여하면 더 많은 무료 크레딧을 받을 수 있습니다.
</Note>

<img src="https://mintcdn.com/soloent/4RpSHkUFmW5kEqcF/assets/images/apikey_4.png?fit=max&auto=format&n=4RpSHkUFmW5kEqcF&q=85&s=da746ca341868270d88d79da60e4fd00" alt="설정 패널에서 SoloEnt AI를 API 공급자로 표시하고 Free 탭에 사용 가능한 무료 모델을 나열" style={{ width: '70%' }} width="720" height="948" data-path="assets/images/apikey_4.png" />

<Warning>
  무료 모델은 도구를 체험하기 위한 것으로, 사용자가 많을 때 등의 이유로 응답이 느리거나 불안정할 수 있습니다.
</Warning>

### 구독 사용자 모델(VIP)

Lite, Pro, Max 세 단계의 구독 사용자는 Anthropic, OpenAI, Google, DeepSeek 등 주요 공급자의 최신 모델을 포함한 VIP 목록의 모든 모델을 서드파티 API Key 설정 없이 바로 사용할 수 있습니다.

<Note>
  SoloEnt의 API 요금은 각 모델 회사의 공식 요금과 동일하며 추가 수수료가 없습니다. 또한 모델별로 수시로 다양한 할인이 제공됩니다.
</Note>

모든 공식 모델과 최신 할인 정보는 [soloent.ai/en/models](https://soloent.ai/en/models) 에서 확인할 수 있습니다.

***

## 서드파티 API Key 설정하기

API Key는 AI 모델에 접근하기 위한 인증 자격 증명으로, 보통 무작위 문자열입니다:

```
sk-abc123xyz456def789ghi012jkl345mno678pqr901stu234
```

<Warning>
  **중요**: API 이용은 월간 구독과 별도로 청구됩니다. \$20 구독에는 API 이용료가 포함되지 않습니다. 예를 들어 가입한 Gemini 멤버십을 여기서 API로 사용할 수는 없습니다.
</Warning>

### API Key를 얻는 곳

#### 인기 공급자

| 공급자             | 최신 모델                              | 주요 용도                    |
| --------------- | ---------------------------------- | ------------------------ |
| **OpenAI**      | GPT-5.6                            | 집필 리서치, 일반 집필            |
| **Anthropic**   | Claude Sonnet-5 / Opus-5 / Fable-5 | 스토리 기획, 전략적 사고, 본문 집필    |
| **Google**      | Gemini-3.1-pro                     | 빠름, 비용 효율적, 산문 집필, 멀티모달  |
| **xAI**         | Grok-4.5                           | 실시간 정보, 유연한 콘텐츠 정책, 멀티모달 |
| **DeepSeek**    | DeepSeek-V4-pro                    | 경제적, 유연한 콘텐츠 정책          |
| **Zhipu AI**    | GLM-5.2                            | 스토리 기획, 중국어 콘텐츠          |
| **Moonshot AI** | Kimi-K3                            | 긴 컨텍스트, 중국어 콘텐츠          |
| **OpenRouter**  | 여러 모델                              | 통합 접근, 모델 비교             |

<Tip>
  자세한 공급자 정보와 등록 절차는 [전체 API 디렉터리](../resources/api-directory) 를 참고하세요.
</Tip>

<Card title="무료 API Key 얻기" icon="gift" href="../resources/free-api-keys">
  무료 등급 옵션과 커뮤니티 리소스 살펴보기
</Card>

### 구매한 API 정보를 올바르게 입력하기

#### 표준 설정(공식 공급자)

OpenAI, Anthropic, Google 및 일부 애그리게이터에 해당합니다. API Provider 드롭다운 목록에서 해당 모델 공급자를 찾아 API Key만 입력하면 됩니다:

```plaintext theme={null}
API Key: sk-abc123xyz456...
```

#### OpenAI 호환 설정(서드파티)

API Provider 드롭다운 목록에서 **OpenAI Compatible** 을 선택하면 서드파티 공급자를 설정할 수 있습니다.

<img src="https://mintcdn.com/soloent/4RpSHkUFmW5kEqcF/assets/images/zh/faq_api_openai.png?fit=max&auto=format&n=4RpSHkUFmW5kEqcF&q=85&s=eb6732c3e8b473cb83128b64173916ce" alt="API Configuration 패널에서 API Provider 드롭다운을 펼치고 OpenAI Compatible 옵션을 빨간 테두리로 강조" style={{ width: '70%' }} width="934" height="992" data-path="assets/images/zh/faq_api_openai.png" />

대부분의 서드파티 공급자는 세 개의 필드를 모두 입력해야 합니다:

<ParamField path="base_url" type="string" required>
  API 엔드포인트 URL(예: `https://api.provider.com/v1`)
</ParamField>

<ParamField path="api_key" type="string" required>
  당신의 API Key
</ParamField>

<ParamField path="model_id" type="string" required>
  모델 식별자(예: `gpt-4-turbo`)
</ParamField>

<Warning>
  세 필드는 모두 필수입니다. 구매 전 공급자에게 확인하세요.
</Warning>

#### 로컬 LLM

자신의 컴퓨터에서 AI 모델을 실행하여 프라이버시를 보호하고 오프라인으로도 이용할 수 있습니다.

| 솔루션           | 모델                        | 주요 용도               |
| ------------- | ------------------------- | ------------------- |
| **Ollama**    | Llama 3.1, Qwen, DeepSeek | 간편한 설정, macOS/Linux |
| **LM Studio** | 여러 오픈 모델                  | GUI 인터페이스, 크로스 플랫폼  |
| **vLLM**      | 커스텀 배포                    | 고성능, 프로덕션 환경        |

<Card title="로컬 모델 설정 가이드" icon="laptop" href="../resources/local-llms">
  로컬에서 모델을 실행하는 완전 가이드
</Card>

## SoloEnt에서 Codex / Claude Code 구독 사용하기

이미 OpenAI Codex 또는 Claude Code 구독이 있다면, 그 크레딧을 SoloEnt에서 그대로 재사용하면서 SoloEnt의 전문 집필 Skill을 활용할 수 있습니다——별도의 API Key를 구매할 필요가 없습니다.

#### Codex 구독 사용하기

**BYOK** 를 선택하고 API Provider 목록에서 **OpenAI Codex** 를 선택한 뒤 OpenAI Codex 로그인을 클릭합니다. 로그인에 성공하면 Codex가 제공하는 모델(GPT-5.x 등)을 모델 목록에서 선택할 수 있습니다. ChatGPT Plus 또는 Pro 구독을 사용할 때는 추가 API 키가 필요 없습니다.

<img src="https://mintcdn.com/soloent/4RpSHkUFmW5kEqcF/assets/images/codex.png?fit=max&auto=format&n=4RpSHkUFmW5kEqcF&q=85&s=0ec7f282fa0033e736f5ea351ab60a93" alt="BYOK 설정에서 API Provider를 OpenAI Codex로 선택하고 Sign in to OpenAI Codex 버튼을 표시" style={{ width: '55%' }} width="642" height="1046" data-path="assets/images/codex.png" />

#### Claude Code 구독 사용하기

먼저 로컬 컴퓨터에 **Claude Code CLI** 를 설치하고 Claude Code 구독 계정을 연결하여 로컬 환경에서 Claude Code가 정상적으로 실행되는지 확인합니다. 그런 다음 **BYOK** 를 선택하고 목록에서 **Claude Code** 를 선택하면, 다른 설정 없이 사용하려는 Claude 모델을 모델 목록에서 바로 선택할 수 있습니다.

<img src="https://mintcdn.com/soloent/4RpSHkUFmW5kEqcF/assets/images/claudecode.png?fit=max&auto=format&n=4RpSHkUFmW5kEqcF&q=85&s=cb4ad3d2c3c24fb07806b165fe8997c1" alt="BYOK 설정에서 API Provider를 Claude Code로 선택하고 Claude Code CLI Path와 모델 선택 항목을 표시" style={{ width: '55%' }} width="632" height="980" data-path="assets/images/claudecode.png" />

## 일반적인 오류 설명

| 원인          | 오류 코드 | 오류 메시지                                                 |
| ----------- | :---: | ------------------------------------------------------ |
| 모델 누락       | `400` | `Missing model`                                        |
| 예산 초과       | `403` | `Budget exceeded`                                      |
| 무료 크레딧 소진   | `403` | `Daily free quota used up, please try again tomorrow.` |
| 모델을 찾을 수 없음 | `404` | `Model not found`                                      |

<Note>
  서드파티 모델의 불안정성으로 인한 기타 오류는 SoloEnt에서 현재 정확히 진단할 수 없습니다.
</Note>

## 기타 자주 묻는 질문

<AccordionGroup>
  <Accordion title="API Key가 유효하지 않음">
    * Key 전체를 복사했는지 확인
    * Key가 만료되지 않았는지 확인
    * 공급자 콘솔에서 재생성
  </Accordion>

  <Accordion title="연결 실패">
    * 네트워크 연결 확인
    * Base URL 확인(OpenAI Compatible 설정의 경우)
    * VPN 없이 시도
  </Accordion>
</AccordionGroup>

## 다음 단계

<CardGroup cols={2}>
  <Card title="언어 설정" icon="language" href="./language-settings">
    선호하는 언어 설정하기
  </Card>

  <Card title="집필 시작하기" icon="pen-to-square" href="../tips/create-project">
    첫 프로젝트 만들기
  </Card>

  <Card title="로컬 모델" icon="laptop" href="../resources/local-llms">
    자신의 컴퓨터에서 AI 모델 실행하기
  </Card>

  <Card title="무료 API Key" icon="gift" href="../resources/free-api-keys">
    AI 모델에 무료로 접근하기
  </Card>
</CardGroup>