본문으로 건너뛰기

Aside 커스텀 프로바이더 설정 가이드: 무료 스텔스 모델부터 Solar Pro 4까지 6단계로 연결하기

· 약 7분
Datapopcorn CEO / AI automation educator
이 글과 연결된 글 보기
7편 · 19개 연결
100%
Aside 커스텀 프로바이더 설정 가이드: 무료 스텔스 모델부터 Solar Pro 4까지 6단계로 연결하기Claude Team 관리자 가이드: 권한·좌석·비용부터 사내 교육까지Aside로 30분 안에 당근비즈니스에 내 물건 등록하기: 따라 하는 프롬프트와 화면 11장AI 데모는 되는데 실무 투입이 어렵다면: GTC Berlin 2026 주요 강연 정리n8n 셀프호스팅 커스텀 가이드: 한글 설정부터 버튼 튜토리얼 UI까지SOC 2 Type II란? ISO 27001·ISMS-P와 차이, 보고서 읽는 법이번 주 팝콘 줍줍 — 제미나이 안에서 고치는 PDF·슬라이드, 반값 GPT-6.1 Terra, ChatGPT 구독에 붙는 API 크레딧 (10월 5주)

드래그로 이동 · 휠/두 손가락으로 확대 · 방향키로 글 선택 · 0으로 맞춤. 실선: 본문 링크, 점선: 시리즈·주제의 대표 연결.

표시된 글 7편 목록
전체 글 연결 탐색

API 키를 하나 발급받은 뒤, 이 글의 JSON에서 키 자리만 바꿔 Aside 설정의 Models → Connect → Add custom provider에 붙여넣으면 기본 목록에 없는 모델도 Aside에서 바로 쓸 수 있습니다. 이 글의 예시 3개는 모두 Aside에서 실제로 대화를 보내 응답까지 확인한 설정이라, 키만 바꾸면 그대로 동작합니다.

이 글은 이런 분께 필요합니다​

  • Aside를 쓰고 있고, 기본 목록에 없는 모델을 쓰고 싶은 분
  • 지금 무료로 풀려 있는 OpenRouter 스텔스 모델(Space Bunny Alpha)을 Aside에서 써보고 싶은 분
  • 한국어에 강한 Upstage Solar Pro 4를 Aside의 기본 모델로 쓰고 싶은 분
  • Add custom provider에 붙여넣었는데 Provider authentication failed나 400 오류가 나서 막힌 분

준비물은 API 키 하나뿐입니다. 어떤 키가 필요한지는 아래 표에서 고르면 됩니다.

쓰고 싶은 모델필요한 키비용 (2026년 9월 30일 기준)예시
Space Bunny Alpha (스텔스)OpenRouter 키무료 (한시적)예시 A
Solar Pro 4, OpenRouter 경유OpenRouter 키입력 $0.09 / 출력 $0.36 (100만 토큰당, 70% 할인가)예시 B
Solar Pro 4, Upstage 직접Upstage 키Upstage 콘솔 요금 기준예시 C

처음이라면 예시 A부터 해보길 권합니다. OpenRouter 키 하나로 무료 모델을 바로 써볼 수 있고, 같은 키로 예시 B도 이어서 연결할 수 있습니다.

Step 1. API 키를 발급받습니다​

OpenRouter 키 (예시 A, B용)​

  1. openrouter.ai/settings/keys에 로그인해 들어갑니다.
  2. 오른쪽 위 New Key를 누르고 이름(예: aside)을 적어 만듭니다.
  3. 화면에 뜬 sk-or-v1-로 시작하는 키를 복사해 둡니다. 이 창을 닫으면 전체 키를 다시 볼 수 없으니 바로 복사합니다.

Upstage 키 (예시 C용)​

  1. console.upstage.ai/api-keys에 로그인해 들어갑니다.
  2. Create new key를 눌러 키를 만듭니다.
  3. up_로 시작하는 키를 복사해 둡니다.

API 키는 비밀번호와 같습니다. 블로그, 채팅, 스크린샷에 올리지 말고, 노출됐다면 같은 화면에서 바로 폐기(Revoke/Delete)하고 새로 만듭니다.

Step 2. 설정에서 Models 화면을 엽니다​

Aside 설정을 열고 왼쪽 메뉴에서 Models를 누릅니다. 화면 위쪽 Providers 목록에 지금 연결된 서비스가 보이고, 목록 맨 아래에 + Connect 버튼이 있습니다.

Aside Settings의 Models 화면. Providers 목록 맨 아래에 + Connect 버튼이 있습니다

