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, Gemini CLI 등

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

인증: 가상 키 사용

모든 게이트웨이 호출은 실제 공급자 키가 아닌 가상 키로 인증합니다. 먼저 키 페이지에서 가상 키를 생성한 뒤 그 평문을 복사해두세요.

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 게이트웨이 프록시 서비스가 동작 중임
최소 1개 이상의 정상 채널이 구성되어 있고, 원하는 모델/채널 권한이 있는 가상 키도 생성되어 있음

자주 묻는 질문(FAQ)

Q: 인증 실패 오류가 발생했나요?
- A: 공급자 원본 키가 아니라 가상 키를 사용하고 있는지, 키가 만료·취소되지 않았는지 확인하세요.
Q: 모델 사용 불가 혹은 권한 없음 오류가 발생하나요?
- A: model이 채널 내에 구성되어 있고, 현재 가상 키의 “허용된 모델/채널”에 포함되어 있는지 점검하세요.
Q: 어떤 엔드포인트 포맷을 써야 하나요?
- A: 사용하는 SDK 프로토콜에 맞게 선택하세요—OpenAI는 /v1, Anthropic은 /v1/messages(Base URL에서는 /v1 생략), Gemini는 /v1beta를 사용합니다.
Q: 같은 네트워크 내 다른 기기에서 게이트웨이에 접속 가능한가요?
- 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)

요약