NOAH’S GUIDE · LEARN BY DOING
거래소 API와 AI API, 역할이 다릅니다
기관 연결용 키와 AI 설명용 키를 구분하고, 공식 발급 화면에서 연결 점검·작업별 모델 저장까지 따라갑니다.
왜 키가 두 종류인가요?
| 종류 | 하는 일 | 앱에서 설정할 곳 |
|---|---|---|
| 거래소·증권사 API | 시세·잔고 조회와 허용된 주문 연계. PAPER/LIVE 권한은 별도입니다. | 설정 → 거래소 API / 거래소·증권사 선택 |
| 생성형 AI API | 질문 설명·심층분석·전략 자료 해석. 거래소 계정 권한을 주지 않습니다. | 설정 → AI 엔진/API |
거래소·증권사 연결 순서
- 사용할 기관의 공식 사이트에 로그인해 API 관리 또는 Open API 신청 메뉴를 엽니다. 본인 인증과 해당 기관의 API 승인을 완료합니다.
- 처음에는 필요한 조회 권한부터 확인합니다. 실주문 기능을 쓸 때만 필요한 주문 권한을 추가하고 출금 권한은 부여하지 않습니다.
- IP 제한이 필요한 기관은 앱이 실행되는 PC의 현재 공인 IP를 등록합니다. 네트워크가 바뀌면 기관의 허용 IP도 재확인합니다.
- PC 앱 설정 → 거래소 API에 해당 기관의 Key·Secret·Passphrase 등 요구 항목을 입력합니다. 키 이름과 실제 키 값을 혼동하지 마세요.
- 설정 저장과 연결 점검 후 PAPER로 시작합니다. 증권은 모의/실전 계좌, 계좌번호·상품코드, API 허용 환경을 공식 문서와 맞춥니다.
기관의 메뉴·권한 정책은 변경될 수 있습니다. 비밀키는 문의글·메신저·스크린샷에 넣지 마세요.
생성형 AI 키는 한 제공사부터
- 아래 공식 콘솔에서 API 계정을 만들고 결제·쿼터·이용 가능 모델을 확인합니다. 일반 채팅 서비스 구독과 API 사용권은 별개일 수 있습니다.
- API 키를 발급하고 제공사 예산·사용량 알림을 설정합니다. 무료 제공량을 고정된 권리로 가정하지 않습니다.
- 앱 설정 → AI 엔진/API에서 제공사를 선택하고 키를 입력해 저장합니다. 연결 점검으로 해당 계정의 접근 가능 모델을 확인합니다.
- 나만의 AI 구성 · 작업별 모델에서 빠른 판단, 일반 분석, 정밀·전략, 어시스턴트에 사용할 확인된 모델을 선택합니다. 현재 설정 저장 후 실제 작업에 적용됩니다.
- 비민감한 짧은 질문으로 한 번 확인하고 요청 모델·실제 응답 모델·토큰과 비용 기록을 읽습니다. 실제 청구는 제공사 Usage가 기준입니다.
제공사별 발급 화면에서 할 일
각 제공사의 공식 콘솔을 열어 아래 순서를 따릅니다. 메뉴 이름이 달라졌으면 공식 시작 안내를 확인하세요. 발급한 키는 브라우저에서 이 사이트로 보내지 않습니다.
| 제공사 | 키 발급·준비 | 앱 연결 후 확인 |
|---|---|---|
| OpenAI | Platform 로그인 → 사용할 Project → API Keys → 새 Secret Key 생성. API 결제·프로젝트 예산 확인. | OpenAI를 선택해 저장·점검. ChatGPT 구독만으로 API 결제를 확인한 것으로 취급하지 않음. |
| Anthropic Claude | Claude Console 로그인 → API Keys → 새 키 생성. API 사용량·크레딧과 Workspace 조건 확인. | Anthropic을 선택해 저장·점검. Claude 앱/Code 구독용 인증과 혼용하지 않음. |
| Google Gemini | Google AI Studio → API Keys → 프로젝트 선택·키 생성. 모델별 이용 조건·쿼터·결제 확인. | Gemini를 선택해 저장·점검. 연결 성공 모델 중 필요한 입력 기능을 확인. |
| DeepSeek | Platform 로그인 → API Keys → 새 키 생성. API 잔액과 사용량 확인. | DeepSeek를 선택해 저장·점검. 실제 호출 가능한 모델을 사용. |
| Kimi | Kimi API Platform 로그인 → Console의 API Keys → 새 키 생성. API 사용량·결제 확인. | Kimi를 선택해 저장·점검. Kimi Membership/Code와 Open Platform 키·청구를 구분. |
빠른 판단용 모델을 왜 따로 고르나요?
짧은 질문의 종류를 구분하거나 정해진 선택지에서 다음 작업을 고르는 데 매번 가장 큰 모델을 호출하면 시간과 비용이 늘 수 있습니다. 빠른 역할에는 계정에서 확인된 경량 모델을, 복잡한 전략 검토에는 적합한 분석 모델을 배치할 수 있습니다.
JEV 같은 별도 결정 엔진을 반드시 설치해야 하는 설정이 아닙니다. NoahAI가 지원하고 실제 연결 점검을 통과한 제공사·모델을 사용하는 역할 배치입니다. 전용 결정 모델과 같은 속도·정확도라는 뜻은 아닙니다.
모델 선택은 설정 → AI 엔진/API에서 합니다. 키 없는 모델을 선택할 수 있다는 안내나 생활금융 화면의 별도 모델 설정은 사용 절차가 아닙니다. 빠른 분류가 거래 권한·수익성·손실 제한을 대신 결정하지 않습니다.
연결 실패를 먼저 분류하세요
| 보이는 현상 | 확인할 것 |
|---|---|
| 401·인증 오류 | 키 값·Secret·Passphrase·만료·해당 제공사를 확인. 키를 재발급했다면 앱의 저장값도 변경. |
| 403·권한 또는 IP 오류 | 허용 IP, API 권한, 계정·지역·회원 조건 확인. 거래 권한을 늘리기 전에 실패 항목부터 확인. |
| 429·호출 제한 | 앱의 로컬 비용 한도인지 제공사 rate limit·쿼터·결제 문제인지 구분. |
| 모델 접근 실패 | 앱에 등록된 이름뿐 아니라 내 API 계정에서 해당 모델을 실제 호출할 수 있는지 점검. |