# 모델 선택하기

RunYour AI API 라우터는 여러 프로바이더(OpenAI, Anthropic, Google 등)의 모델을 지원합니다. 모델 ID만 바꾸면 어떤 모델이든 즉시 전환할 수 있습니다.

***

### 모델 ID 형식

모델은 **`프로바이더/모델명`** 형식으로 지정합니다.

```
provider/model-name

예: openai/gpt-5.2
예: claude/claude-sonnet-4-6
예: gemini/gemini-2.5-pro
```

***

### 지원 모델 목록

Gitbook 매뉴얼에 즉시 활용하실 수 있도록, Runyour AI Router에서 지원하는 최신 모델 정보를 프로바이더별 테이블 형식으로 정리해 드립니다. 모든 내용은 제공해주신 최신 사양을 바탕으로 구성되었습니다.

***

### 🚀 Runyour API Router 지원 모델 목록

Runyour API Router는 bifrost 오픈소스 코어를 기반으로 하며, 최신 LLM들을 통합하여 최적의 경로로 제공합니다.

#### 1. OpenAI 지원 모델

<table data-header-hidden><thead><tr><th width="173.97265625"></th><th width="86.375"></th><th></th></tr></thead><tbody><tr><td><strong>모델 ID</strong></td><td><strong>프로바이더</strong></td><td><strong>특징 (Feature)</strong></td></tr><tr><td><code>openai/gpt-5.5</code></td><td>OpenAI</td><td>최첨단 지능. 코딩 및 전문적인 업무 수행을 위한 새로운 차원의 지능을 제공합니다.</td></tr><tr><td><code>openai/gpt-5.5-pro</code></td><td>OpenAI</td><td>최고 정밀도. GPT-5.5를 기반으로 더욱 스마트하고 정교한 응답을 생성하는 고성능 버전입니다.</td></tr><tr><td><code>openai/gpt-5.4</code></td><td>OpenAI</td><td>고성능 효율. 코딩 및 전문 업무를 위해 보다 합리적인 비용으로 제공되는 모델입니다.</td></tr><tr><td><code>openai/gpt-5.4-pro</code></td><td>OpenAI</td><td>지능형 분석. GPT-5.4 모델 중 더욱 정밀한 답변과 분석이 가능한 고급 버전입니다.</td></tr><tr><td><code>openai/gpt-5.4-mini</code></td><td>OpenAI</td><td>강력한 소형 모델. 코딩, 컴퓨터 사용(Computer Use), 서브 에이전트 구성에 최적화된 역대 가장 강력한 미니 모델입니다.</td></tr><tr><td><code>openai/gpt-5.4-nano</code></td><td>OpenAI</td><td>초저비용. 단순 반복적인 대량 작업을 처리하기 위한 가장 경제적인 GPT-5.4급 모델입니다.</td></tr><tr><td><code>openai/gpt-5-mini</code></td><td>OpenAI</td><td>저지연 지능. 비용에 민감하고 빠른 응답이 필요한 대규모 워크로드에 적합한 최첨단급 지능형 모델입니다.</td></tr><tr><td><code>openai/gpt-5-nano</code></td><td>OpenAI</td><td>초고속 성능. GPT-5 계열 중 가장 빠르고 비용 효율적인 운영이 가능한 버전입니다.</td></tr><tr><td><code>openai/gpt-5</code></td><td>OpenAI</td><td>추론 특화. 코딩 및 에이전트 작업에 최적화되어 있으며 추론 강도(Reasoning Effort) 설정이 가능한 모델입니다.</td></tr><tr><td><code>openai/gpt-4.1</code></td><td>OpenAI</td><td>범용 지능. 추론 전용 모델을 제외한 일반 모델 중 가장 스마트한 성능을 발휘합니다.</td></tr></tbody></table>

#### 2. Anthropic (Claude) 지원 모델

<table data-header-hidden><thead><tr><th width="181.72265625"></th><th width="103.20703125"></th><th></th></tr></thead><tbody><tr><td><strong>모델 ID</strong></td><td><strong>프로바이더</strong></td><td><strong>특징 (Feature)</strong></td></tr><tr><td><code>anthropic/claude-opus-4-7</code></td><td>Anthropic</td><td>최고 성능. 초고난이도 추론(X-High Reasoning)과 정교한 분석 능력 제공</td></tr><tr><td><code>anthropic/claude-opus-4-6</code></td><td>Anthropic</td><td>대규모 문서 분석 및 복잡한 맥락 이해가 필요한 프로젝트에 최적화</td></tr><tr><td><code>anthropic/claude-sonnet-4-6</code></td><td>Anthropic</td><td>주력 모델. 지능과 속도의 완벽한 균형으로 기업용 챗봇 및 자동화에 적합</td></tr><tr><td><code>anthropic/claude-sonnet-4-5</code></td><td>Anthropic</td><td>향상된 시각 분석 기능과 정교한 코딩 지시 이행 능력 보유</td></tr><tr><td><code>anthropic/claude-3.7-sonnet</code></td><td>Anthropic</td><td>안정적인 추론 성능과 자연스러운 한국어 문장 생성 능력을 갖춘 모델</td></tr><tr><td><code>anthropic/claude-haiku-4-5</code></td><td>Anthropic</td><td>초고속 응답. 실시간 고객 응대 및 대량의 단순 데이터 처리에 특화</td></tr><tr><td><code>anthropic/claude-3.5-haiku</code></td><td>Anthropic</td><td>Haiku 모델 중 가장 높은 지능을 갖춘 고효율 가성비 모델</td></tr></tbody></table>

