MINARALLM 제공자
Minara가 지원하는 일곱 개의 모델 제공자와 Minara 카탈로그의 Auto. API 키와 OAuth 경로, 과금 위험, 선택 방법을 설명합니다.
Minara가 추론하려면 LLM 제공자가 하나 필요합니다. 제공자 계열은 일곱 가지입니다. 대부분은 두 가지 로그인 방법(API 키(토큰당 과금)와 OAuth(이미 결제 중인 구독 재사용))을 제공합니다. 일부는 단일 경로로, Kimi와 Ollama Cloud는 API 키만, Minara는 내장 플랫폼 계정으로 OAuth만 지원합니다. 이 페이지에서는 장단점, 과금 위험, 선택 방법을 설명합니다. 실제 로그인 명령은 설치를, 변수 이름은 환경 변수를 참조하세요.
한눈에 보기
| 제공자 | API 키 경로 | OAuth 경로 | OAuth 실행 기반 | OAuth에서 쓸 수 있는 모델 | 과금 |
|---|---|---|---|---|---|
| Minara | : (없음) | minara-oauth | 당신의 Minara 계정 | Auto와 Minara 게이트웨이가 제공하는 모델 | Minara 계정으로 과금. |
| Anthropic | anthropic-api-key | anthropic-oauth | Claude Max + 추가 사용 크레딧 | Claude 모델 | API 키: 토큰당. OAuth: 구매한 추가 사용 크레딧 소비. |
| OpenAI | openai-api-key | openai-oauth(Codex) | ChatGPT 구독, Codex 백엔드 경유 | Codex 지원 모델만 | API 키: 토큰당. OAuth: ChatGPT 요금제에 포함. |
| OpenRouter | openrouter-api-key | openrouter-pkce | OpenRouter 계정 잔액 | 여러 공급사 300+ 모델 | 둘 다 OpenRouter 잔액에서 차감. |
| Kimi | kimi-api-key | (없음) | (없음) | (없음) | Kimi API 계정에서 토큰당 과금. |
| xAI(Grok) | xai-api-key | xai-oauth | SuperGrok 또는 X Premium+ 구독 | Grok 모델 | API 키: 토큰당. OAuth: X 구독에 포함. |
| Ollama Cloud | ollama | : (없음) | — | : | 무료 등급(한도 있음)과 유료 Turbo. Minara가 계측하는 토큰당 과금은 없음. |
경로 선택: API 키 vs OAuth
API 키 는 사용량 계량기입니다. 쓴 만큼 지불하고, 제공자의 모든 모델을 쓸 수 있습니다. 이 경로는 누구나 사용할 수 있습니다.
OAuth 는 이미 구매한 구독을 재사용합니다. 토큰당 별도 청구가 없습니다. 대신 일부 모델만 동작하고 요금제 한도가 있습니다. 각 제공자의 OAuth 경로에는 고유한 함정이 있으며 아래에서 설명합니다.
모델과 추론 수준 선택
Chat 입력창의 모델 컨트롤에서 모델과 추론 수준을 선택합니다. 모델과 추론 옵션은 같은 형식의 하위 메뉴에서 열리며, 표시 위치와 조작 방식도 일관됩니다.
선택한 값은 현재 Chat 세션에 적용됩니다. Minara는 다음 메시지부터 이 설정을 사용하고 같은 Chat의 이후 대화에서도 유지합니다. 이미 생성 중인 응답을 바꾸거나 배포 전체의 기본 모델을 변경하지는 않습니다.
Minara 제공자에서는 Auto로 시작하세요. 각 메시지를 평가한 뒤 그 턴에 맞는 카탈로그 모델을 고릅니다. 전략은 아래 절에서 설명합니다. 입력창에서 특정 모델을 고정할 수도 있습니다. 현재 세션에서 선택한 모델이 해당 Chat의 이후 메시지에 우선 적용됩니다.
Minara
Minara는 내장 플랫폼 계정입니다. minara-oauth로 로그인합니다. 사용량은 Minara 계정으로 과금됩니다. 카탈로그는 Minara 게이트웨이가 현재 제공하는 모델입니다.
Auto
Auto는 Minara에서 권장하는 모델입니다. Chat 입력창에서 한 번만 고르면 됩니다. Minara는 다음 메시지를 평가한 뒤 그 턴에 맞는 카탈로그 모델로 라우팅합니다.
시세 확인은 빠르고 저렴한 모델에 머뭅니다. 시장 메모, 자동화, 실주문 경로, 코드 변경에서는 Auto가 한 단계 올립니다. 가벼운 일은 빠르게, 자금을 움직이거나 코드를 내는 일은 정밀하게 유지합니다.
이것이 Minara의 본업입니다. 금융 분석, 예약 및 Agent 워크플로, 거래 실행, 프로그래밍. Auto를 켜 두면 한 대화에서 이 일을 모두 할 수 있습니다. 라우터는 그 턴이 그만한 가치가 있을 때만 더 씁니다.
Auto를 고른 뒤 설정(제공자 및 모델)에 전략 세 가지가 나타납니다. 저장된 사용자 설정이 MINARA_AUTO_MODEL_STRATEGY보다 우선합니다. 배경 제목과 압축 모델은 배경 작업 모델 페이지에 그대로 있으며 Auto 대상이 아닙니다.
| 전략 | 쓰는 때 | 기본 매핑 |
|---|---|---|
| balanced(기본값) | 가벼운 턴은 빠르게 두고, 점수가 오를 때만 더 쓰고 싶을 때. | SIMPLE/MEDIUM은 DeepSeek V4 Flash(비전 또는 PDF가 필요하면 Claude Sonnet 5). COMPLEX는 GPT-5.6 Terra. REASONING은 GPT-5.6 Sol. |
| economy | 크레딧을 더 오래 쓰고 싶을 때. | 가벼운 턴은 같은 Flash. COMPLEX는 GLM 5.2. REASONING은 Kimi K3. |
| quality | 난이도마다 카탈로그에서 가장 강한 모델을 쓰고 싶을 때. | 가벼운 턴은 Claude Sonnet 5. COMPLEX는 GPT-5.6 Terra. REASONING은 Claude Opus 5. |
세션 후반을 하나의 카탈로그 모델로 고정하려면 그 모델을 고정하세요. 다음 Chat에서도 Auto는 선택기에 남아 있습니다.
Anthropic(Claude)
Anthropic은 Claude를 제공합니다.
anthropic-api-key 는 요청을 api.anthropic.com으로 보냅니다. console.anthropic.com에서 키를 받아 토큰당 지불합니다. 모든 Claude 모델을 쓸 수 있습니다.
anthropic-oauth 는 Claude Max 구독을 재사용합니다. Minara는 Claude Code 도구와 같은 방식으로 로그인하므로, Anthropic은 요청을 Claude Code 활동으로 처리합니다.
Anthropic OAuth에는 Claude Max와 추가 사용 크레딧이 필요합니다
minara auth login anthropic은 Claude Code와 같은 방식으로 로그인합니다. Anthropic은 그 요청을 Claude Code 활동으로 과금합니다. 이 경로는 Claude Max 요금제에서만 동작합니다. Max 위에 구매한 "추가 사용" 크레딧을 소비합니다. 기본 Max 한도는 절대 사용하지 않습니다. 추가 크레딧이 없으면 유효한 Max 요금제에서도 요청이 실패합니다. Claude Pro는 이 경로를 쓸 수 없습니다. Pro이거나 토큰당 지불을 원하면 대신 ANTHROPIC_API_KEY를 설정하세요.
OpenAI
OpenAI에는 로그인 방법이 두 가지 있고, 둘은 매우 다릅니다.
openai-api-key 는 요청을 api.openai.com으로 보냅니다. platform.openai.com에서 키를 받아 토큰당 지불합니다. gpt-5.5-pro, gpt-4.1, o3를 포함한 OpenAI 전체 라인업을 쓸 수 있습니다.
openai-oauth 는 Codex OAuth입니다. Minara는 OpenAI Codex CLI 디바이스 플로우로 로그인하며 Codex CLI로 동작합니다. 요청은 api.openai.com이 아니라 OpenAI의 퍼스트파티 Codex 백엔드 chatgpt.com/backend-api/codex로 가며, 당신의 ChatGPT 구독 위에서 실행됩니다.
OpenAI OAuth는 Codex OAuth이며 OpenAI 플랫폼 API가 아닙니다
minara auth login openai는 OpenAI Codex CLI로 로그인합니다. 요청은 OpenAI의 Codex 백엔드를 거쳐 당신의 ChatGPT 구독 위에서 실행됩니다. 이 경로는 Codex 지원 모델만 지원합니다. gpt-5.5-pro, gpt-4.1, o3 같은 모델은 여기서 쓸 수 없습니다. OpenAI 전체 라인업을 쓰려면 대신 OpenAI API 키로 로그인하세요.
ChatGPT Codex 백엔드는 회전하는 허용 목록을 제공합니다. Settings의 live catalog가 기준입니다. 현세대 모델은 다음과 같습니다.
gpt-5.6-terra(기본값)gpt-5.6-solgpt-5.6-luna
gpt-5.3-codex 같은 이전 *-codex 슬러그는 백엔드가 폐기하면 HTTP 400을 반환합니다.
설정에서 모델 선택기는 항상 OpenAI 전체 라인업을 보여줍니다. 연결된 계정으로 실행할 수 없는 모델은 흐리게 표시되고 짧은 이유가 붙습니다. ChatGPT 로그인에서는 OpenAI API 키를 연결할 때까지 비 Codex 모델이 흐리게 유지됩니다. ChatGPT 로그인과 API 키를 둘 다 연결했다면 어떤 모델이든 고를 수 있습니다. 다른 계정이 필요한 모델을 고르면 활성 연결이 자동으로 전환됩니다.
OpenRouter
OpenRouter는 여러 공급사(Anthropic, OpenAI, Google, Meta 등)의 300+ 모델로 가는 단일 입구입니다. 두 로그인 경로 모두 같은 OpenRouter 크레딧 잔액에서 차감됩니다.
openrouter-api-key 는 openrouter.ai의 키를 사용합니다. openrouter-pkce 는 브라우저로 로그인하며 키를 복사할 필요가 없습니다. 어느 쪽이든 Minara는 귀속 헤더를 붙여 OpenRouter 대시보드에서 사용량이 Minara로 집계되게 합니다.
OpenRouter는 항상 당신의 OpenRouter 잔액에서 차감합니다
여기에는 구독 경로가 없습니다. API 키와 브라우저 로그인 모두 OpenRouter 계정에 충전한 크레딧을 소비합니다. 긴 세션 전에 잔액을 충전하세요. 잔액이 0이 되면 충전할 때까지 요청이 멈춥니다.
Kimi
Kimi는 공식 Kimi API 플랫폼에 직접 연결하는 API 키 전용 제공자입니다. platform.kimi.ai에서 키를 만든 뒤 minara auth login kimi --api-key <key>를 실행하거나 KIMI_API_KEY를 설정하세요.
kimi-api-key 는 OpenAI 호환 Chat Completions 요청을 https://api.moonshot.ai/v1로 보냅니다. 모델 목록은 공식 /v1/models에서 가져오며 콜드 스타트 기본값은 kimi-k2.6입니다. 스트리밍, 도구 호출, 구조화 출력, K2.6 reasoning-content 재전송을 지원합니다. 한 도구를 강제하는 턴에서는 thinking이 켜진 Kimi API가 자동 또는 비활성 도구 선택만 허용하므로 해당 호출에서만 K2.6 thinking을 끕니다.
xAI(Grok)
xAI는 Grok을 제공합니다.
xai-api-key 는 xAI 콘솔의 키를 사용해 api.x.ai에서 토큰당 과금합니다. xai-oauth 는 브라우저로 로그인하며 SuperGrok 또는 X Premium+ 구독을 재사용합니다.
xAI OAuth에는 SuperGrok 또는 X Premium+ 구독이 필요합니다
이 경로는 그 요금제에 포함된 Grok 접근 권한을 재사용합니다. 무료 X 계정으로는 동작하지 않습니다. 이런 구독이 없으면 xAI API 키를 사용하세요.
Ollama Cloud
Ollama Cloud는 Ollama의 호스팅 서버에서 오픈 모델(gpt-oss, DeepSeek, Qwen3-Coder, Kimi K2 등)을 실행하므로 로컬 GPU가 필요 없습니다. 로그인 방법은 API 키 하나뿐입니다.
ollama 는 OpenAI 호환 엔드포인트로 https://ollama.com에 요청을 보냅니다. ollama.com/settings/keys에서 키를 만들고 minara auth login ollama --api-key <key>를 실행하거나 OLLAMA_API_KEY를 설정하세요. 자체 호스팅이나 로컬 Ollama를 가리키려면 OLLAMA_BASE_URL(예: http://localhost:11434)을 설정하거나 --base-url을 전달하세요.
Ollama Cloud에는 무료 등급 한도와 유료 Turbo 등급이 있습니다
무료 등급은 실행량에 한도가 있습니다. 많이 쓰려면 유료 Turbo 요금제가 필요합니다. 한도에 도달하면 창이 초기화되거나 업그레이드할 때까지 요청이 실패합니다. Minara가 계측하는 토큰당 과금이 없으므로 이 제공자의 비용 패널은 0을 표시합니다.
도구 호출, 비전, JSON 출력은 선택한 클라우드 모델에 따라 다릅니다. 큰 지시 튜닝 모델(예: gpt-oss:120b)은 도구를 잘 다루지만 작은 모델은 그렇지 않을 수 있습니다.
무엇을 골라야 할까?
| 당신의 상황 | 이것을 선택 | 이유 |
|---|---|---|
| Minara로 로그인했고 일에 맞춰 강해지는 모델 하나가 필요할 때 | Minara 제공자의 Auto | 메시지마다 라우팅. 가벼운 턴은 빠르고, 분석·자동화·거래·코드에서는 더 강함. |
| Claude Max를 결제하고 추가 사용 크레딧도 구매함 | Anthropic OAuth(anthropic-oauth) | 이미 가진 크레딧 재사용, 새 청구 없음. |
| Claude를 쓰고 싶지만 Pro만 있거나 구독이 없음 | Anthropic API 키(anthropic-api-key) | Pro는 OAuth 경로를 못 씁니다. 토큰당 지불로. |
| ChatGPT를 결제하고 코딩급 모델만 필요함 | OpenAI OAuth(openai-oauth) | ChatGPT 요금제 위에서 실행, 추가 청구 없음. Codex 모델만. |
gpt-5.5-pro, gpt-4.1, o3 또는 전체 라인업이 필요함 | OpenAI API 키(openai-api-key) | OAuth로는 닿지 않습니다. API 키는 가능. |
| 여러 공급사의 다양한 모델을 시험하고 싶음 | OpenRouter | 한 계정, 300+ 모델. |
| Kimi API 계정이 있고 Kimi 모델에 직접 연결하고 싶음 | Kimi(kimi-api-key) | 공식 엔드포인트와 실시간 모델 목록을 사용하며 집계 서비스를 거치지 않습니다. |
| Grok을 쓰고 싶고 SuperGrok 또는 Premium+를 결제함 | xAI OAuth(xai-oauth) | 구독 재사용. |
| 로컬 GPU 없이 하나의 호스팅 키로 오픈 웨이트 모델을 쓰고 싶음 | Ollama Cloud(ollama) | 키 하나, 토큰당 과금 없음, gpt-oss / DeepSeek / Qwen 실행. |
| 잘 모르겠고 가장 간단하게 시작하고 싶음 | 아무 API 키 | 누구나 사용, 모든 모델 사용 가능, 쓴 만큼 지불. |
문제 해결
오류: out_of_credits 또는 잔액 부족
제공자 잔액이 소진되었습니다. OpenRouter는 openrouter.ai에서 충전하세요. Anthropic OAuth는 Claude Max 요금제에서 추가 사용 크레딧을 구매하세요. API 키 경로는 제공자 콘솔에서 충전하거나 지출 한도를 올리세요.
OpenAI OAuth에서 모델이 404 또는 model not found를 반환함
Codex 백엔드가 제공하지 않는 모델을 요청했습니다. live Codex 목록에서 gpt-5.6-terra 같은 모델을 고르거나, OpenAI API 키로 로그인해 전체 라인업에 닿으세요.
로그인이 거부되거나 세션이 만료됨
저장된 자격 증명이 무효이거나 만료되었습니다. 해당하는 minara auth login <provider> 명령을 다시 실행해 갱신하세요. Anthropic OAuth는 Pro가 아니라 Claude Max인지 확인하세요. OpenAI OAuth는 ChatGPT 구독이 유효한지 확인하세요.