← 블로그

OpenRouter로 G0DM0D3 설정하는 방법: 단계별 가이드 (2026)

2026년 OpenRouter API 키로 G0DM0D3를 설정하는 단계별 가이드. 로컬, 정적 호스트, Docker API 서버 세 가지 배포 옵션 제공.

9 min read
OpenRouter로 G0DM0D3 설정하는 방법: 단계별 가이드 (2026)

안녕하세요, 저는 Dora입니다. 모델 출력을 비교하면서 브라우저 탭이 몇 개나 열려 있었는지 세어본 적이 있나요? 일곱 개였습니다. 네 가지 다른 채팅 인터페이스, 두 개의 API 플레이그라운드, 그리고 어떤 모델이 무엇을 말했는지 추적하는 스프레드시트 하나. 바로 이것이 G0DM0D3가 없애기 위해 만들어진 마찰입니다 — HTML 파일 하나, 50개 이상의 모델이 동일한 프롬프트를 병렬로 경쟁하고, 자동으로 채점 및 순위가 매겨집니다.

이 글은 G0DM0D3를 실행하는 방법을 처음부터 첫 번째 멀티모델 평가까지 문서화합니다. 네 가지 배포 경로, 각각 다른 상황에 적합합니다. 비용 계산도 다룰 것입니다. 55개 모델을 동시에 실행하는 것은 무료가 아니며, 아무도 OpenRouter 청구서에서 그 사실을 알게 되어서는 안 됩니다.

시작 전: 필요한 것

OpenRouter 계정 및 API 키 (무료 생성, 사용한 만큼 결제)

G0DM0D3는 모든 모델 호출을 OpenRouter를 통해 라우팅합니다. Anthropic, OpenAI, Google, Meta, Mistral 등 300개 이상의 모델을 포괄하는 통합 API 게이트웨이입니다. API 키 하나, 결제 계정 하나, 모든 모델.

openrouter.ai에서 가입하고, Keys로 이동하여 키를 생성하고 복사하세요. 그것이 G0DM0D3에 필요한 유일한 자격 증명입니다. 신규 계정은 소액의 무료 크레딧 잔액을 받습니다 — GODMODE CLASSIC에는 충분하지만 전체 ULTRAPLINIAN 실행에는 부족합니다. 비용에 대해서는 나중에 더 자세히 설명합니다.

브라우저 (로컬/호스팅용) 또는 Node.js 18+ (API 서버용)

핵심 애플리케이션은 단일 index.html 파일입니다. 브라우저를 열 수 있다면 G0DM0D3를 실행할 수 있습니다. npm install 없음, 빌드 단계 없음, 프레임워크 없음. api/ 디렉토리의 선택적 API 서버는 Node.js 18+ 또는 Docker가 필요하지만 대부분의 사람들은 필요하지 않습니다.

G0DM0D3가 할 수 있는 것과 없는 것 이해하기

G0DM0D3는 멀티모델 평가 및 레드팀 도구이지 ChatGPT 대체품이 아닙니다. 모델을 병렬로 실행하고, 100점 복합 점수로 출력을 채점하며, 특정 프롬프트에서 가장 잘 수행한 모델을 알려줍니다.

하지 않는 것: 세션 간 대화 유지, 계정 관리, 서버 측 저장. 채팅 기록은 localStorage에 저장됩니다. 브라우저 데이터를 지우면 사라집니다.

옵션 1 — 호스팅 버전 (설치 불필요)

가장 빠른 방법. 다운로드 없음, 터미널 없음, 설정 없음.

godmod3.ai로 이동

브라우저에서 godmod3.ai를 엽니다. 전체 애플리케이션이 단일 정적 파일에서 로드됩니다. “설치”는 그것으로 끝입니다.

설정에서 OpenRouter API 키 붙여넣기

설정 아이콘을 클릭합니다. OpenRouter API 키를 붙여넣습니다. localStorage에 저장되며 — 컴퓨터에서 벗어나지 않고, G0DM0D3 서버에 닿지 않습니다. 모든 API 호출은 브라우저에서 OpenRouter로 직접 전달됩니다. 전체 소스가 GitHub에 공개되어 있어 확인 가능합니다.

모드 선택 (GODMODE CLASSIC vs ULTRAPLINIAN)

