모델 선택하기

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

---

지원 모델 목록

모델 ID	프로바이더	특징
openai/gpt-5.2	OpenAI	범용 대화, 복잡한 추론, 문서 작성
openai/gpt-5.1	OpenAI	GPT-5 계열 표준 모델
openai/gpt-5	OpenAI	GPT-5 기본 모델
claude/claude-sonnet-4-6	Anthropic	긴 문서 분석, 맥락 기반 추론
claude/claude-haiku-4-5	Anthropic	빠른 응답, 가벼운 작업에 적합
claude/claude-opus-4-5	Anthropic	고난이도 분석, 정교한 작문
gemini/gemini-2.5-pro	Google	멀티모달(이미지+텍스트) 분석
gemini/gemini-3-pro	Google	Google 최신 고성능 모델
deepseek/deepseek-chat	DeepSeek	코딩, 수학 문제에 특화
upstage/solar-pro-2	Upstage	한국어 업무 특화
upstage/solar-pro-3	Upstage	추론 정확도 및 지시 이행 품질 고도화

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

---

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

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

Python

models = client.models.list()

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

JavaScript

cURL

---

모델 전환하기

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

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": "안녕하세요!"}]
)

JavaScript

cURL

---

모델 선택 시 참고 사항

• 비용: 모델마다 입력·출력 토큰 단가가 다릅니다. 가벼운 작업은 저비용 모델(예: 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)을 사용하세요.