레퍼런스
설정
유효 값은 3계층 순서를 따릅니다: 환경 변수가 ~/.ima2/config.json을 덮어쓰고, 그것이
내장 기본값을 덮어씁니다.
환경 변수
| 변수 | 기본값 | 설명 |
|---|---|---|
IMA2_PORT / PORT | 3333 | 웹 서버 포트. |
IMA2_HOST | 127.0.0.1 | 웹 서버 바인드 호스트. |
IMA2_OAUTH_PROXY_PORT / OAUTH_PORT | 10531 | IMA2_NO_OAUTH_PROXY=1일 때 쓰는 외부 GPT OAuth 엔드포인트 포트. |
IMA2_SERVER | — | CLI 타깃 오버라이드. |
IMA2_CONFIG_DIR | ~/.ima2 | 설정과 SQLite 위치. |
IMA2_ADVERTISE_FILE | ~/.ima2/server.json | 런타임 탐색 파일. |
IMA2_GENERATED_DIR | ~/.ima2/generated | 생성 이미지 디렉터리. |
IMA2_IMAGE_MODEL_DEFAULT | gpt-6-luna | 서버 폴백 이미지 모델. |
IMA2_PROMPT_BUILDER_BACKEND | auto | Prompt Builder 텍스트 백엔드. 자동 선택은 준비된 지원 경로 가운데 하나를 고릅니다. |
IMA2_PROMPT_BUILDER_MODEL | 자동 백엔드에서는 auto | 선택한 백엔드 전용 Builder model. 백엔드를 바꾸면 해당 경로의 기본 모델로 함께 바뀝니다. |
IMA2_REASONING_EFFORT | medium | 기본(OAuth) 경로의 reasoning effort 기본값; none·low·medium·high·xhigh 중 하나. |
IMA2_NO_OAUTH_PROXY | — | 1로 설정하면 GPT OAuth 호출을 ChatGPT 대신 127.0.0.1:IMA2_OAUTH_PROXY_PORT의 OpenAI 호환 엔드포인트로 보냅니다. |
IMA2_LOG_LEVEL | info | serve는 info, dev는 debug 기본; debug·info·warn·error·silent 지원. |
IMA2_INFLIGHT_TERMINAL_TTL_MS | 300000 | 디버그 뷰용 최근 종료 작업 보존 시간. |
OPENAI_API_KEY | — | API 프로바이더 Responses 경로 및 보조 기능용 API key. |
IMA2_API_IMAGE_MODEL_DEFAULT | gpt-5.6-luna | API 경로의 기본 이미지 모델. |
IMA2_API_REASONING_EFFORT | low | API 경로의 기본 reasoning effort. |
IMA2_API_IMAGE_SIZE | 1024x1024 | API 경로의 기본 크기. |
IMA2_API_ALLOW_WEB_SEARCH | true | API 경로의 웹 검색 토글. |
IMA2_GROK_PLANNER_MODEL | grok-4.3 | Grok 플래너 모델. Grok 4.5·4.6도 고를 수 있습니다. |
IMA2_GROK_PLANNER_TIMEOUT_MS | 900000 | 각 Grok search/planner 단계 timeout. |
IMA2_GROK_SEARCH_TIMEOUT_MS | 300000 | 필수 xAI 웹 검색 단계 timeout. |
IMA2_GROK_VIDEO_PLAN_TOTAL_TIMEOUT_MS | 1500000 | 비디오 검색 + 플래너 단계 전체 상한. |
IMA2_GROK_IMAGE_MODEL_DEFAULT | grok-imagine-image-2.0 | Grok 이미지 호출 기본 xAI image 모델. |
IMA2_GROK_VIDEO_MODEL_DEFAULT | grok-imagine-video-1.5 | Grok 생성 경로의 기본 xAI 비디오 모델. |
IMA2_GROK_GENERATION_TIMEOUT_MS | 300000 | 최종 Grok 이미지 생성/edit 호출 timeout. |
IMA2_GROK_STATUS_TIMEOUT_MS | 3000 | /api/grok/status 모델 probe timeout. |
IMA2_OAUTH_MASKED_EDIT_ENABLED | false | OAuth 경로의 masked-edit 옵트인 플래그 (#31, 기반 작업만). |
설정 파일
ima2 config는 ~/.ima2/config.json(파일 레이어)을 읽고 씁니다. 알 수 없는
키를 거부하고, 인증 키(provider, apiKey)를 막고, env 변수가 같은 키를
덮어쓰면 경고합니다. 인증은 ima2 setup 또는 ima2 login으로 바꾸세요.
주요 쓰기 가능 키
promptBuilder.backend promptBuilder.model
imageModels.default imageModels.reasoningEffort
apiProvider.defaultImageModel apiProvider.defaultReasoningEffort
grokProvider.plannerModel grokProvider.plannerTimeoutMs
grokProvider.defaultImageModel grokProvider.defaultVideoModel
log.level features.cardNews
server.port server.host server.bodyLimit
oauth.proxyPort limits.maxRefCount limits.maxParallel
history.defaultPageSize history.maxPageCap storage.generatedDir권위 있는 전체 목록은 ima2 config keys, 병합된 값은 ima2 config ls --effective를 실행하세요.
로깅 모드
ima2 serve는 의도적으로 조용합니다: 시작 URL·경고·에러는 보이고, 요청/node/OAuth
구조화 로그는 기본 숨김입니다. 요청 ID, node phase, OAuth 스트림 진단, inflight 전이가 필요하면
ima2 serve --dev, npm run dev, 또는
IMA2_LOG_LEVEL=debug ima2 serve를 쓰세요.