내 AI API 키
내 OpenAI, Anthropic, Gemini, OpenRouter API 키를 추가하면, 지금 손에 든 앱이 AI와 바로 대화합니다. 보관한 글에 대해 채팅하고, 리서치하고, AI 댓글을 만들고, 선택한 문단을 묻고, 노트에서 AI를 멘션할 수 있습니다. 키는 기기에만 있고, 요청은 그 기기에서 제공업체로 곧장 갑니다.
모바일 앱 2.6.0 이상, 데스크톱 앱 0.9.0 이상, Obsidian 플러그인 4.11.0 이상에서 쓸 수 있습니다. 노트에서 AI 멘션하기와 저장한 채팅의 이어서 채팅하기는 모바일 2.6.1, 데스크톱 0.9.1, 플러그인 4.11.1 이상이 필요합니다.
내 키를 쓰면 무엇이 좋나요?
- 집에 있는 다른 컴퓨터를 거치지 않습니다. 키가 없으면 Cloud AI가 못 하는 AI 작업은 데스크톱 실행 환경에서 돌아갑니다. 요청은 집 컴퓨터의 Obsidian 플러그인, 데스크톱 앱, CLI 중 하나가 가져갈 때까지 기다려야 하므로, 그 컴퓨터가 켜져 있고 잠들지 않았고 AI CLI에 로그인돼 있어야 합니다. 내 키가 있으면 지금 쓰는 폰이나 컴퓨터가 직접 요청을 보냅니다. 어디에 있든, 다른 컴퓨터가 모두 꺼져 있어도 답이 몇 초 만에 흘러나옵니다.
- Cloud 크레딧을 쓰지 않습니다. 제공업체가 내 계정에 청구하며, 보통 요청 하나에 1센트도 안 되거나 몇 센트 수준입니다. Social Archiver Cloud 크레딧은 쓰이지 않습니다.
- 최신 모델과 더 많은 기능. 채팅과 리서치가 제공업체의 최신 모델로 돌아가고, 질문 하나에만 웹 검색을 켜서 출처와 함께 답을 받을 수 있습니다.
- 키가 저희에게 오지 않습니다. 키는 기기의 안전한 저장소(iPhone과 Mac의 키체인, Android Keystore, Obsidian 비밀 저장소)에 보관되고, 요청은 Social Archiver 서버를 거치지 않습니다.
키는 선택 사항입니다
Cloud AI는 요약, 용어집, 번역, 채팅(답변당 0.5 크레딧)을 계속 지원하고, 데스크톱 실행 환경은 AI CLI 구독으로 모든 작업을 처리합니다. AI 댓글을 참고하세요.
지원하는 제공업체
| 제공업체 | 키 발급 | 알아 둘 점 |
|---|---|---|
| OpenAI | platform.openai.com/api-keys | 저장한 댓글에는 OpenAI API로 표시됩니다. |
| Anthropic (Claude) | console.anthropic.com/settings/keys | Anthropic API로 표시됩니다. |
| Google Gemini | aistudio.google.com/app/apikey | 무료 등급에서는 Google이 보낸 내용을 서비스 개선에 쓰고 사람이 검토할 수 있습니다. EEA, 영국, 스위스에서는 유료 등급이 필요합니다. |
| OpenRouter | openrouter.ai/keys | 키 하나로 여러 제공업체의 모델을 씁니다. |
키 추가하기
| 앱 | 위치 |
|---|---|
| 모바일 (iOS, Android) | 설정 → AI API 키 |
| 데스크톱 앱 | 설정 → AI API 키 |
| Obsidian 플러그인 | 설정 → Social Archiver → AI API 키 (안전한 비밀 저장소 때문에 Obsidian 1.11.4 이상 필요) |
키를 붙여넣으면 앱이 제공업체에 확인합니다. 제공업체마다 추천 모델을 그대로 쓰거나 다른 모델을 고를 수 있습니다.
키를 처음 쓸 때는 그 제공업체로 무엇이 전송되는지 보여 주고 동의를 받습니다. 키는 기기마다 따로이며 동기화되지 않으니, 쓰려는 폰과 컴퓨터마다 추가하세요.
할 수 있는 일
게시물에 대해 채팅하기
| 앱 | 여는 방법 |
|---|---|
| 모바일 | 타임라인 카드나 리더에서 ⋯ → 이 게시물로 채팅 |
| 데스크톱 앱 | 카드의 채팅 버튼(이 게시물에 대해 채팅), 또는 리더 오른쪽 위 버튼. 채팅이 본문 옆에 붙어서 열립니다. |
| Obsidian 플러그인 | 카드 메뉴 → 이 글에 대해 채팅. 리더 모드에서는 채팅이 본문 옆에 붙어서 열립니다. |
태블릿과 폴더블에서는 모바일 앱도 채팅을 본문 옆에 엽니다.
- 채팅은 앱이 켜져 있는 동안 그 글에 남습니다. 닫고 본문을 읽다가 다시 열면 이어서 할 수 있습니다.
- 노트에 저장하면 대화가 그 글에 남습니다.
- 저장한 채팅 이어가기: 그 글에서 채팅을 다시 열면 가장 최근에 저장한 채팅부터 이어집니다. 예전 채팅을 이어가려면 모바일에서는 길게 누르고 이어서 채팅하기를 고르고, 데스크톱 앱과 플러그인에서는 저장한 채팅 아래 이어서 채팅하기 버튼을 누르세요(모바일 2.6.1, 데스크톱 0.9.1, 플러그인 4.11.1 이상). 다시 저장하면 저장해 둔 채팅이 바뀝니다.
- 새 채팅은 처음부터 시작합니다. 저장하지 않은 내용이 있을 때만 먼저 묻습니다.
게시물 리서치하기
이 게시물 리서치는 배경, 주장 검증, 출처를 담은 보고서를 써서 노트에 저장합니다. 리서치는 항상 웹을 검색합니다. 모바일에서는 내 데스크톱에 요청을 골라 데스크톱 실행 환경에 맡길 수도 있습니다.
AI 댓글
AI 댓글 시트에서 실행 대상으로 내 키를 고르세요(모바일에서는 내 API 키). 팩트체크는 항상 웹을 검색하고, 사용자 지정 프롬프트는 웹 검색을 켰을 때만 검색합니다.
선택한 문단 묻기
모바일 앱이나 데스크톱 앱의 리더에서 문단을 선택하고 AI에게 묻기를 누른 다음 내 키를 고르세요.
노트에서 AI 멘션하기
모바일 2.6.1, 데스크톱 앱 0.9.1, Obsidian 플러그인 4.11.1 이상에서 쓸 수 있습니다.
노트에 @를 입력하면 멘션할 수 있는 AI가 보입니다. 내 키가 있는 @Claude, @GPT, @Gemini, @OpenRouter와, 로그인했다면 @CloudAI입니다. 멘션은 강조색으로 표시됩니다. 노트를 저장하면 멘션한 AI가 게시물을 읽고 노트 아래에 답글을 답니다. 답하는 동안에는 노트 아래에 답하는 중이라고 표시됩니다.
- 답글은 첫 질문이 내 노트인 저장한 채팅이라, 다른 채팅처럼 이어갈 수 있습니다(모바일은 길게 누르기, 데스크톱과 플러그인은 이어서 채팅하기).
- 한 번 저장할 때 최대 세 AI에게 묻습니다. 노트를 고치면 새로 추가한 AI에게만 묻고, 멘션만 있는 노트는 아무에게도 묻지 않습니다.
- 멘션은 내 노트에서만 동작하고 컬렉션 노트에서는 동작하지 않습니다. Obsidian 플러그인에서는 My Note에서 멘션하세요.
- 이미지에서 읽은 텍스트(OCR 노트)는 멘션으로 처리하지 않습니다.
웹 검색은 요청할 때만
채팅과 AI 댓글은 직접 켜지 않으면 웹을 검색하지 않습니다. 켤 때도 요청 하나에만 적용됩니다.
- 모바일: 질문 입력창 옆의 웹 검색 토글
- 데스크톱 앱: 질문 입력창 안의 웹 검색 칩
- Obsidian 플러그인: 다음 질문에 웹 검색 사용
처음에는 꺼져 있고, 보낸 뒤에는 다시 꺼집니다. 답에는 참고한 출처가 붙습니다. 웹 검색은 제공업체 계정에 추가 비용이 들 수 있고, 검색을 못 하는 모델도 있습니다(토글에 표시됩니다). Cloud AI는 웹을 검색하지 않습니다.
AI가 읽는 것
AI는 게시물을 텍스트로 읽습니다. 제목, 작성자, 본문, 영상의 전사, 보관한 댓글 요약, 그리고 이미지에서 읽은 텍스트(사진 텍스트 포함으로 저장한 OCR 노트)입니다. 이미지 자체는 보지 않습니다.
비용
제공업체가 요청마다 내 계정에 청구합니다. 채팅 답변이나 멘션 답글은 요청 하나이고, 리서치는 웹을 검색하고 긴 보고서를 쓰므로 더 많이 듭니다. 내 키로 하는 요청에 Social Archiver는 요금을 받지 않습니다.
모델이 종료되면
제공업체는 모델을 자주 종료합니다. 고른 모델이 없어지면 앱이 제공업체가 추천하는 대체 모델로 바꾸고 알려 줍니다(예: "OpenAI에서 gpt-5-mini 모델을 종료해 이제 … 모델을 사용해요"). 언제든 AI API 키에서 다른 모델을 고를 수 있습니다.
제한
- CLI는 키를 보관하지 않습니다. 내 키로 하는 작업은 데스크톱 앱, Obsidian 플러그인, 모바일 앱에서 돌아갑니다.
- 데스크톱에 맡긴 작업(내 데스크톱에 요청)은 그 컴퓨터의 AI CLI로 돌아가며 웹을 검색하지 않습니다.
- 채팅 질문은 최대 2,000자입니다. 더 긴 노트는 줄여서 멘션 질문으로 보냅니다.
문제 해결
"…이(가) API 키를 거부했습니다"
제공업체가 키를 받아들이지 않았습니다. AI API 키에서 키를 확인하거나 바꾸고, 제공업체 쪽 결제 설정도 확인하세요.
"이 작업에 맞는 … 모델이 없습니다"
AI API 키에서 그 제공업체의 모델을 고르세요.
요청 한도나 할당량 오류
제공업체에서 오는 오류입니다. 잠시 기다리거나 제공업체 콘솔에서 한도를 올리세요.