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

# 모델

> YouRouter 모델 API로 다양한 모델 패밀리를 호출합니다.

`model` 필드로 어떤 모델이 요청을 처리할지 지정합니다. YouRouter는 하나의 OpenAI 호환 API 뒤에서 여러 모델 패밀리를 지원하므로, 모델을 바꿀 때는 보통 `model` 값만 변경하면 됩니다.

<Note>
  계정에서 현재 사용 가능한 최신 모델 ID는 [YouRouter Dashboard](https://platform.yourouter.ai/dashboard)에서 확인하세요.
</Note>

## 기본 모델 호출

모든 Chat Completions 요청은 동일한 API 구조를 사용합니다.

```bash theme={null}
curl https://api.yourouter.ai/v1/chat/completions \
  -H "Authorization: Bearer $YOUROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-4o",
    "messages": [
      {
        "role": "user",
        "content": "Reply with exactly: connected"
      }
    ]
  }'
```

다른 지원 모델을 호출하려면 `model` 값만 바꾸면 됩니다.

```json theme={null}
{
  "model": "claude-sonnet-4-20250514",
  "messages": [
    {
      "role": "user",
      "content": "Summarize this request in one sentence."
    }
  ]
}
```

## `model` 필드

| 필드         | 필수  | 설명                                                                      |
| ---------- | --- | ----------------------------------------------------------------------- |
| `model`    | 예   | 호출할 모델 ID(예: `gpt-4o`, `claude-sonnet-4-20250514`, `gemini-2.5-flash`). |
| `messages` | 예   | 채팅 모델에 보내는 대화 메시지 배열.                                                   |
| `stream`   | 아니오 | `true`로 설정하면 응답이 조각으로 증분 반환됩니다.                                         |

## 모델 API 기능

| 기능                   | API 경로                               | 시작 문서                                                                |
| -------------------- | ------------------------------------ | -------------------------------------------------------------------- |
| 텍스트 대화               | `/v1/chat/completions`               | [Chat Completions](/ko/guides/chat-completions)                      |
| 이미지 입력·시각            | `/v1/chat/completions`               | [멀티모달](/ko/guides/multimodal)                                        |
| 텍스트 임베딩              | `/v1/embeddings`                     | [Embeddings](/ko/guides/embeddings)                                  |
| Gemini 네이티브 멀티모달     | `/v1/projects/...:generateContent`   | [Google Generate Content](/ko/api-reference/google/generate-content) |
| Claude 네이티브 messages | `/v1/messages`                       | [Anthropic Messages](/ko/api-reference/messages/create)              |
| 영상 생성 작업             | `/api/v3/contents/generations/tasks` | [Ark 텍스트-투-비디오](/ko/guides/ark-video)                                |

## 지원 모델 패밀리

YouRouter는 넓은 모델 접근을 목표로 합니다. 한 번의 연동으로 여러 주요 제공업체와 모델 패밀리를 호출할 수 있습니다.

| 패밀리               | 예시 모델 ID                                                                                 |
| ----------------- | ---------------------------------------------------------------------------------------- |
| OpenAI GPT        | `gpt-4o`, `gpt-4o-mini-2024-07-18`, `gpt-4.1-2025-04-14`                                 |
| OpenAI reasoning  | `o3-2025-04-16`, `o4-mini-2025-04-16`, `o1-2024-12-17`                                   |
| Anthropic Claude  | `claude-sonnet-4-20250514`, `claude-opus-4-20250514`, `claude-3-7-sonnet-20250219`       |
| Google Gemini     | `gemini-2.5-pro`, `gemini-2.5-flash`                                                     |
| DeepSeek          | `deepseek-r1-250528`, `deepseek-v3-250324`                                               |
| xAI Grok          | `grok-3`, `grok-3-mini`, `grok-3-fast`                                                   |
| Volcengine Doubao | `doubao-seed-1-6-250615`, `doubao-seed-1-6-thinking-250615`, `doubao-1-5-pro-32k-250115` |
| Moonshot Kimi     | `kimi-k2-250711`                                                                         |

<Tip>
  모델 가용성은 계정, 상위 제공업체 상태, 라우팅 설정에 따라 달라질 수 있습니다. 애플리케이션 전체에 하드코딩하지 말고 모델 ID는 설정에 두면 전환이 쉽습니다.
</Tip>

## 코드에서 모델 전환

동일한 클라이언트를 쓰고 `model`만 변경하면 됩니다.

<Tabs>
  <Tab title="Python">
    ```python theme={null}
    import os
    from openai import OpenAI

    client = OpenAI(
        api_key=os.environ["YOUROUTER_API_KEY"],
        base_url="https://api.yourouter.ai/v1",
    )

    model_id = "gemini-2.5-flash"

    completion = client.chat.completions.create(
        model=model_id,
        messages=[{"role": "user", "content": "Reply with exactly: connected"}],
    )

    print(completion.choices[0].message.content)
    ```
  </Tab>

  <Tab title="Node.js">
    ```javascript theme={null}
    import OpenAI from 'openai';

    const openai = new OpenAI({
      apiKey: process.env.YOUROUTER_API_KEY,
      baseURL: 'https://api.yourouter.ai/v1',
    });

    const modelId = 'gemini-2.5-flash';

    const completion = await openai.chat.completions.create({
      model: modelId,
      messages: [{ role: 'user', content: 'Reply with exactly: connected' }],
    });

    console.log(completion.choices[0].message.content);
    ```
  </Tab>
</Tabs>

## 제공업체로 라우팅

기본적으로 YouRouter는 요청을 자동으로 라우팅합니다. 특정 상위 제공업체가 필요하면 `vendor` 요청 헤더를 보냅니다.

```bash theme={null}
curl https://api.yourouter.ai/v1/chat/completions \
  -H "Authorization: Bearer $YOUROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -H "vendor: anthropic" \
  -d '{
    "model": "claude-sonnet-4-20250514",
    "messages": [
      {
        "role": "user",
        "content": "Reply with exactly: connected"
      }
    ]
  }'
```

자주 쓰는 `vendor` 값:

| 제공업체         | `vendor` 값   |
| ------------ | ------------ |
| 자동 라우팅       | `auto`       |
| OpenAI       | `openai`     |
| Azure OpenAI | `azure`      |
| Anthropic    | `anthropic`  |
| Google       | `google`     |
| AWS Bedrock  | `aws`        |
| DeepSeek     | `deepseek`   |
| Mistral AI   | `mistral`    |
| Volcengine   | `volcengine` |
| xAI          | `x`          |

자동 라우팅과 제공업체 고정에 대한 자세한 설명은 [라우팅 가이드](/ko/guides/router)를 참고하세요.

## 권장 연동 방식

다음 값은 모두 설정 가능하게 두는 것이 좋습니다.

| 설정           | 예시                            |
| ------------ | ----------------------------- |
| API Base URL | `https://api.yourouter.ai/v1` |
| API Key      | `YOUROUTER_API_KEY`           |
| 기본 모델        | `gpt-4o`                      |
| 대체 모델        | `gemini-2.5-flash`            |
| 선택적 제공업체     | `auto`                        |

모델을 추가·제거·전환할 때 애플리케이션 코드를 바꿀 필요가 적어집니다.

## 관련 가이드

<CardGroup cols={2}>
  <Card title="API 빠른 시작" icon="rocket" href="/ko/quickstart">
    첫 모델 API 요청을 보냅니다.
  </Card>

  <Card title="Chat Completions" icon="message" href="/ko/guides/chat-completions">
    대화, 스트리밍, 도구, 멀티모달 입력을 사용합니다.
  </Card>

  <Card title="멀티모달" icon="image" href="/ko/guides/multimodal">
    이미지 입력을 보내고 네이티브 멀티모달 API를 호출합니다.
  </Card>

  <Card title="라우팅 가이드" icon="route" href="/ko/guides/router">
    자동 라우팅과 제공업체 고정 중 선택합니다.
  </Card>

  <Card title="API 레퍼런스" icon="code" href="/ko/api-reference/introduction">
    엔드포인트 상세와 요청 형식을 확인합니다.
  </Card>
</CardGroup>