> For the complete documentation index, see [llms.txt](https://runyourai.gitbook.io/userguide/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://runyourai.gitbook.io/userguide/api/guide/models.md).

# 모델 선택하기

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들을 통합하여 최적의 경로로 제공합니다.

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

<table><thead><tr><th width="430.2421875">모델 ID</th><th width="256.2578125">프로바이더</th></tr></thead><tbody><tr><td>openai/gpt-5.5-pro-2026-04-23</td><td>openai</td></tr><tr><td>openai/gpt-5.5-2026-04-23</td><td>openai</td></tr><tr><td>openai/gpt-5.5</td><td>openai</td></tr><tr><td>openai/gpt-5.4-pro-2026-03-05</td><td>openai</td></tr><tr><td>openai/gpt-5.4-nano-2026-03-17</td><td>openai</td></tr><tr><td>openai/gpt-5.4-nano</td><td>openai</td></tr><tr><td>openai/gpt-5.4-mini-2026-03-17</td><td>openai</td></tr><tr><td>openai/gpt-5.4-mini</td><td>openai</td></tr><tr><td>openai/gpt-5.4-2026-03-05</td><td>openai</td></tr><tr><td>openai/gpt-5.4</td><td>openai</td></tr><tr><td>openai/gpt-5.3-codex</td><td>openai</td></tr><tr><td>openai/gpt-5.3-chat-latest</td><td>openai</td></tr><tr><td>openai/gpt-5.2-chat-latest</td><td>openai</td></tr><tr><td>openai/gpt-5.2-2025-12-11</td><td>openai</td></tr><tr><td>openai/gpt-5.2</td><td>openai</td></tr><tr><td>openai/gpt-5.1-2025-11-13</td><td>openai</td></tr><tr><td>openai/gpt-5.1</td><td>openai</td></tr><tr><td>openai/gpt-5-search-api-2025-10-14</td><td>openai</td></tr><tr><td>openai/gpt-5-search-api</td><td>openai</td></tr><tr><td>openai/gpt-5-nano-2025-08-07</td><td>openai</td></tr><tr><td>openai/gpt-5-nano</td><td>openai</td></tr><tr><td>openai/gpt-5-mini-2025-08-07</td><td>openai</td></tr><tr><td>openai/gpt-5-mini</td><td>openai</td></tr><tr><td>openai/gpt-5-2025-08-07</td><td>openai</td></tr><tr><td>openai/gpt-5</td><td>openai</td></tr><tr><td>openai/gpt-4o-search-preview</td><td>openai</td></tr><tr><td>openai/gpt-4o-mini-search-preview</td><td>openai</td></tr><tr><td>openai/gpt-4o-mini-2024-07-18</td><td>openai</td></tr><tr><td>openai/gpt-4o-mini</td><td>openai</td></tr><tr><td>openai/gpt-4o-2024-11-20</td><td>openai</td></tr><tr><td>openai/gpt-4o-2024-08-06</td><td>openai</td></tr><tr><td>openai/gpt-4o-2024-05-13</td><td>openai</td></tr><tr><td>openai/gpt-4o</td><td>openai</td></tr><tr><td>openai/gpt-4.1-nano-2025-04-14</td><td>openai</td></tr><tr><td>openai/gpt-4.1-nano</td><td>openai</td></tr><tr><td>openai/gpt-4.1-mini-2025-04-14</td><td>openai</td></tr><tr><td>openai/gpt-4.1-mini</td><td>openai</td></tr><tr><td>openai/gpt-4.1-2025-04-14</td><td>openai</td></tr><tr><td>openai/gpt-4.1</td><td>openai</td></tr><tr><td>openai/gpt-4-turbo-preview</td><td>openai</td></tr><tr><td>openai/gpt-4-turbo-2024-04-09</td><td>openai</td></tr><tr><td>openai/gpt-4-turbo</td><td>openai</td></tr><tr><td>openai/gpt-4-0613</td><td>openai</td></tr><tr><td>openai/gpt-4</td><td>openai</td></tr><tr><td>openai/gpt-3.5-turbo-1106</td><td>openai</td></tr><tr><td>openai/gpt-3.5-turbo-0125</td><td>openai</td></tr><tr><td>openai/gpt-3.5-turbo</td><td>openai</td></tr><tr><td>openai/gpt-image-1.5</td><td>openai</td></tr><tr><td>openai/o4-mini-2025-04-16</td><td>openai</td></tr><tr><td>openai/o4-mini</td><td>openai</td></tr><tr><td>openai/o3-mini-2025-01-31</td><td>openai</td></tr><tr><td>openai/o3-mini</td><td>openai</td></tr><tr><td>openai/o3-2025-04-16</td><td>openai</td></tr><tr><td>openai/o3</td><td>openai</td></tr><tr><td>openai/o1-2024-12-17</td><td>openai</td></tr><tr><td>openai/o1</td><td>openai</td></tr></tbody></table>

{% endtab %}

{% tab title="Anthropic (Claude)" %}

<table><thead><tr><th width="429.8984375">모델 ID</th><th width="256.25390625">프로바이더</th></tr></thead><tbody><tr><td>anthropic/claude-sonnet-4-6</td><td>anthropic</td></tr><tr><td>anthropic/claude-sonnet-4-5-20250929</td><td>anthropic</td></tr><tr><td>anthropic/claude-sonnet-4-5</td><td>anthropic</td></tr><tr><td>anthropic/claude-opus-4-8</td><td>anthropic</td></tr><tr><td>anthropic/claude-opus-4-7</td><td>anthropic</td></tr><tr><td>anthropic/claude-opus-4-6</td><td>anthropic</td></tr><tr><td>anthropic/claude-opus-4-5-20251101</td><td>anthropic</td></tr><tr><td>anthropic/claude-opus-4-5</td><td>anthropic</td></tr><tr><td>anthropic/claude-opus-4-1-20250805</td><td>anthropic</td></tr><tr><td>anthropic/claude-haiku-4-5-20251001</td><td>anthropic</td></tr><tr><td>anthropic/claude-haiku-4-5</td><td>anthropic</td></tr></tbody></table>

{% endtab %}

{% tab title="Google (Gemini)" %}

<table><thead><tr><th width="430.48046875">모델 ID</th><th width="255.921875">프로바이더</th></tr></thead><tbody><tr><td>gemini/gemini-pro-latest</td><td>gemini</td></tr><tr><td>gemini/gemini-flash-lite-latest</td><td>gemini</td></tr><tr><td>gemini/gemini-flash-latest</td><td>gemini</td></tr><tr><td>gemini/gemini-3.5-flash</td><td>gemini</td></tr><tr><td>gemini/gemini-3.1-pro-preview-customtools</td><td>gemini</td></tr><tr><td>gemini/gemini-3.1-pro-preview</td><td>gemini</td></tr><tr><td>gemini/gemini-3.1-flash-image-preview</td><td>gemini</td></tr><tr><td>gemini/gemini-3-pro-image-preview</td><td>gemini</td></tr><tr><td>gemini/gemini-3-flash-preview</td><td>gemini</td></tr><tr><td>gemini/gemini-2.5-pro</td><td>gemini</td></tr><tr><td>gemini/gemini-2.5-flash-lite</td><td>gemini</td></tr><tr><td>gemini/gemini-2.5-flash</td><td>gemini</td></tr></tbody></table>

{% endtab %}

{% tab title="Upstage" %}

<table data-search="true"><thead><tr><th width="429.84375">모델 ID</th><th width="255.85546875">프로바이더</th></tr></thead><tbody><tr><td>upstage/solar-pro3</td><td>upstage</td></tr><tr><td>upstage/solar-pro2</td><td>upstage</td></tr><tr><td>upstage/solar-mini</td><td>upstage</td></tr></tbody></table>
{% endtab %}

{% tab title="Deepseek" %}

<table><thead><tr><th width="429.625">모델 ID</th><th width="256.2890625">프로바이더</th></tr></thead><tbody><tr><td>deepseek/deepseek-v4-pro</td><td>deepseek</td></tr><tr><td>deepseek/deepseek-reasoner</td><td>deepseek</td></tr><tr><td>deepseek/deepseek-coder</td><td>deepseek</td></tr><tr><td>deepseek/deepseek-chat</td><td>deepseek</td></tr></tbody></table>

{% endtab %}
{% endtabs %}

{% 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`)을 사용하세요.