모델 - YouRouter Developer Platform

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

계정에서 현재 사용 가능한 최신 모델 ID는 YouRouter Dashboard에서 확인하세요.

기본 모델 호출

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

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 값만 바꾸면 됩니다.

{
  "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
이미지 입력·시각	`/v1/chat/completions`	멀티모달
텍스트 임베딩	`/v1/embeddings`	Embeddings
Gemini 네이티브 멀티모달	`/v1/projects/...:generateContent`	Google Generate Content
Claude 네이티브 messages	`/v1/messages`	Anthropic Messages
영상 생성 작업	`/api/v3/contents/generations/tasks`	Ark 텍스트-투-비디오

지원 모델 패밀리

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`

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

코드에서 모델 전환

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

Python
Node.js

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)

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);

제공업체로 라우팅

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

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`

자동 라우팅과 제공업체 고정에 대한 자세한 설명은 라우팅 가이드를 참고하세요.

권장 연동 방식

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

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

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

API 빠른 시작

첫 모델 API 요청을 보냅니다.

Chat Completions

대화, 스트리밍, 도구, 멀티모달 입력을 사용합니다.

멀티모달

이미지 입력을 보내고 네이티브 멀티모달 API를 호출합니다.

라우팅 가이드

자동 라우팅과 제공업체 고정 중 선택합니다.

API 레퍼런스

엔드포인트 상세와 요청 형식을 확인합니다.

시작하기

모델 API

라우팅 및 안정성

API 레퍼런스

기능

법무

모델

기본 모델 호출

`model` 필드

모델 API 기능

지원 모델 패밀리

코드에서 모델 전환

제공업체로 라우팅

권장 연동 방식

관련 가이드

API 빠른 시작

Chat Completions

멀티모달

라우팅 가이드

API 레퍼런스

​기본 모델 호출

​model 필드

​모델 API 기능

​지원 모델 패밀리

​코드에서 모델 전환

​제공업체로 라우팅

​권장 연동 방식

​관련 가이드

API 빠른 시작

Chat Completions

멀티모달

라우팅 가이드

API 레퍼런스

기본 모델 호출

`model` 필드

모델 API 기능

지원 모델 패밀리

코드에서 모델 전환

제공업체로 라우팅

권장 연동 방식

관련 가이드