AI 게이트웨이 엔드포인트와 환경 변수

원클릭 테이크오버로 기존 AI 도구를 바로 사용하는 것 외에도, 자체 애플리케이션, 스크립트 또는 임의의 AI 도구에서 AI 게이트웨이를 직접 호출할 수 있습니다. 이 문서에서는 게이트웨이가 노출하는 엔드포인트 형식과 가상 키로 연결하는 방법을 설명합니다.

프록시 엔드포인트

AI 게이트웨이의 프록시 서비스는 http://127.0.0.1:11580에서 수신 대기합니다. 다양한 공급자의 SDK 및 도구와 호환되도록, 게이트웨이는 동일한 포트에서 여러 프로토콜 형식의 엔드포인트를 제공합니다.

프로토콜 형식	엔드포인트 경로	사용 사례
OpenAI 호환	`http://127.0.0.1:11580/v1`	OpenAI API 형식을 사용하는 모든 SDK / 도구 (예: `/v1/chat/completions`)
Anthropic 호환	`http://127.0.0.1:11580/v1/messages`	Anthropic SDK 및 Claude Code 등
Gemini 호환	`http://127.0.0.1:11580/v1beta`	Google Gemini SDK 등

사용 중인 SDK의 프로토콜에 맞는 형식을 선택하고 요청을 게이트웨이 주소로 보내기만 하면, 게이트웨이가 가상 키의 권한에 따라 요청을 해당 공급자 채널로 라우팅합니다.

인증: 가상 키 사용

게이트웨이에 대한 모든 요청은 공급자의 실제 Key가 아니라 가상 키로 인증합니다. 먼저 키 페이지에서 가상 키를 생성하고 평문을 복사하세요.

AI 게이트웨이 → 엔드포인트(Endpoints) 페이지에서 가상 키를 선택할 수 있으며, 게이트웨이가 자주 쓰는 도구를 위한 복사 가능한 환경 변수 스니펫을 바로 생성합니다.

환경 변수 예시

다음 예시는 가상 키(여기서는 <你的虚拟密钥>로 표기)를 이미 발급받았다고 가정합니다.

OpenAI 호환 SDK / 도구

bash

export OPENAI_BASE_URL="http://127.0.0.1:11580/v1"
export OPENAI_API_KEY="<你的虚拟密钥>"

Claude Code / Anthropic

bash

# 참고: Anthropic 프로토콜은 게이트웨이 루트 주소를 사용하며 /v1을 붙이지 않습니다
export ANTHROPIC_BASE_URL="http://127.0.0.1:11580"
export ANTHROPIC_AUTH_TOKEN="<你的虚拟密钥>"

Gemini

bash

export GOOGLE_GEMINI_BASE_URL="http://127.0.0.1:11580"
export GEMINI_API_KEY="<你的虚拟密钥>"

호출 예시(OpenAI 호환)

bash

curl http://127.0.0.1:11580/v1/chat/completions \
  -H "Authorization: Bearer <你的虚拟密钥>" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-4o",
    "messages": [{"role": "user", "content": "你好"}]
  }'

여기서 model은 채널에 이미 구성되어 있고 해당 가상 키가 호출을 허용하는 모델이어야 합니다.

전제 조건

AI 게이트웨이 프록시 서비스가 실행 중이어야 합니다.
최소 하나의 정상 채널이 구성되어 있어야 하며, 해당 모델 / 채널 권한을 가진 가상 키가 생성되어 있어야 합니다.

자주 묻는 질문(FAQ)

Q: 요청이 인증 실패를 반환하나요?
- A: 가상 키(공급자의 실제 Key가 아님)를 사용하고 있는지, 키가 만료되거나 폐기되지 않았는지 확인하세요.
Q: 모델을 사용할 수 없거나 권한이 없다고 표시되나요?
- A: 해당 model이 어떤 채널에 구성되어 있고, 현재 가상 키의 "허용된 모델 / 채널"에 포함되어 있는지 확인하세요.
Q: 어떤 엔드포인트 형식을 사용해야 하나요?
- A: 사용하는 SDK의 프로토콜에 따라 선택하세요. OpenAI 스타일은 /v1, Anthropic 스타일은 /v1/messages(Base URL에는 /v1을 붙이지 않음), Gemini 스타일은 /v1beta를 사용합니다.
Q: LAN 내 다른 장치에서 게이트웨이에 접근할 수 있나요?
- A: 게이트웨이는 기본적으로 127.0.0.1(로컬 머신 전용)만 수신 대기합니다. 이는 보안을 고려한 권장 설정입니다.

요약

AI 게이트웨이는 OpenAI / Anthropic / Gemini 세 가지 호환 형식으로 통합 로컬 엔드포인트를 제공합니다. 가상 키 인증과 함께 사용하면 모든 애플리케이션이나 AI 도구를 게이트웨이에 연결하여 통합 키 관리와 사용량 통계를 누릴 수 있습니다. 일반적인 CLI 도구라면 원클릭 테이크오버를 바로 사용하는 편이 더 간편합니다.

AI 게이트웨이 엔드포인트와 환경 변수 ​

프록시 엔드포인트 ​

인증: 가상 키 사용 ​

환경 변수 예시 ​

OpenAI 호환 SDK / 도구 ​

Claude Code / Anthropic ​

Gemini ​

호출 예시(OpenAI 호환) ​

전제 조건 ​

자주 묻는 질문(FAQ) ​

요약 ​

AI 게이트웨이 엔드포인트와 환경 변수

프록시 엔드포인트

인증: 가상 키 사용

환경 변수 예시

OpenAI 호환 SDK / 도구

Claude Code / Anthropic

Gemini

호출 예시(OpenAI 호환)

전제 조건

자주 묻는 질문(FAQ)

요약