#### 3. Google (Gemini) 지원 모델

<table data-header-hidden><thead><tr><th width="185.4765625"></th><th width="107.98046875"></th><th></th></tr></thead><tbody><tr><td><strong>모델 ID</strong></td><td><strong>프로바이더</strong></td><td><strong>특징 (Feature)</strong></td></tr><tr><td><code>google/gemini-3.1-pro</code></td><td>Google</td><td>최신 모델. 구글의 가장 진보된 AI로 복잡한 지시 이행 및 논리적 추론 강화</td></tr><tr><td><code>google/gemini-3-flash-preview</code></td><td>Google</td><td>대규모 데이터 세트 기반의 전문 지식 답변 및 멀티모달 처리 최적화</td></tr><tr><td><code>google/gemini-2.5-pro</code></td><td>Google</td><td>비디오, 오디오 분석을 포함한 가장 강력한 멀티모달 분석 지능 제공</td></tr><tr><td><code>google/gemini-2.5-flash</code></td><td>Google</td><td>높은 지능을 유지하면서 지연 시간을 획기적으로 줄인 고속 플래시 모델</td></tr><tr><td><code>google/gemini-2.5-flash-lite</code></td><td>Google</td><td>극도로 낮은 지연 시간과 비용 효율성을 극대화한 경량 멀티모달 모델</td></tr><tr><td><code>google/gemma-3-27b</code></td><td>Google</td><td>특정 도메인 커스텀 및 연구용으로 적합한 고성능 오픈 가중치 모델</td></tr></tbody></table>

{% hint style="info" %}
모델 목록은 계속 업데이트됩니다. 현재 사용 가능한 전체 모델 목록은 **API로 직접 조회**하거나 콘솔에서 확인할 수 있습니다.
{% endhint %}

***

### 현재 사용 가능한 모델 목록 조회하기

API를 통해 실시간으로 사용 가능한 모델 전체 목록을 확인할 수 있습니다.

{% tabs %}
{% tab title="Python" %}

```python
models = client.models.list()

for m in models.data:
    print(m.id)
```

{% endtab %}

{% tab title="JavaScript" %}

```javascript
const models = await client.models.list();
console.log(models.data.map((m) => m.id));
```

{% endtab %}

{% tab title="cURL" %}

```bash
curl "https://api.runyour.ai/v1/models" \
  -H "Authorization: Bearer runyour-v1-YOUR_API_KEY"
```

{% endtab %}
{% endtabs %}

***

### 모델 전환하기

`model` 파라미터의 값만 바꾸면 됩니다. 나머지 코드는 동일하게 사용할 수 있습니다.

{% tabs %}
{% tab title="Python" %}

```python
# OpenAI GPT-5.2 사용
completion = client.chat.completions.create(
    model="openai/gpt-5.2",
    messages=[{"role": "user", "content": "안녕하세요!"}]
)

# Claude로 전환 — model 값만 변경
completion = client.chat.completions.create(
    model="claude/claude-sonnet-4-6",
    messages=[{"role": "user", "content": "안녕하세요!"}]
)
```

{% endtab %}

{% tab title="JavaScript" %}

```javascript
// OpenAI GPT-5.2 사용
const result1 = await client.chat.completions.create({
  model: "openai/gpt-5.2",
  messages: [{ role: "user", content: "안녕하세요!" }],
});

// DeepSeek으로 전환 — model 값만 변경
const result2 = await client.chat.completions.create({
  model: "deepseek/deepseek-chat",
  messages: [{ role: "user", content: "안녕하세요!" }],
});
```

{% endtab %}

{% tab title="cURL" %}

```bash
# OpenAI GPT-5.2 사용
curl https://api.runyour.ai/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer runyour-v1-YOUR_API_KEY" \
  -d '{"model": "openai/gpt-5.2", "messages": [{"role": "user", "content": "안녕하세요!"}]}'

# Claude로 전환 — model 값만 변경
curl https://api.runyour.ai/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer runyour-v1-YOUR_API_KEY" \
  -d '{"model": "claude/claude-sonnet-4-6", "messages": [{"role": "user", "content": "안녕하세요!"}]}'
```

{% endtab %}
{% endtabs %}

***

### 모델 선택 시 참고 사항

* **비용**: 모델마다 입력·출력 토큰 단가가 다릅니다. 가벼운 작업은 저비용 모델(예: Claude Haiku, DeepSeek)을, 높은 품질이 필요한 작업에는 고성능 모델(예: GPT-5.2, Claude Opus)을 선택하세요.
* **한국어**: 한국어 업무에는 `upstage/solar-pro`가 특화되어 있습니다.
* **멀티모달(이미지 포함)**: 이미지를 함께 전달하려면 Gemini, GPT-5, Claude 계열 모델을 사용하세요.
* **스트리밍 제약**: Responses API(`/v1/responses`)의 스트리밍은 `openai/...` 모델에서만 지원됩니다. 다른 모델의 스트리밍은 Chat Completions(`/v1/chat/completions`)을 사용하세요.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://runyourai.gitbook.io/userguide/api/guide/models.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.