메인 콘텐츠로 건너뛰기
YouRouter는 단일 게이트웨이를 통해 모델 API를 노출합니다. 대부분의 연동은 OpenAI 호환 Chat Completions 엔드포인트부터 시작하는 것이 좋습니다.

​
Base URL

https://api.yourouter.ai/v1
이 레퍼런스의 모든 모델 API 경로는 이 base URL을 기준으로 합니다.

​
인증

YouRouter API 키를 Bearer 토큰으로 전송하세요. 
Authorization: Bearer <YOUR_YOUROUTER_API_KEY>
JSON 요청의 경우 다음도 함께 보냅니다. 
Content-Type: application/json
API 키는 서버 측 코드, 백엔드 서비스, CI 작업 또는 신뢰할 수 있는 내부 도구에서만 사용하세요. 브라우저 코드나 모바일 클라이언트에 넣지 마세요.

​
첫 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"
      }
    ]
  }'
생성된 텍스트는 보통 다음 위치에 있습니다. 
choices[0].message.content

​
핵심 개념

개념사용 방법
모델 선택요청 본문의 model 필드를 설정합니다.
멀티모달 입력messages[].content에 텍스트와 이미지 블록을 보내거나, 제공업체 네이티브 멀티모달 엔드포인트를 사용합니다.
자동 라우팅vendor 헤더를 생략하거나 vendor: auto를 보냅니다.
제공업체 고정vendor: openai, vendor: anthropic, vendor: google 등의 값을 보냅니다.
스트리밍stream: true로 설정하면 SSE로 내용이 증분 반환됩니다.
제공업체 네이티브 APIAnthropic은 /messages, Gemini는 generateContent 경로를 사용합니다.

​
주요 엔드포인트

엔드포인트용도
POST /chat/completionsOpenAI 호환 텍스트 및 이미지 입력 호출. 대부분의 연동에 적합합니다.
POST /embeddings텍스트 임베딩 생성.
POST /messagesAnthropic Messages 호환 호출.
POST /projects/.../models/{model}:generateContentGoogle Gemini generateContent 호환 호출.
POST /api/v3/contents/generations/tasks작업 기반 영상 생성 호출.

​
상태 코드

상태 코드의미
200요청 성공.
400요청 본문, 모델 또는 매개변수 형식이 잘못됨.
401API 키가 없거나 잘못됨.
429제공업체의 속도 제한 또는 동시성 제한에 도달함.
500게이트웨이 또는 상위 제공업체 내부 오류.
핵심 요청 형식은 Create Chat Completion을, 이미지 및 영상 예시는 멀티모달을 참고하세요.