GODMODE CLASSIC은 미리 구성된 5개의 모델+프롬프트 조합을 병렬로 실행합니다. 빠르고, 저렴하며, 빠른 비교에 좋습니다. ULTRAPLINIAN은 플래그십으로 — 5개 티어에 걸쳐 10~55개 모델을 쿼리하고, 각 응답을 채점하며, 복합 점수와 함께 승자를 반환합니다. 확장하기 전에 CLASSIC으로 시작하여 키가 작동하는지 확인하세요.

호스팅 버전의 데이터 처리에 대해 알아야 할 것

godmod3.ai의 호스팅 버전은 익명의 운영 메타데이터를 수집합니다 — 어떤 엔드포인트가 호출되었는지, 응답 시간, 성공/실패. 메시지 내용, 프롬프트, API 키는 없습니다. 이는 GitHub의 프로젝트 TERMS.md에 문서화되어 있습니다. 메타데이터 수집이 중요하다면 자체 호스팅하세요.

옵션 2 — 로컬 단일 파일 배포

API 키와 프롬프트를 완전히 자신의 컴퓨터에 보관하고 싶은 분들을 위해. 명령어 두 개.

저장소 복제

git clone https://github.com/elder-plinius/G0DM0D3.git
cd G0DM0D3

로컬에서 서비스

python3 -m http.server 8000

전체 설정은 이것뿐입니다. 설치할 의존성 없음. Python 한 줄 명령어가 포트 8000에서 디렉토리를 서비스합니다.

http://localhost:8000 열기, 설정에서 API 키 추가

호스팅 버전과 동일한 흐름 — 브라우저에서 열고, 설정에서 OpenRouter 키를 붙여넣고, 모드를 선택합니다. 차이점: 모든 것이 파일 시스템에서 실행됩니다. 이 구성에서는 외부 서버가 없기 때문에 외부 서버가 메타데이터를 받지 않습니다.

브라우저 데이터 지우기 전에 채팅 기록 내보내기

이것은 너무 늦을 때까지 아무도 읽지 않는 경고입니다. G0DM0D3는 채팅 기록을 localStorage에 저장합니다. 브라우저 데이터를 지우거나, 브라우저를 전환하거나, 시크릿 창을 열면 기록이 사라집니다. 클라우드 동기화, 백업, 인터페이스에 내장된 내보내기 버튼이 없습니다. 평가 세션 기록이 필요하다면 탭을 닫기 전에 수동으로 출력을 복사하세요. 모든 세션을 임시로 취급하세요.

옵션 3 — 정적 호스팅 (Vercel / GitHub Pages / Cloudflare Pages)

각 사람이 자신의 OpenRouter 키를 사용하는 팀과 접근을 공유하기 위해.

index.html을 루트 에셋으로 업로드

index.html을 GitHub 저장소에 푸시하고 Pages를 활성화합니다. 또는 Vercel에 드래그합니다. 또는 Cloudflare Pages에 푸시합니다. 서버 측 의존성이 없습니다 — 모든 API 호출은 방문자의 브라우저에서 시작됩니다.

빌드 단계 없음, 환경 변수 불필요

호스팅 측에서 설정할 것이 없습니다. 빌드 명령어 없음, 환경 변수 없음. 각 사용자는 클라이언트 측에서 자신의 OpenRouter API 키를 붙여넣습니다.

커스텀 도메인 및 HTTPS 설정

모든 정적 호스트에서 표준입니다. 한 가지 주목할 점: localStorage는 origin에 한정됩니다. 다른 JavaScript도 서비스하는 도메인에서 G0DM0D3를 서비스한다면, 해당 origin의 모든 스크립트가 저장된 API 키를 읽을 수 있습니다. 보안이 중요한 배포라면 전용 서브도메인을 사용하세요.

옵션 4 — 전체 API 서버 (Docker)

프로덕션 통합, 팀 배포, 또는 G0DM0D3의 평가 엔진 위에 프로그래밍 방식으로 구축하는 모든 분을 위한 경로.

Docker로 빌드 및 실행

cd api/
docker build -t g0dm0d3-api .
docker run -p 7860:7860 g0dm0d3-api

API 서버는 포트 7860에서 실행되며 ULTRAPLINIAN 엔진, AutoTune, Parseltongue, STM을 OpenAI SDK 호환 REST 엔드포인트로 노출합니다.

OPENROUTER_API_KEY를 환경 변수로 설정

API 서버의 경우, OpenRouter 키는 localStorage 대신 환경 변수에 저장됩니다:

docker run -p 7860:7860 -e OPENROUTER_API_KEY=sk-or-v1-your-key-here g0dm0d3-api

API 서버와 정적 파일 중 언제 사용할지

