Any AI Proxy API

OpenAI 호환 API 엔드포인트

Gin 기반 HTTP 서버가 /v1/chat/completions 엔드포인트를 제공해 OpenAI Chat Completions 형식의 요청과 응답을 그대로 사용할 수 있도록 합니다.

ChromeDP 기반 브라우저 자동화

Fingerprint Chromium 브라우저를 ChromeDP로 제어해 텍스트 입력, 버튼 클릭 등 실제 사용자 동작을 자동 수행합니다.

요청 큐와 다중 인스턴스

요청을 순차적으로 처리하는 큐 시스템과 여러 AI 서비스 인스턴스를 동시에 운용할 수 있는 다중 인스턴스 지원이 포함됩니다.

YAML 기반 구성 가능한 워크플로우

runner/main.yaml과 인스턴스별 runner/instance-name/ 디렉터리의 YAML 파일로 브라우저 자동화 흐름을 단계별로 정의하고 수정할 수 있습니다.

다중 AI 서비스 어댑터

ChatGPT, Gemini AI Studio, Grok 각각의 응답 포맷과 상호작용 방식을 처리하는 전용 어댑터가 내장되어 있습니다.

디버깅용 스크린샷 API

GET /screenshot?instance=instance-name 엔드포인트로 헤드리스 모드에서도 각 인스턴스의 화면을 캡처해 워크플로우를 진단할 수 있습니다.

자동 인증 관리

쿠키와 세션을 자동으로 관리하며 /v1/auth/upload 경로로 인증 정보를 업로드해 로그인 상태를 유지할 수 있습니다.

winget을 이용한 설치(Windows)

Windows 환경에서는 winget 패키지 관리자로 다음 명령을 실행해 설치할 수 있습니다.

winget install --id LuisPater.anyAIProxyAPI --exact

소스에서 직접 실행

저장소를克隆한 뒤 의존성을 내려받고 설정 파일을 편집한 다음 go run main.go로 서버를 시작합니다. 기본 포트는 2048이며 api-port 설정으로 변경할 수 있습니다.

기본 구성

runner/main.yaml에서 디버그 모드, 헤드리스 여부, Fingerprint Chromium 경위, API 포트, 전역 토큰, 그리고 각 AI 서비스 인스턴스의 URL과 프록시, 인증 파일, 러너 매핑을 지정합니다.

API 호출 예시

OpenAI 호환 클라이언트로 다음과 같이 요청을 보내면 됩니다. 모델 이름은 instance-name/model-name 형식으로 지정합니다.

curl -X POST http://localhost:2048/v1/chat/completions -H "Content-Type: application/json" -d '{"model":"chatgpt/gpt-4","messages":[{"role":"user","content":"Explain the basic principles of quantum computing"}]}'

인증 정보 업로드

각 서비스의 로그인 세션이 담긴 JSON을 POST /v1/auth/upload로 전송해 인증을 유지합니다.

새로운 AI 서비스를 추가하려면 어떻게 하나요?

internal/adapter/에 새로운 어댑터를 구현하고 runner/ 디렉터리에 해당 인스턴스의 워크플로우 YAML(init 또는 init-system, chat_completions, context-canceled)을 추가해야 합니다.

브라우저가 시작되지 않을 때는 어떻게 하나요?

Fingerprint Chromium 경로 설정이 실제 실행 파일을 가리키는지 확인하고, 파일이 존재하는지 점검해야 합니다.

워크플로우 디버깅은 어떻게 하나요?

runner/main.yaml에서 debug: true로 설정해 상세 디버그 로그를 활성화할 수 있습니다.