Step 3. Connect → Add custom provider를 누릅니다​

+ Connect를 누르면 연결할 수 있는 서비스 목록이 열립니다. 목록 맨 아래 + Add custom provider를 누르면 JSON을 붙여넣는 입력 칸이 나옵니다.

Connect 목록 맨 아래의 Add custom provider 버튼

입력 칸에는 "Paste a pi-compatible provider config"라는 안내가 나옵니다. Aside는 오픈소스 코딩 에이전트 pi와 같은 설정 형식을 쓰기 때문에, pi용으로 만든 설정도 그대로 붙여넣을 수 있습니다.

Step 4. 예시 JSON을 복사해 키만 바꾸고 붙여넣습니다​

아래 예시 중 하나를 통째로 복사합니다. 바꿀 곳은 "apiKey" 한 줄뿐입니다. 따옴표는 그대로 두고, 따옴표 안의 OPENROUTER_API_KEY 또는 UPSTAGE_API_KEY 글자를 지우고 Step 1에서 복사한 키를 넣습니다.

"apiKey": "OPENROUTER_API_KEY", ← 바꾸기 전
"apiKey": "sk-or-v1-발급받은_키_전체", ← 바꾼 후

OPENROUTER_API_KEY 글자를 그대로 두면 키가 전달되지 않아 인증 오류가 납니다. 환경변수로 설정해도 Aside 앱에는 전달되지 않을 수 있으니, 키 문자열을 직접 넣습니다.

예시 A. Space Bunny Alpha (무료 스텔스 모델)​

OpenRouter의 Space Bunny Alpha 페이지. 가격이 Free, 컨텍스트 1.0M으로 표시됩니다

Space Bunny Alpha는 OpenRouter에 익명으로 올라온 스텔스 모델입니다. 2026년 9월 30일 기준 입력과 출력이 모두 무료이고, 100만 토큰 컨텍스트와 이미지 입력을 지원합니다.

{
"providers": {
"openrouter-stealth": {
"name": "OpenRouter Stealth",
"baseUrl": "https://openrouter.ai/api/v1",
"apiKey": "OPENROUTER_API_KEY",
"api": "openai-completions",
"authHeader": true,
"models": [
{
"id": "stealth/space-bunny-alpha",
"name": "Space Bunny Alpha",
"reasoning": true,
"input": ["text", "image"],
"contextWindow": 1000000,
"maxTokens": 32768
}
]
}
}
}

쓰기 전에 알아둘 점이 두 가지 있습니다. 모델 페이지 안내에 따르면 스텔스 모델의 프롬프트와 답변은 제공사가 보관할 수 있습니다(학습에는 쓰지 않는다고 되어 있음). 그래서 회사 기밀이나 개인정보는 넣지 않는 편이 좋습니다. 또 무료는 공개 전 미리보기 기간 동안이라, 나중에 유료로 바뀌거나 모델 이름이 바뀌어 목록에서 사라질 수 있습니다.

예시 B. Solar Pro 4, OpenRouter 경유 (70% 할인 중)​

OpenRouter의 Solar Pro 4 페이지. 70% 할인된 입력 $0.09, 출력 $0.36 가격이 표시됩니다

예시 A와 같은 OpenRouter 키로 Upstage의 Solar Pro 4를 쓰는 방법입니다. 2026년 9월 30일 기준 70% 할인가로 100만 토큰당 입력 $0.09, 출력 $0.36이고, 컨텍스트는 524K입니다. 추가 옵션 없이 바로 동작합니다.

{
"providers": {
"openrouter-upstage": {
"name": "OpenRouter Solar Pro 4",
"baseUrl": "https://openrouter.ai/api/v1",
"apiKey": "OPENROUTER_API_KEY",
"api": "openai-completions",
"authHeader": true,
"models": [
{
"id": "upstage/solar-pro4",
"name": "Solar Pro 4",
"reasoning": true,
"input": ["text"],
"contextWindow": 524288,
"maxTokens": 16384
}
]
}
}
}

예시 A와 B는 providers 아래 이름(openrouter-stealth, openrouter-upstage)이 달라서 둘 다 추가해도 겹치지 않습니다. 하나씩 따로 붙여넣으면 됩니다.

예시 C. Solar Pro 4, Upstage 직접 연결​

Upstage 콘솔에서 받은 키로 직접 연결하는 방법입니다. 예시 B와 달리 compat 부분(옵션 두 개)이 꼭 필요합니다. 이 부분이 없으면 400 오류가 나는데, 이유는 아래 오류 해결 표에 정리했습니다.

