메인 콘텐츠로 건너뛰기
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/completionsChat Completions
이미지 입력·시각/v1/chat/completions멀티모달
텍스트 임베딩/v1/embeddingsEmbeddings
Gemini 네이티브 멀티모달/v1/projects/...:generateContentGoogle Generate Content
Claude 네이티브 messages/v1/messagesAnthropic Messages
영상 생성 작업/api/v3/contents/generations/tasksArk 텍스트-투-비디오

​
지원 모델 패밀리

YouRouter는 넓은 모델 접근을 목표로 합니다. 한 번의 연동으로 여러 주요 제공업체와 모델 패밀리를 호출할 수 있습니다.
패밀리예시 모델 ID
OpenAI GPTgpt-4o, gpt-4o-mini-2024-07-18, gpt-4.1-2025-04-14
OpenAI reasoningo3-2025-04-16, o4-mini-2025-04-16, o1-2024-12-17
Anthropic Claudeclaude-sonnet-4-20250514, claude-opus-4-20250514, claude-3-7-sonnet-20250219
Google Geminigemini-2.5-pro, gemini-2.5-flash
DeepSeekdeepseek-r1-250528, deepseek-v3-250324
xAI Grokgrok-3, grok-3-mini, grok-3-fast
Volcengine Doubaodoubao-seed-1-6-250615, doubao-seed-1-6-thinking-250615, doubao-1-5-pro-32k-250115
Moonshot Kimikimi-k2-250711
모델 가용성은 계정, 상위 상태, 라우팅 설정에 따라 달라질 수 있습니다. 애플리케이션 전체에 하드코딩하지 말고 모델 ID는 설정에 두면 전환이 쉽습니다.

​
코드에서 모델 전환

동일한 클라이언트를 쓰고 model만 변경하면 됩니다. 
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)

​
제공업체로 라우팅

기본적으로 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
OpenAIopenai
Azure OpenAIazure
Anthropicanthropic
Googlegoogle
AWS Bedrockaws
DeepSeekdeepseek
Mistral AImistral
Volcenginevolcengine
xAIx
자동 라우팅과 제공업체 고정에 대한 자세한 설명은 라우팅 가이드를 참고하세요.

​
권장 연동 방식

다음 값은 모두 설정 가능하게 두는 것이 좋습니다.
설정예시
API Base URLhttps://api.yourouter.ai/v1
API KeyYOUROUTER_API_KEY
기본 모델gpt-4o
대체 모델gemini-2.5-flash
선택적 제공업체auto
모델을 추가·제거·전환할 때 애플리케이션 코드를 바꿀 필요가 적어집니다.

​
관련 가이드

API 빠른 시작

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

Chat Completions

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

멀티모달

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

라우팅 가이드

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

API 레퍼런스

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