정적 index.html은 개인 사용에 적합합니다 — 한 사람, 하나의 브라우저, 임시 세션. API 서버는 모든 사람이 자신의 OpenRouter 키를 관리하지 않고 공유 접근이 필요하거나, 스크립트에서 프로그래밍 방식의 접근이 필요할 때 적합합니다.

팀 접근 및 공유 배포 고려사항

API를 보호하려면 GODMODE_API_KEY 또는 GODMODE_API_KEYS (쉼표로 구분)를 환경 변수로 설정하세요. 없으면 서버가 개방형으로 실행됩니다 — 로컬 개발에는 괜찮지만 인터넷에 연결된 환경에는 위험합니다.

첫 번째 멀티모델 평가 실행

GODMODE CLASSIC: 프롬프트 선택, 5개 모델 경쟁 관찰

프롬프트를 입력합니다. 5개의 모델+프롬프트 조합이 병렬로 실행됩니다 — Claude, Grok, Gemini 등. 결과는 5~8초 내에 나타납니다. 프롬프트당 5개의 API 호출. 현재 요금으로 짧은 CLASSIC 실행 비용은 1센트의 일부입니다.

ULTRAPLINIAN: 티어 설정 (1=10개 모델, 5=55개 모델), 복합 점수 확인

ULTRAPLINIAN은 비용 계산이 중요해지기 시작하는 곳입니다. 5개 티어: 10, 21, 31, 41, 또는 55개 모델. 각 모델은 동일한 프롬프트를 받고, 각 응답은 100점 복합 점수로 채점됩니다 — 품질 (50%), 필터 여부 (30%), 속도 (20%).

비용 현실이 여기 있습니다. 전체 티어 5 실행은 55개의 동시 API 호출을 실행합니다. 1K 토큰 프롬프트에 500 토큰 응답의 경우, 실행 전체에서 약 76,500 토큰입니다. 모델 믹스 전체에서 백만 토큰당 $24의 혼합 평균으로, 전체 티어에서 ULTRAPLINIAN 실행 한 번은 약 $0.15~$0.30입니다. 10번 실행: $1.50~$3.00. 연구 세션에서 100번 실행: $15~$30. 예산을 계획하고 G0DM0D3 인터페이스가 아닌 OpenRouter 대시보드에서 지출을 모니터링하세요 — 도구에는 내장된 지출 추적기가 없습니다.

채점에 대해 알아야 할 한 가지: 연구 논문에 따르면 응답 길이가 실효 점수 범위의 약 47%를 차지합니다. 정확도와 무관하게 긴 응답이 더 높은 점수를 받습니다. 리더보드를 해석할 때 그 편향을 염두에 두세요.

AutoTune: 10~20번 상호작용 후 수렴 대기

AutoTune은 EMA 학습 루프를 기반으로 샘플링 매개변수 — temperature, top_p, top_k —를 조정합니다. 어떤 매개변수 구성이 더 좋은 평가를 받는 출력을 생성하는지 관찰하고 세션 동안 적응합니다. 유용한 영역에 정착하는 데 10~20번의 상호작용이 필요합니다. 처음 세 번의 쿼리로 판단하지 마세요.

일반적인 설정 오류 및 수정 방법

”API 키가 작동하지 않음” — OpenRouter 키 형식 및 크레딧 요구사항

GitHub 이슈 페이지에서 가장 흔한 문제입니다. 확인할 세 가지:

첫째, 형식. OpenRouter 키는 sk-or-v1-로 시작합니다. 그렇지 않다면 잘못된 자격 증명을 붙여넣고 있는 것입니다.

둘째, 크레딧. 일부 모델은 프롬프트 비용이 1센트의 일부에 불과하더라도 양수 크레딧 잔액이 필요합니다. 무료 티어는 Google, Meta, Mistral의 옵션을 포함한 25개 이상의 모델을 커버하지만, Claude나 GPT-5 같은 프리미엄 모델은 충전된 크레딧이 필요합니다. OpenRouter는 크레딧 구매에 5.5% 수수료를 부과합니다 — $100 크레딧은 $105.50입니다.

셋째, 타이밍. 계정을 방금 생성했다면 키가 활성화되기 전에 잠깐의 지연이 있을 수 있습니다. 55개 모델로 ULTRAPLINIAN을 시도하기 전에 먼저 간단한 쿼리 하나를 실행하여 작동하는지 확인하세요.

로컬 서비스의 CORS 오류 — 원인과 수정 방법