{
"providers": {
"upstage": {
"name": "Upstage",
"baseUrl": "https://api.upstage.ai/v1",
"apiKey": "UPSTAGE_API_KEY",
"api": "openai-completions",
"authHeader": true,
"compat": {
"supportsStore": false,
"supportsDeveloperRole": false
},
"models": [
{
"id": "solar-pro4",
"name": "Solar Pro 4",
"reasoning": true,
"input": ["text"],
"contextWindow": 524288,
"maxTokens": 16384
}
]
}
}
}

다른 모델로 바꾸고 싶다면​

위 예시에서 아래 칸만 바꾸면 다른 모델도 같은 방식으로 붙일 수 있습니다.

칸넣을 값
providers 아래 이름영문 소문자와 하이픈으로 된 이름. Providers 목록에 이 이름이 표시되므로(openrouter-upstage → Openrouter Upstage), 다른 프로바이더와 겹치지 않게 짓습니다
models[].idOpenRouter는 모델 페이지 주소의 이름(예: stealth/space-bunny-alpha), 직접 연결은 서비스 문서의 모델 ID
models[].name모델 선택 목록에 보일 이름
input이미지를 받는 모델이면 ["text", "image"], 아니면 ["text"]
contextWindow, maxTokens모델 페이지에 적힌 컨텍스트 길이와 최대 출력 토큰
baseUrl서비스의 OpenAI 호환 주소. /v1까지만 쓰고 /chat/completions는 붙이지 않습니다

Step 5. 목록에 뜬 모델을 기본 모델로 고릅니다​

저장하면 Providers 목록에 새 프로바이더가 추가됩니다. 예시 B라면 "Openrouter Upstage"라는 이름으로 보입니다. 같은 Models 화면 아래 Task models → Default model 드롭다운을 열면 새 모델(models[].name에 적은 이름)을 고를 수 있습니다.

화면 설명("The last used model becomes the default for new chat")처럼 마지막에 쓴 모델이 새 대화의 기본값이 됩니다. 다른 모델로 대화하면 기본값도 그 모델로 바뀐다는 점만 알아두면 됩니다.

Step 6. 짧은 질문으로 연결을 확인합니다​

새 대화를 열고 답이 정해진 짧은 질문을 보내 봅니다.

An $80 item gets a 20% discount, then 10% tax is added. What is the final price? Answer with only the dollar amount.

$70.40이 돌아오면 연결이 끝난 것입니다. 이 글의 예시 A, B, C 모두 이 질문에 $70.40으로 답하는 것을 확인했습니다. 오류가 나면 아래 표에서 같은 메시지를 찾아 설정을 고칩니다.

오류가 나면 여기부터 확인하세요​

오류 메시지원인해결
Provider authentication failedapiKey에 OPENROUTER_API_KEY 같은 안내 글자가 그대로 있거나, 키가 빠졌거나, 키를 폐기했음apiKey에 발급받은 키 문자열 전체를 넣습니다. 앞뒤 공백도 확인합니다
400: Unrecognized request arguments supplied: storeAside가 보내는 store 필드를 서비스가 모름"compat": { "supportsStore": false }를 추가합니다
400: The 'role' value 'developer' must be one of ['system', 'assistant', 'user', 'tool']시스템 프롬프트를 developer 역할로 보내는데 서비스가 지원하지 않음compat에 "supportsDeveloperRole": false를 추가합니다

Upstage에 직접 연결하면 두 번째와 세 번째 오류가 차례로 나옵니다. store를 끄고 나면 다음 요청에서 developer 오류가 나오기 때문에, 처음부터 예시 C처럼 두 옵션을 함께 넣는 편이 빠릅니다. compat의 전체 옵션은 pi 문서의 OpenAI Compatibility 항목에 있습니다. 다른 서비스를 연결하다 비슷한 400 오류를 만나면, 오류에 나온 필드 이름으로 이 목록에서 맞는 옵션을 찾으면 됩니다.

정리​

키 발급 → Models → Connect → Add custom provider → 예시 JSON에서 키만 바꿔 붙여넣기 → Default model 선택 → 질문으로 확인, 이 여섯 단계면 끝납니다. 가장 빨리 해보려면 OpenRouter 키 하나로 예시 A의 무료 스텔스 모델부터 연결해 보세요. 같은 키로 예시 B의 Solar Pro 4도 바로 추가할 수 있습니다.

전체 연결 보기