https://api.yourouter.ai/v1에서 OpenAI 호환 엔드포인트를 제공하므로, 기존 OpenAI SDK 연동은 대개 base_url과 API 키만 바꾸면 됩니다.
API 키가 필요하면 YouRouter Dashboard에서 생성하세요.
연동 기본 정보
1. API 키 설정
아래 예제를 실행하기 전에 API 키를 환경 변수에 넣으세요.- macOS/Linux
- Windows
- .env
2. 첫 테스트 요청
가장 빠른 연동 검증은 Chat Completions 엔드포인트로 직접 HTTP 요청을 보내는 것입니다. 성공 시 모델 출력은choices[0].message.content에서 읽을 수 있습니다. cURL 또는 표준 HTTP 클라이언트를 사용할 수 있으며, 아래 예시는 Python, Node.js, Go, Java, PHP, Rust를 포함합니다.
- cURL
- Python requests
- Node.js 18+ fetch
- Go
- Java 11+
- PHP
- Rust
3. 기존 OpenAI SDK 코드 이전
이미 OpenAI SDK를 쓰는 앱이라면 요청 본문 구조는 유지하고api_key와 base_url 두 필드만 바꾸는 경우가 많습니다.
- Python
- Node.js
Go, Java, PHP, Rust도 같은 사용자 지정 Base URL 방식을 사용합니다. 사용하는 OpenAI 호환 SDK가 base URL 설정을 지원하면
https://api.yourouter.ai/v1을 지정하고, 지원하지 않으면 위의 HTTP 예시로 /v1/chat/completions를 직접 호출하세요.4. 모델과 라우팅 선택
model 필드로 모델을 고릅니다. OpenAI GPT, Claude, Gemini, DeepSeek, Grok, Doubao, Kimi 등 여러 패밀리를 같은 API 형태로 호출할 수 있습니다. 이미지 등 멀티모달 입력은 멀티모달 가이드를 참고하세요.
예시 모델이 계정에서 활성화되어 있지 않다면 YouRouter Dashboard에 표시되는 사용 가능한 모델 ID로 바꾸세요.
vendor 헤더를 생략하거나 vendor: auto로 두면 현재 가장 적합한 사용 가능한 상위 제공업체로 라우팅합니다.
연동이 특정 상위 제공업체의 동작, 모델 변형, 계정 격리 또는 규정 준수에 명확히 의존할 때만 vendor로 고정하세요.
- cURL
- Python SDK
- Node.js SDK
5. 응답과 오류 처리
OpenAI 호환 인터페이스의 성공 응답은 OpenAI 스타일 형식을 따릅니다. 생성 텍스트는 보통choices[0].message.content에 있습니다.
6. 스트리밍
채팅 UI나 에이전트에서는stream: true로 설정해 모델이 생성하는 동안 조각 단위로 응답을 받을 수 있습니다.
다음 단계
API 레퍼런스
엔드포인트, 매개변수, 응답 형식을 확인합니다.
모델
모델 ID를 전달하고 API로 모델을 전환하는 방법을 확인합니다.
멀티모달
이미지 입력을 보내고 제공업체 네이티브 멀티모달 API를 호출합니다.
라우팅 가이드
자동 라우팅과 제공업체 고정의 적용 시점을 이해합니다.
Chat Completions
대화, 스트리밍 UI, 도구 호출, 멀티모달 흐름을 구축합니다.