python3 -m http.server 대신 index.html을 더블클릭하면 브라우저가 file:// URL로 엽니다. 일부 브라우저는 file:// origin에서의 교차 출처 API 요청을 차단합니다. 수정 방법: 항상 로컬 HTTP 서버를 통해 서비스하세요. python3 -m http.server 8000은 한 줄이면 문제를 해결합니다.

병렬 모드에서 오류를 반환하는 모델 — 속도 제한 처리

단일 API 키에서 55개의 동시 요청을 실행하면 OpenRouter의 키당 속도 제한에 걸릴 수 있습니다. 증상: 일부 모델 슬롯은 오류를 반환하고 다른 슬롯은 정상적으로 완료됩니다. ULTRAPLINIAN은 부분 결과를 처리합니다 — 반환된 것은 무엇이든 채점합니다 — 하지만 나쁜 실행은 불완전한 리더보드를 생성합니다.

두 가지 실용적인 수정 방법. 첫째, 낮은 티어 (10~21개 모델)에서 시작하여 계정의 속도 제한이 동시성을 처리할 수 있는지 확인한 후 확장하세요. 둘째, OpenRouter 무료 티어에 있다면 속도 제한이 더 엄격합니다. 크레딧을 추가하면 제한이 완화됩니다. 불안정한 WiFi는 이를 악화시킵니다 — 불안정한 모바일 데이터로 브라우저에서 55개의 동시 HTTP 요청은 타임아웃을 생성합니다. 안정적인 연결을 사용하세요.

FAQ

55개 모델에서 ULTRAPLINIAN을 실행하는 데 얼마나 드나요?

모델 믹스와 응답 길이에 따라 일반적인 프롬프트에서 실행당 약 $0.15~$0.30입니다. 비용이 균일하지 않습니다 — Claude와 GPT-5 같은 프리미엄 모델은 Meta나 Mistral의 오픈소스 대안보다 토큰당 훨씬 더 많은 비용이 듭니다. 전체 티어에서 100개 쿼리의 연구 세션에서는 $15~$30을 예상하세요. openrouter.ai/activity에서 지출을 모니터링하세요.

팀과 G0DM0D3 인스턴스를 공유할 수 있나요?

정적 파일 (옵션 1~3)의 경우, 각 사람은 자신의 OpenRouter 키가 필요합니다 — 키는 각 사람의 브라우저 클라이언트 측에 저장됩니다. Docker API 서버 (옵션 4)의 경우, 하나의 공유 OpenRouter 키를 서버 측에 설정하고 GODMODE_API_KEY로 접근을 제어할 수 있습니다. 그것이 의도된 팀 배포 경로입니다.

G0DM0D3가 Ollama나 로컬 모델과 작동하나요?

직접적으로는 아닙니다. G0DM0D3는 아키텍처적으로 OpenRouter의 API에 결합되어 있습니다. 로컬 Ollama 엔드포인트를 가리키는 인터페이스가 없습니다. 로컬 모델 평가가 필요하다면 소스를 수정해야 합니다 — AGPL-3.0 하에 공개되어 있습니다 — OpenRouter 호출을 Ollama 호환 엔드포인트로 교체하기 위해. 그것은 설정 변경이 아닌 중요한 포크입니다.

새 버전이 출시될 때 G0DM0D3를 어떻게 업데이트하나요?

복제된 저장소에서 git pull을 실행하세요. 애플리케이션은 단일 파일이므로 마이그레이션, 데이터베이스 업데이트, 의존성 해결이 없습니다. godmod3.ai의 호스팅 버전의 경우 업데이트가 자동으로 이루어집니다 — 항상 최신 배포를 받습니다.

병렬 모델 호출 실행 시 속도 제한이 있나요?

네, 하지만 G0DM0D3의 속도 제한이 아닌 OpenRouter의 속도 제한입니다. 도구 자체는 정적 배포에서 서버 측 속도 제한이 없습니다. OpenRouter는 계정 티어와 크레딧 잔액에 따라 다른 키당 제한을 적용합니다. 티어 5에서 지속적으로 제한에 걸린다면, 크레딧을 추가하여 할당량을 늘리거나 낮은 티어에서 실행하세요.

G0DM0D3는 AGPL-3.0 하에 라이선스됩니다. 엔터프라이즈 사용에는 별도의 라이선스가 필요합니다 — 자세한 내용은 GitHub 저장소에 있습니다. 도구는 AI 안전 연구, 레드팀, 멀티모델 평가를 위해 elder-plinius (Pliny the Prompter)가 구축했습니다.

이전 게시물: