OmniRoute 로컬 설치 및 시작 검증

이 페이지는 가장 짧은 OmniRoute 설정 경로를 원하는 최초 HagiCode 사용자를 위한 것입니다. 로컬 서비스를 시작하고, http://localhost:20128/v1 작동하는지 확인하고 대시보드와 API를 모두 사용할 수 있는지 확인하세요.

추천 경로

이 첫 번째 버전은 가장 안정적인 경로를 먼저 유지합니다. npm install -g omniroute, omniroute, 대시보드 http://localhost:20128및 OpenAI 호환 기본 URL은 다음과 같습니다. http://localhost:20128/v1. Docker, VPS 및 고급 배포 모드는 선택 사항 섹션에 유지됩니다.

전제조건

• Node.js가 이미 설치되어 있습니다. 완료 Node.js 설치 필요하다면 먼저.
• 로컬 포트 20128 사용 가능하며 아직 점유되지 않았습니다.
• OmniRoute를 통해 라우팅하려는 업스트림 모델 공급자 계정이 하나 이상 있습니다.
• HagiCode, CLI 또는 SDK를 통합하기 전에 다음 두 주소를 별도로 유지하십시오.
  • 대시보드: http://localhost:20128
  • OpenAI 호환 기본 URL: http://localhost:20128/v1

로컬로 설치 및 실행

권장되는 전역 npm 경로로 시작하세요.

npm install -g omniroute
omniroute

서비스가 시작된 후 다음 순서로 유효성을 검사합니다.

1. 열기 http://localhost:20128 브라우저에서 대시보드가 로드되는지 확인하세요.
2. 로 이동 Endpoints 대시보드 페이지에서 API 키를 생성하거나 복사하세요.
3. 나중에 도구에 전달할 기본 URL을 기록해 두십시오. http://localhost:20128/v1.

대시보드로 시작하는 이유

첫 번째 설정의 경우 대시보드는 OmniRoute가 실행 중인지, 공급자가 연결되어 있는지, API 키가 존재하는지 확인하는 가장 빠른 방법입니다. 이후 클라이언트 호출이 실패하는 경우 일반적으로 대시보드를 먼저 확인하는 것이 SDK 코드를 즉시 디버깅하는 것보다 빠릅니다.

실행 중인 서비스 유효성 검사

검증 1: 모델 카탈로그를 읽을 수 있는지 확인

열쇠부터 넣어라 Endpoints 환경 변수로 페이지를 이동합니다.

export OMNIROUTE_API_KEY="replace-with-the-key-you-copied-from-the-Endpoints-page"

그런 다음 요청 /v1/models:

curl http://localhost:20128/v1/models \
  -H "Authorization: Bearer ${OMNIROUTE_API_KEY}"

모델 목록을 다시 받으면 OpenAI 호환 엔드포인트와 인증 흐름이 작동하는 것입니다.

검증 2: 최소한의 채팅 요청 보내기

curl http://localhost:20128/v1/chat/completions \
  -H "Authorization: Bearer ${OMNIROUTE_API_KEY}" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "replace-with-a-model-id-from-v1-models",
    "messages": [
      { "role": "user", "content": "Reply with ok." }
    ]
  }'

여기서의 목표는 신속한 품질이 아닙니다. 선택한 모델이 이미 OmniRoute를 통해 성공적으로 라우팅될 수 있음을 증명하는 것입니다.

다음 단계

Installing Node.js

AI Agent CLI Installation

OmniRoute Upstream Project