docs(ko): sync Korean docs with English manual restructure (#2296)
This commit is contained in:
mullung
@@ -3,3 +3,11 @@ title: 디자인 가이드라인
|
||||
description: Project AIRI에 디자인으로 기여하는 방법
|
||||
---
|
||||
|
||||
::: warning 작업 진행 중
|
||||
이 섹션은 아직 작성 중입니다.
|
||||
:::
|
||||
|
||||
자세한 내용은 사이드바의 페이지를 참고하세요:
|
||||
|
||||
- [리소스](./resources)
|
||||
- [도구](./tools)
|
||||
|
||||
@@ -0,0 +1,142 @@
|
||||
---
|
||||
title: 데스크톱 개발자 도구
|
||||
description: 데스크톱 버전의 설정 → 시스템 → 개발자 아래에 있는 진단·검증 도구 사용법을 안내합니다.
|
||||
---
|
||||
|
||||
데스크톱 버전의 **시스템 → 개발자** 페이지에는 개발, 문제 해결, 실험적 기능 검증을 위한 도구가 모여 있습니다. 이 도구들은 일상적인 채팅이나 캐릭터 상호작용을 개선하지 않습니다. 설치 후에 따로 설정할 필요도 없습니다. 문제를 재현하거나, 기능을 개발하거나, 메인테이너에게 전달할 진단 정보를 수집할 때만 사용하세요.
|
||||
|
||||
이 페이지는 데스크톱 앱만 다룹니다. 웹 앱에도 개발 페이지가 있지만, 사용 가능한 기능과 런타임 환경이 다릅니다.
|
||||
|
||||
::: warning 무엇을 테스트하는지 알고 사용하세요
|
||||
일부 도구는 화면을 캡처하거나, 마이크를 사용하거나, 전역 단축키를 등록하거나, 추가 창을 열거나, 가공되지 않은 네트워크·플러그인 데이터를 표시합니다. 테스트가 끝나면 캡처 스트림을 중지하고 사용하지 않는 창을 닫으세요. API Key, 대화 내용, 화면 내용, WebSocket 데이터가 포함된 스크린샷을 공개적으로 공유하지 마세요.
|
||||
:::
|
||||
|
||||
## 페이지 열기와 도구 선택
|
||||
|
||||
데스크톱 앱에서 **설정 → 시스템 → 개발자**를 여세요. 상단에는 빠른 작업과 렌더링 스위치가, 그 아래에는 개별 진단 페이지로 가는 링크가 표시됩니다.
|
||||
|
||||
조사하려는 대상에 따라 도구를 선택하세요:
|
||||
|
||||
| 확인하려는 것 | 시작할 도구 |
|
||||
| --- | --- |
|
||||
| 페이지 오류, 요소 스타일, 네트워크 요청 | Open Developer Tools |
|
||||
| Three.js 또는 VRM 렌더링 진단 | Lag Visualizer |
|
||||
| 깨진 전환 애니메이션 | 애니메이션 스위치 |
|
||||
| 키보드, 마우스, 디스플레이, 전역 단축키 동작 | useMagicKeys, 마우스/디스플레이 도구, Global Shortcut |
|
||||
| 채팅 컨텍스트, WebSocket, 실시간 전사 | Context Flow, WebSocket Inspector, Aliyun Real-time Transcriber |
|
||||
| 플러그인 발견, 로드, 언로드 | Plugin Host Debug |
|
||||
| 실패한 업데이트나 예상치 못한 업데이트 소스 | Updater |
|
||||
| 화면 공유, 비전 입력, 캡처 권한 | Screen Capture 또는 Vision Capture |
|
||||
|
||||
## 빠른 작업과 렌더링 진단
|
||||
|
||||
### Open Developer Tools
|
||||
|
||||
**Open**을 선택하면 Electron에 내장된 브라우저 개발자 도구가 실행됩니다. 콘솔 오류, 네트워크 요청, DOM, 성능 기록을 확인할 때 사용하세요. 인터페이스 문제를 조사할 때 보통 가장 좋은 출발점입니다.
|
||||
|
||||
재현 가능한 문제라면 콘솔을 비우고 동작을 한 번만 반복한 뒤 관련된 오류만 저장하세요. 이슈나 풀 리퀘스트에 진단 정보를 첨부하기 전에 민감한 정보를 제거하세요.
|
||||
|
||||
### Markdown Stress
|
||||
|
||||
이 도구는 대량의 Markdown을 별도 창에 렌더링하여 긴 문단, 코드 블록, 표, 스크롤, 테마 스타일을 테스트합니다. 문서나 대화를 수정하지 않습니다.
|
||||
|
||||
### IO Tracer
|
||||
|
||||
IO Tracer는 상호작용 턴의 타이밍 구간을 ASR, LLM, Streaming Control, TTS, Playback 단계별로 보여줍니다. 음성·채팅 파이프라인에서 지연이나 누락된 단계를 찾을 때 사용하세요. 트레이스 데이터에는 문맥 정보가 포함될 수 있으므로 필요할 때만 열고, 전체 트레이스를 공유하는 일은 피하세요.
|
||||
|
||||
### Lag Visualizer
|
||||
|
||||
Lag Visualizer는 Stage Three 런타임을 추적합니다. 창 수명 주기, Three.js 렌더링 횟수와 리소스, VRM 프레임 업데이트 타이밍, fade-on-hover 히트 테스트, VRM 로드·해제 타이밍, 렌더러/리소스 스냅숏을 보고합니다. Three.js나 VRM 렌더링 문제에 사용하세요. 일반적인 페이지 전환, 롱 태스크, FPS 프로파일러는 아닙니다.
|
||||
|
||||
### 스테이지·페이지 전환 애니메이션
|
||||
|
||||
**Disable Stage Transitions**는 스테이지를 전환할 때 사용하는 전체 애니메이션을 제거합니다. 테스트 중에 스테이지 전환을 변수에서 제외하려면 켜세요. **Use Page Specific Transitions**는 각 페이지의 고유 전환을 제어하며, **Disable Stage Transitions**가 켜져 있는 동안에는 사용할 수 없습니다.
|
||||
|
||||
화면 깜빡임, 언로드되지 않는 페이지, 느린 전환을 조사할 때는 각 상태를 따로 테스트하세요. 테스트가 끝나면 원래 설정으로 되돌리세요.
|
||||
|
||||
## 키보드, 마우스, 디스플레이
|
||||
|
||||
### useMagicKeys
|
||||
|
||||
이 페이지는 키보드 단축키와 보조 키 상태를 표시하여 앱이 키 이벤트를 올바르게 받는지 확인할 수 있게 합니다. 일반 사용자용 설정은 없습니다. AIRI의 Spotlight 단축키를 변경하려면 대신 **설정 → 시스템 → 창 단축키**를 사용하세요.
|
||||
|
||||
### useElectronWindowMouse, Displays, Relative Mouse
|
||||
|
||||
이 도구들은 서로 다른 좌표계에서 포인터 위치를 표시합니다:
|
||||
|
||||
- **useElectronWindowMouse**는 모든 디스플레이가 이루는 데스크톱 좌표 공간에서 포인터를 표시합니다.
|
||||
- **Displays**는 연결된 디스플레이와 포인터의 현재 위치를 표시합니다. 다중 디스플레이, 배율, 외장 모니터 문제에 사용하세요.
|
||||
- **Relative Mouse**는 AIRI 창을 기준으로 한 포인터 위치를 표시합니다. 창 내부의 히트 영역과 드래그를 테스트할 때 사용하세요.
|
||||
|
||||
창 따라가기, 클릭 오프셋, 다중 디스플레이 위치 문제를 보고할 때는 디스플레이 배치, 배율, 주 디스플레이, 재현 단계를 함께 적어 주세요.
|
||||
|
||||
### Widgets Calling
|
||||
|
||||
Widgets Calling은 오버레이 위젯을 생성하고 위젯에 전달되는 컴포넌트 props의 유효성을 검사합니다. 데스크톱 오버레이와 컴포넌트 호출 개발을 위한 도구이며, 일반적인 AIRI 사용에는 필요하지 않습니다.
|
||||
|
||||
### Beat Sync Visualizer
|
||||
|
||||
Beat Sync Visualizer는 비트에 동기화된 V-motion 목표, 경로, Y/Z 스칼라 변화를 그래프로 표시합니다. **Hit beat**나 **Hit V sequence**로 테스트 비트를 주입하고 그 결과 모션을 살펴보세요. 이 페이지에는 오디오 입력이나 자동 비트 감지 경로가 없습니다.
|
||||
|
||||
## 채팅, 실시간 서비스, 네트워킹
|
||||
|
||||
### Context Flow
|
||||
|
||||
Context Flow는 채팅 파이프라인으로 들어오는 컨텍스트 업데이트와 서비스로 전송되는 채팅 스트림 이벤트를 보여줍니다. 플러그인, VS Code 등 외부 소스의 컨텍스트가 AIRI에 도달하는지 확인할 때 유용합니다.
|
||||
|
||||
먼저 도구를 열고 가장 작은 재현을 수행한 다음, 입력 컨텍스트와 출력 이벤트를 시간순으로 비교하세요. 컨텍스트에는 파일명, 대화 내용, 그 밖의 사적인 정보가 포함될 수 있으므로 로그를 공유하기 전에 민감한 부분을 지우세요.
|
||||
|
||||
### WebSocket Inspector
|
||||
|
||||
WebSocket Inspector는 가공되지 않은 WebSocket 트래픽을 표시합니다. 연결 실패, 누락된 이벤트, 예상과 다른 형식의 메시지를 조사할 때 사용하세요. 문제와 관련된 몇 개의 프레임만 공유하고, 토큰, 사용자 콘텐츠, 주소 정보는 제거하세요.
|
||||
|
||||
### Aliyun Real-time Transcriber
|
||||
|
||||
이 페이지는 시스템 기본 마이크의 오디오를 Alibaba Cloud NLS로 전송하고 도착하는 대로 전사 결과를 표시합니다. 실시간 음성 인식 경로, 즉 기본 마이크 입력, 자격 증명, 네트워크 연결, 전사 출력을 검증합니다. 페이지에 입력 장치 선택기가 없으므로, 열기 전에 운영 체제에서 원하는 기본 마이크를 선택하세요. 녹음이 허용된 곳에서만 녹음하세요.
|
||||
|
||||
## 플러그인, 업데이트, 시스템 기능
|
||||
|
||||
### Plugin Host Debug
|
||||
|
||||
Plugin Host Debug는 플러그인이 발견·활성화·로드되었는지 보여주고, 개발자가 로드와 언로드 수명 주기를 제어할 수 있게 합니다. 동작하지 않는 플러그인이 있다면 발견 여부, 활성화 상태, 로드 오류, 언로드 후 이벤트나 인터페이스 상태가 남아 있는지 확인하세요.
|
||||
|
||||
무언가를 바꾸기 전에 현재 상태와 오류를 기록하세요. 최소 재현 없이 플러그인을 반복해서 로드·언로드하면 원래 문제를 진단하기가 더 어려워질 수 있습니다.
|
||||
|
||||
### Updater
|
||||
|
||||
Updater는 현재 버전, 플랫폼, 아키텍처, 업데이트 채널, 업데이트 소스, 로그 위치, 업데이트 상태를 표시합니다. 업데이트를 수동으로 확인·다운로드·설치할 수도 있습니다. 실패한 업데이트, 예상치 못한 업데이트 소스, 플랫폼별 설치 문제를 조사할 때 사용하세요.
|
||||
|
||||
일상적인 업데이트에는 **About** 창을 사용하는 편이 좋습니다. 업데이트 소스를 이해하고 신뢰할 수 있는 경우가 아니라면 재정의하지 마세요.
|
||||
|
||||
## 화면·비전 캡처
|
||||
|
||||
### Screen Capture
|
||||
|
||||
Screen Capture는 애플리케이션 창이나 디스플레이 전체를 캡처하여 비디오 또는 오디오 스트림을 만들 수 있습니다. 주로 화면 공유와 캡처 동작을 테스트하는 페이지입니다.
|
||||
|
||||
처음 사용할 때 운영 체제가 화면 녹화 권한을 요청할 수 있습니다. macOS에서 AIRI가 목록에 없다면 **System Settings → Privacy & Security → Screen & System Audio Recording**에서 활성화하거나 추가한 뒤 AIRI를 재시작하고 다시 시도하세요. Windows와 Linux의 권한 프롬프트는 운영 체제, 데스크톱 환경, Electron 버전에 따라 다릅니다.
|
||||
|
||||
도구에서 **Applications**는 애플리케이션 창을, **Displays**는 화면 전체를 나열합니다. 현재 구현은 **Devices** 탭에 외부 소스를 제공하지 않으므로 이 탭은 비어 있습니다. 디스플레이를 연결·해제하거나, 창을 열거나, 권한을 변경한 뒤에는 **Refetch**를 사용하세요. 중지한 뒤에는 미리보기가 닫혔는지 확인하여 스트림이 더 이상 시스템 리소스나 권한을 사용하지 않게 하세요.
|
||||
|
||||
### Vision Capture
|
||||
|
||||
Vision Capture는 화면 프레임을 캡처하고 비전 파이프라인을 통해 전송되는 페이로드를 보여줍니다. 비전 입력이 올바르게 캡처되어 다운스트림 기능에 도달하는지 확인할 때 사용하세요. 진단용 워크플로이며, 비전 제공자를 설정한 뒤 계속 켜 두어야 하는 전역 스위치가 아닙니다.
|
||||
|
||||
화면 비전을 테스트하려면:
|
||||
|
||||
1. **설정 → 제공자 → 비전**에서 비전 제공자의 자격 증명을 설정하세요.
|
||||
2. **설정 → 모듈 → 비전**을 열고 설정한 제공자와 이미지 처리가 가능한 모델을 선택하세요.
|
||||
3. **설정 → 시스템 → 개발자 → Vision Capture**를 열고 운영 체제의 화면 녹화 권한을 허용하세요.
|
||||
4. 창이나 디스플레이를 선택한 뒤 **Start ticker**를 선택하여 프레임 캡처와 분석을 시작하세요.
|
||||
5. 인식 결과를 AIRI의 대화 컨텍스트에 추가하고 싶을 때만 **Publish to character**를 활성화하세요.
|
||||
6. 끝나면 **Stop ticker**를 선택하세요. 페이지를 벗어나도 캡처 루프가 중지됩니다.
|
||||
|
||||
페이지가 권한 프롬프트에서 멈춰 있다면 운영 체제에서 권한을 허용하고, AIRI를 완전히 종료했다가 재시작한 뒤 도구를 다시 여세요. 개인 데스크톱, 알림, 다른 애플리케이션의 콘텐츠가 보이는 캡처는 절대 공개하지 마세요.
|
||||
|
||||
## 전역 단축키
|
||||
|
||||
### Global Shortcut
|
||||
|
||||
Global Shortcut은 시스템 전역 단축키 이벤트를 등록·해제·관찰합니다. **설정 → 시스템 → 창 단축키**에서 일상용으로 설정하는 Spotlight 단축키와는 다르며, 이 페이지는 개발과 검증을 위해 존재합니다.
|
||||
|
||||
운영 체제나 다른 애플리케이션과 충돌하지 않는 키 조합을 선택하세요. 등록에 실패하면 해당 조합이 이미 사용 중인지 확인하세요. 테스트가 끝나면 단축키가 계속 키 입력을 가로채지 않도록 등록을 해제하세요.
|
||||
@@ -1,20 +1,27 @@
|
||||
---
|
||||
title: 문서 사이트
|
||||
description: Project AIRI에 기여하기
|
||||
title: 문서 사이트 개발
|
||||
description: VitePress 문서를 로컬에서 작성하고, 미리 보고, 검증하기
|
||||
---
|
||||
|
||||
### 문서 사이트
|
||||
문서 사이트는 `docs`에 있으며, 콘텐츠는 로케일별로 `docs/content/<locale>` 아래에 정리되어 있습니다. 저장소 루트에서 다음을 실행하세요:
|
||||
|
||||
```shell
|
||||
pnpm dev:docs
|
||||
```
|
||||
|
||||
::: tip
|
||||
문서 사이트만 검증하려면 다음을 실행하세요:
|
||||
|
||||
[@antfu/ni](https://github.com/antfu-collective/ni) 사용자라면 이렇게 쓸 수 있습니다
|
||||
```shell
|
||||
pnpm -F @proj-airi/docs typecheck
|
||||
pnpm -F @proj-airi/docs build
|
||||
```
|
||||
|
||||
영어 페이지를 추가할 때는 `docs/.vitepress/config.ts`의 `en` 사이드바에도 추가하세요. 그렇지 않으면 페이지가 URL로는 접근할 수 있지만 내비게이션에는 나타나지 않습니다.
|
||||
|
||||
::: tip
|
||||
[@antfu/ni](https://github.com/antfu-collective/ni)를 사용한다면 다음을 실행하세요:
|
||||
|
||||
```shell
|
||||
nr dev:docs
|
||||
```
|
||||
|
||||
:::
|
||||
|
||||
@@ -1,50 +1,37 @@
|
||||
---
|
||||
title: 기여하기
|
||||
description: Project AIRI에 기여하기
|
||||
title: 개발 환경 설정과 첫 기여
|
||||
description: Project AIRI를 로컬에서 실행하고 첫 Pull Request 제출하기
|
||||
---
|
||||
|
||||
안녕하세요! 이 프로젝트에 기여하는 데 관심을 가져 주셔서 감사합니다. 이 가이드가 첫걸음을 도와드릴 거예요.
|
||||
안녕하세요! Project AIRI에 기여하는 데 관심을 가져 주셔서 감사합니다. 이 가이드는 로컬 개발 환경을 설정하고, 브랜치를 만들고, 첫 Pull Request를 제출하는 방법을 설명합니다.
|
||||
|
||||
::: info 적용 범위
|
||||
이 섹션은 소스 코드, 문서, 디자인 리소스를 변경하려는 컨트리뷰터를 위한 내용입니다. AIRI를 사용하기만 하려면 사용자 매뉴얼부터 시작하세요. 앱에 내장된 디버깅 도구는 [개발자 도구](./desktop-developer-tools)를 참고하세요.
|
||||
:::
|
||||
|
||||
## 사전 준비물
|
||||
|
||||
- [Git](https://git-scm.com/downloads)
|
||||
- [Node.js 23+](https://nodejs.org/en/download/)
|
||||
- [corepack](https://github.com/nodejs/corepack)
|
||||
- [pnpm](https://pnpm.io/installation)
|
||||
- [mise](https://mise.jdx.dev/installing-mise.html) 또는 `.tool-versions`를 읽는 다른 버전 관리자
|
||||
- [Corepack](https://github.com/nodejs/corepack) — 최신 Node.js 릴리스에 포함되어 있습니다
|
||||
|
||||
이 저장소는 [`.tool-versions`](https://github.com/moeru-ai/airi/blob/main/.tool-versions)에 Node.js 버전을 고정해 둡니다(현재 24.13.0). 시스템 패키지 매니저가 제공하는 버전에 의존하지 말고, 클론한 뒤 고정된 버전을 설치하세요.
|
||||
|
||||
<details>
|
||||
<summary>Windows 설정</summary>
|
||||
|
||||
0. [Visual Studio](https://visualstudio.microsoft.com/downloads/) 를 내려받고 다음 안내를 따르세요: https://rust-lang.github.io/rustup/installation/windows-msvc.html#walkthrough-installing-visual-studio-2022
|
||||
|
||||
> Visual Studio를 설치할 때 Windows SDK와 C++ 빌드 도구를 반드시 함께 설치하세요.
|
||||
|
||||
1. PowerShell을 엽니다
|
||||
2. [`scoop`](https://scoop.sh/) 을 설치합니다
|
||||
1. PowerShell을 여세요.
|
||||
2. [`scoop`](https://scoop.sh/)을 설치하세요.
|
||||
|
||||
```powershell
|
||||
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
|
||||
Invoke-RestMethod -Uri https://get.scoop.sh | Invoke-Expression
|
||||
```
|
||||
|
||||
3. `scoop`으로 `git`, Node.js, `rustup`, `msvc`를 설치합니다
|
||||
3. Scoop으로 Git과 mise를 설치하세요.
|
||||
|
||||
```powershell
|
||||
scoop install git nodejs rustup
|
||||
|
||||
# Rust 의존성용
|
||||
# crates나 apps/tamagotchi를 개발하지 않는다면 필요 없습니다
|
||||
scoop install main/rust-msvc
|
||||
# Rust & Windows 전용
|
||||
rustup toolchain install stable-x86_64-pc-windows-msvc
|
||||
rustup default stable-x86_64-pc-windows-msvc
|
||||
```
|
||||
|
||||
4. `corepack`으로 `pnpm`을 설치합니다
|
||||
|
||||
```powershell
|
||||
corepack enable
|
||||
corepack prepare pnpm@latest --activate
|
||||
scoop install git mise
|
||||
```
|
||||
|
||||
</details>
|
||||
@@ -52,18 +39,11 @@ description: Project AIRI에 기여하기
|
||||
<details>
|
||||
<summary>macOS 설정</summary>
|
||||
|
||||
0. 터미널(또는 iTerm2, Ghostty, Kitty 등)을 엽니다
|
||||
1. `brew`로 `git`과 `node`를 설치합니다
|
||||
1. 터미널, iTerm2, Ghostty, Kitty 등 원하는 터미널을 여세요.
|
||||
2. Homebrew로 Git과 mise를 설치하세요.
|
||||
|
||||
```shell
|
||||
brew install git node
|
||||
```
|
||||
|
||||
2. `corepack`으로 `pnpm`을 설치합니다
|
||||
|
||||
```shell
|
||||
corepack enable
|
||||
corepack prepare pnpm@latest --activate
|
||||
brew install git mise
|
||||
```
|
||||
|
||||
</details>
|
||||
@@ -71,55 +51,38 @@ description: Project AIRI에 기여하기
|
||||
<details>
|
||||
<summary>Linux 설정</summary>
|
||||
|
||||
0. 터미널을 엽니다
|
||||
1. [nodesource/distributions: NodeSource Node.js Binary Distributions](https://github.com/nodesource/distributions?tab=readme-ov-file#table-of-contents)를 따라 `node`를 설치합니다
|
||||
2. [Git](https://git-scm.com/downloads/linux) 안내를 따라 `git`을 설치합니다
|
||||
3. `corepack`으로 `pnpm`을 설치합니다
|
||||
|
||||
```shell
|
||||
corepack enable
|
||||
corepack prepare pnpm@latest --activate
|
||||
```
|
||||
4. 데스크톱 버전 개발을 돕고 싶다면 다음 의존성이 필요합니다:
|
||||
```shell
|
||||
sudo apt install \
|
||||
libssl-dev \
|
||||
libglib2.0-dev \
|
||||
libgtk-3-dev \
|
||||
libjavascriptcoregtk-4.1-dev \
|
||||
libwebkit2gtk-4.1-dev
|
||||
```
|
||||
1. 터미널을 여세요.
|
||||
2. [Linux용 Git 설치 안내](https://git-scm.com/downloads/linux)를 따르세요.
|
||||
3. [배포판에 맞는 패키지 또는 설치 방법](https://mise.jdx.dev/installing-mise.html)으로 mise를 설치하세요.
|
||||
|
||||
</details>
|
||||
|
||||
## 이전에 이미 이 프로젝트에 기여한 적이 있다면
|
||||
|
||||
::: warning
|
||||
|
||||
아직 이 저장소를 클론하지 않았다면 이 섹션은 건너뛰세요.
|
||||
## 이전에 기여한 적이 있다면
|
||||
|
||||
::: tip
|
||||
아직 저장소를 클론하지 않았다면 이 섹션은 건너뛰세요.
|
||||
:::
|
||||
|
||||
로컬 저장소가 업스트림 저장소와 최신 상태인지 확인하세요:
|
||||
업스트림 변경 사항을 가져와 로컬 `main` 브랜치를 리베이스하세요:
|
||||
|
||||
```shell
|
||||
git fetch --all
|
||||
git checkout main
|
||||
git switch main
|
||||
git pull upstream main --rebase
|
||||
```
|
||||
|
||||
작업 브랜치가 있다면, 그 브랜치를 업스트림 저장소 기준으로 최신화하려면:
|
||||
이미 작업 브랜치가 있다면 `main` 기준으로 최신화하세요:
|
||||
|
||||
```shell
|
||||
git checkout <your-branch-name>
|
||||
git switch <your-branch-name>
|
||||
git rebase main
|
||||
```
|
||||
|
||||
## 이 프로젝트를 포크하기
|
||||
|
||||
[moeru-ai/airi](https://github.com/moeru-ai/airi) 페이지 오른쪽 위의 **Fork** 버튼을 클릭하세요.
|
||||
[moeru-ai/airi](https://github.com/moeru-ai/airi) 저장소 페이지 오른쪽 위의 **Fork**를 클릭해 자신의 계정 아래에 복사본을 만드세요.
|
||||
|
||||
## 클론하기
|
||||
## 포크한 저장소 클론하기
|
||||
|
||||
```shell
|
||||
git clone https://github.com/<your-github-username>/airi.git
|
||||
@@ -129,94 +92,89 @@ cd airi
|
||||
## 작업 브랜치 만들기
|
||||
|
||||
```shell
|
||||
git checkout -b <your-branch-name>
|
||||
git switch -c <your-branch-name>
|
||||
```
|
||||
|
||||
## 의존성 설치
|
||||
|
||||
```shell
|
||||
corepack enable
|
||||
pnpm install
|
||||
저장소 루트에서 `.tool-versions`에 기록된 Node.js 버전을 설치하고, 버전을 확인하고, Corepack을 활성화한 뒤 의존성을 설치하세요:
|
||||
|
||||
# Rust 의존성용
|
||||
# crates 나 apps/tamagotchi 를 개발하지 않는다면 필요 없습니다
|
||||
cargo fetch
|
||||
```shell
|
||||
mise install
|
||||
mise exec -- node --version
|
||||
mise exec -- corepack enable
|
||||
mise exec -- pnpm install
|
||||
```
|
||||
|
||||
출력된 Node.js 버전이 `.tool-versions`와 일치해야 합니다. 이후 예시는 [셸에서 mise가 활성화되어 있다고](https://mise.jdx.dev/dev-tools/shims.html) 가정합니다. 그렇지 않다면 패키지 매니저 명령을 `mise exec --`를 통해 실행하세요(예: `mise exec -- pnpm typecheck`).
|
||||
|
||||
::: tip
|
||||
패키지 매니저 명령을 간단하게 쓰고 싶다면 [@antfu/ni](https://github.com/antfu-collective/ni)를 선택적으로 설치할 수 있습니다:
|
||||
|
||||
```shell
|
||||
mise exec -- npm install --global @antfu/ni
|
||||
```
|
||||
|
||||
설치하고 나면:
|
||||
|
||||
- `pnpm install`, `npm install`, `yarn install` 대신 `ni`를 사용하세요.
|
||||
- `pnpm run`, `npm run`, `yarn run` 대신 `nr`을 사용하세요.
|
||||
|
||||
`ni`는 저장소가 사용하는 패키지 매니저를 감지합니다.
|
||||
:::
|
||||
|
||||
## 변경 사항 커밋하기
|
||||
|
||||
### 커밋하기 전에 검증하기
|
||||
|
||||
코드가 lint와 타입 검사를 통과하는지 확인하세요:
|
||||
|
||||
```shell
|
||||
pnpm lint
|
||||
pnpm typecheck
|
||||
```
|
||||
|
||||
::: tip
|
||||
|
||||
스크립트를 더 간단히 쓰기 위해 [@antfu/ni](https://github.com/antfu-collective/ni) 설치를 권장합니다.
|
||||
|
||||
```shell
|
||||
corepack enable
|
||||
npm i -g @antfu/ni
|
||||
```
|
||||
|
||||
설치하고 나면
|
||||
|
||||
- `pnpm install`, `npm install`, `yarn install` 대신 `ni`를 쓸 수 있습니다.
|
||||
- `pnpm run`, `npm run`, `yarn run` 대신 `nr`을 쓸 수 있습니다.
|
||||
|
||||
패키지 매니저가 무엇인지 신경 쓸 필요가 없습니다. `ni`가 알맞은 것을 골라 줍니다.
|
||||
:::
|
||||
|
||||
## 개발하고 싶은 애플리케이션 고르기
|
||||
|
||||
## 커밋
|
||||
|
||||
### 커밋하기 전에
|
||||
|
||||
::: warning
|
||||
|
||||
lint(정적 검사기)와 TypeScript 컴파일러를 모두 통과했는지 확인해 주세요:
|
||||
|
||||
```shell
|
||||
pnpm lint && pnpm typecheck
|
||||
```
|
||||
|
||||
:::
|
||||
|
||||
::: tip
|
||||
|
||||
[@antfu/ni](https://github.com/antfu-collective/ni)를 설치했다면 `nr`로 명령을 실행할 수 있습니다:
|
||||
[@antfu/ni](https://github.com/antfu-collective/ni)를 설치했다면 다음을 실행하세요:
|
||||
|
||||
```shell
|
||||
nr lint && nr typecheck
|
||||
```
|
||||
|
||||
:::
|
||||
|
||||
### 커밋
|
||||
### 커밋 만들기
|
||||
|
||||
```shell
|
||||
git add .
|
||||
git add <changed-files>
|
||||
git commit -m "<your-commit-message>"
|
||||
```
|
||||
|
||||
### 포크한 저장소로 푸시
|
||||
### 브랜치 푸시하기
|
||||
|
||||
```shell
|
||||
git push origin <your-branch-name> -u
|
||||
git push -u origin <your-branch-name>
|
||||
```
|
||||
|
||||
포크한 저장소에서 해당 브랜치를 확인할 수 있습니다.
|
||||
이제 GitHub에서 해당 브랜치를 확인할 수 있습니다.
|
||||
|
||||
::: tip
|
||||
|
||||
이 프로젝트에 처음 기여하는 것이라면 업스트림 저장소도 추가해야 합니다:
|
||||
처음 기여하는 것이라면 Project AIRI 저장소를 `upstream` 원격으로 추가하세요:
|
||||
|
||||
```shell
|
||||
git remote add upstream https://github.com/moeru-ai/airi.git
|
||||
```
|
||||
|
||||
:::
|
||||
|
||||
## Pull Request 만들기
|
||||
|
||||
[moeru-ai/airi](https://github.com/moeru-ai/airi) 페이지로 이동해 **Pull requests** 탭을 클릭하고, **New pull request** 버튼을 누른 뒤 **Compare across forks** 링크를 클릭해 포크한 저장소를 선택하세요.
|
||||
[moeru-ai/airi](https://github.com/moeru-ai/airi) 저장소 페이지를 여세요:
|
||||
|
||||
변경 사항을 검토한 뒤 **Create pull request** 버튼을 클릭합니다.
|
||||
1. **Pull requests**를 클릭하세요.
|
||||
2. **New pull request**를 클릭하세요.
|
||||
3. **Compare across forks**를 클릭하세요.
|
||||
4. 포크한 저장소와 작업 브랜치를 선택하세요.
|
||||
5. 변경 사항을 검토한 뒤 **Create pull request**를 클릭하세요.
|
||||
|
||||
## 우와! 해내셨네요!
|
||||
## 해내셨습니다!
|
||||
|
||||
축하합니다! 이 프로젝트에 첫 기여를 하셨습니다. 이제 메인테이너가 여러분의 Pull Request를 리뷰할 때까지 기다리시면 됩니다.
|
||||
첫 기여를 제출하신 것을 축하합니다. 이제 프로젝트 메인테이너가 여러분의 Pull Request를 리뷰할 수 있습니다.
|
||||
|
||||
@@ -1,34 +0,0 @@
|
||||
---
|
||||
title: Discord 봇
|
||||
description: Project AIRI에 기여하기
|
||||
---
|
||||
|
||||
### Discord 봇 연동
|
||||
|
||||
```shell
|
||||
cd integrations/discord-bot
|
||||
```
|
||||
|
||||
`.env` 설정하기
|
||||
|
||||
```shell
|
||||
cp .env .env.local
|
||||
```
|
||||
|
||||
`.env.local`에서 인증 정보를 수정하세요.
|
||||
|
||||
봇 실행하기
|
||||
|
||||
```shell
|
||||
pnpm -F @proj-airi/discord-bot start
|
||||
```
|
||||
|
||||
::: tip
|
||||
|
||||
[@antfu/ni](https://github.com/antfu-collective/ni) 사용자라면 이렇게 쓸 수 있습니다
|
||||
|
||||
```shell
|
||||
nr -F @proj-airi/discord-bot dev
|
||||
```
|
||||
|
||||
:::
|
||||
@@ -1,36 +0,0 @@
|
||||
---
|
||||
title: Minecraft
|
||||
description: Project AIRI에 기여하기
|
||||
---
|
||||
|
||||
### Minecraft 에이전트
|
||||
|
||||
```shell
|
||||
cd integrations/minecraft
|
||||
```
|
||||
|
||||
Minecraft 클라이언트를 실행하고 원하는 포트로 월드를 개방한 뒤, 그 포트 번호를 `.env.local`에 입력하세요.
|
||||
|
||||
`.env` 설정하기
|
||||
|
||||
```shell
|
||||
cp .env .env.local
|
||||
```
|
||||
|
||||
`.env.local`에서 인증 정보를 수정하세요.
|
||||
|
||||
봇 실행하기
|
||||
|
||||
```shell
|
||||
pnpm -F @proj-airi/minecraft-bot start
|
||||
```
|
||||
|
||||
::: tip
|
||||
|
||||
[@antfu/ni](https://github.com/antfu-collective/ni) 사용자라면 이렇게 쓸 수 있습니다
|
||||
|
||||
```shell
|
||||
nr -F @proj-airi/minecraft-bot dev
|
||||
```
|
||||
|
||||
:::
|
||||
@@ -1,34 +0,0 @@
|
||||
---
|
||||
title: Satori 봇
|
||||
description: Project AIRI에 기여하기
|
||||
---
|
||||
|
||||
### Satori 봇
|
||||
|
||||
```shell
|
||||
cd integrations/satori-bot
|
||||
```
|
||||
|
||||
`.env` 파일 설정하기:
|
||||
|
||||
```shell
|
||||
cp .env .env.local
|
||||
```
|
||||
|
||||
`.env.local`에서 각종 키와 설정 정보를 수정하세요.
|
||||
|
||||
봇 시작하기:
|
||||
|
||||
```shell
|
||||
pnpm -F @proj-airi/satori-bot dev
|
||||
```
|
||||
|
||||
::: tip
|
||||
|
||||
[@antfu/ni](https://github.com/antfu-collective/ni)를 쓰신다면 이렇게 할 수 있습니다:
|
||||
|
||||
```shell
|
||||
nr -F @proj-airi/satori-bot dev
|
||||
```
|
||||
|
||||
:::
|
||||
@@ -1,44 +0,0 @@
|
||||
---
|
||||
title: Telegram 봇
|
||||
description: Project AIRI에 기여하기
|
||||
---
|
||||
|
||||
### Telegram 봇 연동
|
||||
|
||||
Postgres 데이터베이스가 필요합니다.
|
||||
|
||||
```shell
|
||||
cd integrations/telegram-bot
|
||||
docker compose up -d
|
||||
```
|
||||
|
||||
`.env` 설정하기
|
||||
|
||||
```shell
|
||||
cp .env .env.local
|
||||
```
|
||||
|
||||
`.env.local`에서 인증 정보를 수정하세요.
|
||||
|
||||
데이터베이스 마이그레이션
|
||||
|
||||
```shell
|
||||
pnpm -F @proj-airi/telegram-bot db:generate
|
||||
pnpm -F @proj-airi/telegram-bot db:push
|
||||
```
|
||||
|
||||
봇 실행하기
|
||||
|
||||
```shell
|
||||
pnpm -F @proj-airi/telegram-bot start
|
||||
```
|
||||
|
||||
::: tip
|
||||
|
||||
[@antfu/ni](https://github.com/antfu-collective/ni) 사용자라면 이렇게 쓸 수 있습니다
|
||||
|
||||
```shell
|
||||
nr -F @proj-airi/telegram-bot dev
|
||||
```
|
||||
|
||||
:::
|
||||
@@ -1,20 +1,29 @@
|
||||
---
|
||||
title: 데스크톱
|
||||
description: Project AIRI에 기여하기
|
||||
title: 데스크톱 개발
|
||||
description: Electron 데스크톱 앱 실행, 검사, 빌드
|
||||
---
|
||||
|
||||
### Stage Tamagotchi (데스크톱 버전)
|
||||
데스크톱 앱은 `apps/stage-tamagotchi`에 있습니다. 저장소 루트에서 다음을 실행하세요:
|
||||
|
||||
```shell
|
||||
pnpm dev:tamagotchi
|
||||
```
|
||||
|
||||
::: tip
|
||||
이 명령은 Electron 개발 환경을 시작합니다. 데스크톱 페이지를 변경하기 전에, 관련 공유 컴포넌트나 상태가 이미 `packages/stage-ui`에 있는지 확인하세요. 웹 앱과 데스크톱 앱이 함께 사용하는 로직은 보통 공유 패키지에 두어야 합니다.
|
||||
|
||||
[@antfu/ni](https://github.com/antfu-collective/ni) 사용자라면 이렇게 쓸 수 있습니다
|
||||
## 검증
|
||||
|
||||
```shell
|
||||
pnpm -F @proj-airi/stage-tamagotchi typecheck
|
||||
pnpm -F @proj-airi/stage-tamagotchi build
|
||||
```
|
||||
|
||||
**System → Developer** 메뉴와 각 디버깅 도구의 용도는 [개발자 도구](./desktop-developer-tools)를 참고하세요.
|
||||
|
||||
::: tip
|
||||
[@antfu/ni](https://github.com/antfu-collective/ni)를 사용한다면 다음을 실행하세요:
|
||||
|
||||
```shell
|
||||
nr dev:tamagotchi
|
||||
```
|
||||
|
||||
:::
|
||||
|
||||
@@ -1,20 +1,31 @@
|
||||
---
|
||||
title: 웹 UI
|
||||
description: Project AIRI에 기여하기
|
||||
title: 웹 앱 개발
|
||||
description: AIRI 웹 앱 실행, 검사, 빌드
|
||||
---
|
||||
|
||||
### Stage Web ([airi.moeru.ai](https://airi.moeru.ai) 브라우저 버전)
|
||||
웹 앱은 `apps/stage-web`에 있으며 [airi.moeru.ai](https://airi.moeru.ai)를 구동합니다. 저장소 루트에서 다음을 실행하세요:
|
||||
|
||||
```shell
|
||||
pnpm dev
|
||||
```
|
||||
|
||||
::: tip
|
||||
더 명시적인 명령을 사용할 수도 있습니다:
|
||||
|
||||
[@antfu/ni](https://github.com/antfu-collective/ni) 사용자라면 이렇게 쓸 수 있습니다
|
||||
```shell
|
||||
pnpm dev:web
|
||||
```
|
||||
|
||||
## 검증
|
||||
|
||||
```shell
|
||||
pnpm -F @proj-airi/stage-web typecheck
|
||||
pnpm -F @proj-airi/stage-web build
|
||||
```
|
||||
|
||||
::: tip
|
||||
[@antfu/ni](https://github.com/antfu-collective/ni)를 사용한다면 다음을 실행하세요:
|
||||
|
||||
```shell
|
||||
nr dev
|
||||
```
|
||||
|
||||
:::
|
||||
|
||||
@@ -0,0 +1,64 @@
|
||||
---
|
||||
title: Discord 봇
|
||||
description: Discord 애플리케이션으로 AIRI를 음성·메시징 봇으로 실행하기
|
||||
---
|
||||
|
||||
Discord 봇은 Discord 서버의 텍스트 채널과 음성 채널에 연결됩니다. 텍스트 응답은 AIRI에서 선택한 채팅 제공자와 모델을 사용합니다.
|
||||
|
||||
## 사전 준비 사항
|
||||
|
||||
- 저장소 루트에서 **pnpm i**로 의존성을 설치하세요.
|
||||
- [Discord Developer Portal](https://discord.com/developers/home)에서 애플리케이션과 봇을 만드세요.
|
||||
- 봇 설정에서 **Message Content Intent**를 활성화하세요.
|
||||
- AIRI에서 동작하는 채팅 제공자와 모델을 설정하세요.
|
||||
|
||||
::: warning 자격 증명 보안
|
||||
Bot Token과 AIRI Auth Token은 AIRI의 로컬 설정 또는 봇 서비스의 로컬 **.env.local** 파일에만 보관하세요. 이 자격 증명을 커밋하거나, 스크린샷에 포함하거나, 공유하지 마세요.
|
||||
:::
|
||||
|
||||
## 봇 서비스 설정
|
||||
|
||||
```bash
|
||||
cp integrations/discord-bot/.env integrations/discord-bot/.env.local
|
||||
```
|
||||
|
||||
데스크톱 버전에서 **설정 → 연결**을 여세요. **Auth Token**을 표시하고 복사하세요. 그런 다음 **integrations/discord-bot/.env.local**에 아래 값을 추가하세요:
|
||||
|
||||
```env
|
||||
AIRI_URL=ws://localhost:6121/ws
|
||||
AIRI_TOKEN=<Auth Token from Settings → Connection>
|
||||
```
|
||||
|
||||
`DISCORD_TOKEN`은 시작 시점에 사용하는 선택적 대체값입니다. 비워 두고 서비스가 연결된 뒤 AIRI에서 Bot Token을 보낼 수 있습니다. 서비스는 `DISCORD_BOT_CLIENT_ID`, `OPENAI_MODEL`, `OPENAI_API_*`, `ELEVENLABS_*`를 사용하지 않습니다. Discord 텍스트 응답은 AIRI의 활성 채팅 설정을 사용합니다.
|
||||
|
||||
Discord 음성 입력을 사용하려면 `OPENAI_STT_API_BASE_URL`, `OPENAI_STT_API_KEY`, `OPENAI_STT_MODEL`로 OpenAI 호환 전사 엔드포인트를 설정하세요. 텍스트 채널에는 이 값이 필요하지 않지만, 이 값 없이는 음성 전사가 완료되지 않습니다.
|
||||
|
||||
## 서비스 시작
|
||||
|
||||
```bash
|
||||
pnpm -F @proj-airi/discord-bot start
|
||||
```
|
||||
|
||||
## AIRI에서 Discord 설정하기
|
||||
|
||||
1. **설정 → 모듈 → Discord**를 여세요.
|
||||
2. **Bot Token**에 봇 토큰을 붙여넣으세요.
|
||||
3. **Enable Discord Integration**을 켜세요.
|
||||
4. **저장**을 클릭하세요.
|
||||
|
||||
인증된 봇 서비스는 AIRI의 설정 채널을 통해 활성화 상태와 토큰을 전달받습니다. 서비스가 실행 중이 아니거나 서비스의 AIRI Auth Token이 없거나 잘못된 경우, 이 필드를 저장하는 것만으로는 Discord 봇이 시작되지 않습니다.
|
||||
|
||||
## Discord에서 봇 설치 및 사용
|
||||
|
||||
1. Discord Developer Portal에서 `bot` 스코프로 **Guild Install**을 구성하고 봇을 서버에 설치하세요. `bot` 스코프는 기본적으로 `applications.commands`를 포함합니다. 사용하는 기능에 필요한 권한만 부여하세요:
|
||||
- 텍스트 응답: **View Channels**와 **Send Messages**.
|
||||
- 음성 입력: **View Channels**와 **Connect**.
|
||||
- 음성 재생: **Speak**.
|
||||
2. 텍스트 채팅은 봇에게 다이렉트 메시지를 보내거나 서버 채널에서 봇을 멘션하세요. 봇이 모든 서버 메시지에 응답하지는 않습니다.
|
||||
3. 음성 입력은 음성 채널에 참여한 뒤 `/summon`을 실행하세요. 서비스는 봇이 로그인한 후 `/ping`과 `/summon`을 등록합니다.
|
||||
|
||||
봇이 일부 채널에서만 동작하고 다른 채널에서는 동작하지 않으면, 채널 수준의 권한 재정의를 확인하세요.
|
||||
|
||||
## 보안 참고 사항
|
||||
|
||||
봇의 접근 권한을 필요한 채널과 기능으로만 제한하세요. Bot Token을 분실했거나 유출됐다면 Discord Developer Portal에서 즉시 재설정하세요.
|
||||
@@ -0,0 +1,30 @@
|
||||
---
|
||||
title: Factorio
|
||||
description: 신뢰할 수 있는 Factorio 서버에 AIRI 연결하기
|
||||
---
|
||||
|
||||
Factorio 통합은 AIRI를 외부 게임 서비스에 연결합니다. 데스크톱 버전은 서버 주소, 포트, 플레이어 이름 설정을 제공합니다. 접속 가능한 Factorio 서버와 호환되는 서버 측 통합은 직접 준비해야 합니다.
|
||||
|
||||
## 사전 준비 사항
|
||||
|
||||
- 접속 가능한 Factorio 서버.
|
||||
- 계정과 서버 측 통합이 연결할 수 있도록 서버 관리자에게 받은 권한.
|
||||
- 서버 주소, 포트, 게임 내 사용자 이름.
|
||||
|
||||
::: warning 신뢰할 수 있는 서버에만 연결하세요
|
||||
이 통합은 게임 서버와 컨텍스트 및 행동 요청을 주고받습니다. 신뢰할 수 없는 공개 서버에서 사용하지 말고, 서버 주소, 토큰, 계정 정보를 공개 채팅, 스크린샷, 이슈에 노출하지 마세요.
|
||||
:::
|
||||
|
||||
## AIRI에서 설정하기
|
||||
|
||||
1. **설정 → 모듈 → Factorio**를 여세요.
|
||||
2. **Factorio 통합**을 활성화하세요.
|
||||
3. 서버 주소, 포트, 게임 내 사용자 이름을 입력하세요. 기본 포트는 `34197`입니다.
|
||||
4. **저장**을 클릭하세요. **설정됨** 상태는 세 필드에 모두 값이 있다는 뜻일 뿐이며, 실제 연결은 서버와 서버 측 통합에 따라 달라집니다.
|
||||
|
||||
## 문제 해결
|
||||
|
||||
- AIRI를 실행하는 기기가 서버 주소와 포트에 접근할 수 있는지 확인하세요.
|
||||
- 방화벽, VPN, 서버 허용 목록이 연결을 차단하지 않는지 확인하세요.
|
||||
- 사용자 이름이 서버의 플레이어 이름과 일치하는지 확인하세요.
|
||||
- 설정을 저장했는데도 AIRI가 상호작용하지 못하면 서버 측 통합 로그를 확인하세요. 데스크톱 버전에는 바로 배포할 수 있는 Factorio 봇 서비스가 포함되어 있지 않습니다.
|
||||
@@ -0,0 +1,46 @@
|
||||
---
|
||||
title: Minecraft 에이전트
|
||||
description: 신뢰할 수 있는 Minecraft 서버에서 AIRI의 로컬 게임 에이전트 실행하기
|
||||
---
|
||||
|
||||
Minecraft 통합은 Mineflayer를 사용해 AIRI를 Minecraft 서버에 연결합니다. 이를 통해 에이전트가 컨텍스트를 받고, 게임 내 행동을 수행하고, 상태를 보고할 수 있습니다. 이 통합은 로컬 개발과 유지보수 용도로 만들어졌습니다. 현재 구현은 Fabric 런타임으로 이전할 계획이므로, 이를 기반으로 새로운 장기 기능을 만들지 마세요.
|
||||
|
||||
## 사전 준비 사항
|
||||
|
||||
- 저장소 루트에서 **pnpm i**로 의존성을 설치하세요.
|
||||
- 접속 가능한 로컬 또는 신뢰할 수 있는 Minecraft 서버를 준비하세요. 연결 주소와 포트는 환경 설정에서 가져옵니다.
|
||||
- AIRI에서 동작하는 채팅 제공자와 모델을 설정하고, Minecraft 에이전트가 사용할 OpenAI 호환 모델 설정을 준비하세요.
|
||||
|
||||
::: warning 자격 증명 보안
|
||||
API Key, 서비스 주소, Minecraft 서버 자격 증명은 로컬 **.env.local** 파일에만 보관하세요. 이 값을 커밋하거나, 스크린샷에 포함하거나, 공유하지 마세요.
|
||||
:::
|
||||
|
||||
## 설정하기
|
||||
|
||||
```bash
|
||||
cp integrations/minecraft/.env integrations/minecraft/.env.local
|
||||
```
|
||||
|
||||
**integrations/minecraft/.env.local**을 편집해 필요한 Minecraft 서버, AIRI, 모델 서비스 설정을 입력하세요.
|
||||
|
||||
데스크톱 버전에서 **설정 → 연결**을 여세요. **Auth Token**을 표시한 뒤 복사하세요. 그런 다음 아래 AIRI 채널 설정을 추가하세요:
|
||||
|
||||
```env
|
||||
AIRI_WS_BASEURL=ws://localhost:6121/ws
|
||||
AIRI_CLIENT_NAME=minecraft-bot
|
||||
AIRI_WS_TOKEN=<Auth Token from Settings → Connection>
|
||||
```
|
||||
|
||||
또한 서버와 모델 서비스에 필요한 `BOT_HOSTNAME`, `BOT_PORT` 값과 `OPENAI_API_BASEURL`, `OPENAI_API_KEY`, `OPENAI_MODEL`, `OPENAI_REASONING_MODEL` 값을 설정하세요. 기본값은 로컬 환경과 일치할 때만 그대로 두세요.
|
||||
|
||||
## 시작하기
|
||||
|
||||
```bash
|
||||
pnpm -F @proj-airi/minecraft-bot dev
|
||||
```
|
||||
|
||||
시작한 후 터미널 출력에서 AIRI 인증이 성공했는지, 에이전트가 Minecraft 서버에 연결되었는지 확인하세요. `AIRI_WS_TOKEN`이 없거나 잘못되면 모듈이 AIRI에 등록되지 않습니다.
|
||||
|
||||
## 보안 및 제한 사항
|
||||
|
||||
신뢰할 수 없는 공개 서버에 에이전트를 연결하지 마세요. 에이전트는 로컬 Minecraft 세션과 네트워크 연결을 제어합니다. 행동 계획이 격리된 환경에서 실행되더라도, 악의적인 서버는 예기치 않은 동작을 일으킬 수 있습니다.
|
||||
@@ -0,0 +1,34 @@
|
||||
---
|
||||
title: Satori 봇
|
||||
description: Koishi와 Satori 프로토콜을 통해 AIRI를 여러 메시징 플랫폼에 연결하기
|
||||
---
|
||||
|
||||
Satori 봇은 Koishi의 Satori 서비스를 통해 QQ, Telegram, Discord, Lark 같은 메시징 플랫폼에 연결됩니다. 현재의 독립 실행형 코어는 과도기적 구현으로 실험과 유지보수에 적합하며, 안정적인 AIRI Core 통합으로 간주해서는 안 됩니다.
|
||||
|
||||
## 사전 준비 사항
|
||||
|
||||
- 저장소 루트에서 **pnpm i**로 의존성을 설치하세요.
|
||||
- **server-satori** 플러그인이 활성화된 Koishi 인스턴스를 실행하세요.
|
||||
- OpenAI 호환 API를 제공하는 모델 서비스를 준비하세요.
|
||||
|
||||
::: warning 자격 증명 보안
|
||||
Satori 토큰, 메시징 플랫폼 자격 증명, 모델 API Key는 로컬 **.env.local** 파일에만 보관하세요. 이 값을 커밋하거나, 스크린샷에 포함하거나, 공유하지 마세요.
|
||||
:::
|
||||
|
||||
## 설정
|
||||
|
||||
```bash
|
||||
cp integrations/satori-bot/.env integrations/satori-bot/.env.local
|
||||
```
|
||||
|
||||
**integrations/satori-bot/.env.local**을 편집해 **SATORI_WS_URL**, **SATORI_API_BASE_URL**, 선택 사항인 **SATORI_TOKEN**, 그리고 LLM 주소·키·모델을 입력하세요.
|
||||
|
||||
## 시작
|
||||
|
||||
```bash
|
||||
pnpm -F @proj-airi/satori-bot dev
|
||||
```
|
||||
|
||||
## 참고 사항
|
||||
|
||||
메시징 플랫폼 주소, 토큰, 모델 자격 증명은 민감한 정보입니다. **.env.local**을 커밋하거나 그 내용을 누구에게도 보내지 마세요.
|
||||
@@ -0,0 +1,52 @@
|
||||
---
|
||||
title: Telegram 봇
|
||||
description: PostgreSQL과 모델 서비스를 사용해 AIRI를 Telegram 봇으로 실행하기
|
||||
---
|
||||
|
||||
Telegram 봇을 실행하려면 Telegram Bot Token, PostgreSQL 벡터 데이터베이스, 모델 서비스가 필요합니다. 저장소의 Compose 서비스는 pgvector 호환 모드로 pgvecto.rs 0.4.0이 포함된 PostgreSQL을 실행합니다. 봇은 소스에서 직접 실행하도록 만들어졌습니다.
|
||||
|
||||
## 사전 준비 사항
|
||||
|
||||
- 저장소 루트에서 **pnpm i**로 의존성을 설치하세요.
|
||||
- [@BotFather](https://t.me/BotFather)로 Telegram 봇을 만들고 토큰을 발급받으세요.
|
||||
- 저장소의 PostgreSQL 벡터 서비스를 시작할 수 있도록 Docker를 준비하세요.
|
||||
- 채팅 모델과 임베딩 모델 서비스를 준비하세요.
|
||||
|
||||
::: warning 자격 증명 보안
|
||||
Telegram Bot Token, 데이터베이스 연결 정보, 모델 API Key는 로컬 **.env.local** 파일에만 보관하세요. 이 값을 커밋하거나, 스크린샷에 포함하거나, 공유하지 마세요.
|
||||
:::
|
||||
|
||||
## 설정하기
|
||||
|
||||
```bash
|
||||
cp integrations/telegram-bot/.env integrations/telegram-bot/.env.local
|
||||
```
|
||||
|
||||
**integrations/telegram-bot/.env.local**을 편집해 **TELEGRAM_BOT_TOKEN**, 데이터베이스 연결 정보, 채팅 모델과 임베딩 모델 설정을 입력하세요. 임베딩 서비스의 출력 크기는 `EMBEDDING_DIMENSION`과 일치해야 하며, 지원되는 값은 `768`, `1024`, `1536`입니다.
|
||||
|
||||
## 데이터베이스 초기화
|
||||
|
||||
```bash
|
||||
cd integrations/telegram-bot
|
||||
docker compose up -d --wait pgvector
|
||||
cd ../..
|
||||
pnpm -F @proj-airi/telegram-bot db:push
|
||||
```
|
||||
|
||||
저장소의 Compose 파일은 PostgreSQL을 호스트 포트 `5433`으로 노출합니다. 이 서비스를 사용할 때는 다음과 같이 설정하세요:
|
||||
|
||||
```env
|
||||
DATABASE_URL=postgres://postgres:123456@localhost:5433/postgres
|
||||
```
|
||||
|
||||
`pgvector`만 시작하면 선택 사항인 Grafana, Tempo, Prometheus, OpenTelemetry 서비스는 실행되지 않습니다.
|
||||
|
||||
## 시작하기
|
||||
|
||||
```bash
|
||||
pnpm -F @proj-airi/telegram-bot start
|
||||
```
|
||||
|
||||
## 참고 사항
|
||||
|
||||
데이터베이스, Telegram 토큰, 모델 자격 증명은 민감한 정보입니다. **.env.local**을 커밋하지 마세요. 첫 배포 전에 데이터베이스 백업과 접근 제어 방안도 확인하세요.
|
||||
@@ -0,0 +1,26 @@
|
||||
---
|
||||
title: X / Twitter (사용 불가)
|
||||
description: AIRI X / Twitter 통합의 현재 구현 상태
|
||||
---
|
||||
|
||||
X / Twitter 통합은 AIRI 0.11.3에서 동작하지 않습니다. **설정 → 모듈 → X / Twitter**에 자격 증명 필드가 표시되고 **configured** 상태가 나타날 수 있지만, 현재 앱은 그 설정을 별도의 X 서비스에 전달할 수 없습니다.
|
||||
|
||||
::: warning X 자격 증명을 입력하지 마세요
|
||||
|
||||
현재 버전에서는 API Key, API Secret, Access Token, Access Token Secret을 입력하지 마세요. **configured** 상태는 네 필드에 모두 값이 들어 있다는 뜻일 뿐, 서비스 연결이 동작한다는 것을 확인해 주지 않습니다.
|
||||
:::
|
||||
|
||||
## 현재 제한 사항
|
||||
|
||||
프로토콜 불일치를 조사하기 전에, 컨트리뷰터는 `ENABLE_AIRI=true`, `AIRI_URL=ws://localhost:6121/ws`, 그리고 **설정 → 연결 → Auth Token**과 일치하는 `AIRI_TOKEN`으로 외부 프로세스를 시작해야 합니다. 저장소에 커밋된 기본값은 AIRI 어댑터를 비활성화하고, 주소를 `http://localhost:3000`으로 지정하며, 토큰을 제공하지 않습니다. 이 설정을 바로잡으면 서비스가 연결될 수 있을 뿐, 아래에 설명한 호환되지 않는 설정 전달 흐름이 고쳐지는 것은 아닙니다.
|
||||
|
||||
AIRI 모듈은 모듈 이름 `twitter`로 설정을 발행하지만, 외부 서비스는 `x`를 기대합니다. 채널 프로토콜도 서로 다릅니다. 서버는 설정을 `{ config }` 페이로드가 담긴 `module:configure`로 전달하지만, 서비스는 `ui:configure`를 수신 대기하며 `moduleName` 필드를 기대합니다. 또한 외부 서비스는 별도 프로세스로 실행되며 AIRI가 시작해 주지 않습니다. 따라서 모듈 이름만 고치거나 서비스를 수동으로 시작하는 것만으로는 이 폼이 동작하지 않습니다.
|
||||
|
||||
지원되는 최종 사용자용 해결 방법은 없습니다. 구현을 조사하는 컨트리뷰터는 다음을 비교할 수 있습니다:
|
||||
|
||||
- `packages/stage-ui/src/stores/modules/twitter.ts`
|
||||
- `integrations/twitter-services/src/adapters/airi-adapter.ts`
|
||||
|
||||
## 자격 증명 보안
|
||||
|
||||
이전에 자격 증명을 입력했다면 AIRI에서 제거하고, 유출됐을 가능성이 있다면 [X Developer Portal](https://developer.x.com/en/portal/dashboard)에서 교체하세요. X 자격 증명은 절대 커밋하거나, 스크린샷에 포함하거나, 공유하지 마세요.
|
||||
@@ -0,0 +1,41 @@
|
||||
---
|
||||
title: 음성 입력 및 출력 설정
|
||||
description: AIRI의 음성 합성(TTS)과 음성 인식(ASR/STT) 설정하기
|
||||
---
|
||||
|
||||
음성 합성(TTS)은 AIRI의 텍스트 응답을 소리 내어 읽어 주고, 음성 인식(ASR/STT)은 마이크 오디오를 텍스트로 변환합니다. 두 기능은 각각 독립적으로 설정할 수 있습니다.
|
||||
|
||||
## 음성 합성(TTS) 설정
|
||||
|
||||
1. **설정 → 제공자 → 음성 합성**을 열고 제공자를 선택한 뒤 자격 증명을 입력하세요.
|
||||
2. 제공자 플레이그라운드가 있다면 짧은 테스트 문장을 합성해 보세요.
|
||||
3. **설정 → 모듈 → 음성 합성**을 열고 설정한 제공자, 모델, 음성을 선택하세요.
|
||||
|
||||
제공자별 안내는 사이드바의 **서비스 제공자 → 음성 합성**을 참고하세요. 사용 중인 제공자가 OpenAI 음성 인터페이스를 구현한다면 [OpenAI Compatible API (TTS)](./providers/speech/openai.md)를 참고하세요.
|
||||
|
||||
## 음성 인식(ASR/STT) 설정
|
||||
|
||||
1. **설정 → 제공자 → 전사**를 열고 제공자를 선택한 뒤 자격 증명을 입력하세요.
|
||||
2. **설정 → 모듈 → 청각**을 열고 설정한 제공자와 모델을 선택하세요.
|
||||
3. 올바른 마이크를 선택하고 **Start Monitoring**을 클릭한 뒤 짧은 문장을 말해 보세요.
|
||||
4. 인식 결과 영역에 텍스트가 올바르게 표시되는지 확인하세요.
|
||||
|
||||
제공자별 안내는 사이드바의 **서비스 제공자 → 전사**를 참고하세요. 사용 중인 제공자가 OpenAI 호환 전사 인터페이스를 지원한다면 [OpenAI Compatible API (ASR/STT)](./providers/transcription/openai.md)를 참고하세요.
|
||||
|
||||
## FAQ
|
||||
|
||||
### TTS 소리가 나지 않는 경우
|
||||
|
||||
음성 합성 제공자, 모델, 음성이 선택되어 있는지 확인하고, 시스템 출력 장치와 볼륨을 점검하세요. 플레이그라운드에서 오류가 표시되면 API Key, 계정 크레딧, 모델 기능을 확인하세요.
|
||||
|
||||
### ASR이 텍스트를 생성하지 않는 경우
|
||||
|
||||
AIRI에 마이크 권한이 있는지, 청각 페이지에서 올바른 입력 장치가 선택되어 있는지 확인하세요. 실시간 인식 서비스의 경우 네트워크 장애나 브라우저/시스템 마이크 권한 회수로 인해 빈 결과가 나올 수도 있습니다.
|
||||
|
||||
### 언어나 음성이 잘못된 경우
|
||||
|
||||
대상 언어를 제공자가 지원하는 모델과 음성을 선택하세요. 전사 언어, 지역, 모델 설정은 제공자 계정에 활성화된 기능과 일치해야 합니다.
|
||||
|
||||
## 다음 단계
|
||||
|
||||
필드와 유효성 검사에 대한 자세한 내용은 [공통 설정 안내](./common.md)를 읽어 보세요. 제공자별 가이드는 **제공자 → 음성 합성**과 **제공자 → 전사** 아래에 있습니다.
|
||||
@@ -0,0 +1,45 @@
|
||||
---
|
||||
title: 일반 설정 안내
|
||||
description: AIRI의 제공자 설정 흐름, 필드, 확인 방법을 이해합니다
|
||||
---
|
||||
|
||||
이 페이지는 AIRI의 제공자 설정이 어떻게 동작하는지 설명합니다. 각 제공자의 API 엔드포인트, 계정 설정, 모델 선택은 해당 제공자별 가이드를 참고하세요.
|
||||
|
||||
## 설정 과정
|
||||
|
||||
1. **설정 → 제공자**를 열고 **채팅**, **비전**, **음성 합성**, **전사**, **Artistry** 중 하나를 선택하세요.
|
||||
2. 제공자를 선택하고 해당 설정 페이지에서 요구하는 자격 증명을 입력하세요.
|
||||
3. 필요하다면 고급 설정을 펼쳐 제공자 문서에 나온 Base URL이나 다른 매개변수를 입력하세요.
|
||||
4. 자동 유효성 검사가 끝날 때까지 기다리세요. 가능한 경우 **Ping API**나 제공자 플레이그라운드로 실제 요청을 테스트할 수 있습니다.
|
||||
5. **설정 → 모듈** 아래의 해당 페이지에서 제공자와 모델 또는 음성을 선택하세요.
|
||||
|
||||
::: warning 자격 증명 보안
|
||||
자격 증명과 제공자 설정은 현재 기기의 로컬 설정에 저장됩니다. API Key나 AccessKey Secret 같은 자격 증명을 스크린샷, 로그, 이슈, 채팅 메시지에 절대 노출하지 마세요.
|
||||
:::
|
||||
|
||||
## 공통 필드
|
||||
|
||||
| 필드 | 의미 | 안내 |
|
||||
| --- | --- | --- |
|
||||
| API Key | 제공자가 발급한 액세스 토큰 | 따옴표나 공백을 추가하지 말고 전체 키를 붙여넣으세요. |
|
||||
| Base URL | 제공자 API의 루트 URL | 제공자 문서에서 다른 URL을 요구할 때만 변경하세요. `https://` 또는 `http://`를 포함한 전체 주소를 입력하세요. |
|
||||
| 모델 | 채팅, 음성, 인식에 사용하는 모델 ID | AIRI의 목록에 있는 모델을 우선 사용하세요. 목록을 불러올 수 없고 필드가 직접 입력을 허용한다면, 제공자 문서에 나온 정확한 ID를 입력하세요. |
|
||||
| 음성 | 음성 합성에 사용하는 음성 ID | 먼저 모델을 선택한 뒤, 해당 모델이 지원하는 음성을 선택하세요. |
|
||||
| 리전 | 일부 클라우드 서비스가 사용하는 배포 리전 | 제공자 콘솔에 표시된 프로젝트 또는 리소스의 리전과 일치시키세요. |
|
||||
|
||||
## 확인 결과
|
||||
|
||||
채팅 제공자 폼은 필수 필드의 유효성을 자동으로 검사합니다. **Ping API**를 제공하는 제공자는 실제 요청도 보낼 수 있으며, 이 과정에서 소량의 크레딧이 소모될 수 있습니다. 음성 제공자의 플레이그라운드는 가능한 경우 합성과 재생을 테스트합니다. 전사는 **설정 → 모듈 → 청각**에서 선택한 마이크로 테스트하세요.
|
||||
|
||||
확인이 실패하면 다음 순서로 문제를 해결하세요.
|
||||
|
||||
1. 계정이 서비스에 접근할 수 있고 사용 가능한 크레딧이나 할당량이 있는지 확인하세요.
|
||||
2. API Key를 다시 복사하고, 앞뒤 공백이나 줄바꿈이 포함되지 않았는지 확인하세요.
|
||||
3. 기본 Base URL을 복원하거나, 제공자의 공식 문서와 정확히 비교하세요.
|
||||
4. 네트워크, 프록시, 방화벽이 제공자로의 접근을 허용하는지 확인하세요.
|
||||
5. 제공자가 명시적으로 지원하는 모델을 선택하세요. 표시 이름을 모델 ID로 사용하지 마세요.
|
||||
|
||||
## 다음 단계
|
||||
|
||||
- 텍스트 응답을 설정하려면 [채팅 모델 설정](./llm.md)을 읽어보세요.
|
||||
- 음성 출력이나 마이크 입력을 설정하려면 [음성 입출력 설정](./audio.md)을 읽어보세요.
|
||||
@@ -1,45 +1,56 @@
|
||||
---
|
||||
title: 설정 가이드
|
||||
description: Project AIRI 사용법
|
||||
title: 제공자 설정 가이드
|
||||
description: Project AIRI의 채팅, 비전, 음성 합성, 전사, Artistry 제공자 설정하기
|
||||
---
|
||||
|
||||
## 설정
|
||||
AIRI와 대화하려면 최소 하나의 채팅 제공자와 채팅 모델을 설정해야 합니다. 음성 합성(TTS)은 음성 출력을, 자동 음성 인식(ASR/STT)은 마이크 입력을 추가합니다. 음성 입력과 출력은 선택 사항이며 서로 독립적으로 설정할 수 있습니다.
|
||||
|
||||
시스템 트레이에서 설정을 열어 더 자세히 커스터마이즈할 수 있습니다. 예를 들어
|
||||
AIRI의 테마 색상을 바꾸거나, Live2D(2D) 또는 VRM(3D, Grok Companion과 비슷한 형태)
|
||||
같은 다른 모델로 전환할 수 있습니다.
|
||||
## 최소 필수 설정하기
|
||||
|
||||
<video autoplay loop muted>
|
||||
1. AIRI의 **설정 → 제공자**를 여세요.
|
||||
2. **채팅** 카테고리에서 제공자를 선택하고, 자격 증명을 입력한 뒤, 제공되는 검증 절차를 완료하세요.
|
||||
3. **설정 → 모듈 → 의식**을 열어 설정한 제공자와 모델을 선택하세요.
|
||||
4. 메시지를 보내 AIRI가 응답하는지 확인하세요.
|
||||
|
||||
채팅이 동작하면 필요에 따라 음성 입력이나 출력을 추가하세요:
|
||||
|
||||
* **[일반 안내](./common.md)**: 설정 과정, 각 필드의 의미, 검증 결과, FAQ를 이해할 수 있습니다.
|
||||
* **[채팅 모델 설정](./llm.md)**: LLM을 설정하고 의식에서 모델을 선택합니다.
|
||||
* **[음성 입출력 설정](./audio.md)**: TTS와 ASR/STT를 설정하고 **모듈 → 음성 합성**과 **모듈 → 청각**에서 활성화합니다.
|
||||
* **[시각 이해 설정](./vision.md)**: 별도의 비전 제공자를 설정하고 이미지를 처리할 수 있는 모델을 선택합니다.
|
||||
* **[웹 검색 설정](./web-search.md)**: Tavily를 사용해 AIRI가 필요할 때 인터넷에서 최신 정보를 검색하도록 합니다.
|
||||
* **제공자**: 사이드바에서 **제공자**를 펼쳐 **채팅**, **비전**, **음성 합성**, **전사**, **Artistry** 중 하나를 선택하세요. 제공자 페이지는 자격 증명을 저장하고, 모듈 페이지는 AIRI가 실제로 사용할 제공자와 모델을 선택합니다.
|
||||
|
||||
> [!TIP]
|
||||
> 기본 설정을 확인하려면 채팅을 먼저 설정하세요. TTS와 ASR은 그 후에 추가해야 음성 설정 문제를 분리해서 파악할 수 있습니다.
|
||||
|
||||
## 추가 설정
|
||||
|
||||
제공자를 설정한 뒤에는 AIRI의 테마를 바꾸거나 표시 모델을 전환할 수도 있습니다. 현재 모델 선택기는 Live2D, Spine, VRM, MMD, Tachie를 지원합니다.
|
||||
|
||||
<video autoplay loop muted playsinline preload="metadata" poster="/assets/tutorial-basic-open-settings-poster.avif">
|
||||
<source src="/assets/tutorial-basic-open-settings.mp4" type="video/mp4">
|
||||
</video>
|
||||
|
||||
설정에는 정말 많은 항목이 있으니, 이것저것 시도해 보면서 마음에 드는 조합을 찾아보세요.
|
||||
서비스 제공자를 설정할 때는 가능한 한 해당 제공자 문서에 나온 기본 주소와 모델 이름을 사용하세요. Base URL, 모델 ID, 리전 파라미터는 제공자마다 다르므로 추측해서 입력하지 마세요.
|
||||
|
||||
### 모델 바꾸기
|
||||
|
||||
기본 모델을 다른 Live2D(2D)나 VRM(3D, 마찬가지로 Grok Companion과 비슷한 3D 모델이라면
|
||||
가지고 계신 것으로) 모델로 교체할 수 있습니다.
|
||||
기본 모델을 지원되는 다른 2D 또는 3D 표시 모델로 교체할 수 있습니다.
|
||||
|
||||
모델 설정은 [설정] -> [모델] 아래에 있습니다.
|
||||
모델 설정은 **설정 → 모델**에 있습니다.
|
||||
|
||||
::: tip VTuber Studio 모델을 가져오시나요?
|
||||
Live2D 모델을 렌더링하는 데 사용하는 라이브러리는 VTuber Studio 모델에서 만들어진 ZIP 파일을
|
||||
읽는 데 어려움을 겪습니다. VTuber Studio는 사용하지만 Live2D 엔진은 알지 못하는 파일이 섞여 있기 때문입니다.
|
||||
|
||||
따라서 가져오기 전에, VTuber Studio 모델을 ZIP으로 압축하기 전에 다음 파일을 반드시 제외하세요.
|
||||
|
||||
- `items_pinned_to_model.json`
|
||||
::: tip VTube Studio 모델을 가져오시나요?
|
||||
완전한 Live2D 모델 폴더를 ZIP 파일로 압축하세요. AIRI는 가져오기 과정에서 VTube Studio의 `items_pinned_to_model.json` 메타데이터를 무시하므로, 직접 삭제할 필요가 없습니다.
|
||||
:::
|
||||
|
||||
<br />
|
||||
|
||||
::: warning 알려진 버그
|
||||
현재 모델의 장면을 다시 불러오는 기능이 의도대로 동작하지 않습니다.
|
||||
모델을 불러온 뒤에는 AIRI를 재시작해야 합니다.
|
||||
::: tip 모델 변경
|
||||
스테이지는 모델 설정 변경을 감지해 선택된 렌더러를 자동으로 다시 불러옵니다. 가져온 모델 자체가 로드되지 않는다면, AIRI를 재시작하기 전에 모델의 패키지 구조와 에셋을 확인하세요.
|
||||
:::
|
||||
|
||||
<br />
|
||||
|
||||
<video autoplay loop muted>
|
||||
<video autoplay loop muted playsinline preload="metadata" poster="/assets/tutorial-settings-change-model-poster.avif">
|
||||
<source src="/assets/tutorial-settings-change-model.mp4" type="video/mp4">
|
||||
</video>
|
||||
|
||||
@@ -0,0 +1,46 @@
|
||||
---
|
||||
title: 채팅 모델 설정
|
||||
description: AIRI의 채팅 제공자와 모델 설정하기
|
||||
---
|
||||
|
||||
채팅 모델은 AIRI의 "두뇌"입니다. 텍스트 응답을 생성하려면 채팅 모델을 사용할 수 있는 제공자 계정 또는 실행 중인 로컬 모델 서비스가 필요합니다.
|
||||
|
||||
## 사전 준비 사항
|
||||
|
||||
- AIRI가 설치되어 실행 중입니다.
|
||||
- 클라우드 제공자의 경우, API Key를 생성했고 계정에서 선택한 채팅 모델을 사용할 수 있는지 확인했습니다.
|
||||
- 로컬 제공자의 경우, 모델 서비스가 실행 중이며 AIRI가 실행되는 기기에서 접근할 수 있습니다.
|
||||
|
||||
## 제공자와 모델 설정
|
||||
|
||||
1. **설정 → 제공자 → 채팅**을 열고 사용할 제공자를 선택하세요.
|
||||
|
||||
어떤 제공자를 선택할지 확실하지 않다면 [OpenRouter](./providers/consciousness/openrouter.md), [DeepSeek](./providers/consciousness/deepseek.md), [OpenAI Compatible](./providers/consciousness/openai.md) 또는 로컬 [Ollama](./providers/consciousness/ollama.md)부터 시작하세요. 다른 채팅 제공자는 **제공자 → 채팅** 아래에 나열되어 있습니다.
|
||||
|
||||
2. API Key를 입력하세요. Base URL은 제공자 문서에서 다른 주소를 요구하는 경우에만 고급 설정에서 변경하세요.
|
||||
|
||||
3. 제공자 페이지에 표시되는 자동 유효성 검사 결과를 확인하세요. 제공자 필드는 수정하는 즉시 저장됩니다. 유효성 검사 방식은 제공자마다 다르며, 필드만 검사하거나, 모델 목록을 가져오거나, 소규모 실제 요청을 위한 **Ping API**를 제공하기도 합니다.
|
||||
|
||||
4. **설정 → 모듈 → 의식**을 열고 설정한 제공자와 모델을 선택하세요.
|
||||
|
||||
제공자가 지원하는 경우 AIRI가 모델 목록을 불러옵니다. 목록을 불러올 수 없고 필드에 직접 입력이 가능하다면, 제공자 공식 문서에 있는 정확한 모델 ID를 입력하세요.
|
||||
|
||||
5. 채팅 인터페이스로 돌아가 "Hello" 같은 짧은 메시지를 보내세요. 응답이 오면 제공자와 모델이 정상 동작하는 것입니다.
|
||||
|
||||
## 문제 해결
|
||||
|
||||
### 유효성 검사는 통과했지만 사용 가능한 모델이 없는 경우
|
||||
|
||||
먼저 제공자가 모델 목록 조회를 지원하는지 확인하세요. 일부 제공자는 모델 목록을 반환하지 않거나, API Key에 필요한 권한이 없을 수 있습니다. 이 경우 **설정 → 모듈 → 의식**에서 모델 ID를 직접 입력하세요. 모델 ID는 제공자 문서와 정확히 일치해야 합니다.
|
||||
|
||||
### 확인에 실패하거나 요청이 시간 초과되는 경우
|
||||
|
||||
API Key, Base URL, 계정 할당량, 네트워크 연결을 확인하세요. 로컬 서비스라면 서비스가 실행 중이고 AIRI가 설정된 주소에 접근할 수 있는지 확인하세요.
|
||||
|
||||
### AIRI가 응답하지 않는 경우
|
||||
|
||||
**설정 → 모듈 → 의식**에서 제공자와 모델이 모두 선택되어 있는지 확인하세요. 제공자 자격 증명을 저장해도 제공자가 자동으로 활성화되지는 않습니다.
|
||||
|
||||
## 다음 단계
|
||||
|
||||
채팅이 동작하면 [음성 입력 및 출력 설정](./audio.md)으로 이동해 AIRI가 말하거나 마이크 입력을 사용할 수 있게 하세요.
|
||||
@@ -0,0 +1,42 @@
|
||||
---
|
||||
title: ComfyUI (Artistry)
|
||||
description: 로컬 ComfyUI 워크플로를 AIRI에 연결하기
|
||||
---
|
||||
|
||||
ComfyUI를 사용하면 AIRI가 로컬 머신이나 신뢰할 수 있는 LAN의 이미지 생성 워크플로를 사용할 수 있습니다. 제공자 페이지에서 워크플로를 설정하고 활성화한 뒤, **설정 → 모듈 → Artistry**에서 **ComfyUI (Local)**을 선택하세요.
|
||||
|
||||
::: info 왜 ComfyUI를 선택하나요?
|
||||
이미지 생성을 로컬 환경에서 유지하면서 직접 설치한 모델·노드·워크플로를 사용하려면 ComfyUI를 선택하세요.
|
||||
:::
|
||||
|
||||
## ComfyUI 서비스와 워크플로 준비하기
|
||||
|
||||
1. ComfyUI를 시작하세요. AIRI는 기본적으로 `http://localhost:8188`에 연결합니다.
|
||||
2. ComfyUI에서 직접 실행할 수 있는 이미지 워크플로를 준비하고, ComfyUI에서 해당 워크플로의 API 워크플로 JSON을 내보내세요.
|
||||
3. AIRI와 ComfyUI가 같은 기기에 있지 않다면, AIRI가 있는 기기에서 해당 주소에 접근할 수 있는지 확인하세요.
|
||||
|
||||
::: warning 로컬 서비스와 워크플로 보안
|
||||
ComfyUI의 서비스 포트를 신뢰할 수 없는 공용 네트워크에 노출하지 마세요. 워크플로를 가져오기 전에 워크플로의 노드, 모델 경로, 매개변수를 확인하고, 출처를 알 수 없는 워크플로 JSON은 가져오지 마세요.
|
||||
:::
|
||||
|
||||
## AIRI에서 설정하기
|
||||
|
||||
1. **설정 → 제공자 → Artistry → ComfyUI**를 여세요.
|
||||
2. ComfyUI **Server URL**을 입력하세요. 기본값은 `http://localhost:8188`입니다.
|
||||
3. **Test**를 클릭해 AIRI가 ComfyUI 서비스 상태를 읽을 수 있는지 확인하세요.
|
||||
4. Workflow 영역에 API 워크플로 JSON을 업로드하고, 이름을 입력한 뒤, AIRI가 제어할 수 있는 입력 필드를 선택하세요.
|
||||
5. 워크플로를 저장하고 활성 워크플로로 지정하세요.
|
||||
|
||||
## 설정 확인
|
||||
|
||||
1. **설정 → 모듈 → 의식**에서 도구 호출을 지원하는 채팅 모델을 선택하세요. ComfyUI가 생성 작업을 받으려면 먼저 모델이 Artistry 도구를 호출해야 합니다.
|
||||
2. **설정 → 모듈 → Artistry**를 열고 **ComfyUI (Local)**을 선택하세요.
|
||||
3. 채팅으로 돌아가 AIRI에게 민감하지 않은 이미지를 생성해 달라고 요청하세요.
|
||||
4. ComfyUI의 Queue 또는 History에 작업이 나타나는지 확인하세요. 이미지가 반환되면 연결, 활성 워크플로, 노출된 필드, 채팅 모델의 도구 호출이 모두 정상 동작하는 것입니다.
|
||||
|
||||
## 문제 해결
|
||||
|
||||
- **Test가 실패하는 경우:** ComfyUI가 실행 중인지, 그리고 **Server URL**, 포트, 네트워크 경로가 올바른지 확인하세요.
|
||||
- **브라우저에 교차 출처(cross-origin) 오류가 표시되는 경우:** AIRI의 ComfyUI 제공자 페이지에 표시된 CORS 옵션으로 ComfyUI를 다시 시작하세요.
|
||||
- **워크플로가 ComfyUI에서 실패하는 경우:** API 형식의 워크플로 JSON을 가져온 뒤, 참조된 모든 커스텀 노드와 모델이 설치되어 있는지 확인하세요.
|
||||
- **Queue나 History에 작업이 나타나지 않는 경우:** 대화형 Artistry 흐름에서는 선택한 채팅 모델이 도구 호출을 지원하는지, 그리고 **설정 → 모듈 → Artistry**가 **ComfyUI (Local)**로 설정되어 있는지 확인하세요. 도구를 호출할 수 없는 텍스트 전용 모델은 대화형 Artistry 작업을 시작할 수 없습니다.
|
||||
@@ -0,0 +1,37 @@
|
||||
---
|
||||
title: Nano Banana (Artistry)
|
||||
description: AIRI에서 Nano Banana 이미지 생성 설정하기
|
||||
---
|
||||
|
||||
Nano Banana는 Google AI Studio API Key를 사용해 이미지를 생성합니다. **설정 → 제공자 → Artistry**에서 설정한 뒤, **설정 → 모듈 → Artistry**에서 활성화하세요.
|
||||
|
||||
::: info 왜 Nano Banana를 선택하나요?
|
||||
이미 Google AI Studio API Key가 있고 AIRI에 내장된 Gemini 이미지 모델과 해상도 옵션을 바로 사용하고 싶다면 선택할 수 있습니다.
|
||||
:::
|
||||
|
||||
## API Key 발급받기
|
||||
|
||||
1. [Google AI Studio API Keys](https://aistudio.google.com/app/apikey)에 로그인한 뒤 API Key를 만드세요.
|
||||
2. 선택한 이미지 모델을 계정과 지역에서 사용할 수 있는지 확인하세요.
|
||||
3. 키를 복사해 안전한 곳에 보관하세요.
|
||||
|
||||
::: warning API Key 보안
|
||||
API Key를 커밋하거나, 스크린샷에 포함하거나, 누구와도 공유하지 마세요. 키가 유출되면 즉시 폐기하고 Google AI Studio에서 새 키를 만드세요.
|
||||
:::
|
||||
|
||||
## AIRI에서 설정하기
|
||||
|
||||
1. **설정 → 제공자 → Artistry → Nano Banana**를 열고 API Key를 붙여넣으세요.
|
||||
2. 기본 모델을 선택하세요: `gemini-3.1-flash-image-preview`, `gemini-3-pro-image-preview` 또는 `gemini-2.5-flash-image`.
|
||||
3. 기본 해상도를 선택하세요: 1K, 2K 또는 4K.
|
||||
|
||||
## 설정 확인
|
||||
|
||||
1. **설정 → 모듈 → Artistry**를 열고 **Nano Banana (Preview)**를 선택하세요.
|
||||
2. **설정 → 모듈 → 의식**에서 도구/함수 호출을 지원하는 채팅 모델을 선택하세요.
|
||||
3. 채팅으로 돌아가 AIRI에게 민감하지 않은 이미지를 생성해 달라고 요청하세요.
|
||||
4. 이미지가 반환되면 API Key, 모델, 해상도, 도구 호출이 모두 정상 동작하는 것입니다.
|
||||
|
||||
## 문제 해결
|
||||
|
||||
인증이 실패하면 API Key가 유효한지 확인하세요. 이미지 생성이 실패하면 Google AI Studio 계정, 지역별 사용 가능 여부, 현재 모델 상태를 확인한 뒤 1K 해상도나 사용 가능한 다른 모델을 시도해 보세요.
|
||||
@@ -0,0 +1,38 @@
|
||||
---
|
||||
title: Replicate (Artistry)
|
||||
description: AIRI에서 Replicate 이미지 생성 설정하기
|
||||
---
|
||||
|
||||
Replicate를 사용하면 AIRI가 클라우드에 호스팅된 모델로 이미지를 생성할 수 있습니다. **설정 → 제공자 → Artistry**에서 설정한 뒤, **설정 → 모듈 → Artistry**에서 활성화하세요.
|
||||
|
||||
::: info 왜 Replicate를 선택하나요?
|
||||
이미지 모델을 직접 배포하고 싶지 않고 Replicate에서 제공하는 모델 중에서 선택하고 싶다면 이 클라우드 추론 서비스를 선택할 수 있습니다.
|
||||
:::
|
||||
|
||||
## API Token 발급받기
|
||||
|
||||
1. [Replicate API Tokens](https://replicate.com/account/api-tokens)에 로그인한 뒤 API Token을 만드세요.
|
||||
2. 계정에 사용 가능한 결제 수단이나 충분한 크레딧이 있는지 확인하세요.
|
||||
3. 토큰을 복사해 안전하게 보관하세요.
|
||||
|
||||
::: warning API Token 보안
|
||||
API Token을 커밋하거나, 스크린샷에 포함하거나, 누구와도 공유하지 마세요. 토큰이 유출되면 즉시 폐기하고 Replicate 콘솔에서 새 토큰을 만드세요.
|
||||
:::
|
||||
|
||||
## AIRI에서 설정하기
|
||||
|
||||
1. **설정 → 제공자 → Artistry → Replicate**를 여세요.
|
||||
2. API Token을 붙여넣으세요.
|
||||
3. 모델 ID를 입력하세요. AIRI의 기본값은 `black-forest-labs/flux-schnell`입니다. 다른 모델을 선택하는 경우 Replicate 모델 페이지에 표시된 정확한 ID를 사용하세요.
|
||||
4. 필요에 따라 기본 종횡비(기본값 `16:9`)와 추론 단계 수(기본값 4)를 설정하세요.
|
||||
|
||||
## 설정 확인
|
||||
|
||||
1. **설정 → 모듈 → Artistry**를 열고 **Replicate.ai (Cloud)**를 선택하세요.
|
||||
2. **설정 → 모듈 → 의식**에서 도구/함수 호출을 지원하는 채팅 모델을 선택하세요.
|
||||
3. 채팅으로 돌아가 AIRI에게 민감하지 않은 이미지를 생성해 달라고 요청하세요.
|
||||
4. 이미지가 반환되면 토큰, 모델 ID, 계정 할당량, 도구 호출이 모두 정상 동작하는 것입니다.
|
||||
|
||||
## 문제 해결
|
||||
|
||||
인증이 실패하면 토큰 전체가 빠짐없이 붙여넣어졌는지 확인하세요. 요청이 거부되면 계정 할당량, 모델 접근 권한, 모델 ID를 확인하세요. 결과가 예상과 다르면 해당 모델이 지원하는 종횡비와 매개변수 범위를 확인한 뒤 추론 단계를 조정하거나 다른 모델을 선택하세요.
|
||||
@@ -0,0 +1,36 @@
|
||||
---
|
||||
title: 302.AI
|
||||
description: AIRI에서 302.AI를 채팅 제공자로 설정하기
|
||||
is_openai_compatible: true
|
||||
---
|
||||
|
||||
302.AI는 API 통합 제공자입니다. 설정을 완료한 후 **설정 → 모듈 → 의식**에서 302.AI 채팅 모델을 선택하세요.
|
||||
|
||||
::: info 왜 302.AI를 선택하나요?
|
||||
중국 본토에서 AIRI를 주로 사용한다면 302.AI를 먼저 시도해 볼 수 있습니다. 통합 API를 제공하므로 하나의 API Key로 여러 모델을 쉽게 사용해 볼 수 있습니다. 다만 실제 사용 가능 여부는 네트워크 환경, 결제 수단, 서비스 제공자 정책에 따라 달라질 수 있습니다.
|
||||
:::
|
||||
|
||||
## API Key 발급받기
|
||||
|
||||
1. [302.AI 콘솔](https://302.ai/)을 열고 로그인하거나 계정을 만드세요.
|
||||
2. 콘솔에서 API Key를 생성하세요.
|
||||
3. 키를 복사해 안전한 곳에 보관하세요.
|
||||
|
||||
::: warning API Key 보안
|
||||
API Key를 커밋하거나, 스크린샷에 포함하거나, 누구와도 공유하지 마세요. 키가 유출되면 즉시 폐기하고 302.AI 콘솔에서 새 키를 만드세요.
|
||||
:::
|
||||
|
||||
## AIRI에서 설정하기
|
||||
|
||||
1. **설정 → 제공자 → 채팅 → 302.AI**를 여세요.
|
||||
2. 기본 설정에 API Key를 붙여넣으세요.
|
||||
3. 기본 Base URL을 그대로 유지하세요: `https://api.302.ai/v1/`.
|
||||
|
||||
## 설정 확인
|
||||
|
||||
1. **설정 유효성 검사**: AIRI는 설정을 수정하는 동안 자동으로 유효성을 검사합니다. **Ping API** 버튼이 보이면 실제 요청 테스트에 사용할 수 있습니다.
|
||||
2. **모델 선택 →**: 유효성 검사가 통과되면 이 버튼으로 **설정 → 모듈 → 의식**을 열어 제공자와 모델을 선택하세요.
|
||||
|
||||
## 문제 해결
|
||||
|
||||
API 확인이 실패하면 API Key, 계정 잔액, 네트워크 연결을 점검하세요. AIRI가 모델 목록을 불러오지 못하면 **의식** 페이지에서 302.AI가 제공하는 정확한 모델 ID를 직접 입력하세요.
|
||||
@@ -0,0 +1,31 @@
|
||||
---
|
||||
title: AIHubMix
|
||||
description: AIRI에서 AIHubMix 채팅 모델 설정하기
|
||||
---
|
||||
|
||||
AIHubMix는 AIRI에서 채팅 모델을 제공하며 계정에서 사용 가능한 모델 목록을 표시합니다.
|
||||
|
||||
::: info 왜 AIHubMix를 선택하나요?
|
||||
API Key로 AIHubMix 계정에서 제공되는 모델을 사용하고 싶다면 이 제공자를 선택할 수 있습니다.
|
||||
:::
|
||||
|
||||
## API Key 발급받기
|
||||
|
||||
[AIHubMix](https://aihubmix.com/)에 로그인한 뒤 콘솔에서 API Key를 생성하세요.
|
||||
|
||||
::: warning API Key 보안
|
||||
API Key를 커밋하거나, 스크린샷에 포함하거나, 누구와도 공유하지 마세요.
|
||||
:::
|
||||
|
||||
## AIRI에서 설정하기
|
||||
|
||||
**설정 → 제공자 → 채팅 → AIHubMix**를 열고 **API Key**를 입력하세요. 기본 Base URL은 `https://aihubmix.com/v1/`입니다.
|
||||
|
||||
## 설정 확인
|
||||
|
||||
1. **설정 유효성 검사**: AIRI는 설정을 수정하는 동안 자동으로 유효성을 검사합니다. **Ping API** 버튼이 보이면 실제 요청 테스트에 사용할 수 있습니다.
|
||||
2. **모델 선택 →**: 유효성 검사가 통과되면 이 버튼으로 **설정 → 모듈 → 의식**을 열어 제공자와 모델을 선택하세요.
|
||||
|
||||
## 문제 해결
|
||||
|
||||
API 확인이 실패하면 API Key, 계정 잔액, 네트워크 연결을 점검하세요. AIRI가 모델 목록을 불러오지 못하면 Base URL이 변경되지 않았는지 확인하거나, **의식** 페이지에서 AIHubMix가 제공하는 정확한 모델 ID를 직접 입력하세요.
|
||||
@@ -0,0 +1,32 @@
|
||||
---
|
||||
title: Amazon Bedrock
|
||||
description: AIRI에서 Amazon Bedrock 채팅 모델 설정하기
|
||||
---
|
||||
|
||||
Amazon Bedrock은 Bedrock API Key와 AWS 리전을 사용해 접근이 허용된 기반 모델에 액세스합니다.
|
||||
|
||||
::: info 왜 Amazon Bedrock을 선택하나요?
|
||||
이미 AWS에서 모델 액세스, 리전, 결제를 관리하고 있다면 Bedrock은 동일한 계정 관리 방식을 그대로 활용할 수 있습니다.
|
||||
:::
|
||||
|
||||
## Bedrock API Key 준비하기
|
||||
|
||||
1. [Amazon Bedrock 콘솔](https://console.aws.amazon.com/bedrock/)을 열어 필요한 모델에 대한 액세스를 활성화하고, 같은 계정과 리전에서 Bedrock API Key를 생성하세요.
|
||||
|
||||
::: warning AWS 자격 증명 보안
|
||||
Bedrock API Key를 노출하지 마세요. AIRI의 제공자 설정에만 저장하고, 더 이상 필요하지 않으면 폐기하세요.
|
||||
:::
|
||||
|
||||
## AIRI에서 설정하기
|
||||
|
||||
1. **설정 → 제공자 → 채팅 → Amazon Bedrock**을 열고 **Amazon Bedrock API Key**와 **AWS Region**을 입력하세요. 기본 리전은 `us-east-1`입니다.
|
||||
2. AWS 계정이 해당 리전에서 대상 모델에 액세스할 수 있는지 확인하세요. AIRI 폼에는 커스텀 엔드포인트 필드가 없습니다.
|
||||
|
||||
## 설정 확인
|
||||
|
||||
1. API Key와 리전을 입력한 뒤 AIRI의 자동 유효성 검사가 끝나기를 기다리세요.
|
||||
2. **설정 → 모듈 → 의식**으로 이동해 Amazon Bedrock과 접근이 허용된 모델을 선택한 뒤, 메시지를 보내 설정을 확인하세요.
|
||||
|
||||
## 문제 해결
|
||||
|
||||
확인이 실패하면 Bedrock API Key, 선택한 AWS 리전, 모델 액세스가 같은 계정에 속하는지 점검하세요. 모델을 선택할 수 없다면 Bedrock 콘솔에서 해당 계정이 선택한 리전에서 그 모델에 액세스할 수 있는지 확인하세요.
|
||||
@@ -0,0 +1,37 @@
|
||||
---
|
||||
title: Anthropic
|
||||
description: AIRI에서 Anthropic Claude 채팅 모델 설정하기
|
||||
---
|
||||
|
||||
Anthropic 제공자를 사용하면 AIRI에서 Claude 채팅 모델을 사용할 수 있습니다. AIRI는 Anthropic의 API 주소와 사용자의 API Key를 사용하며, 모델 목록이 AIRI에 내장되어 있어 시작할 때 Base URL이나 모델 ID를 직접 입력할 필요가 없습니다.
|
||||
|
||||
::: info 왜 Anthropic을 선택하나요?
|
||||
이미 Claude API를 사용 중이거나 AIRI에서 Claude 모델을 사용하고 싶다면 Anthropic을 바로 선택할 수 있습니다.
|
||||
:::
|
||||
|
||||
## API Key 생성하기
|
||||
|
||||
1. [Anthropic 콘솔](https://platform.claude.com/settings/keys)에 로그인해 API Key를 생성하고, 계정에 API 액세스가 활성화되어 있는지 확인하세요.
|
||||
2. 키에 적절한 이름, 유효 기간, 사용량 한도를 설정하세요.
|
||||
3. 키를 복사해 안전한 곳에 보관하세요.
|
||||
|
||||
::: warning API Key 보안
|
||||
API Key를 커밋하거나, 스크린샷에 포함하거나, 누구와도 공유하지 마세요. 키가 유출되면 즉시 폐기하고 Anthropic 콘솔에서 새 키를 만드세요.
|
||||
:::
|
||||
|
||||
## AIRI에서 설정하기
|
||||
|
||||
1. **설정 → 제공자 → 채팅 → Anthropic**을 여세요.
|
||||
2. 기본 설정에 API Key를 붙여넣으세요.
|
||||
3. 기본 Base URL을 그대로 유지하세요: `https://api.anthropic.com/v1/`.
|
||||
|
||||
## 설정 확인
|
||||
|
||||
1. **설정 유효성 검사**: AIRI는 설정을 수정하는 동안 자동으로 유효성을 검사합니다. **Ping API** 버튼이 보이면 실제 요청 테스트에 사용할 수 있습니다.
|
||||
2. **모델 선택 →**: 유효성 검사가 통과되면 이 버튼으로 **설정 → 모듈 → 의식**을 열어 제공자와 모델을 선택하세요.
|
||||
|
||||
## 문제 해결
|
||||
|
||||
제공자 유효성 검사는 짧은 채팅 요청을 보내 연결 상태를 확인합니다. 검사가 실패하면 API Key가 유효한지, 계정에 사용 가능한 크레딧과 충분한 사용량 한도가 있는지, 속도 제한이 걸려 있지 않은지, 네트워크가 Anthropic API에 접근할 수 있는지 확인하세요.
|
||||
|
||||
모델 선택기에 원하는 모델이 보이지 않으면 먼저 AIRI를 업데이트하거나, **의식** 페이지에서 Anthropic이 제공하는 정확한 모델 ID를 직접 입력하세요.
|
||||
@@ -0,0 +1,35 @@
|
||||
---
|
||||
title: Atlas Cloud
|
||||
description: AIRI에서 Atlas Cloud를 채팅 제공자로 설정하기
|
||||
is_openai_compatible: true
|
||||
---
|
||||
|
||||
Atlas Cloud는 OpenAI 형식과 호환되는 채팅 API를 제공합니다. 설정을 완료한 후 **설정 → 모듈 → 의식**에서 Atlas Cloud 모델을 선택하세요.
|
||||
|
||||
::: info 왜 Atlas Cloud를 선택하나요?
|
||||
이미 Atlas Cloud API Key가 있거나 Atlas Cloud가 제공하는 모델을 사용하고 싶다면 이 서비스 제공자를 바로 선택할 수 있습니다.
|
||||
:::
|
||||
|
||||
## API Key 발급받기
|
||||
|
||||
1. [Atlas Cloud](https://www.atlascloud.ai/)에 접속해 계정을 등록하고 API Key를 생성하세요.
|
||||
2. 키를 복사해 안전한 곳에 보관하세요.
|
||||
|
||||
::: warning API Key 보안
|
||||
API Key를 커밋하거나, 스크린샷에 포함하거나, 누구와도 공유하지 마세요. 키가 유출되면 즉시 폐기하고 Atlas Cloud 콘솔에서 새 키를 만드세요.
|
||||
:::
|
||||
|
||||
## AIRI에서 설정하기
|
||||
|
||||
1. **설정 → 제공자 → 채팅 → Atlas Cloud**를 여세요.
|
||||
2. 기본 설정에 API Key를 붙여넣으세요.
|
||||
3. 기본 Base URL을 그대로 유지하세요: `https://api.atlascloud.ai/v1`.
|
||||
|
||||
## 설정 확인
|
||||
|
||||
1. **설정 유효성 검사**: AIRI는 설정을 수정하는 동안 자동으로 유효성을 검사합니다. **Ping API** 버튼이 보이면 실제 요청 테스트에 사용할 수 있습니다.
|
||||
2. **모델 선택 →**: 유효성 검사가 통과되면 이 버튼으로 **설정 → 모듈 → 의식**을 열어 제공자와 모델을 선택하세요.
|
||||
|
||||
## 문제 해결
|
||||
|
||||
API 확인이 실패하면 API Key, 사용 가능한 크레딧 또는 할당량, 요청 한도, 네트워크 연결을 확인하세요. AIRI가 모델 목록을 불러오지 못하면 **의식** 페이지에서 Atlas Cloud가 제공하는 정확한 모델 ID를 직접 입력하세요.
|
||||
@@ -0,0 +1,32 @@
|
||||
---
|
||||
title: Azure AI Foundry
|
||||
description: AIRI에서 Azure AI Foundry 채팅 모델 설정하기
|
||||
---
|
||||
|
||||
Azure AI Foundry를 사용하려면 리소스 이름, 모델 배포 정보, API Key가 필요합니다.
|
||||
|
||||
::: info 왜 Azure AI Foundry를 선택하나요?
|
||||
Azure AI Foundry에서 모델 배포와 접근 제어를 이미 완료했다면, 이 제공자를 통해 해당 배포에 직접 연결할 수 있습니다.
|
||||
:::
|
||||
|
||||
## Azure AI Foundry 리소스 준비하기
|
||||
|
||||
1. [Azure AI Foundry](https://ai.azure.com/)에 로그인한 뒤 대상 프로젝트를 만들거나 열고 API Key, 리소스 이름, 모델 배포 정보를 확인하세요.
|
||||
|
||||
::: warning API Key 보안
|
||||
Azure API Key를 커밋하거나, 스크린샷에 포함하거나, 누구와도 공유하지 마세요.
|
||||
:::
|
||||
|
||||
## AIRI에서 설정하기
|
||||
|
||||
1. **설정 → 제공자 → 채팅 → Azure AI Foundry**를 열고 **API Key**, 리소스 이름, 모델 ID를 입력하세요.
|
||||
2. 콘솔에서 특정 API 버전을 요구한다면 화면에 함께 입력하세요. 표시용 모델 이름을 배포 이름으로 착각하지 않도록 주의하세요.
|
||||
|
||||
## 설정 확인
|
||||
|
||||
1. 필수 항목을 입력하면 AIRI가 API Key, 리소스 이름, 모델 ID가 채워져 있는지 자동으로 확인합니다. 이 확인은 네트워크 연결이나 자격 증명을 테스트하지 않습니다.
|
||||
2. **설정 → 모듈 → 의식**으로 이동해 Azure AI Foundry 제공자와 배포를 선택한 뒤, 테스트 메시지를 보내 배포가 응답하는지 확인하세요.
|
||||
|
||||
## 문제 해결
|
||||
|
||||
유효성 검사가 실패하면 API Key, 리소스 이름, 배포 이름, API 버전이 모두 같은 Azure AI Foundry 프로젝트의 것인지 확인하세요. 표시용인 모델 이름이 아니라 배포 이름을 사용해야 합니다.
|
||||
@@ -0,0 +1,32 @@
|
||||
---
|
||||
title: Azure OpenAI
|
||||
description: AIRI에서 Azure OpenAI 채팅 모델 설정하기
|
||||
---
|
||||
|
||||
Azure OpenAI를 사용하면 AIRI가 여러분의 Azure 리소스 엔드포인트와 배포를 통해 모델에 접근할 수 있습니다.
|
||||
|
||||
::: info 왜 Azure OpenAI를 선택하나요?
|
||||
팀에서 이미 Azure OpenAI로 모델을 배포하고 권한을 관리하고 있다면, 가장 간단하게 도입할 수 있는 방법입니다.
|
||||
:::
|
||||
|
||||
## Azure OpenAI 리소스 준비하기
|
||||
|
||||
1. [Azure Portal](https://portal.azure.com/)에 로그인한 뒤 Azure OpenAI 리소스를 만들거나 열고 엔드포인트와 API Key를 확인하세요.
|
||||
|
||||
::: warning API Key 보안
|
||||
Azure API Key를 커밋하거나, 스크린샷에 포함하거나, 누구와도 공유하지 마세요.
|
||||
:::
|
||||
|
||||
## AIRI에서 설정하기
|
||||
|
||||
1. **설정 → 제공자 → 채팅 → Azure OpenAI**를 열고 **API Key**를 입력하세요.
|
||||
2. Azure가 제공하는 전체 Chat Completions URL을 입력하세요. AIRI가 URL에서 배포 이름과 `api-version`을 추출합니다.
|
||||
|
||||
## 설정 확인
|
||||
|
||||
1. API Key, 엔드포인트, 배포 정보를 입력한 뒤 AIRI의 자동 유효성 검사를 기다리세요.
|
||||
2. **설정 → 모듈 → 의식**으로 이동해 Azure OpenAI와 해당 배포를 선택한 뒤, 메시지를 보내 설정을 확인하세요.
|
||||
|
||||
## 문제 해결
|
||||
|
||||
유효성 검사가 실패하면 API Key, 엔드포인트, 배포 이름, `api-version`이 모두 같은 Azure OpenAI 리소스에 속하는지 확인하세요. 모델의 표시 이름이 아니라 배포 이름을 사용하세요.
|
||||
@@ -0,0 +1,32 @@
|
||||
---
|
||||
title: BytePlus Coding Plan
|
||||
description: AIRI에서 BytePlus Coding Plan 채팅 모델 설정하기
|
||||
---
|
||||
|
||||
BytePlus Coding Plan은 AIRI에서 독립된 제공자 카드로 제공됩니다.
|
||||
|
||||
::: info 왜 BytePlus Coding Plan을 선택하나요?
|
||||
BytePlus 계정에 Coding Plan이 있다면, 해당 서비스 플랜에 맞도록 일반 BytePlus 설정 대신 이 카드를 사용해야 합니다.
|
||||
:::
|
||||
|
||||
## BytePlus Coding Plan 자격 증명 준비하기
|
||||
|
||||
1. [BytePlus ModelArk 콘솔](https://console.byteplus.com/ark/region%3Aark%2Bap-southeast-1/application-center)에 로그인해 Coding Plan API Key를 발급받으세요.
|
||||
|
||||
::: warning API Key 보안
|
||||
API Key나 엔드포인트 자격 증명을 커밋하거나, 스크린샷에 포함하거나, 누구와도 공유하지 마세요.
|
||||
:::
|
||||
|
||||
## AIRI에서 설정하기
|
||||
|
||||
1. **설정 → 제공자 → 채팅 → BytePlus Coding Plan**을 열고 API Key를 입력하세요.
|
||||
2. Coding Plan 문서에서 다른 호환 API 루트를 안내하지 않는 한 기본 **Base URL**을 유지하세요. 모델은 AIRI의 정적 제공자 목록에서 가져옵니다. 이 폼에는 Endpoint ID나 모델 입력란이 없습니다.
|
||||
|
||||
## 설정 확인
|
||||
|
||||
1. **설정 유효성 검사**: AIRI는 설정을 수정하는 동안 자동으로 유효성을 검사합니다. **Ping API** 버튼이 보이면 실제 요청 테스트에 사용할 수 있습니다.
|
||||
2. **모델 선택 →**: 유효성 검사가 통과되면 이 버튼으로 **설정 → 모듈 → 의식**을 열어 사용 가능한 모델을 선택하세요.
|
||||
|
||||
## 문제 해결
|
||||
|
||||
유효성 검사가 실패하면 API Key가 활성화된 BytePlus Coding Plan의 것인지, Base URL이 올바른지 확인하세요. 목록에 있는 모델이 거부되면 플랜에 해당 모델 접근 권한이 있는지 확인하세요.
|
||||
@@ -0,0 +1,32 @@
|
||||
---
|
||||
title: BytePlus
|
||||
description: AIRI에서 BytePlus 채팅 모델 설정하기
|
||||
---
|
||||
|
||||
BytePlus는 AIRI에서 Ark 호환 채팅 서비스 설정을 사용합니다.
|
||||
|
||||
::: info 왜 BytePlus를 선택하나요?
|
||||
BytePlus 계정에 Ark API 접근 권한이 있다면 이 제공자를 사용하세요.
|
||||
:::
|
||||
|
||||
## BytePlus 자격 증명 준비하기
|
||||
|
||||
1. [BytePlus ModelArk 콘솔](https://console.byteplus.com/ark/region%3Aark%2Bap-southeast-1/apikey)에 로그인해 API Key를 생성하세요.
|
||||
|
||||
::: warning API Key 보안
|
||||
API Key나 엔드포인트 자격 증명을 커밋하거나, 스크린샷에 포함하거나, 누구와도 공유하지 마세요.
|
||||
:::
|
||||
|
||||
## AIRI에서 설정하기
|
||||
|
||||
1. **설정 → 제공자 → 채팅 → BytePlus**를 열고 API Key를 입력하세요.
|
||||
2. BytePlus 문서에서 다른 호환 API 루트를 안내하지 않는 한 기본 Base URL을 유지하세요. 모델은 AIRI의 제공자 목록에서 선택합니다. 이 폼에는 Endpoint ID나 모델 입력란이 없습니다.
|
||||
|
||||
## 설정 확인
|
||||
|
||||
1. **설정 유효성 검사**: AIRI는 설정을 수정하는 동안 자동으로 유효성을 검사합니다. **Ping API** 버튼이 보이면 실제 요청 테스트에 사용할 수 있습니다.
|
||||
2. **모델 선택 →**: 유효성 검사가 통과되면 이 버튼으로 **설정 → 모듈 → 의식**을 열어 제공자와 모델을 선택하세요.
|
||||
|
||||
## 문제 해결
|
||||
|
||||
유효성 검사가 실패하면 API Key, Base URL, 계정 접근 권한, 네트워크 연결을 확인하세요. 모델을 사용할 수 없다면 제공자가 노출하는 목록에서 모델을 선택하세요.
|
||||
@@ -0,0 +1,31 @@
|
||||
---
|
||||
title: Cerebras
|
||||
description: AIRI에서 Cerebras 채팅 모델 설정하기
|
||||
---
|
||||
|
||||
Cerebras는 호환 API를 통해 AIRI에서 채팅 모델을 제공합니다.
|
||||
|
||||
::: info 왜 Cerebras인가요?
|
||||
이미 Cerebras API를 사용 중이고 계정에서 사용할 수 있는 모델을 AIRI에서 이용하고 싶다면 Cerebras를 선택하세요.
|
||||
:::
|
||||
|
||||
## API Key 발급받기
|
||||
|
||||
[Cerebras Cloud](https://cloud.cerebras.ai/)에 로그인한 뒤 API Key를 생성하세요.
|
||||
|
||||
::: warning API Key 보안
|
||||
API Key를 커밋하거나, 스크린샷에 포함하거나, 누구와도 공유하지 마세요.
|
||||
:::
|
||||
|
||||
## AIRI에서 설정하기
|
||||
|
||||
**설정 → 제공자 → 채팅 → Cerebras**를 열고 **API Key**를 입력하세요. 기본 Base URL은 `https://api.cerebras.ai/v1/`입니다.
|
||||
|
||||
## 설정 확인
|
||||
|
||||
1. **설정 유효성 검사**: AIRI는 설정을 수정하는 동안 자동으로 유효성을 검사합니다. **Ping API** 버튼이 보이면 실제 요청 테스트에 사용할 수 있습니다.
|
||||
2. **모델 선택 →**: 유효성 검사가 통과되면 이 버튼으로 **설정 → 모듈 → 의식**을 열어 제공자와 모델을 선택하세요.
|
||||
|
||||
## 문제 해결
|
||||
|
||||
API 확인이 실패하면 API Key, 계정 상태, 네트워크 연결을 확인하세요. AIRI가 모델 목록을 불러오지 못한다면 Base URL이 변경되지 않았는지 확인하거나, **의식** 페이지에서 Cerebras가 제공하는 정확한 모델 ID를 직접 입력하세요.
|
||||
@@ -0,0 +1,35 @@
|
||||
---
|
||||
title: Cloudflare Workers AI
|
||||
description: AIRI에서 Cloudflare Workers AI 채팅 모델 설정하기
|
||||
---
|
||||
|
||||
Cloudflare Workers AI는 계정 수준의 자격 증명을 사용합니다. AIRI는 API Token 외에도 Workers AI 리소스를 찾기 위한 Cloudflare Account ID가 필요합니다.
|
||||
|
||||
::: info 왜 Cloudflare Workers AI를 선택하나요?
|
||||
Cloudflare 계정으로 지원되는 Workers AI 모델을 실행하려면 이 제공자를 사용하세요.
|
||||
:::
|
||||
|
||||
## 자격 증명 준비하기
|
||||
|
||||
1. [Cloudflare API Tokens](https://dash.cloudflare.com/profile/api-tokens)를 열고 Workers AI 접근 권한이 있는 API 토큰을 만드세요.
|
||||
2. Token을 복사하세요.
|
||||
3. [Cloudflare 콘솔](https://dash.cloudflare.com/)에서 Account ID를 찾아 복사하세요.
|
||||
|
||||
::: warning 안전 주의사항
|
||||
API Token은 계정 권한에 바인딩됩니다. 최소 권한 원칙에 따라 AIRI에 필요한 Workers AI 권한만 부여하세요. Token이나 Account ID를 공개 로그에 포함하지 마세요.
|
||||
:::
|
||||
|
||||
## AIRI에서 설정하기
|
||||
|
||||
1. **설정 → 제공자 → 채팅 → Cloudflare Workers AI**를 여세요.
|
||||
2. **API Token**과 **Account ID**를 입력하세요.
|
||||
|
||||
## 설정 확인
|
||||
|
||||
1. AIRI의 자동 필수 필드 검사가 통과될 때까지 기다리세요. 이 검사는 두 필드에 값이 있는지만 확인하며, Cloudflare에 접속하거나 자격 증명을 검증하지는 않습니다.
|
||||
2. **모델 선택 →** 버튼을 클릭해 **설정 → 모듈 → 의식**을 열고 Cloudflare Workers AI와 사용 가능한 모델을 선택하세요.
|
||||
3. 채팅으로 돌아가 테스트 메시지를 보내세요. 응답이 성공하면 Account ID, API Token 권한, 선택한 모델이 함께 정상 동작하는 것입니다.
|
||||
|
||||
## 문제 해결
|
||||
|
||||
필수 필드 검사가 실패하면 **API Token**과 **Account ID**에 모두 값이 있는지 확인하세요. 테스트 메시지가 실패하면 Token에 Workers AI 권한이 있는지, 그리고 Account ID와 같은 Cloudflare 계정에 속하는지 확인하세요. 이 제공자는 편집 가능한 Base URL을 사용하지 않으므로 Worker URL이나 API 경로를 입력하지 마세요.
|
||||
@@ -0,0 +1,31 @@
|
||||
---
|
||||
title: CometAPI
|
||||
description: AIRI에서 CometAPI 채팅 모델 설정하기
|
||||
---
|
||||
|
||||
CometAPI는 AIRI에서 채팅 모델을 제공하며, 독립적인 TTS·STT 서비스 제공자 페이지도 있습니다.
|
||||
|
||||
::: info 왜 CometAPI를 선택하나요?
|
||||
같은 CometAPI 계정으로 채팅, 음성 합성, 음성 인식을 함께 설정하고 싶다면 이 제공자를 선택할 수 있습니다.
|
||||
:::
|
||||
|
||||
## API Key 발급받기
|
||||
|
||||
1. [CometAPI 콘솔](https://www.cometapi.com/console/token)에 로그인한 다음 API Key를 만드세요.
|
||||
|
||||
::: warning API Key 보안
|
||||
API Key를 커밋하거나, 스크린샷에 포함하거나, 누구와도 공유하지 마세요.
|
||||
:::
|
||||
|
||||
## AIRI에서 설정하기
|
||||
|
||||
1. **설정 → 제공자 → 채팅 → Comet API**를 열고 **API Key**를 입력하세요. 기본 Base URL은 `https://api.cometapi.com/v1/`입니다.
|
||||
|
||||
## 설정 확인
|
||||
|
||||
1. **설정 유효성 검사**: AIRI는 설정을 수정하는 동안 자동으로 유효성을 검사합니다. **Ping API** 버튼이 보이면 실제 요청 테스트에 사용할 수 있습니다.
|
||||
2. **모델 선택 →**: 유효성 검사가 통과되면 이 버튼으로 **설정 → 모듈 → 의식**을 열어 제공자와 모델을 선택하세요.
|
||||
|
||||
## 문제 해결
|
||||
|
||||
제공자 유효성 검사가 실패하면 API Key, 사용 가능한 크레딧 또는 할당량, 요청 한도, 네트워크 연결을 확인하세요. 모델 목록을 불러오지 못하면 Base URL이 기본값 그대로인지 확인하거나, 의식 페이지에서 CometAPI가 제공하는 정확한 모델 ID를 입력하세요.
|
||||
@@ -0,0 +1,36 @@
|
||||
---
|
||||
title: DeepSeek
|
||||
description: AIRI에서 DeepSeek을 채팅 제공자로 설정하기
|
||||
is_openai_compatible: true
|
||||
---
|
||||
|
||||
DeepSeek은 OpenAI 형식과 호환되는 채팅 API를 제공합니다. 이 페이지의 설정을 마치면 AIRI는 의식에서 DeepSeek이 제공하는 모델을 사용할 수 있습니다.
|
||||
|
||||
::: info 왜 DeepSeek을 선택하나요?
|
||||
AIRI에서 DeepSeek 모델을 사용하고 싶거나 이미 DeepSeek API Key가 있다면 이 서비스 제공자를 바로 선택할 수 있습니다.
|
||||
:::
|
||||
|
||||
## API Key 발급받기
|
||||
|
||||
1. [DeepSeek 관리 콘솔](https://platform.deepseek.com/)을 여세요.
|
||||
2. API Keys 페이지에서 새 API Key를 만드세요.
|
||||
3. 키를 복사해 안전한 곳에 보관하세요.
|
||||
|
||||
::: warning API Key 보안
|
||||
API Key를 커밋하거나, 스크린샷에 포함하거나, 누구와도 공유하지 마세요. 키가 유출되면 즉시 폐기하고 DeepSeek 콘솔에서 새 키를 만드세요.
|
||||
:::
|
||||
|
||||
## AIRI에서 설정하기
|
||||
|
||||
1. **설정 → 제공자 → 채팅 → DeepSeek**을 여세요.
|
||||
2. 기본 설정에 API Key를 붙여넣으세요.
|
||||
3. 기본 Base URL을 유지하세요: `https://api.deepseek.com/`.
|
||||
|
||||
## 설정 확인
|
||||
|
||||
1. **설정 유효성 검사**: AIRI는 설정을 수정하는 동안 자동으로 유효성을 검사합니다. **Ping API** 버튼이 보이면 실제 요청 테스트에 사용할 수 있습니다.
|
||||
2. **모델 선택 →**: 유효성 검사가 통과되면 이 버튼으로 **설정 → 모듈 → 의식**을 열어 제공자와 모델을 선택하세요.
|
||||
|
||||
## 문제 해결
|
||||
|
||||
API 확인이 실패하면 API Key, 사용 가능한 크레딧 또는 할당량, 요청 한도, 네트워크 연결을 확인하세요. AIRI가 모델 목록을 불러오지 못하면 **의식** 페이지에서 DeepSeek이 제공하는 정확한 모델 ID를 직접 입력하세요.
|
||||
@@ -0,0 +1,31 @@
|
||||
---
|
||||
title: Featherless AI
|
||||
description: AIRI에서 Featherless.ai 채팅 모델 설정하기
|
||||
---
|
||||
|
||||
Featherless.ai는 호환 API를 통해 AIRI에서 채팅 모델을 제공합니다.
|
||||
|
||||
::: info 왜 Featherless.ai를 선택하나요?
|
||||
Featherless.ai에서 모델 접근 권한을 열어 두었다면 해당 API Key로 AIRI를 바로 설정할 수 있습니다.
|
||||
:::
|
||||
|
||||
## API Key 발급받기
|
||||
|
||||
1. [Featherless.ai](https://featherless.ai/)에 로그인한 다음 계정 콘솔에서 API Key를 만드세요.
|
||||
|
||||
::: warning API Key 보안
|
||||
API Key를 커밋하거나, 스크린샷에 포함하거나, 누구와도 공유하지 마세요.
|
||||
:::
|
||||
|
||||
## AIRI에서 설정하기
|
||||
|
||||
1. **설정 → 제공자 → 채팅 → Featherless AI**를 열고 **API Key**를 입력하세요. 기본 Base URL은 `https://api.featherless.ai/v1/`입니다.
|
||||
|
||||
## 설정 확인
|
||||
|
||||
1. **설정 유효성 검사**: AIRI는 설정을 수정하는 동안 자동으로 유효성을 검사합니다. **Ping API** 버튼이 보이면 실제 요청 테스트에 사용할 수 있습니다.
|
||||
2. **모델 선택 →**: 유효성 검사가 통과되면 이 버튼으로 **설정 → 모듈 → 의식**을 열어 제공자와 모델을 선택하세요.
|
||||
|
||||
## 문제 해결
|
||||
|
||||
API 검사가 실패하면 API Key, 계정 상태, 네트워크 연결을 확인하세요. AIRI가 모델 목록을 불러오지 못하면 Base URL이 변경되지 않았는지 확인하거나 **의식** 페이지에서 Featherless.ai가 제공하는 정확한 모델 ID를 직접 입력하세요.
|
||||
@@ -0,0 +1,36 @@
|
||||
---
|
||||
title: Fireworks AI
|
||||
description: AIRI에서 Fireworks AI를 채팅 제공자로 설정하기
|
||||
is_openai_compatible: true
|
||||
---
|
||||
|
||||
Fireworks AI는 OpenAI 형식과 호환되는 채팅 API를 제공합니다. 이 페이지의 설정을 마치면 AIRI는 의식에서 Fireworks AI가 제공하는 모델을 사용할 수 있습니다.
|
||||
|
||||
::: info 왜 Fireworks AI를 선택하나요?
|
||||
이미 Fireworks AI에서 모델이나 추론 서비스를 관리하고 있다면 같은 API 자격 증명을 그대로 재사용할 수 있습니다.
|
||||
:::
|
||||
|
||||
## API Key 발급받기
|
||||
|
||||
1. [Fireworks AI 온보딩 가이드](https://docs.fireworks.ai/getting-started/onboarding)를 따라 API Key를 만드세요.
|
||||
2. 새 API Key를 만드세요.
|
||||
3. 키를 복사해 안전한 곳에 보관하세요.
|
||||
|
||||
::: warning API Key 보안
|
||||
API Key를 커밋하거나, 스크린샷에 포함하거나, 누구와도 공유하지 마세요. 키가 유출되면 즉시 폐기하고 Fireworks AI 콘솔에서 새 키를 만드세요.
|
||||
:::
|
||||
|
||||
## AIRI에서 설정하기
|
||||
|
||||
1. **설정 → 제공자 → 채팅 → Fireworks.ai**를 여세요.
|
||||
2. 기본 설정에 API Key를 붙여넣으세요.
|
||||
3. 기본 Base URL을 유지하세요: `https://api.fireworks.ai/inference/v1/`.
|
||||
|
||||
## 설정 확인
|
||||
|
||||
1. **설정 유효성 검사**: AIRI는 설정을 수정하는 동안 자동으로 유효성을 검사합니다. **Ping API** 버튼이 보이면 실제 요청 테스트에 사용할 수 있습니다.
|
||||
2. **모델 선택 →**: 유효성 검사가 통과되면 이 버튼으로 **설정 → 모듈 → 의식**을 열어 제공자와 모델을 선택하세요.
|
||||
|
||||
## 문제 해결
|
||||
|
||||
API 확인이 실패하면 API Key, 사용 가능한 크레딧 또는 할당량, 요청 한도, 네트워크 연결을 확인하세요. AIRI가 모델 목록을 불러오지 못하면 **의식** 페이지에서 Fireworks AI가 제공하는 정확한 모델 ID를 직접 입력하세요.
|
||||
@@ -0,0 +1,35 @@
|
||||
---
|
||||
title: Google Gemini
|
||||
description: AIRI에서 Google Gemini 채팅 모델 설정하기
|
||||
---
|
||||
|
||||
Google Gemini 제공자는 Google Generative Language API의 OpenAI 호환 엔드포인트를 사용합니다. 설정을 완료한 후 **설정 → 모듈 → 의식**에서 Gemini 모델을 선택하세요.
|
||||
|
||||
::: info 왜 Google Gemini를 선택하나요?
|
||||
이미 Gemini API Key가 있거나 AIRI에서 Gemini 모델을 사용하고 싶다면 이 서비스 제공자를 선택할 수 있습니다.
|
||||
:::
|
||||
|
||||
## API Key 생성하기
|
||||
|
||||
1. [Google AI Studio API Keys](https://aistudio.google.com/app/apikey)에 로그인한 뒤 Gemini API Key를 생성하세요.
|
||||
2. 키가 속한 프로젝트에서 Gemini API가 활성화되어 있고 대상 모델을 사용할 수 있는지 확인하세요.
|
||||
3. API Key를 복사하세요.
|
||||
|
||||
::: warning API Key 보안
|
||||
키가 유출되면 Google AI 개발자 콘솔에서 즉시 폐기하고 다시 생성하세요. 키를 코드, 스크린샷, 공개 설정 파일에 넣지 마세요.
|
||||
:::
|
||||
|
||||
## AIRI에서 설정하기
|
||||
|
||||
1. **설정 → 제공자 → 채팅 → Google Gemini**를 여세요.
|
||||
2. API Key를 입력하세요.
|
||||
3. 기본 Base URL을 유지하세요: `https://generativelanguage.googleapis.com/v1beta/openai/`.
|
||||
|
||||
## 설정 확인
|
||||
|
||||
1. **설정 유효성 검사**: AIRI는 설정을 수정하는 동안 자동으로 유효성을 검사합니다. **Ping API** 버튼이 보이면 실제 요청 테스트에 사용할 수 있습니다.
|
||||
2. **모델 선택 →**: 유효성 검사가 통과되면 이 버튼으로 **설정 → 모듈 → 의식**을 열어 제공자와 모델을 선택하세요.
|
||||
|
||||
## 문제 해결
|
||||
|
||||
제공자 유효성 검사는 연결 상태, 모델 목록, 채팅 요청을 확인합니다. AIRI가 권한 오류나 사용할 수 없는 모델을 보고하면, API Key가 속한 프로젝트에서 Gemini API가 활성화되어 있는지, 해당 프로젝트의 리전에서 모델을 사용할 수 있는지 확인하세요. Google AI Studio에 표시된 이름을 고쳐 쓰지 말고 AIRI에 반환된 모델 이름을 사용하세요.
|
||||
@@ -0,0 +1,36 @@
|
||||
---
|
||||
title: Groq
|
||||
description: AIRI에서 Groq를 채팅 제공자로 설정하기
|
||||
is_openai_compatible: true
|
||||
---
|
||||
|
||||
Groq는 OpenAI 형식과 호환되는 채팅 API를 제공합니다. 이 페이지의 설정을 완료하면 AIRI가 의식에서 Groq가 제공하는 모델을 사용할 수 있습니다.
|
||||
|
||||
::: info 왜 Groq를 선택하나요?
|
||||
대화 응답 속도를 중시하고 대상 모델을 Groq에서 사용할 수 있다면 이 제공자를 사용해 보세요.
|
||||
:::
|
||||
|
||||
## API Key 발급받기
|
||||
|
||||
1. [Groq Console](https://console.groq.com/)을 여세요.
|
||||
2. API Keys 페이지에서 새 API Key를 생성하세요.
|
||||
3. 키를 복사해 안전한 곳에 보관하세요.
|
||||
|
||||
::: warning API Key 보안
|
||||
API Key를 커밋하거나, 스크린샷에 포함하거나, 누구와도 공유하지 마세요. 키가 유출되면 즉시 폐기하고 Groq 콘솔에서 새 키를 만드세요.
|
||||
:::
|
||||
|
||||
## AIRI에서 설정하기
|
||||
|
||||
1. **설정 → 제공자 → 채팅 → Groq**를 여세요.
|
||||
2. 기본 설정에 API Key를 붙여넣으세요.
|
||||
3. 기본 Base URL을 유지하세요: `https://api.groq.com/openai/v1/`.
|
||||
|
||||
## 설정 확인
|
||||
|
||||
1. **설정 유효성 검사**: AIRI는 설정을 수정하는 동안 자동으로 유효성을 검사합니다. **Ping API** 버튼이 보이면 실제 요청 테스트에 사용할 수 있습니다.
|
||||
2. **모델 선택 →**: 유효성 검사가 통과되면 이 버튼으로 **설정 → 모듈 → 의식**을 열어 제공자와 모델을 선택하세요.
|
||||
|
||||
## 문제 해결
|
||||
|
||||
API 확인이 실패하면 API Key, 사용 가능한 크레딧 또는 할당량, 요청 한도, 네트워크 연결을 확인하세요. AIRI가 모델 목록을 불러오지 못하면 **의식** 페이지에서 Groq가 제공하는 정확한 모델 ID를 직접 입력하세요.
|
||||
@@ -0,0 +1,31 @@
|
||||
---
|
||||
title: LM Studio (로컬 모델)
|
||||
description: 로컬 LM Studio 서비스로 AIRI 채팅 모델 설정하기
|
||||
---
|
||||
|
||||
LM Studio는 모델을 로컬에서 직접 실행하고 자체 API를 제공합니다. 자신의 기기에서 모델을 실행하려는 사용자에게 적합하며, 기본적으로 API Key가 필요하지 않습니다.
|
||||
|
||||
::: info 왜 LM Studio를 선택하나요?
|
||||
모델을 로컬에서 실행하고 모델 파일을 직접 관리하고 싶다면, LM Studio는 클라우드 API Key에 의존하지 않는 선택지입니다.
|
||||
:::
|
||||
|
||||
## 로컬 서비스 시작하기
|
||||
|
||||
1. [LM Studio 다운로드 페이지](https://lmstudio.ai/download)에서 LM Studio를 설치하고 실행한 뒤, 채팅 모델을 다운로드해 로드하세요.
|
||||
2. **Local Server**를 열고 로컬 서버를 시작하세요.
|
||||
3. AIRI가 로컬 서비스에 접근하지 못하면 LM Studio의 서버 설정에서 CORS를 활성화하세요.
|
||||
|
||||
## AIRI에서 설정하기
|
||||
|
||||
1. **설정 → 제공자 → 채팅 → LM Studio**를 여세요.
|
||||
2. 기본 Base URL을 유지하세요: `http://localhost:1234/v1/`.
|
||||
3. LM Studio 서비스에 인증이 필요하면 API Key를 입력하고, 그렇지 않으면 비워 두세요.
|
||||
|
||||
## 설정 확인
|
||||
|
||||
1. **설정 유효성 검사**: AIRI는 설정을 수정하는 동안 자동으로 유효성을 검사합니다. **Ping API** 버튼이 보이면 실제 요청 테스트에 사용할 수 있습니다.
|
||||
2. **모델 선택 →**: 유효성 검사가 통과되면 이 버튼으로 **설정 → 모듈 → 의식**을 열어 로드된 모델을 선택하세요.
|
||||
|
||||
## 문제 해결
|
||||
|
||||
연결할 수 없을 때는 먼저 Local Server가 실행 중인지, 포트가 Base URL과 일치하는지 확인하세요. AIRI와 LM Studio가 같은 기기에 있지 않다면 AIRI 기기에서 접근할 수 있는 LAN 주소를 사용하고, 신뢰할 수 있는 네트워크에서만 서비스를 여세요.
|
||||
@@ -0,0 +1,31 @@
|
||||
---
|
||||
title: Xiaomi MiMo
|
||||
description: AIRI에서 Xiaomi MiMo 채팅 모델 설정하기
|
||||
---
|
||||
|
||||
Xiaomi MiMo는 AIRI에서 채팅 모델을 제공하며, TTS와 STT는 별도의 서비스 제공자 페이지가 있습니다.
|
||||
|
||||
::: info 왜 Xiaomi MiMo를 선택하나요?
|
||||
같은 MiMo 계정으로 채팅과 오디오 기능을 함께 사용하고 싶다면 이 제공자를 선택할 수 있습니다.
|
||||
:::
|
||||
|
||||
## API Key 발급받기
|
||||
|
||||
1. [Xiaomi MiMo Platform](https://platform.xiaomimimo.com/)에 로그인한 뒤 API Key를 생성하세요.
|
||||
|
||||
::: warning API Key 보안
|
||||
API Key를 커밋하거나, 스크린샷에 포함하거나, 누구와도 공유하지 마세요.
|
||||
:::
|
||||
|
||||
## AIRI에서 설정하기
|
||||
|
||||
1. **설정 → 제공자 → 채팅 → Xiaomi MiMo**를 열고 **API Key**를 입력하세요. 기본 Base URL은 `https://api.xiaomimimo.com/v1/`입니다.
|
||||
|
||||
## 설정 확인
|
||||
|
||||
1. **설정 유효성 검사**: AIRI는 설정을 수정하는 동안 자동으로 유효성을 검사합니다. **Ping API** 버튼이 보이면 실제 요청 테스트에 사용할 수 있습니다.
|
||||
2. **모델 선택 →**: 유효성 검사가 통과되면 이 버튼으로 **설정 → 모듈 → 의식**을 열어 제공자와 모델을 선택하세요.
|
||||
|
||||
## 문제 해결
|
||||
|
||||
API 확인이 실패하면 API Key, 계정 상태, 네트워크 연결을 확인하세요. AIRI가 모델 목록을 불러오지 못하면 Base URL이 변경되지 않았는지 확인하거나, **의식** 페이지에서 Xiaomi MiMo가 제공하는 정확한 모델 ID를 직접 입력하세요.
|
||||
@@ -0,0 +1,37 @@
|
||||
---
|
||||
title: MiniMax Global
|
||||
description: MiniMax 해외 버전을 AIRI의 채팅 제공자로 설정하기
|
||||
is_openai_compatible: true
|
||||
---
|
||||
|
||||
이 페이지는 MiniMax 해외 플랫폼에서 생성한 API Key에 적용됩니다. 설정을 마치면 AIRI는 의식에서 MiniMax Global이 제공하는 채팅 모델을 사용할 수 있습니다.
|
||||
|
||||
::: info 왜 MiniMax Global을 선택하나요?
|
||||
MiniMax 해외 플랫폼에서 API Key를 생성했거나 해외 Token Plan을 사용한다면 MiniMax Global을 선택해야 합니다. 중국 본토 플랫폼에서 생성한 Key는 [MiniMax (중국 본토)](./minimax.md)를 사용하세요. 두 플랫폼의 API Key, 과금, Base URL은 섞어 쓸 수 없습니다.
|
||||
:::
|
||||
|
||||
## API Key 발급받기
|
||||
|
||||
1. [MiniMax Global 플랫폼](https://platform.minimax.io/)에 로그인하세요.
|
||||
2. **API Keys**에서 종량제 API Key를 생성하세요. Token Plan을 사용한다면 해당 구독 페이지에서 전용 Key를 발급받으세요.
|
||||
3. 키를 복사해 안전한 곳에 보관하세요.
|
||||
|
||||
::: warning API Key 보안
|
||||
API Key를 커밋하거나, 스크린샷에 포함하거나, 누구와도 공유하지 마세요. 키가 유출되면 즉시 폐기하고 MiniMax Global 플랫폼에서 새 키를 만드세요.
|
||||
:::
|
||||
|
||||
## AIRI에서 설정하기
|
||||
|
||||
1. **설정 → 제공자 → 채팅 → MiniMax Global**을 여세요.
|
||||
2. 기본 설정에 API Key를 붙여 넣으세요.
|
||||
3. 기본 Base URL인 `https://api.minimax.io/v1/`를 유지하세요.
|
||||
|
||||
## 설정 확인
|
||||
|
||||
1. **설정 유효성 검사**: AIRI는 설정을 수정하는 동안 자동으로 유효성을 검사합니다. **Ping API** 버튼이 보이면 실제 요청 테스트에 사용할 수 있습니다.
|
||||
2. **모델 선택 →**: 유효성 검사가 통과되면 이 버튼으로 **설정 → 모듈 → 의식**을 열어 제공자와 모델을 선택하세요.
|
||||
3. **설정 → 모듈 → 의식**에서 MiniMax Global과 모델을 선택한 뒤, 짧은 메시지를 보내 AIRI가 응답하는지 확인하세요.
|
||||
|
||||
## 문제 해결
|
||||
|
||||
API 확인이 실패하면 API Key가 글로벌 플랫폼에서 발급된 것인지, Base URL이 `https://api.minimax.io/v1/`인지, 계정에 사용 가능한 크레딧이나 할당량이 있는지, 요청 제한에 걸리지 않았는지, 네트워크에서 서비스에 접근할 수 있는지 확인하세요. `401` 응답은 대개 중국 본토 키를 글로벌 엔드포인트에 사용했거나 그 반대인 경우를 의미합니다. AIRI가 모델 목록을 불러오지 못하면 **의식** 페이지에서 MiniMax Global의 정확한 모델 ID를 직접 입력하세요.
|
||||
@@ -0,0 +1,36 @@
|
||||
---
|
||||
title: MiniMax (중국 본토)
|
||||
description: AIRI에서 중국 본토 버전 MiniMax를 채팅 제공자로 설정하기
|
||||
is_openai_compatible: true
|
||||
---
|
||||
|
||||
이 페이지는 중국 본토 MiniMax 오픈 플랫폼에서 생성한 API Key에 적용됩니다. MiniMax는 OpenAI 형식과 호환되는 채팅 API를 제공하며, 설정을 완료하면 AIRI가 의식에서 해당 모델을 사용할 수 있습니다.
|
||||
|
||||
::: info 왜 MiniMax를 선택하나요?
|
||||
중국 본토 MiniMax 오픈 플랫폼에서 API Key를 생성했다면 이 서비스 제공자를 선택하세요. 해외 플랫폼에서 생성한 키는 [MiniMax Global](./minimax-global.md)을 사용하세요.
|
||||
:::
|
||||
|
||||
## API Key 발급받기
|
||||
|
||||
1. [MiniMax Console](https://platform.minimaxi.com/)을 여세요.
|
||||
2. API Keys 페이지에서 새 API Key를 생성하세요.
|
||||
3. 키를 복사해 안전한 곳에 보관하세요.
|
||||
|
||||
::: warning API Key 보안
|
||||
API Key를 커밋하거나, 스크린샷에 포함하거나, 누구와도 공유하지 마세요. 키가 유출되면 즉시 폐기하고 MiniMax 콘솔에서 새 키를 만드세요.
|
||||
:::
|
||||
|
||||
## AIRI에서 설정하기
|
||||
|
||||
1. **설정 → 제공자 → 채팅 → MiniMax**를 여세요.
|
||||
2. 기본 설정에 API Key를 붙여넣으세요.
|
||||
3. 기본 Base URL을 유지하세요: `https://api.minimaxi.com/v1/`. 중국 본토 플랫폼과 해외 플랫폼의 API Key, 과금, Base URL은 섞어 쓸 수 없습니다.
|
||||
|
||||
## 설정 확인
|
||||
|
||||
1. **설정 유효성 검사**: AIRI는 설정을 수정하는 동안 자동으로 유효성을 검사합니다. **Ping API** 버튼이 보이면 실제 요청 테스트에 사용할 수 있습니다.
|
||||
2. **모델 선택 →**: 유효성 검사가 통과되면 이 버튼으로 **설정 → 모듈 → 의식**을 열어 제공자와 모델을 선택하세요.
|
||||
|
||||
## 문제 해결
|
||||
|
||||
API 확인이 실패하면 API Key, 사용 가능한 크레딧 또는 할당량, 요청 한도, 네트워크 연결을 확인하세요. AIRI가 모델 목록을 불러오지 못하면 **의식** 페이지에서 MiniMax가 제공하는 정확한 모델 ID를 직접 입력하세요.
|
||||
@@ -0,0 +1,36 @@
|
||||
---
|
||||
title: Mistral
|
||||
description: AIRI에서 Mistral을 채팅 제공자로 설정하기
|
||||
is_openai_compatible: true
|
||||
---
|
||||
|
||||
Mistral은 OpenAI 형식과 호환되는 채팅 API를 제공합니다. 이 페이지의 설정을 마치면 AIRI는 의식에서 Mistral이 제공하는 모델을 사용할 수 있습니다.
|
||||
|
||||
::: info 왜 Mistral을 선택하나요?
|
||||
이미 Mistral 모델을 사용하고 있거나 AIRI에서 Mistral의 다국어 모델을 사용해 보고 싶다면 이 제공자를 선택할 수 있습니다.
|
||||
:::
|
||||
|
||||
## API Key 발급받기
|
||||
|
||||
1. [Mistral Console](https://console.mistral.ai/)을 여세요.
|
||||
2. API Keys 페이지에서 새 API Key를 생성하세요.
|
||||
3. 키를 복사해 안전한 곳에 보관하세요.
|
||||
|
||||
::: warning API Key 보안
|
||||
API Key를 커밋하거나, 스크린샷에 포함하거나, 누구와도 공유하지 마세요. 키가 유출되면 즉시 폐기하고 Mistral 콘솔에서 새 키를 만드세요.
|
||||
:::
|
||||
|
||||
## AIRI에서 설정하기
|
||||
|
||||
1. **설정 → 제공자 → 채팅 → Mistral**을 여세요.
|
||||
2. 기본 설정에 API Key를 붙여 넣으세요.
|
||||
3. 기본 Base URL인 `https://api.mistral.ai/v1/`를 유지하세요.
|
||||
|
||||
## 설정 확인
|
||||
|
||||
1. **설정 유효성 검사**: AIRI는 설정을 수정하는 동안 자동으로 유효성을 검사합니다. **Ping API** 버튼이 보이면 실제 요청 테스트에 사용할 수 있습니다.
|
||||
2. **모델 선택 →**: 유효성 검사가 통과되면 이 버튼으로 **설정 → 모듈 → 의식**을 열어 제공자와 모델을 선택하세요.
|
||||
|
||||
## 문제 해결
|
||||
|
||||
API 확인이 실패하면 API Key, 사용 가능한 크레딧 또는 할당량, 요청 한도, 네트워크 연결을 확인하세요. AIRI가 모델 목록을 불러오지 못하면 **의식** 페이지에서 Mistral이 제공하는 정확한 모델 ID를 직접 입력하세요.
|
||||
@@ -0,0 +1,31 @@
|
||||
---
|
||||
title: ModelScope
|
||||
description: AIRI에서 ModelScope 채팅 모델 설정하기
|
||||
---
|
||||
|
||||
ModelScope는 추론 API를 통해 AIRI에서 채팅 모델을 제공합니다.
|
||||
|
||||
::: info 왜 ModelScope를 선택하나요?
|
||||
ModelScope에서 모델 접근 권한을 관리하고 있다면, 이 카드에 해당 API Key를 바로 입력해 사용하세요.
|
||||
:::
|
||||
|
||||
## API Key 발급받기
|
||||
|
||||
1. [ModelScope](https://modelscope.cn/)에 로그인한 뒤, 계정 콘솔에서 API Key를 생성하세요.
|
||||
|
||||
::: warning API Key 보안
|
||||
API Key를 커밋하거나, 스크린샷에 포함하거나, 누구와도 공유하지 마세요.
|
||||
:::
|
||||
|
||||
## AIRI에서 설정하기
|
||||
|
||||
1. **설정 → 제공자 → 채팅 → ModelScope**를 열고 **API Key**를 입력하세요. 기본 Base URL은 `https://api-inference.modelscope.cn/v1/`입니다.
|
||||
|
||||
## 설정 확인
|
||||
|
||||
1. **설정 유효성 검사**: AIRI는 설정을 수정하는 동안 자동으로 유효성을 검사합니다. **Ping API** 버튼이 보이면 실제 요청 테스트에 사용할 수 있습니다.
|
||||
2. **모델 선택 →**: 유효성 검사가 통과되면 이 버튼으로 **설정 → 모듈 → 의식**을 열어 제공자와 모델을 선택하세요.
|
||||
|
||||
## 문제 해결
|
||||
|
||||
API 확인이 실패하면 API Key, 계정 상태, 네트워크 연결을 확인하세요. AIRI가 모델 목록을 불러오지 못하면 Base URL이 변경되지 않았는지 확인하거나, **의식** 페이지에서 ModelScope가 제공하는 정확한 모델 ID를 직접 입력하세요.
|
||||
@@ -0,0 +1,36 @@
|
||||
---
|
||||
title: Moonshot AI
|
||||
description: AIRI에서 Moonshot AI를 채팅 제공자로 설정하기
|
||||
is_openai_compatible: true
|
||||
---
|
||||
|
||||
Moonshot AI는 OpenAI 형식과 호환되는 채팅 API를 제공합니다. 이 페이지의 설정을 마치면 AIRI는 의식에서 Moonshot AI 모델을 사용할 수 있습니다.
|
||||
|
||||
::: info 왜 Moonshot을 선택하나요?
|
||||
AIRI에서 Moonshot 모델을 사용하고 싶거나 이미 Moonshot API Key가 있다면 이 제공자를 바로 선택할 수 있습니다.
|
||||
:::
|
||||
|
||||
## API Key 발급받기
|
||||
|
||||
1. [Moonshot Global 콘솔](https://platform.moonshot.ai/)을 여세요.
|
||||
2. API Keys 페이지에서 새 API Key를 생성하세요.
|
||||
3. 키를 복사해 안전한 곳에 보관하세요.
|
||||
|
||||
::: warning API Key 보안
|
||||
API Key를 커밋하거나, 스크린샷에 포함하거나, 누구와도 공유하지 마세요. 키가 유출되면 즉시 폐기하고 Moonshot 콘솔에서 새 키를 만드세요.
|
||||
:::
|
||||
|
||||
## AIRI에서 설정하기
|
||||
|
||||
1. **설정 → 제공자 → 채팅 → Moonshot AI**를 여세요.
|
||||
2. 기본 설정에 API Key를 붙여 넣으세요.
|
||||
3. 글로벌 Base URL인 `https://api.moonshot.ai/v1/`를 유지하세요. `platform.moonshot.cn`에서 발급한 키는 해당 콘솔 문서에 안내된 중국 엔드포인트를 사용해야 하며, 리전 간에 자격 증명과 엔드포인트를 섞어 쓸 수 없습니다.
|
||||
|
||||
## 설정 확인
|
||||
|
||||
1. **설정 유효성 검사**: AIRI는 설정을 수정하는 동안 자동으로 유효성을 검사합니다. **Ping API** 버튼이 보이면 실제 요청 테스트에 사용할 수 있습니다.
|
||||
2. **모델 선택 →**: 유효성 검사가 통과되면 이 버튼으로 **설정 → 모듈 → 의식**을 열어 제공자와 모델을 선택하세요.
|
||||
|
||||
## 문제 해결
|
||||
|
||||
API 확인이 실패하면 API Key, 사용 가능한 크레딧 또는 할당량, 요청 한도, 네트워크 연결을 확인하세요. AIRI가 모델 목록을 불러오지 못하면 **의식** 페이지에서 Moonshot이 제공하는 정확한 모델 ID를 직접 입력하세요.
|
||||
@@ -0,0 +1,32 @@
|
||||
---
|
||||
title: n1n
|
||||
description: AIRI에서 n1n 채팅 모델 설정하기
|
||||
---
|
||||
|
||||
n1n은 AIRI에서 API 호환 채팅 모델 접근을 제공합니다.
|
||||
|
||||
::: info 왜 n1n을 선택하나요?
|
||||
n1n의 모델 서비스를 사용한다면 AIRI에 서비스 주소와 계정 자격 증명을 입력해 사용할 수 있습니다.
|
||||
:::
|
||||
|
||||
## 서비스 접근 방법 준비하기
|
||||
|
||||
1. [n1n](https://n1n.ai/)에 로그인한 뒤, 서비스 URL과 API Key 필요 여부를 확인하세요.
|
||||
|
||||
::: warning 자격 증명 보안
|
||||
API Key가 선택 사항이더라도 개인 서비스 주소, 액세스 토큰, 게이트웨이 설정을 노출하지 마세요.
|
||||
:::
|
||||
|
||||
## AIRI에서 설정하기
|
||||
|
||||
1. **설정 → 제공자 → 채팅 → n1n**을 여세요. 기본 Base URL은 `https://api.n1n.ai/v1/`입니다.
|
||||
2. n1n의 현재 서비스 요구 사항에 따라 API Key를 입력하세요. 배포 환경이 익명 접근을 허용한다면 배포자의 안내에 따라 비워 두세요.
|
||||
|
||||
## 설정 확인
|
||||
|
||||
1. **설정 유효성 검사**: AIRI는 설정을 수정하는 동안 자동으로 유효성을 검사합니다. **Ping API** 버튼이 보이면 실제 요청 테스트에 사용할 수 있습니다.
|
||||
2. **모델 선택 →**: 유효성 검사가 통과되면 이 버튼으로 **설정 → 모듈 → 의식**을 열어 제공자와 모델을 선택하세요.
|
||||
|
||||
## 문제 해결
|
||||
|
||||
확인이 실패하면 서비스 주소, API Key, 배포자의 접근 정책을 점검하세요. 서비스가 익명 접근을 허용한다면 배포자의 안내에 따라 API Key를 비워 두고, AIRI를 실행하는 기기에서 해당 주소에 접근할 수 있는지 확인하세요.
|
||||
@@ -0,0 +1,36 @@
|
||||
---
|
||||
title: Novita
|
||||
description: AIRI에서 Novita를 채팅 제공자로 설정하기
|
||||
is_openai_compatible: true
|
||||
---
|
||||
|
||||
Novita AI는 OpenAI 형식과 호환되는 채팅 API를 제공합니다. 이 페이지의 설정을 완료하면 AIRI가 의식에서 Novita AI가 제공하는 모델을 사용할 수 있습니다.
|
||||
|
||||
::: info 왜 Novita AI를 선택하나요?
|
||||
Novita AI에서 모델 서비스를 관리하고 있다면 해당 서비스 제공자의 API Key를 그대로 재사용할 수 있습니다.
|
||||
:::
|
||||
|
||||
## API Key 발급받기
|
||||
|
||||
1. [Novita AI Console](https://novita.ai/dashboard)을 여세요.
|
||||
2. API Keys 페이지에서 새 API Key를 만드세요.
|
||||
3. 키를 복사해 안전한 곳에 보관하세요.
|
||||
|
||||
::: warning API Key 보안
|
||||
API Key를 커밋하거나, 스크린샷에 포함하거나, 누구와도 공유하지 마세요. 키가 유출되면 즉시 폐기하고 Novita AI 콘솔에서 새 키를 만드세요.
|
||||
:::
|
||||
|
||||
## AIRI에서 설정하기
|
||||
|
||||
1. **설정 → 제공자 → 채팅 → Novita**를 여세요.
|
||||
2. 기본 설정에 API Key를 붙여넣으세요.
|
||||
3. 기본 Base URL인 `https://api.novita.ai/openai/`를 유지하세요.
|
||||
|
||||
## 설정 확인
|
||||
|
||||
1. **설정 유효성 검사**: AIRI는 설정을 수정하는 동안 자동으로 유효성을 검사합니다. **Ping API** 버튼이 보이면 실제 요청 테스트에 사용할 수 있습니다.
|
||||
2. **모델 선택 →**: 유효성 검사가 통과되면 이 버튼으로 **설정 → 모듈 → 의식**을 열어 제공자와 모델을 선택하세요.
|
||||
|
||||
## 문제 해결
|
||||
|
||||
API 확인이 실패하면 API Key, 사용 가능한 크레딧 또는 할당량, 요청 한도, 네트워크 연결을 확인하세요. AIRI가 모델 목록을 불러오지 못하면 **의식** 페이지에서 Novita AI가 제공하는 정확한 모델 ID를 직접 입력하세요.
|
||||
@@ -0,0 +1,40 @@
|
||||
---
|
||||
title: NVIDIA NIM
|
||||
description: AIRI에서 NVIDIA NIM을 채팅 제공자로 설정하기
|
||||
is_openai_compatible: true
|
||||
---
|
||||
|
||||
NVIDIA NIM은 OpenAI 형식과 호환되는 채팅 API를 제공합니다. 이 페이지의 설정을 완료하면 AIRI가 의식에서 NVIDIA NIM이 제공하는 모델을 사용할 수 있습니다.
|
||||
|
||||
::: warning 데스크톱 전용
|
||||
이 제공자는 현재 Electron 데스크톱 앱에서만 사용할 수 있습니다. AIRI 웹에서는 제공되지 않습니다.
|
||||
:::
|
||||
|
||||
::: info 왜 NVIDIA NIM을 선택하나요?
|
||||
NVIDIA NIM 플랫폼에서 이미 모델 서비스를 사용하고 있다면 같은 자격 증명을 AIRI에 연결할 수 있습니다.
|
||||
:::
|
||||
|
||||
## API Key 발급받기
|
||||
|
||||
1. [NVIDIA NIM Console](https://build.nvidia.com/)을 여세요.
|
||||
2. API Keys 페이지에서 새 API Key를 만드세요.
|
||||
3. 키를 복사해 안전한 곳에 보관하세요.
|
||||
|
||||
::: warning API Key 보안
|
||||
API Key를 커밋하거나, 스크린샷에 포함하거나, 누구와도 공유하지 마세요. 키가 유출되면 즉시 폐기하고 NVIDIA 콘솔에서 새 키를 만드세요.
|
||||
:::
|
||||
|
||||
## AIRI에서 설정하기
|
||||
|
||||
1. **설정 → 제공자 → 채팅 → NVIDIA NIM**을 여세요.
|
||||
2. 기본 설정에 API Key를 붙여넣으세요.
|
||||
3. 기본 Base URL인 `https://integrate.api.nvidia.com/v1/`를 유지하세요.
|
||||
|
||||
## 설정 확인
|
||||
|
||||
1. **설정 유효성 검사**: AIRI는 설정을 수정하는 동안 자동으로 유효성을 검사합니다. **Ping API** 버튼이 보이면 실제 요청 테스트에 사용할 수 있습니다.
|
||||
2. **모델 선택 →**: 유효성 검사가 통과되면 이 버튼으로 **설정 → 모듈 → 의식**을 열어 제공자와 모델을 선택하세요.
|
||||
|
||||
## 문제 해결
|
||||
|
||||
API 확인이 실패하면 API Key, 사용 가능한 크레딧 또는 할당량, 요청 한도, 네트워크 연결을 확인하세요. AIRI가 모델 목록을 불러오지 못하면 **의식** 페이지에서 NVIDIA NIM이 제공하는 정확한 모델 ID를 직접 입력하세요.
|
||||
@@ -0,0 +1,45 @@
|
||||
---
|
||||
title: AIRI 공식 제공자
|
||||
description: AIRI 공식 채팅 제공자 사용하기
|
||||
---
|
||||
|
||||
AIRI를 빠르게 시작하고 설정을 간단히 하고 싶다면 공식 제공자로 채팅을 활성화할 수 있습니다.
|
||||
|
||||
::: info 왜 AIRI 공식 제공자를 선택하나요?
|
||||
서드파티 API Key를 직접 설정하지 않고 AIRI를 빠르게 체험하고 싶다면 공식 제공자를 선택할 수 있습니다.
|
||||
:::
|
||||
|
||||
## 계정에 로그인하기
|
||||
|
||||
1. 로그인 버튼을 클릭하면 브라우저 페이지가 열립니다.
|
||||
2. 로그인 방법을 선택하세요. 현재 이메일, Google, GitHub 로그인을 지원합니다.
|
||||
|
||||
::: info 중국 사용자를 위한 특별 안내
|
||||
중국에 있는 사용자는 Google과 GitHub로 로그인하지 못할 수 있습니다. 이메일로 로그인해 주세요. 휴대폰 번호를 이용한 가입과 로그인은 현재 지원하지 않습니다.
|
||||
:::
|
||||
|
||||
3. 안내에 따라 로그인/가입을 완료하세요.
|
||||
|
||||
::: info
|
||||
이메일이 도착하지 않으면 스팸함을 확인하세요.
|
||||
:::
|
||||
|
||||
## 사용 가능한 Flux 확인
|
||||
|
||||
Flux는 AIRI 공식 서비스에서 사용하는 잔액입니다. 초기 지급량은 현재 배포 환경의 설정에 따라 다르므로, 고정된 금액을 가정하지 말고 **설정 → Flux**에 표시된 잔액을 확인하세요.
|
||||
|
||||
## 제공자 활성화
|
||||
|
||||
1. **설정 → 모듈 → 의식**을 여세요.
|
||||
2. **Official Provider**와 **Auto** 모델을 선택하세요.
|
||||
3. 짧은 메시지를 보내 AIRI가 응답하는지 확인하세요.
|
||||
|
||||
AIRI는 활성화된 채팅 제공자가 없을 때만 공식 제공자를 자동으로 선택합니다. 이전에 다른 제공자를 선택했다면 로그인해도 그 선택이 바뀌지 않습니다.
|
||||
|
||||
## Flux 충전
|
||||
|
||||
**설정 → Flux**를 열고 사용 가능한 패키지를 선택하세요. 데스크톱에서는 AIRI가 시스템 브라우저에서 결제 페이지를 열고, 앱이 다시 포커스를 얻으면 잔액을 갱신합니다. 구매가 비활성화된 빌드나 배포 환경에서는 결제를 제공하지 않습니다.
|
||||
|
||||
## 문제 해결
|
||||
|
||||
로그인 이메일을 받지 못하면 스팸함을 확인하세요. Flux 패키지가 보이지 않거나 결제를 생성할 수 없다면 해당 배포 환경에서 구매가 비활성화되었거나 일시적으로 사용할 수 없는 상태일 수 있습니다.
|
||||
@@ -0,0 +1,48 @@
|
||||
---
|
||||
title: Ollama (로컬 모델)
|
||||
description: 로컬 Ollama 서비스로 AIRI 채팅 모델 설정하기
|
||||
---
|
||||
|
||||
Ollama는 언어 모델을 로컬에서 실행하는 오픈소스 런타임입니다. 로컬 API를 제공하며 기본적으로 API Key가 필요하지 않습니다.
|
||||
|
||||
::: info 왜 Ollama를 선택하나요?
|
||||
모델을 직접 실행하고 싶거나, 클라우드 API 의존도를 줄이고 싶거나, 대화 데이터의 로컬 처리를 더 중시한다면 Ollama가 알맞은 선택입니다.
|
||||
:::
|
||||
|
||||
## Ollama 설치하기
|
||||
|
||||
1. [공식 웹사이트](https://ollama.com/)에서 운영 체제에 맞는 Ollama를 다운로드해 설치하세요.
|
||||
2. Terminal이나 PowerShell에서 다음 명령어를 실행해 설치를 확인하세요:
|
||||
|
||||
```bash
|
||||
ollama --version
|
||||
```
|
||||
|
||||
## 모델 다운로드 및 실행
|
||||
|
||||
1. 다음 명령어를 실행해 모델을 다운로드하고 시작하세요:
|
||||
|
||||
```bash
|
||||
ollama run qwen2
|
||||
```
|
||||
|
||||
2. 다른 모델을 사용하려면 `qwen2`를 해당 모델 ID로 바꾸세요. 최초 다운로드 시간은 모델 크기와 네트워크 속도에 따라 다릅니다.
|
||||
|
||||
## AIRI에서 설정하기
|
||||
|
||||
1. **설정 → 제공자 → 채팅 → Ollama**를 여세요.
|
||||
2. 기본 Base URL인 `http://localhost:11434/v1/`를 유지하세요. Ollama가 다른 기기에서 실행 중이라면 AIRI를 실행하는 기기에서 접근할 수 있는 URL을 입력하세요.
|
||||
3. **설정 → 모듈 → 의식**에서 Ollama와 다운로드한 모델을 선택하세요.
|
||||
|
||||
## 설정 확인
|
||||
|
||||
1. **설정 유효성 검사**: AIRI는 설정을 수정하는 동안 자동으로 유효성을 검사합니다. **Ping API** 버튼이 보이면 실제 요청 테스트에 사용할 수 있습니다.
|
||||
2. **모델 선택 →**: 유효성 검사가 통과되면 이 버튼으로 **설정 → 모듈 → 의식**을 열어 다운로드한 모델을 선택하세요.
|
||||
|
||||
## 문제 해결
|
||||
|
||||
AIRI가 연결하지 못하면 Ollama가 실행 중인지, Base URL이 올바른 포트를 사용하는지 확인하세요. AIRI와 Ollama가 서로 다른 기기에서 실행 중이라면 AIRI 기기에서 접근할 수 있는 LAN 주소를 사용하고, 신뢰할 수 있는 네트워크에서만 서비스를 노출하세요.
|
||||
|
||||
::: warning AIRI가 로컬 Ollama에 연결하지 못할 때
|
||||
Ollama가 실행 중인데도 AIRI가 CORS 오류를 보고하면, `OLLAMA_ORIGINS`에 AIRI의 정확한 origin을 추가하고 Ollama를 재시작하세요. 문제 해결의 지름길이라는 이유로 와일드카드를 사용하거나 Ollama를 공용 인터넷에 노출하지 마세요.
|
||||
:::
|
||||
@@ -0,0 +1,36 @@
|
||||
---
|
||||
title: OpenAI 및 호환 API
|
||||
description: AIRI에서 OpenAI 또는 OpenAI 호환 채팅 서비스 설정하기
|
||||
is_openai_compatible: true
|
||||
---
|
||||
|
||||
공식 OpenAI 엔드포인트를 사용하려면 **OpenAI**를, 서드파티 호환 엔드포인트를 사용하려면 **OpenAI Compatible**을 선택하세요. 설정을 완료한 뒤 **설정 → 모듈 → 의식**에서 제공자와 채팅 모델을 선택하세요.
|
||||
|
||||
::: info 왜 OpenAI 또는 호환 API를 선택하나요?
|
||||
이미 OpenAI API Key를 가지고 있거나, 서비스 제공자가 OpenAI 호환 채팅 인터페이스를 명시적으로 제공한다면 이 설정 방법을 사용할 수 있습니다. API 주소가 `/v1`로 끝나거나 키가 `sk-`로 시작한다는 것만으로는 서비스 호환성이 보장되지 않습니다.
|
||||
:::
|
||||
|
||||
## API Key 발급받기
|
||||
|
||||
1. OpenAI 공식 서비스를 사용할 때는 [OpenAI API Keys](https://platform.openai.com/api-keys)를 여세요. 호환 서비스를 사용할 때는 해당 서비스 제공자의 관리 콘솔을 여세요.
|
||||
2. API Key 또는 Developer Settings 페이지에서 API Key를 만드세요.
|
||||
3. 키를 복사해 안전한 곳에 보관하세요.
|
||||
|
||||
::: warning API Key 보안
|
||||
API Key를 커밋하거나, 스크린샷에 포함하거나, 누구와도 공유하지 마세요. 키가 유출되면 즉시 폐기하고 제공자 콘솔에서 새 키를 만드세요.
|
||||
:::
|
||||
|
||||
## AIRI에서 설정하기
|
||||
|
||||
1. **설정 → 제공자 → 채팅 → OpenAI** 또는 **OpenAI Compatible**을 여세요.
|
||||
2. 기본 설정에 API Key를 붙여넣으세요.
|
||||
3. OpenAI 공식 서비스를 사용할 때는 기본 Base URL인 `https://api.openai.com/v1`을 유지하세요. 호환 서비스를 사용할 때는 서비스 제공자 문서에 안내된 API 루트 주소를 입력하고, `/chat/completions` 경로를 뒤에 붙이지 마세요.
|
||||
|
||||
## 설정 확인
|
||||
|
||||
1. **설정 유효성 검사**: AIRI는 설정을 수정하는 동안 자동으로 유효성을 검사합니다. **Ping API** 버튼이 보이면 실제 요청 테스트에 사용할 수 있습니다.
|
||||
2. **모델 선택 →**: 유효성 검사가 통과되면 이 버튼으로 **설정 → 모듈 → 의식**을 열어 제공자와 모델을 선택하세요.
|
||||
|
||||
## 문제 해결
|
||||
|
||||
API 확인이 실패하면 API Key, 사용 가능한 크레딧 또는 할당량, 요청 한도, 네트워크 연결을 확인하세요. 호환 서비스라면 해당 서비스가 OpenAI Chat Completions API를 지원하는지, Base URL이 제공자 문서에 안내된 API 루트인지 확인하세요.
|
||||
@@ -0,0 +1,35 @@
|
||||
---
|
||||
title: OpenPaths
|
||||
description: AIRI에서 OpenPaths를 채팅 제공자로 설정하기
|
||||
is_openai_compatible: true
|
||||
---
|
||||
|
||||
OpenPaths는 OpenAI 형식과 호환되는 채팅 API 제공자입니다. 이 페이지의 설정을 완료하면 AIRI가 **의식**에서 OpenPaths 모델을 사용할 수 있습니다.
|
||||
|
||||
::: info 왜 OpenPaths인가요?
|
||||
이미 OpenPaths API Key가 있거나 OpenPaths가 제공하는 모델을 사용하고 싶다면 이 서비스 제공자를 바로 선택할 수 있습니다.
|
||||
:::
|
||||
|
||||
## API Key 발급받기
|
||||
|
||||
1. [OpenPaths](https://openpaths.io/)에서 계정을 등록하고 API Key를 만드세요.
|
||||
2. 키를 복사해 안전한 곳에 보관하세요.
|
||||
|
||||
::: warning API Key 보안
|
||||
API Key를 커밋하거나, 스크린샷에 포함하거나, 누구와도 공유하지 마세요. 키가 유출되면 즉시 폐기하고 OpenPaths 콘솔에서 새 키를 만드세요.
|
||||
:::
|
||||
|
||||
## AIRI에서 설정하기
|
||||
|
||||
1. **설정 → 제공자 → 채팅 → OpenPaths**를 여세요.
|
||||
2. 기본 설정에 API Key를 붙여넣으세요.
|
||||
3. 기본 Base URL을 그대로 유지하세요: `https://openpaths.io/v1`.
|
||||
|
||||
## 설정 확인
|
||||
|
||||
1. **설정 유효성 검사**: AIRI는 설정을 수정하는 동안 자동으로 유효성을 검사합니다. **Ping API** 버튼이 보이면 실제 요청 테스트에 사용할 수 있습니다.
|
||||
2. **모델 선택 →**: 유효성 검사가 통과되면 이 버튼으로 **설정 → 모듈 → 의식**을 열어 제공자와 모델을 선택하세요.
|
||||
|
||||
## 문제 해결
|
||||
|
||||
API 확인이 실패하면 API Key, 사용 가능한 크레딧 또는 할당량, 요청 한도, 네트워크 연결을 확인하세요. AIRI가 모델 목록을 불러오지 못하면 **의식** 페이지에서 OpenPaths가 제공하는 정확한 모델 ID를 직접 입력하세요.
|
||||
@@ -0,0 +1,37 @@
|
||||
---
|
||||
title: OpenRouter
|
||||
description: AIRI에서 OpenRouter를 채팅 제공자로 설정하기
|
||||
is_openai_compatible: true
|
||||
---
|
||||
|
||||
OpenRouter는 여러 모델을 모아 제공하는 API 서비스 제공자입니다. 이 페이지의 설정을 완료하면 AIRI가 의식에서 OpenRouter가 제공하는 채팅 모델을 사용할 수 있습니다.
|
||||
|
||||
::: info 왜 OpenRouter를 선택하나요?
|
||||
OpenRouter는 하나의 API Key와 결제 계정으로 여러 모델 벤더에 접근하고 싶을 때 편리합니다. 각 업스트림 제공자를 따로 설정하지 않고도 OpenRouter가 노출하는 모델 사이를 전환할 수 있습니다. 다만 사용 가능 여부는 지역, 네트워크, 결제 수단, 제공자 정책에 따라 달라질 수 있습니다.
|
||||
:::
|
||||
|
||||
## API Key 발급받기
|
||||
|
||||
1. [OpenRouter API Keys](https://openrouter.ai/keys)를 열고 새 API Key를 만드세요.
|
||||
2. 키에 적절한 이름, 유효 기간, 할당량 제한을 설정하세요.
|
||||
3. 키를 복사해 안전한 곳에 보관하세요.
|
||||
|
||||
::: warning API Key 보안
|
||||
API Key를 커밋하거나, 스크린샷에 포함하거나, 누구와도 공유하지 마세요. 키가 유출되면 즉시 폐기하고 OpenRouter 콘솔에서 새 키를 만드세요.
|
||||
:::
|
||||
|
||||
|
||||
## AIRI에서 설정하기
|
||||
|
||||
1. **설정 → 제공자 → 채팅 → OpenRouter**를 여세요.
|
||||
2. 기본 설정에 API Key를 붙여넣으세요.
|
||||
3. 기본 Base URL을 그대로 유지하세요: `https://openrouter.ai/api/v1/`.
|
||||
|
||||
## 설정 확인
|
||||
|
||||
1. **설정 유효성 검사**: AIRI는 설정을 수정하는 동안 자동으로 유효성을 검사합니다. **Ping API** 버튼이 보이면 실제 요청 테스트에 사용할 수 있습니다.
|
||||
2. **모델 선택 →**: 유효성 검사가 통과되면 이 버튼으로 **설정 → 모듈 → 의식**을 열어 사용 가능한 OpenRouter 모델을 선택하세요.
|
||||
|
||||
## 문제 해결
|
||||
|
||||
API 확인이 실패하면 API Key, 사용 가능한 크레딧 또는 할당량, 요청 한도, 네트워크 연결을 확인하세요. AIRI가 모델 목록을 불러오지 못하면 **의식** 페이지에서 OpenRouter가 제공하는 정확한 모델 ID를 직접 입력하세요.
|
||||
@@ -0,0 +1,36 @@
|
||||
---
|
||||
title: Perplexity
|
||||
description: AIRI에서 Perplexity를 채팅 제공자로 설정하기
|
||||
is_openai_compatible: true
|
||||
---
|
||||
|
||||
Perplexity는 OpenAI 형식과 호환되는 채팅 API를 제공합니다. 이 페이지의 설정을 완료하면 AIRI가 의식에서 Perplexity가 제공하는 모델을 사용할 수 있습니다.
|
||||
|
||||
::: info 왜 Perplexity를 선택하나요?
|
||||
이미 Perplexity API 계정이 있고 사용 가능한 모델을 AIRI에서 쓰고 싶다면 이 제공자를 선택할 수 있습니다.
|
||||
:::
|
||||
|
||||
## API Key 발급받기
|
||||
|
||||
1. [Perplexity API Settings](https://www.perplexity.ai/settings/api)를 여세요.
|
||||
2. API Keys 페이지에서 새 API Key를 만드세요.
|
||||
3. 키를 복사해 안전한 곳에 보관하세요.
|
||||
|
||||
::: warning API Key 보안
|
||||
API Key를 커밋하거나, 스크린샷에 포함하거나, 누구와도 공유하지 마세요. 키가 유출되면 즉시 폐기하고 Perplexity 콘솔에서 새 키를 만드세요.
|
||||
:::
|
||||
|
||||
## AIRI에서 설정하기
|
||||
|
||||
1. **설정 → 제공자 → 채팅 → Perplexity**를 여세요.
|
||||
2. 기본 설정에 API Key를 붙여넣으세요.
|
||||
3. 기본 Base URL을 그대로 유지하세요: `https://api.perplexity.ai/`.
|
||||
|
||||
## 설정 확인
|
||||
|
||||
1. **설정 유효성 검사**: AIRI는 설정을 수정하는 동안 자동으로 유효성을 검사합니다. **Ping API** 버튼이 보이면 실제 요청 테스트에 사용할 수 있습니다.
|
||||
2. **모델 선택 →**: 유효성 검사가 통과되면 이 버튼으로 **설정 → 모듈 → 의식**을 열어 제공자와 모델을 선택하세요.
|
||||
|
||||
## 문제 해결
|
||||
|
||||
API 확인이 실패하면 API Key, 사용 가능한 크레딧 또는 할당량, 요청 한도, 네트워크 연결을 확인하세요. AIRI가 모델 목록을 불러오지 못하면 **의식** 페이지에서 Perplexity가 제공하는 정확한 모델 ID를 직접 입력하세요.
|
||||
@@ -0,0 +1,36 @@
|
||||
---
|
||||
title: Together.ai
|
||||
description: AIRI에서 Together.ai를 채팅 제공자로 설정하기
|
||||
is_openai_compatible: true
|
||||
---
|
||||
|
||||
Together AI는 OpenAI 형식과 호환되는 채팅 API를 제공합니다. 이 페이지의 설정을 완료하면 AIRI가 의식에서 Together AI가 제공하는 모델을 사용할 수 있습니다.
|
||||
|
||||
::: info 왜 Together AI를 선택하나요?
|
||||
Together AI에서 모델을 배포했거나 사용해 본 적이 있다면 해당 API Key를 바로 재사용할 수 있습니다.
|
||||
:::
|
||||
|
||||
## API Key 발급받기
|
||||
|
||||
1. [Together AI API Keys](https://api.together.ai/settings/api-keys)를 여세요.
|
||||
2. 새 API Key를 만드세요.
|
||||
3. 키를 복사해 안전한 곳에 보관하세요.
|
||||
|
||||
::: warning API Key 보안
|
||||
API Key를 커밋하거나, 스크린샷에 포함하거나, 누구와도 공유하지 마세요. 키가 유출되면 즉시 폐기하고 Together AI 콘솔에서 새 키를 만드세요.
|
||||
:::
|
||||
|
||||
## AIRI에서 설정하기
|
||||
|
||||
1. **설정 → 제공자 → 채팅 → Together.ai**를 여세요.
|
||||
2. 기본 설정에 API Key를 붙여넣으세요.
|
||||
3. 기본 Base URL을 그대로 유지하세요: `https://api.together.xyz/v1/`.
|
||||
|
||||
## 설정 확인
|
||||
|
||||
1. **설정 유효성 검사**: AIRI는 설정을 수정하는 동안 자동으로 유효성을 검사합니다. **Ping API** 버튼이 보이면 실제 요청 테스트에 사용할 수 있습니다.
|
||||
2. **모델 선택 →**: 유효성 검사가 통과되면 이 버튼으로 **설정 → 모듈 → 의식**을 열어 제공자와 모델을 선택하세요.
|
||||
|
||||
## 문제 해결
|
||||
|
||||
API 확인이 실패하면 API Key, 사용 가능한 크레딧 또는 할당량, 요청 한도, 네트워크 연결을 확인하세요. AIRI가 모델 목록을 불러오지 못하면 **의식** 페이지에서 Together AI가 제공하는 정확한 모델 ID를 직접 입력하세요.
|
||||
@@ -0,0 +1,32 @@
|
||||
---
|
||||
title: Volcengine Coding Plan
|
||||
description: AIRI에서 Volcengine Coding Plan 채팅 모델 설정하기
|
||||
---
|
||||
|
||||
Volcengine Coding Plan은 AIRI에서 독립된 제공자 카드로 제공됩니다.
|
||||
|
||||
::: info 왜 Volcengine Coding Plan을 선택하나요?
|
||||
계정에서 Volcengine Coding Plan을 사용하고 있다면 해당 서비스 플랜에 맞는 이 카드를 선택하세요.
|
||||
:::
|
||||
|
||||
## Coding Plan 자격 증명 준비하기
|
||||
|
||||
1. [Volcengine Ark Coding Plan 콘솔](https://console.volcengine.com/ark/region%3Acn-beijing/subscription/coding-plan)에 로그인해 Coding Plan API Key를 발급받으세요.
|
||||
|
||||
::: warning API Key 보안
|
||||
API Key나 엔드포인트 자격 증명을 커밋하거나, 스크린샷에 포함하거나, 누구와도 공유하지 마세요.
|
||||
:::
|
||||
|
||||
## AIRI에서 설정하기
|
||||
|
||||
1. **설정 → 제공자 → 채팅 → Volcengine Coding Plan**을 열고 API Key를 입력하세요.
|
||||
2. Coding Plan 문서에서 다른 호환 API 루트를 안내하지 않는 한 기본 **Base URL**을 그대로 유지하세요. 모델은 AIRI의 정적 제공자 목록에서 가져오며, 이 양식에는 Endpoint ID나 모델 필드가 없습니다.
|
||||
|
||||
## 설정 확인
|
||||
|
||||
1. **설정 유효성 검사**: AIRI는 설정을 수정하는 동안 자동으로 유효성을 검사합니다. **Ping API** 버튼이 보이면 실제 요청 테스트에 사용할 수 있습니다.
|
||||
2. **모델 선택 →**: 유효성 검사가 통과되면 이 버튼으로 **설정 → 모듈 → 의식**을 열어 사용 가능한 모델을 선택하세요.
|
||||
|
||||
## 문제 해결
|
||||
|
||||
유효성 검사가 실패하면 API Key가 활성 상태의 Volcengine Coding Plan에 속하는지, Base URL이 올바른지 확인하세요. 목록에 있는 모델이 거부되면 플랜에 해당 모델 접근 권한이 있는지 확인하세요.
|
||||
@@ -0,0 +1,35 @@
|
||||
---
|
||||
title: xAI
|
||||
description: AIRI에서 xAI Grok 채팅 모델 설정하기
|
||||
---
|
||||
|
||||
xAI 제공자를 사용하면 AIRI가 Grok 채팅 모델을 사용할 수 있습니다. 설정 방법은 일반적인 API Key 서비스 제공자와 동일합니다.
|
||||
|
||||
::: info 왜 xAI를 선택하나요?
|
||||
이미 xAI API 계정이 있고 AIRI에서 Grok 모델을 사용하고 싶다면 이 서비스 제공자를 선택할 수 있습니다.
|
||||
:::
|
||||
|
||||
## API Key 생성하기
|
||||
|
||||
1. [xAI Developer Console](https://console.x.ai/)에 로그인한 뒤 API Key를 만드세요.
|
||||
2. 계정이 API 사용을 위해 활성화되어 있고 사용 가능한 할당량이 있는지 확인하세요.
|
||||
3. 키를 복사하세요.
|
||||
|
||||
::: warning API Key 보안
|
||||
API Key는 비밀번호 관리자나 AIRI의 로컬 설정에만 저장하세요. 키를 코드에 적거나, 저장소에 커밋하거나, 다른 사람에게 보내지 마세요.
|
||||
:::
|
||||
|
||||
## AIRI에서 설정하기
|
||||
|
||||
1. **설정 → 제공자 → 채팅 → xAI**를 여세요.
|
||||
2. API Key를 입력하세요.
|
||||
3. 기본 Base URL을 그대로 유지하세요: `https://api.x.ai/v1/`.
|
||||
|
||||
## 설정 확인
|
||||
|
||||
1. **설정 유효성 검사**: AIRI는 설정을 수정하는 동안 자동으로 유효성을 검사합니다. **Ping API** 버튼이 보이면 실제 요청 테스트에 사용할 수 있습니다.
|
||||
2. **모델 선택 →**: 유효성 검사가 통과되면 이 버튼으로 **설정 → 모듈 → 의식**을 열어 제공자와 모델을 선택하세요.
|
||||
|
||||
## 문제 해결
|
||||
|
||||
제공자 유효성 검사가 실패하면 API Key, 사용 가능한 크레딧 또는 할당량, 요청 한도, 네트워크 연결을 확인하세요. AIRI가 모델 목록을 불러오지 못하면 **의식** 페이지에서 xAI 문서에 있는 정확한 모델 ID를 직접 입력하세요.
|
||||
@@ -0,0 +1,36 @@
|
||||
---
|
||||
title: Z.ai
|
||||
description: AIRI에서 Z.ai를 채팅 서비스 제공자로 설정하기
|
||||
is_openai_compatible: true
|
||||
---
|
||||
|
||||
Z.ai는 OpenAI 형식과 호환되는 채팅 API를 제공합니다. 이 페이지의 설정을 완료하면 AIRI가 **의식**에서 Z.ai 모델을 사용할 수 있습니다.
|
||||
|
||||
::: info 왜 Z.ai를 선택하나요?
|
||||
AIRI에서 Z.ai 모델을 사용하고 싶거나 이미 Z.ai API Key가 있다면 이 서비스 제공자를 바로 선택할 수 있습니다.
|
||||
:::
|
||||
|
||||
## API Key 발급받기
|
||||
|
||||
1. [Z.ai API Keys 페이지](https://z.ai/manage-apikey/apikey-list)를 여세요.
|
||||
2. 새 API Key를 만드세요.
|
||||
3. 키를 복사해 안전한 곳에 보관하세요.
|
||||
|
||||
::: warning API Key 보안
|
||||
API Key를 커밋하거나, 스크린샷에 포함하거나, 누구와도 공유하지 마세요. 키가 유출되면 즉시 폐기하고 Z.ai 콘솔에서 새 키를 만드세요.
|
||||
:::
|
||||
|
||||
## AIRI에서 설정하기
|
||||
|
||||
1. **설정 → 제공자 → 채팅 → Z.ai**를 여세요.
|
||||
2. 기본 설정에 API Key를 붙여넣으세요.
|
||||
3. 기본 Base URL을 그대로 유지하세요: `https://api.z.ai/api/paas/v4`.
|
||||
|
||||
## 설정 확인
|
||||
|
||||
1. **설정 유효성 검사**: AIRI는 설정을 수정하는 동안 자동으로 유효성을 검사합니다. **Ping API** 버튼이 보이면 실제 요청 테스트에 사용할 수 있습니다.
|
||||
2. **모델 선택 →**: 유효성 검사가 통과되면 이 버튼으로 **설정 → 모듈 → 의식**을 열어 제공자와 모델을 선택하세요.
|
||||
|
||||
## 문제 해결
|
||||
|
||||
API 확인이 실패하면 API Key, 사용 가능한 크레딧 또는 할당량, 요청 한도, 네트워크 연결을 확인하세요. AIRI가 모델 목록을 불러오지 못하면 **의식** 페이지에서 Z.ai가 제공하는 정확한 모델 ID를 직접 입력하세요.
|
||||
@@ -0,0 +1,38 @@
|
||||
---
|
||||
title: Alibaba Cloud Bailian (TTS)
|
||||
description: AIRI에서 Alibaba Cloud Bailian 음성 합성 설정하기
|
||||
---
|
||||
|
||||
Alibaba Cloud Bailian은 AIRI에서 CosyVoice 음성 합성 모델을 제공합니다.
|
||||
|
||||
::: info 왜 Alibaba Cloud Bailian을 선택하나요?
|
||||
이미 Alibaba Cloud Model Studio를 사용하고 있고 CosyVoice 음성과 모델 중에서 선택하고 싶다면, 이것이 직접 접근하는 방법입니다.
|
||||
:::
|
||||
|
||||
## API Key 발급받기
|
||||
|
||||
1. [Alibaba Cloud Bailian Console](https://bailian.console.aliyun.com/)에 로그인한 뒤, 모델 서비스가 활성화되어 있는지 확인하세요.
|
||||
2. API Key 관리 페이지에서 키를 생성하세요.
|
||||
3. 키를 복사해 안전한 곳에 보관하세요.
|
||||
|
||||
::: warning API Key 보안
|
||||
Bailian API Key를 커밋하거나, 스크린샷에 포함하거나, 누구와도 공유하지 마세요.
|
||||
:::
|
||||
|
||||
## AIRI에서 설정하기
|
||||
|
||||
1. **설정 → 제공자 → 음성 합성 → Alibaba Cloud Model Studio**를 여세요.
|
||||
2. Model Studio API Key를 입력하세요. 기본 Base URL은 Alibaba Cloud의 직접 API가 아니라 AIRI/UnSpeech 게이트웨이인 `https://unspeech.hyp3r.link/v1/`입니다. 키, 합성할 텍스트, 모델/음성 선택, 반환된 오디오가 모두 이 게이트웨이를 거칩니다. 이 신뢰 경계를 수용할 수 있는 경우에만 사용하고, 그렇지 않으면 호환되는 자체 호스팅 게이트웨이 URL을 입력하거나 직접 연결되는 제공자를 선택하세요.
|
||||
|
||||
## 설정 확인
|
||||
|
||||
1. 제공자 플레이그라운드에서 사용 가능한 음성을 선택하세요. 이 페이지는 AIRI의 기본 CosyVoice 모델을 사용합니다.
|
||||
2. 같은 페이지의 플레이그라운드에 짧은 텍스트를 입력하고 오디오가 재생되는지 확인하세요.
|
||||
|
||||
## AIRI 응답에 사용하기
|
||||
|
||||
**설정 → 모듈 → 음성 합성**을 열고 **Alibaba Cloud Model Studio**를 선택한 뒤, 사용 가능한 모델과 음성을 선택하세요. 제공자 플레이그라운드는 자격 증명을 테스트할 뿐이며, 이 모듈 선택이 일반 AIRI 응답에 음성을 활성화하는 단계입니다.
|
||||
|
||||
## 문제 해결
|
||||
|
||||
플레이그라운드에서 요청이 완료되지 않으면 API Key, Model Studio 결제 및 할당량 상태, 요청 한도, 네트워크 연결을 확인하세요. 모델이나 음성을 사용할 수 없다면 Bailian 계정에서 해당 모델 서비스가 활성화되어 있는지 확인하세요.
|
||||
@@ -0,0 +1,38 @@
|
||||
---
|
||||
title: Microsoft Azure Speech (TTS)
|
||||
description: AIRI에서 Microsoft Azure Speech 음성 합성 설정하기
|
||||
---
|
||||
|
||||
Microsoft Azure Speech는 AIRI에서 Azure 음성 합성 기능을 제공합니다.
|
||||
|
||||
::: info 왜 Microsoft Azure Speech를 선택하나요?
|
||||
팀이 이미 Azure에서 음성 리소스와 리전 구성을 관리하고 있다면, 같은 자격 증명을 사용하는 것이 더 편리합니다.
|
||||
:::
|
||||
|
||||
## Azure Speech 리소스 준비하기
|
||||
|
||||
1. [Azure Portal](https://portal.azure.com/)에 로그인한 뒤, Speech 리소스를 만들거나 여세요.
|
||||
2. 리소스의 **API Key**와 리전을 기록해 두세요. 둘 다 같은 Speech 리소스에서 가져와야 합니다.
|
||||
3. 키를 복사해 안전한 곳에 보관하세요.
|
||||
|
||||
::: warning API Key 보안
|
||||
Azure 키는 Speech 리소스에 대한 접근 권한을 제공합니다. 키를 커밋하거나, 스크린샷에 포함하거나, 누구와도 공유하지 마세요.
|
||||
:::
|
||||
|
||||
## AIRI에서 설정하기
|
||||
|
||||
1. **설정 → 제공자 → 음성 합성 → Microsoft / Azure Speech**를 여세요.
|
||||
2. API Key와 리전을 입력하세요. 기본 Base URL은 Azure의 직접 API가 아니라 AIRI/UnSpeech 게이트웨이인 `https://unspeech.hyp3r.link/v1/`입니다. 키, 리전, 합성할 텍스트, 음성 선택, 반환된 오디오가 모두 이 게이트웨이를 거칩니다. 이 신뢰 경계를 수용할 수 있는 경우에만 사용하고, 그렇지 않으면 호환되는 자체 호스팅 게이트웨이 URL을 입력하거나 직접 연결되는 제공자를 선택하세요.
|
||||
|
||||
## 설정 확인
|
||||
|
||||
1. 제공자 플레이그라운드에서 사용 가능한 음성을 선택하세요. 이 페이지는 AIRI의 기본 Azure Speech 모델을 사용합니다.
|
||||
2. 같은 페이지의 플레이그라운드에 짧은 텍스트를 입력하고 오디오가 재생되는지 확인하세요.
|
||||
|
||||
## AIRI 응답에 사용하기
|
||||
|
||||
**설정 → 모듈 → 음성 합성**을 열고 **Microsoft / Azure Speech**를 선택한 뒤, 사용 가능한 모델과 음성을 선택하세요. 제공자 플레이그라운드는 자격 증명을 테스트할 뿐이며, 이 모듈 선택이 일반 AIRI 응답에 음성을 활성화합니다.
|
||||
|
||||
## 문제 해결
|
||||
|
||||
확인에 실패하면 먼저 리전이 Speech 리소스와 일치하는지 확인하세요. 소리가 나지 않으면 **설정 → 모듈 → 음성 합성**에서 음성이 선택되어 있는지, 리소스에 사용 가능한 할당량이 있는지 확인하세요.
|
||||
@@ -0,0 +1,14 @@
|
||||
---
|
||||
title: 브라우저 로컬 음성 합성 (TTS, 사용 불가)
|
||||
description: 브라우저 로컬 음성 합성은 아직 설정할 수 없습니다
|
||||
---
|
||||
|
||||
브라우저(로컬) 음성 합성은 아직 사용할 수 없습니다. 해당 AIRI 설정 페이지는 현재 Work in Progress 자리 표시자만 보여 주므로, 모델과 음성을 준비하거나 선택할 수 없습니다.
|
||||
|
||||
::: warning 사용 불가
|
||||
아직 실제 동작하는 설정에 이 제공자를 사용하지 마세요. 현재 사용 가능 여부를 명확히 하기 위해서만 문서화되어 있습니다.
|
||||
:::
|
||||
|
||||
## 사용 가능한 대안
|
||||
|
||||
AIRI에 구현된 로컬 음성 합성이 필요하면 [Kokoro](./kokoro.md)를 사용하거나, 지원되는 클라우드 TTS 제공자를 선택하세요.
|
||||
@@ -0,0 +1,37 @@
|
||||
---
|
||||
title: CometAPI (TTS)
|
||||
description: AIRI에서 CometAPI 음성 합성 설정하기
|
||||
---
|
||||
|
||||
CometAPI는 호환 인터페이스를 통해 음성 합성을 제공합니다.
|
||||
|
||||
::: info 왜 CometAPI를 선택하나요?
|
||||
이미 CometAPI로 모델과 자격 증명을 관리하고 있다면, AIRI에서 API Key를 그대로 재사용할 수 있습니다.
|
||||
:::
|
||||
|
||||
## API Key 발급받기
|
||||
|
||||
1. [CometAPI Console](https://www.cometapi.com/console/token)에 로그인한 뒤, API Key를 생성하세요.
|
||||
2. 키를 복사해 안전한 곳에 보관하세요.
|
||||
|
||||
::: warning API Key 보안
|
||||
API Key를 커밋하거나, 스크린샷에 포함하거나, 누구와도 공유하지 마세요.
|
||||
:::
|
||||
|
||||
## AIRI에서 설정하기
|
||||
|
||||
1. **설정 → 제공자 → 음성 합성 → Comet API**를 열고 API Key를 입력하세요.
|
||||
2. 기본 Base URL인 `https://api.cometapi.com/v1/`를 유지하세요. 프록시나 호환 게이트웨이를 사용할 때만 수정하세요.
|
||||
|
||||
## 설정 확인
|
||||
|
||||
1. 제공자 설정에서 모델과 사용 가능한 음성을 선택하세요.
|
||||
2. 같은 페이지의 플레이그라운드에 짧은 텍스트를 입력하고 오디오가 재생되는지 확인하세요.
|
||||
|
||||
## AIRI 응답에 사용하기
|
||||
|
||||
**설정 → 모듈 → 음성 합성**을 열고 **Comet API**를 선택한 뒤, 사용 가능한 모델과 음성을 선택하세요. 플레이그라운드 테스트만으로는 일반 응답에 제공자가 활성화되지 않습니다.
|
||||
|
||||
## 문제 해결
|
||||
|
||||
확인에 실패하면 API Key, 계정 잔액, 네트워크 연결을 확인하세요. 모델 목록이 비어 있으면 계정이 현재 해당 음성 모델에 접근할 수 있는지 확인하세요.
|
||||
@@ -0,0 +1,38 @@
|
||||
---
|
||||
title: Deepgram (TTS)
|
||||
description: AIRI에서 Deepgram 음성 합성 설정하기
|
||||
---
|
||||
|
||||
Deepgram은 AIRI에서 Aura 계열의 음성 합성 모델을 제공합니다.
|
||||
|
||||
::: info 왜 Deepgram을 선택하나요?
|
||||
이미 Deepgram을 사용하고 있거나 Aura 계열의 음성 중에서 선택하고 싶다면 이 통합을 사용할 수 있습니다.
|
||||
:::
|
||||
|
||||
## API Key 발급받기
|
||||
|
||||
1. [Deepgram Console](https://console.deepgram.com/)에 로그인한 뒤, 프로젝트의 API Key 페이지에서 키를 생성하세요.
|
||||
2. 프로젝트에 음성 합성 사용 권한이 있는지 확인하세요.
|
||||
3. 키를 복사해 안전한 곳에 보관하세요.
|
||||
|
||||
::: warning API Key 보안
|
||||
API Key를 커밋하거나, 스크린샷에 포함하거나, 누구와도 공유하지 마세요.
|
||||
:::
|
||||
|
||||
## AIRI에서 설정하기
|
||||
|
||||
1. **설정 → 제공자 → 음성 합성 → Deepgram**을 열고 API Key를 붙여넣으세요.
|
||||
2. 기본 Base URL은 Deepgram의 직접 API가 아니라 AIRI/UnSpeech 게이트웨이인 `https://unspeech.hyp3r.link/v1/`입니다. API Key, 합성할 텍스트, 모델/음성 선택, 반환된 오디오가 모두 이 게이트웨이를 거칩니다. 이 신뢰 경계를 수용할 수 있는 경우에만 사용하고, 그렇지 않으면 호환되는 자체 호스팅 게이트웨이 URL을 입력하거나 직접 연결되는 제공자를 선택하세요.
|
||||
|
||||
## 설정 확인
|
||||
|
||||
1. 제공자 플레이그라운드에서 사용 가능한 Aura 음성을 선택하세요.
|
||||
2. 같은 페이지의 플레이그라운드에 짧은 텍스트를 입력하고 오디오가 재생되는지 확인하세요.
|
||||
|
||||
## AIRI 응답에 사용하기
|
||||
|
||||
**설정 → 모듈 → 음성 합성**을 열고 **Deepgram**을 선택한 뒤, 사용 가능한 모델과 음성을 선택하세요. 플레이그라운드 테스트만으로는 일반 응답에 제공자가 활성화되지 않습니다.
|
||||
|
||||
## 문제 해결
|
||||
|
||||
플레이그라운드에서 요청이 완료되지 않으면 프로젝트 API Key, 계정 권한, 네트워크 연결을 확인하세요. 음성 목록이 비어 있으면 모델을 선택하기 전에 자격 증명을 다시 테스트하세요.
|
||||
@@ -0,0 +1,14 @@
|
||||
---
|
||||
title: 데스크톱 로컬 음성 합성 (TTS, 사용 불가)
|
||||
description: 데스크톱 로컬 음성 합성은 아직 설정할 수 없습니다
|
||||
---
|
||||
|
||||
앱(로컬) 음성 합성은 아직 사용할 수 없습니다. 해당 AIRI 설정 페이지는 현재 Work in Progress 자리 표시자만 보여 주므로, 모델과 음성을 준비하거나 선택할 수 없습니다.
|
||||
|
||||
::: warning 사용 불가
|
||||
아직 실제 동작하는 설정에 이 제공자를 사용하지 마세요. 현재 사용 가능 여부를 명확히 하기 위해서만 문서화되어 있습니다.
|
||||
:::
|
||||
|
||||
## 사용 가능한 대안
|
||||
|
||||
AIRI에 구현된 로컬 음성 합성이 필요하면 [Kokoro](./kokoro.md)를 사용하거나, 지원되는 클라우드 TTS 제공자를 선택하세요.
|
||||
@@ -0,0 +1,39 @@
|
||||
---
|
||||
title: ElevenLabs (TTS)
|
||||
description: AIRI에서 ElevenLabs 음성 합성 설정하기
|
||||
---
|
||||
|
||||
ElevenLabs는 AIRI의 응답을 음성으로 합성합니다.
|
||||
|
||||
::: info 왜 ElevenLabs를 선택하나요?
|
||||
ElevenLabs 계정의 음성을 AIRI에서 직접 선택해 사용하려면 이 제공자를 선택하세요.
|
||||
:::
|
||||
|
||||
## API Key 발급받기
|
||||
|
||||
1. [ElevenLabs API Key Settings](https://elevenlabs.io/app/settings/api-keys)에 로그인한 다음 API Key를 생성하세요.
|
||||
2. 키에 알아보기 쉬운 이름과 적절한 사용 제한을 지정하세요.
|
||||
3. 키를 복사해 안전한 곳에 보관하세요.
|
||||
|
||||
::: warning API Key 보안
|
||||
API Key를 커밋하거나, 스크린샷에 포함하거나, 누구와도 공유하지 마세요. 유출이 의심되면 즉시 폐기하고 ElevenLabs 콘솔에서 다시 생성하세요.
|
||||
:::
|
||||
|
||||
## AIRI에서 설정하기
|
||||
|
||||
1. **설정 → 제공자 → 음성 합성 → ElevenLabs**를 여세요.
|
||||
2. 기본 설정에 API Key를 붙여넣으세요.
|
||||
3. 기본 Base URL은 ElevenLabs의 직접 API가 아니라 AIRI/UnSpeech 게이트웨이인 `https://unspeech.hyp3r.link/v1/`입니다. API Key, 합성할 텍스트, 모델/음성 선택, 반환된 오디오가 모두 이 게이트웨이를 거칩니다. 이 신뢰 경계를 수용할 수 있는 경우에만 사용하고, 그렇지 않으면 호환되는 자체 호스팅 게이트웨이 URL을 입력하거나 직접 연결되는 제공자를 선택하세요.
|
||||
|
||||
## 설정 확인
|
||||
|
||||
1. 제공자 플레이그라운드에서 사용 가능한 음성을 선택하세요. 이 페이지는 AIRI의 기본 ElevenLabs 모델을 사용합니다.
|
||||
2. 같은 페이지의 플레이그라운드에 짧은 텍스트를 입력하고 오디오가 재생되는지 확인하세요.
|
||||
|
||||
## AIRI 응답에 사용하기
|
||||
|
||||
**설정 → 모듈 → 음성 합성**을 열고 **ElevenLabs**를 선택한 다음 사용 가능한 모델과 음성을 선택하세요. 플레이그라운드 테스트만으로는 일반 응답에 제공자가 활성화되지 않습니다.
|
||||
|
||||
## 문제 해결
|
||||
|
||||
플레이그라운드에서 요청을 완료할 수 없으면 API Key, 구독 문자 할당량, 요청 한도, 네트워크 연결을 확인하세요. 모델은 로드되지만 오디오가 재생되지 않으면 **설정 → 모듈 → 음성 합성**에서 유효한 모델과 음성이 선택되어 있는지 확인하세요.
|
||||
@@ -0,0 +1,38 @@
|
||||
---
|
||||
title: Google Gemini (TTS)
|
||||
description: AIRI에서 Google Gemini 오디오 음성 합성 설정하기
|
||||
---
|
||||
|
||||
Google Gemini Audio 음성 합성은 Gemini 자격 증명과 오디오 출력을 지원하는 모델을 사용합니다.
|
||||
|
||||
::: info 왜 Google Gemini를 선택하나요?
|
||||
AIRI에 Google Gemini를 이미 설정했고 같은 서비스 제공자의 오디오 출력 기능을 사용하고 싶다면 이 옵션을 선택할 수 있습니다.
|
||||
:::
|
||||
|
||||
## API Key 발급받기
|
||||
|
||||
1. [Google AI Studio](https://aistudio.google.com/app/apikey)에 로그인한 다음 API Key를 생성하세요.
|
||||
2. 계정이 오디오 출력을 지원하는 Gemini 모델을 사용할 수 있는지 확인하세요.
|
||||
3. 키를 복사해 안전한 곳에 보관하세요.
|
||||
|
||||
::: warning API Key 보안
|
||||
Gemini API Key를 커밋하거나, 스크린샷에 포함하거나, 누구와도 공유하지 마세요.
|
||||
:::
|
||||
|
||||
## AIRI에서 설정하기
|
||||
|
||||
1. **설정 → 제공자 → 음성 합성 → Google Gemini**에 Gemini API Key를 입력하세요.
|
||||
2. 엔터프라이즈 게이트웨이나 호환 프록시를 사용하는 경우가 아니라면 인터페이스 기본 Base URL을 그대로 두세요.
|
||||
|
||||
## 설정 확인
|
||||
|
||||
1. 제공자 설정에서 모델과 사용 가능한 음성을 선택하세요.
|
||||
2. 같은 페이지의 플레이그라운드에 짧은 텍스트를 입력하고 오디오가 재생되는지 확인하세요.
|
||||
|
||||
## AIRI 응답에 사용하기
|
||||
|
||||
**설정 → 모듈 → 음성 합성**을 열고 **Google Gemini**를 선택한 다음 사용 가능한 오디오 모델과 음성을 선택하세요. 플레이그라운드 테스트만으로는 일반 응답에 제공자가 활성화되지 않습니다.
|
||||
|
||||
## 문제 해결
|
||||
|
||||
확인에 실패하면 API Key, 계정의 리전별 사용 가능 여부, 네트워크 연결을 확인하세요. 요청은 성공하지만 소리가 나지 않으면 선택한 모델이 실제로 오디오 출력을 지원하는지 확인하세요.
|
||||
@@ -0,0 +1,38 @@
|
||||
---
|
||||
title: Index-TTS (로컬 TTS)
|
||||
description: AIRI에서 로컬 Index-TTS 서비스에 연결하기
|
||||
---
|
||||
|
||||
Index-TTS는 로컬 HTTP 서비스를 통해 AIRI에 연결됩니다.
|
||||
|
||||
::: info 왜 Index-TTS를 선택하나요?
|
||||
Index-TTS를 이미 로컬에서 실행 중이고 소리 데이터를 로컬 네트워크 안에 유지하고 싶다면 이 옵션을 선택할 수 있습니다.
|
||||
:::
|
||||
|
||||
## 로컬 서비스 시작하기
|
||||
|
||||
1. Index-TTS의 배포 안내에 따라 서비스를 시작하세요.
|
||||
2. AIRI는 기본적으로 `http://localhost:11996/tts/`에 연결합니다. 다른 호스트나 포트를 사용한다면 전체 주소를 기록해 두세요.
|
||||
3. 서비스가 모델과 음성 정보를 반환할 수 있는지 확인하세요.
|
||||
|
||||
::: warning 로컬 서비스 보안
|
||||
로컬 서비스 포트를 신뢰할 수 없는 공용 네트워크에 노출하지 마세요. 수신 대기 주소를 변경했다면 서비스 접근을 직접 보호하세요.
|
||||
:::
|
||||
|
||||
## AIRI에서 설정하기
|
||||
|
||||
1. **설정 → 제공자 → 음성 합성 → Bilibili / IndexTTS**를 여세요.
|
||||
2. 로컬 서비스의 Base URL을 입력하세요.
|
||||
|
||||
## 설정 확인
|
||||
|
||||
1. 제공자 플레이그라운드에서 사용 가능한 음성을 선택하세요. 이 페이지는 설정한 Index-TTS 서비스와 AIRI의 기본 모델 ID를 사용합니다.
|
||||
2. 같은 페이지의 플레이그라운드에 짧은 텍스트를 입력하고 오디오가 재생되는지 확인하세요.
|
||||
|
||||
## AIRI 응답에 사용하기
|
||||
|
||||
**설정 → 모듈 → 음성 합성**을 열고 **Bilibili / IndexTTS**를 선택한 다음 모델 ID `IndexTTS-1.5`와 음성을 선택하세요. 제공자 테스트만으로는 일반 응답에 음성이 활성화되지 않습니다.
|
||||
|
||||
## 문제 해결
|
||||
|
||||
연결할 수 없으면 서비스가 실행 중인지, Base URL에 올바른 포트가 포함되어 있는지 확인하고 로컬 방화벽이나 리버스 프록시를 점검하세요. 음성 목록이 비어 있으면 서비스의 `audio/voices` 인터페이스가 사용 가능한지 확인하세요.
|
||||
@@ -0,0 +1,34 @@
|
||||
---
|
||||
title: Kokoro TTS (로컬)
|
||||
description: AIRI에서 네이티브 Kokoro 음성 합성 설정하기
|
||||
---
|
||||
|
||||
Kokoro는 AIRI 안에서 네이티브 모델로 음성 합성을 실행합니다.
|
||||
|
||||
::: info 왜 Kokoro를 선택하나요?
|
||||
음성을 로컬에서 합성하고 싶고 기기에 모델을 실행할 자원이 충분하다면 Kokoro를 선택하세요.
|
||||
:::
|
||||
|
||||
## 로컬 실행 환경 준비하기
|
||||
|
||||
1. AIRI를 열고 첫 사용 시 모델 다운로드가 완료될 때까지 기다리세요.
|
||||
2. WebGPU를 사용할 수 있으면 합성이 가속됩니다. WebGPU가 없어도 AIRI는 WASM으로 대체 동작할 수 있지만, 일반적으로 합성이 느려지고 CPU를 더 많이 사용합니다.
|
||||
3. 이 옵션은 클라우드 API Key가 필요 없지만 로컬 저장 공간, 메모리, 연산 자원을 사용합니다.
|
||||
|
||||
::: warning 로컬 자원 사용
|
||||
모델은 로컬 저장 공간, 메모리, CPU 또는 GPU 자원을 사용합니다. 다운로드가 완료되지 않거나, 메모리 압박이 크거나, 합성 때문에 기기가 응답하지 않으면 호스팅형 음성 제공자를 대신 사용하세요.
|
||||
:::
|
||||
|
||||
## AIRI에서 설정하기
|
||||
|
||||
1. **설정 → 제공자 → 음성 합성 → Kokoro TTS (Local)**를 여세요.
|
||||
2. AIRI가 제공하는 사용 가능한 Kokoro 모델을 선택하세요.
|
||||
|
||||
## 설정 확인
|
||||
|
||||
1. **모델과 음성 선택**: 모델이 준비되면 음성을 선택한 다음 **설정 → 모듈 → 음성 합성**으로 이동해 활성화하세요.
|
||||
2. 짧은 테스트 문장을 입력하고 AIRI가 생성된 오디오를 재생하는지 확인하세요.
|
||||
|
||||
## 문제 해결
|
||||
|
||||
모델을 로드할 수 없으면 사용 가능한 저장 공간과 메모리를 확인한 다음 페이지를 다시 열어 다운로드가 끝날 때까지 기다리세요. WebGPU를 사용할 수 없으면 WASM 대체 동작이 초기화와 합성을 마칠 때까지 시간을 더 주세요.
|
||||
@@ -0,0 +1,43 @@
|
||||
---
|
||||
title: Xiaomi MiMo (TTS)
|
||||
description: AIRI에서 Xiaomi MiMo 음성 합성 설정하기
|
||||
---
|
||||
|
||||
MiMo는 프리셋 음성, 사운드 디자인, 음성 복제의 세 가지 음성 합성 모드를 지원합니다.
|
||||
|
||||
::: info 왜 Xiaomi MiMo를 선택하나요?
|
||||
MiMo의 프리셋 중국어 음성이 필요하거나 텍스트 설명으로 음성을 디자인하고 싶다면 MiMo를 선택하세요.
|
||||
:::
|
||||
|
||||
## API Key 발급받기
|
||||
|
||||
1. [Xiaomi MiMo Platform](https://platform.xiaomimimo.com/)에 로그인한 다음 계정에 API 접근이 활성화되어 있는지 확인하세요.
|
||||
2. API Key를 생성하고 복사해 안전한 곳에 보관하세요.
|
||||
|
||||
::: warning 음성 샘플과 API Key 보안
|
||||
음성 복제에는 Base64 data URI 형식의 오디오 샘플이 필요합니다. 사용 권한이 있는 샘플만 업로드하고, API Key나 타인의 음성 샘플을 절대 공개하지 마세요.
|
||||
:::
|
||||
|
||||
## AIRI에서 설정하기
|
||||
|
||||
1. **설정 → 제공자 → 음성 합성 → Xiaomi MiMo**에 API Key를 입력하세요.
|
||||
2. 서비스 제공자가 다른 주소를 안내하지 않는 한 기본 Base URL인 `https://api.xiaomimimo.com/v1/`를 유지하세요.
|
||||
|
||||
## 설정 확인
|
||||
|
||||
1. 제공자 설정에서 모델과 사용 가능한 음성을 선택하세요.
|
||||
2. 같은 페이지의 플레이그라운드에 짧은 텍스트를 입력하고 오디오가 재생되는지 확인하세요.
|
||||
|
||||
## AIRI 응답에 사용하기
|
||||
|
||||
**설정 → 모듈 → 음성 합성**을 열고 **Xiaomi MiMo**를 선택한 다음 사용 사례에 맞는 TTS 모델을 선택하세요:
|
||||
|
||||
- 프리셋 음성에는 `mimo-v2.5-tts`
|
||||
- 텍스트 설명으로 만든 음성에는 `mimo-v2.5-tts-voicedesign`
|
||||
- 사용 허가를 받은 음성 샘플에는 `mimo-v2.5-tts-voiceclone`
|
||||
|
||||
선택한 모드가 음성을 제공하면 음성을 선택하세요. 제공자 테스트만으로는 일반 응답에 음성이 활성화되지 않습니다.
|
||||
|
||||
## 문제 해결
|
||||
|
||||
요청이 실패하면 API Key, TTS 모델, 필요한 음성이나 프롬프트, 네트워크 연결을 확인하세요. 음성 복제가 실패하면 샘플이 유효한 Base64 data URI인지, 그리고 해당 녹음의 사용 권한이 있는지 확인하세요.
|
||||
@@ -0,0 +1,14 @@
|
||||
---
|
||||
title: MiniMax Speech (TTS, 사용 불가)
|
||||
description: AIRI에서 MiniMax 음성 합성의 현재 사용 가능 여부
|
||||
---
|
||||
|
||||
MiniMax Speech는 AIRI의 제공자 레지스트리에 표시되지만, 현재 앱에는 MiniMax Speech 설정 페이지가 포함되어 있지 않습니다. 따라서 **설정 → 제공자 → 음성 합성**에서 선택해도 사용 가능한 설정을 완료할 수 없습니다.
|
||||
|
||||
::: warning AIRI 0.11.3에서 사용 불가
|
||||
이 버전에서는 자격 증명을 입력하거나 MiniMax 설정 절차를 따라 하지 마세요. 제공자 라우트가 구현되어 있지 않아 AIRI가 UI에서 필요한 설정을 저장하거나 테스트할 수 없습니다.
|
||||
:::
|
||||
|
||||
## 대신 사용할 수 있는 방법
|
||||
|
||||
**설정 → 제공자 → 음성 합성**에서 설정 페이지가 동작하는 다른 제공자를 선택하세요. 사용 중인 서비스가 OpenAI 호환 음성 엔드포인트를 제공한다면 [OpenAI Compatible API (TTS)](./openai.md)를 사용하고 해당 서비스가 문서화한 Base URL과 모델 ID를 따르세요.
|
||||
@@ -0,0 +1,39 @@
|
||||
---
|
||||
title: 공식 음성 합성 제공자 (TTS)
|
||||
description: AIRI에서 공식 제공 음성 합성 사용하기
|
||||
---
|
||||
|
||||
공식 음성 합성은 활성화된 AIRI 세션을 사용하며, 서드파티 API Key가 필요하지 않습니다.
|
||||
|
||||
::: info 왜 AIRI 공식 음성 합성을 선택하나요?
|
||||
이미 공식 AIRI 제공자를 사용하고 있고 서드파티 자격 증명 설정을 줄이고 싶다면 이 옵션을 먼저 사용해 보세요.
|
||||
:::
|
||||
|
||||
## 계정에 로그인하기
|
||||
|
||||
1. AIRI 계정으로 로그인하세요.
|
||||
2. 현재 세션에서 공식 음성 합성 제공자를 사용할 수 있는지 확인하세요.
|
||||
|
||||
::: warning 계정 및 서비스 가용성
|
||||
사용 가능한 모델, 할당량, 지역은 공식 서비스에 따라 결정됩니다. 계정 세션이나 브라우저 세션 데이터를 공유하지 마세요.
|
||||
:::
|
||||
|
||||
## AIRI에서 설정하기
|
||||
|
||||
1. **설정 → 제공자 → 음성 합성 → Official Speech Provider**를 여세요.
|
||||
2. 로그인하라는 안내가 표시되면 로그인하세요. 페이지에 Flux 잔액과 정상 연결 상태가 표시되는지 확인하세요.
|
||||
|
||||
## 설정 확인
|
||||
|
||||
1. **설정 → 모듈 → 음성 합성**을 열고 **Official Speech Provider**를 선택한 다음 사용 가능한 모델과 음성을 선택하세요.
|
||||
2. 짧은 테스트 문장을 입력하고 **Test Voice**를 클릭한 다음 AIRI가 생성된 오디오를 재생하는지 확인하세요.
|
||||
|
||||
## 스트리밍 제공자 (선택 사항)
|
||||
|
||||
공식 서비스에서 스트리밍 TTS를 사용할 수 있다고 알리면, AIRI는 **설정 → 제공자 → 음성 합성** 아래에 별도의 **Official Streaming Speech Provider** 카드를 표시합니다.
|
||||
|
||||
**설정 → 모듈 → 음성 합성**에서는 **Official Speech Provider**를 그대로 선택해 두세요. AIRI는 해당 제공자의 모델 목록에 스트리밍 모델을 포함합니다. 스트리밍 모델과 음성을 선택하면 AIRI가 선택된 모델에 맞춰 내부 음성 합성 제공자를 자동으로 전환합니다.
|
||||
|
||||
## 문제 해결
|
||||
|
||||
제공자를 사용할 수 없으면 로그인되어 있는지, AIRI가 공식 서비스에 접근할 수 있는지 확인하세요. 계정에 Flux가 충분한지도 확인하세요. **설정 → Flux**를 열면 사용 가능한 패키지를 볼 수 있습니다. 데스크톱 버전은 시스템 브라우저에서 결제 페이지를 엽니다. 빌드나 배포 환경이 구매를 지원하지 않으면 구매 옵션이 표시되지 않습니다.
|
||||
@@ -0,0 +1,37 @@
|
||||
---
|
||||
title: OpenAI 호환 API (TTS)
|
||||
description: AIRI에서 OpenAI 또는 OpenAI 호환 API를 음성 합성 제공자로 설정하기
|
||||
---
|
||||
|
||||
이 페이지에서는 OpenAI 음성 API를 구현하는 제공자를 설정합니다. 제공자를 저장한 다음 **설정 → 모듈 → 음성 합성**에서 해당 모델과 음성을 선택하세요.
|
||||
|
||||
::: info 왜 TTS에 OpenAI 호환 API를 사용하나요?
|
||||
사용 중인 음성 서비스가 OpenAI 음성 API를 명시적으로 지원할 때 이 제공자를 사용하세요. API 주소가 `/v1`로 끝나거나 키가 `sk-`로 시작한다고 해서 호환성이 보장되는 것은 아닙니다.
|
||||
:::
|
||||
|
||||
## API Key 발급받기
|
||||
|
||||
1. 선택한 서비스 제공자의 관리 콘솔에 로그인하세요.
|
||||
2. API Key 또는 개발자 설정 페이지에서 API Key를 생성하세요.
|
||||
3. 키를 복사해 안전한 곳에 보관하세요.
|
||||
|
||||
::: warning API Key 보안
|
||||
API Key를 커밋하거나, 스크린샷에 포함하거나, 누구와도 공유하지 마세요. 키가 유출되면 즉시 폐기하고 제공자 콘솔에서 새 키를 만드세요.
|
||||
:::
|
||||
|
||||
## AIRI에서 설정하기
|
||||
|
||||
1. **설정 → 제공자 → 음성 합성 → OpenAI Compatible**을 여세요.
|
||||
2. API Key와 사용할 TTS 모델 ID를 입력하세요.
|
||||
3. 공식 OpenAI를 사용하려면 별도의 **OpenAI** 제공자를 선택하세요. **OpenAI Compatible** 제공자에는 기본 Base URL이 없으므로, 호환 서비스 문서에 안내된 전체 API 루트를 입력하세요.
|
||||
4. 필요에 따라 말하기 속도를 조정하세요.
|
||||
|
||||
## 설정 확인
|
||||
|
||||
1. **설정 → 모듈 → 음성 합성**에서 설정한 제공자, 모델, 음성을 선택하세요.
|
||||
2. 테스트 텍스트를 입력하고 **Test Voice**를 클릭하세요.
|
||||
3. 테스트 오디오가 재생되면 제공자가 올바르게 설정된 것입니다. AIRI에 오류가 표시되면 오류 메시지를 참고해 자격 증명, 모델 ID, Base URL을 확인하세요.
|
||||
|
||||
## 문제 해결
|
||||
|
||||
오디오가 재생되지 않으면 선택한 모델과 음성을 제공자가 지원하는지 확인하세요. 호환 서비스라면 해당 서비스가 OpenAI 음성 API를 구현하는지 확인하세요.
|
||||
@@ -0,0 +1,36 @@
|
||||
---
|
||||
title: OpenRouter (TTS)
|
||||
description: AIRI에서 OpenRouter를 음성 합성 서비스 제공자로 설정하기
|
||||
---
|
||||
|
||||
OpenRouter는 여러 API를 통합해 제공하는 서비스 제공자입니다. 설정을 완료한 다음 **설정 → 모듈 → 음성 합성**에서 OpenRouter가 제공하는 모델과 음성을 선택하세요.
|
||||
|
||||
::: info 왜 OpenRouter Voice를 선택하나요?
|
||||
지원되는 음성 합성 모델과 음성을 OpenRouter 계정으로 관리하고 싶다면 이 제공자를 선택하세요. 사용 가능 여부는 네트워크 환경, 결제 수단, OpenRouter 정책에 따라 달라질 수 있습니다.
|
||||
:::
|
||||
|
||||
## API Key 발급받기
|
||||
|
||||
1. [OpenRouter API Keys](https://openrouter.ai/keys)를 열고 새 API Key를 생성하세요.
|
||||
2. 키에 적절한 이름, 유효 기간, 할당량 제한을 설정하세요.
|
||||
3. 키를 복사해 안전한 곳에 보관하세요.
|
||||
|
||||
::: warning API Key 보안
|
||||
API Key를 커밋하거나, 스크린샷에 포함하거나, 누구와도 공유하지 마세요. 키가 유출되면 즉시 폐기하고 OpenRouter 콘솔에서 새 키를 만드세요.
|
||||
:::
|
||||
|
||||
## AIRI에서 설정하기
|
||||
|
||||
1. **설정 → 제공자 → 음성 합성 → OpenRouter**를 여세요.
|
||||
2. 기본 설정에 API Key를 붙여넣으세요.
|
||||
3. 기본 Base URL인 `https://openrouter.ai/api/v1/`를 그대로 유지하세요.
|
||||
|
||||
## 설정 확인
|
||||
|
||||
1. **설정 → 모듈 → 음성 합성**에서 설정한 제공자, 모델, 음성을 선택하세요.
|
||||
2. 테스트 텍스트를 입력하고 **Test Voice**를 클릭하세요.
|
||||
3. 테스트 오디오가 재생되면 제공자가 올바르게 설정된 것입니다. AIRI에 오류가 표시되면 오류 메시지를 참고해 자격 증명과 모델을 확인하세요.
|
||||
|
||||
## 문제 해결
|
||||
|
||||
소리가 나지 않으면 선택한 모델이 음성 출력을 제공하는지 확인하고, 계정 잔액과 네트워크 연결을 점검하세요.
|
||||
@@ -0,0 +1,37 @@
|
||||
---
|
||||
title: Player2 (TTS)
|
||||
description: AIRI에서 로컬 Player2 Speech 서비스에 연결하기
|
||||
---
|
||||
|
||||
Player2 Speech는 로컬 서비스를 통해 연결하는 음성 합성 옵션입니다.
|
||||
|
||||
::: info 왜 Player2를 선택하나요?
|
||||
이미 Player2 Speech를 로컬 또는 신뢰할 수 있는 LAN에서 실행하고 있다면, AIRI를 해당 서비스에 연결해 사용 가능한 음성을 이용할 수 있습니다.
|
||||
:::
|
||||
|
||||
## 로컬 서비스 시작하기
|
||||
|
||||
1. Player2 Speech 서비스를 시작하고 헬스 체크가 가능한지 확인하세요.
|
||||
2. AIRI는 기본적으로 `http://localhost:4315/v1/`에 연결합니다. 서비스가 다른 주소에서 실행 중이라면 전체 Base URL을 기록해 두세요.
|
||||
|
||||
::: warning 로컬 서비스 보안
|
||||
로컬 서비스 포트를 신뢰할 수 없는 공용 네트워크에 노출하지 마세요.
|
||||
:::
|
||||
|
||||
## AIRI에서 설정하기
|
||||
|
||||
1. **설정 → 제공자 → 음성 합성 → Player2**를 여세요.
|
||||
2. 서비스의 Base URL을 입력하세요.
|
||||
|
||||
## 설정 확인
|
||||
|
||||
1. 제공자 플레이그라운드에서 사용 가능한 음성을 선택하세요. 이 페이지는 AIRI의 기본 Player2 모델을 사용합니다.
|
||||
2. 같은 페이지의 플레이그라운드에 짧은 텍스트를 입력하고 오디오가 재생되는지 확인하세요.
|
||||
|
||||
## AIRI 응답에 사용하기
|
||||
|
||||
**설정 → 모듈 → 음성 합성**을 열고 **Player2**를 선택한 다음 사용 가능한 모델과 음성을 선택하세요. 플레이그라운드 테스트만으로는 일반 응답에 제공자가 활성화되지 않습니다.
|
||||
|
||||
## 문제 해결
|
||||
|
||||
연결이 실패하면 서비스의 `/health` 응답과 Base URL을 확인하세요. 음성 목록이 비어 있으면 서비스의 `/tts/voices` 인터페이스에 접근할 수 있는지 확인하세요.
|
||||
@@ -0,0 +1,38 @@
|
||||
---
|
||||
title: Volcano Engine (TTS)
|
||||
description: AIRI에서 Volcano Engine 음성 합성 설정하기
|
||||
---
|
||||
|
||||
Volcengine 음성 합성을 사용하려면 AIRI에 API Key와 애플리케이션 정보를 입력해야 합니다.
|
||||
|
||||
::: info 왜 Volcengine을 선택하나요?
|
||||
이미 Volcengine에서 음성 애플리케이션을 만들고 음성 리소스를 관리하고 있다면, 해당 설정을 AIRI에서 재사용할 수 있습니다.
|
||||
:::
|
||||
|
||||
## 애플리케이션 자격 증명 준비하기
|
||||
|
||||
1. [Volcengine Speech 콘솔](https://console.volcengine.com/speech/app)에 로그인한 다음 음성 애플리케이션을 새로 만들거나 기존 애플리케이션을 여세요.
|
||||
2. 애플리케이션의 **App ID**를 복사하고 해당 **API Key**를 생성하세요.
|
||||
3. 두 정보가 같은 계정과 애플리케이션 설정에서 나온 것인지 확인하세요.
|
||||
|
||||
::: warning API Key 보안
|
||||
API Key나 App ID를 커밋하거나, 스크린샷에 포함하거나, 누구와도 공유하지 마세요. 키나 ID가 유출되면 즉시 폐기하고 Volcengine 콘솔에서 새 키를 만드세요.
|
||||
:::
|
||||
|
||||
## AIRI에서 설정하기
|
||||
|
||||
1. **설정 → 제공자 → 음성 합성 → Volcano Engine**을 여세요.
|
||||
2. API Key와 App ID를 입력하세요. 기본 Base URL은 Volcengine의 직접 API가 아니라 AIRI/UnSpeech 게이트웨이인 `https://unspeech.hyp3r.link/v1/`입니다. 자격 증명, 합성할 텍스트, 모델/음성 선택, 반환된 오디오가 모두 이 게이트웨이를 거칩니다. 이 신뢰 경계를 수용할 수 있는 경우에만 사용하고, 그렇지 않으면 호환되는 자체 호스팅 게이트웨이 URL을 입력하거나 직접 연결되는 제공자를 선택하세요.
|
||||
|
||||
## 설정 확인
|
||||
|
||||
1. 제공자 플레이그라운드에서 사용 가능한 음성을 선택하세요. 이 페이지는 AIRI의 기본 Volcengine 음성 합성 모델을 사용합니다.
|
||||
2. 같은 페이지의 플레이그라운드에 짧은 텍스트를 입력하고 오디오가 재생되는지 확인하세요.
|
||||
|
||||
## AIRI 응답에 사용하기
|
||||
|
||||
**설정 → 모듈 → 음성 합성**을 열고 **Volcano Engine**을 선택한 다음 사용 가능한 모델과 음성을 선택하세요. 제공자 플레이그라운드는 자격 증명을 테스트할 뿐이며, 이 모듈 선택이 일반 AIRI 응답에 음성을 활성화합니다.
|
||||
|
||||
## 문제 해결
|
||||
|
||||
확인에 실패하면 App ID와 API Key가 같은 애플리케이션의 것인지 확인하세요. 소리가 나지 않으면 앱에서 음성 합성이 활성화되어 있고 음성이 선택되어 있는지 확인하세요.
|
||||
@@ -0,0 +1,37 @@
|
||||
---
|
||||
title: Aliyun NLS
|
||||
description: AIRI에서 Alibaba Cloud 지능형 음성 상호작용 서비스(ASR) 설정하기
|
||||
---
|
||||
|
||||
Alibaba Cloud NLS는 AIRI에 실시간 음성 인식(ASR)을 제공합니다. 설정을 완료한 후 **설정 → 모듈 → 청각**에서 **Aliyun NLS**를 선택하고 마이크 입력을 테스트하세요.
|
||||
|
||||
::: info 왜 Alibaba Cloud NLS를 선택하나요?
|
||||
이미 Alibaba Cloud 계정을 사용 중이고 실시간 음성 인식 기능이 필요하다면 Alibaba Cloud NLS를 선택할 수 있습니다.
|
||||
:::
|
||||
|
||||
## 자격 증명 준비하기
|
||||
|
||||
1. [Alibaba Cloud 지능형 음성 상호작용 콘솔](https://nls-portal.console.aliyun.com/overview)에서 서비스를 활성화하고 프로젝트를 만든 뒤 **AppKey**를 복사하세요.
|
||||
2. **AccessKey Management**에서 필요한 권한을 가진 RAM 사용자 AccessKey를 만드세요.
|
||||
3. **AccessKey ID**와 **AccessKey Secret**을 복사하세요. Secret은 보통 전체 값이 한 번만 표시됩니다.
|
||||
|
||||
::: warning AccessKey 보안
|
||||
AccessKey ID, AccessKey Secret, AppKey를 커밋하거나, 스크린샷에 포함하거나, 누구와도 공유하지 마세요. RAM 사용자에게는 필요한 권한만 부여하세요. 자격 증명이 유출되면 즉시 비활성화하고 Alibaba Cloud 콘솔에서 대체 자격 증명을 만드세요.
|
||||
:::
|
||||
|
||||
## AIRI에서 설정하기
|
||||
|
||||
1. **설정 → 제공자 → 전사 → Aliyun NLS**를 여세요.
|
||||
2. **AccessKey ID**, **AccessKey Secret**, **AppKey**를 입력하세요.
|
||||
3. 중국 동부 `cn-shanghai`, 중국 북부 `cn-beijing`, 중국 남부 `cn-shenzhen`처럼 가장 가까운 지역을 선택하세요.
|
||||
|
||||
## 설정 확인
|
||||
|
||||
1. 확인 페이지에 기본 자격 증명 검증이 통과되었다는 안내가 표시됩니다.
|
||||
2. **설정 → 모듈 → 청각**에서 **Aliyun NLS**와 오디오 입력 장치를 선택하세요.
|
||||
3. "Start Monitoring"을 클릭한 뒤 마이크에 대고 말하거나 오디오 클립을 재생하세요.
|
||||
4. 전사 영역에 텍스트가 실시간으로 출력되는지 확인하세요. 인식 결과가 부정확하면 감도를 조정한 뒤 다시 테스트할 수 있습니다.
|
||||
|
||||
## 문제 해결
|
||||
|
||||
자격 증명 검증에 실패하면 세 가지 자격 증명이 모두 같은 Alibaba Cloud 계정과 프로젝트에서 발급된 것인지 확인한 뒤 RAM 사용자 권한을 점검하세요. 텍스트가 표시되지 않으면 운영 체제가 AIRI에 마이크 접근 권한을 부여했는지 확인하세요.
|
||||
@@ -0,0 +1,14 @@
|
||||
---
|
||||
title: 브라우저 로컬 음성 인식 (ASR/STT, 사용 불가)
|
||||
description: 브라우저 로컬 음성 인식은 아직 설정할 수 없습니다
|
||||
---
|
||||
|
||||
Browser (Local) 음성 인식은 아직 사용할 수 없습니다. AIRI 설정 페이지에는 현재 Work in Progress 플레이스홀더만 표시되어 모델을 준비하거나 활성화할 수 없습니다.
|
||||
|
||||
::: warning 사용 불가
|
||||
아직 실제 사용 환경 구성에 이 제공자를 사용하지 마세요. 현재 사용 가능 여부를 명확히 알리기 위해서만 문서화되어 있습니다.
|
||||
:::
|
||||
|
||||
## 사용 가능한 대안
|
||||
|
||||
지원되는 브라우저에서 [Web Speech API](./web-speech-api.md)를 사용하거나, 지원되는 클라우드 전사 제공자를 선택하세요.
|
||||
@@ -0,0 +1,37 @@
|
||||
---
|
||||
title: CometAPI (ASR/STT)
|
||||
description: AIRI에서 CometAPI 음성 인식 설정하기
|
||||
---
|
||||
|
||||
CometAPI는 호환 인터페이스를 통해 오디오 전사를 제공합니다.
|
||||
|
||||
::: info 왜 CometAPI를 선택하나요?
|
||||
CometAPI로 모델과 자격 증명을 관리해 본 적이 있다면, 같은 API Key를 AIRI에서 음성 인식에 바로 재사용할 수 있습니다.
|
||||
:::
|
||||
|
||||
## API Key 발급받기
|
||||
|
||||
1. [CometAPI 콘솔](https://www.cometapi.com/console/token)에 로그인한 뒤 API Key를 만드세요.
|
||||
2. 계정이 오디오 전사 모델에 접근할 수 있는지 확인한 뒤 키를 복사해 안전하게 보관하세요.
|
||||
|
||||
::: warning API Key 보안
|
||||
API Key를 커밋하거나, 스크린샷에 포함하거나, 누구와도 공유하지 마세요.
|
||||
:::
|
||||
|
||||
## AIRI에서 설정하기
|
||||
|
||||
1. **설정 → 제공자 → 전사 → Comet API**를 열고 API Key를 입력하세요.
|
||||
2. 기본 Base URL `https://api.cometapi.com/v1/`를 유지하세요. 프록시나 호환 게이트웨이를 사용할 때만 수정하세요.
|
||||
|
||||
## 설정 확인
|
||||
|
||||
1. 제공자 설정에서 사용 가능한 전사 모델을 선택하세요.
|
||||
2. 같은 페이지의 플레이그라운드에서 마이크 접근을 허용하고 짧은 샘플을 녹음해 텍스트가 반환되는지 확인하세요.
|
||||
|
||||
## 마이크 전사 활성화하기
|
||||
|
||||
**설정 → 모듈 → 청각**을 열어 **Comet API**와 사용 가능한 모델을 선택한 뒤, 마이크를 선택하고 청각 테스트를 실행하세요. 제공자 페이지에서만 테스트하는 것으로는 마이크 전사가 활성화되지 않습니다.
|
||||
|
||||
## 문제 해결
|
||||
|
||||
플레이그라운드에서 요청이 완료되지 않으면 API Key, 계정 권한, 네트워크 연결을 확인하세요. 텍스트가 표시되지 않으면 AIRI에 마이크 접근 권한이 있는지 확인하세요.
|
||||
@@ -0,0 +1,14 @@
|
||||
---
|
||||
title: 데스크톱 로컬 음성 인식 (ASR/STT, 사용 불가)
|
||||
description: 데스크톱 로컬 음성 인식은 아직 설정할 수 없습니다
|
||||
---
|
||||
|
||||
App (Local) 음성 인식은 아직 사용할 수 없습니다. AIRI 설정 페이지에는 현재 Work in Progress 플레이스홀더만 표시되어 모델을 준비하거나 활성화할 수 없습니다.
|
||||
|
||||
::: warning 사용 불가
|
||||
아직 실제 사용 환경 구성에 이 제공자를 사용하지 마세요. 현재 사용 가능 여부를 명확히 알리기 위해서만 문서화되어 있습니다.
|
||||
:::
|
||||
|
||||
## 사용 가능한 대안
|
||||
|
||||
지원되는 브라우저에서 [Web Speech API](./web-speech-api.md)를 사용하거나, 지원되는 클라우드 전사 제공자를 선택하세요.
|
||||
@@ -0,0 +1,37 @@
|
||||
---
|
||||
title: Xiaomi MiMo (ASR/STT)
|
||||
description: AIRI에서 Xiaomi MiMo 음성 인식 설정하기
|
||||
---
|
||||
|
||||
MiMo는 자체 오디오 이해 모델을 사용해 음성 전사를 수행합니다.
|
||||
|
||||
::: info 왜 Xiaomi MiMo를 선택하나요?
|
||||
이미 MiMo를 사용하고 있거나, MiMo의 멀티모달 모델로 오디오 콘텐츠를 처리하고 싶다면 이 서비스 제공자를 선택할 수 있습니다.
|
||||
:::
|
||||
|
||||
## API Key 발급받기
|
||||
|
||||
1. [Xiaomi MiMo Platform](https://platform.xiaomimimo.com/)에 로그인한 뒤, 계정에 API 접근이 활성화되어 있는지 확인하세요.
|
||||
2. API Key를 생성하고 복사해 안전한 곳에 보관하세요.
|
||||
|
||||
::: warning API Key와 오디오 데이터
|
||||
API Key를 노출하지 마세요. 클라우드 전사는 오디오를 제공자에게 전송해 처리하므로, 이것이 개인정보 및 데이터 처리 요구 사항에 부합하는지 확인하세요.
|
||||
:::
|
||||
|
||||
## AIRI에서 설정하기
|
||||
|
||||
1. **설정 → 제공자 → 전사 → Xiaomi MiMo**에 API Key를 입력하세요.
|
||||
2. 서비스 제공자가 다른 주소를 제공하지 않는 한 기본 Base URL `https://api.xiaomimimo.com/v1/`를 유지하세요.
|
||||
|
||||
## 설정 확인
|
||||
|
||||
1. 제공자 설정에서 사용 가능한 전사 모델을 선택하세요.
|
||||
2. 같은 페이지의 플레이그라운드에서 마이크 접근을 허용하고, 짧은 샘플을 녹음해 텍스트가 반환되는지 확인하세요.
|
||||
|
||||
## 마이크 전사 활성화하기
|
||||
|
||||
**설정 → 모듈 → 청각**을 열고 **Xiaomi MiMo**를 선택한 뒤, 모델 ID `mimo-v2-omni`를 선택하고 마이크를 골라 청각 테스트를 실행하세요. 제공자 페이지에서만 테스트하는 것으로는 마이크 전사가 활성화되지 않습니다.
|
||||
|
||||
## 문제 해결
|
||||
|
||||
요청이 실패하면 API Key, 모델 선택, 네트워크 연결을 확인하세요. 텍스트가 반환되지 않으면 AIRI에 마이크 권한이 있는지 확인하세요.
|
||||
@@ -0,0 +1,34 @@
|
||||
---
|
||||
title: 공식 전사 제공자 (ASR/STT)
|
||||
description: AIRI에서 공식 실시간 음성 인식 사용하기
|
||||
---
|
||||
|
||||
공식 전사는 현재 AIRI 세션을 사용하므로 서드파티 API Key가 필요하지 않습니다.
|
||||
|
||||
::: info 왜 AIRI 공식 음성 인식을 선택하나요?
|
||||
이미 공식 AIRI 제공자를 사용하고 있고 실시간 음성 입력을 빠르게 활성화하고 싶다면, 이 옵션을 먼저 시도해 볼 수 있습니다.
|
||||
:::
|
||||
|
||||
## 계정에 로그인하기
|
||||
|
||||
1. AIRI 계정으로 로그인하세요.
|
||||
2. 현재 세션에서 공식 전사 제공자를 사용할 수 있는지 확인하세요.
|
||||
|
||||
::: warning 계정과 오디오 데이터
|
||||
실시간 인식은 오디오를 공식 서비스로 전송합니다. 민감한 정보가 포함된 테스트 오디오를 사용하지 말고, 계정 세션 정보를 공유하지 마세요.
|
||||
:::
|
||||
|
||||
## AIRI에서 설정하기
|
||||
|
||||
1. **설정 → 제공자 → 전사 → 공식 전사 제공자**를 여세요.
|
||||
2. 로그인한 계정에서 제공자 페이지를 사용할 수 있는지 확인하세요. 이 페이지에는 활성 모델 선택기가 없습니다.
|
||||
3. **설정 → 모듈 → 청각**을 열고 **공식 전사 제공자**를 선택한 뒤 **Auto**를 선택하세요. 현재 제공자는 `Auto` 모델만 제공합니다.
|
||||
|
||||
## 설정 확인
|
||||
|
||||
1. AIRI가 마이크를 사용하도록 허용하고 짧은 음성 입력을 해 보세요.
|
||||
2. 전사 결과가 표시되면 제공자가 올바르게 설정된 것입니다.
|
||||
|
||||
## 문제 해결
|
||||
|
||||
모델을 사용할 수 없다면 로그인되어 있는지, AIRI가 서비스에 연결할 수 있는지, 계정에 사용 가능한 크레딧이 있는지 확인하세요. 전사 결과가 표시되지 않으면 운영 체제에서 AIRI의 마이크 권한을 확인하세요.
|
||||
@@ -0,0 +1,36 @@
|
||||
---
|
||||
title: OpenAI 호환 API (ASR/STT)
|
||||
description: AIRI에서 OpenAI 또는 OpenAI 호환 API를 음성 인식 제공자로 설정하기
|
||||
---
|
||||
|
||||
이 페이지에서는 OpenAI 호환 전사 API를 설정합니다. 저장한 뒤 **설정 → 모듈 → 청각**에서 제공자와 모델을 선택하고 마이크 입력을 테스트하세요.
|
||||
|
||||
::: info 왜 ASR/STT에 OpenAI 호환 API를 사용하나요?
|
||||
전사 제공자가 OpenAI 전사 API를 구현하고 있다면, 이 가이드를 따라 AIRI에 연결하세요. API 주소가 `/v1`로 끝나거나 키가 `sk-`로 시작한다고 해서 호환성이 보장되는 것은 아닙니다.
|
||||
:::
|
||||
|
||||
## API Key 발급받기
|
||||
|
||||
1. 선택한 서비스 제공자의 관리 콘솔에 로그인하세요.
|
||||
2. API Key 또는 Developer Settings 페이지에서 API Key를 생성하세요.
|
||||
3. 키를 복사해 안전한 곳에 보관하세요.
|
||||
|
||||
::: warning API Key 보안
|
||||
API Key를 커밋하거나, 스크린샷에 포함하거나, 누구와도 공유하지 마세요. 키가 유출되면 즉시 폐기하고 제공자 콘솔에서 새 키를 만드세요.
|
||||
:::
|
||||
|
||||
## AIRI에서 설정하기
|
||||
|
||||
1. **설정 → 제공자 → 전사 → OpenAI Compatible**을 여세요.
|
||||
2. API Key와 사용할 ASR/STT 모델 ID를 입력하세요.
|
||||
3. 공식 OpenAI를 사용하려면 별도의 **OpenAI** 제공자를 선택하세요. **OpenAI Compatible** 제공자에는 기본 Base URL이 없으므로, 호환 서비스 문서에 안내된 완전한 API 루트를 입력하세요.
|
||||
|
||||
## 설정 확인
|
||||
|
||||
1. **설정 → 모듈 → 청각**에서 설정한 서비스 제공자와 모델을 선택한 뒤, 오디오 입력 장치를 선택하세요.
|
||||
2. **Start Monitoring**을 클릭한 뒤 마이크에 대고 말하거나 오디오 클립을 재생하세요.
|
||||
3. 전사 영역에 텍스트가 표시되는지 확인하세요. 인식이 부정확하면 감도를 조정하고 다시 테스트하세요.
|
||||
|
||||
## 문제 해결
|
||||
|
||||
텍스트 결과가 없으면 AIRI에 마이크 권한이 있는지 확인하세요. 호환 서비스를 사용하는 경우, 해당 서비스가 OpenAI 전사 API를 구현하고 입력한 모델 ID를 지원하는지 확인하세요.
|
||||
@@ -0,0 +1,34 @@
|
||||
---
|
||||
title: 브라우저 Web Speech API (ASR/STT)
|
||||
description: AIRI 웹에서 브라우저 내장 음성 인식 사용하기
|
||||
---
|
||||
|
||||
Web Speech API는 브라우저에 내장된 음성 인식 기능을 사용하며 API Key가 필요하지 않습니다.
|
||||
|
||||
::: info 왜 Web Speech API를 선택하나요?
|
||||
웹에서 음성 입력을 빠르게 시험해 보고 싶고 브라우저가 Web Speech API를 지원한다면, 이것이 가장 간단한 설정 옵션입니다.
|
||||
:::
|
||||
|
||||
## 브라우저 지원 확인
|
||||
|
||||
1. AIRI 웹을 사용하세요. Web Speech API 제공자는 데스크톱 버전(Electron)에서는 사용할 수 없습니다.
|
||||
2. 현재 브라우저가 Web Speech API를 지원하고 마이크 권한을 허용할 준비가 되어 있는지 확인하세요.
|
||||
|
||||
::: warning 브라우저 제한
|
||||
Web Speech API는 브라우저 환경에서만 사용할 수 있으며, AIRI 데스크톱 버전(Electron)에서는 지원되지 않습니다. 인식 성능은 브라우저, 네트워크 환경, 언어에 따라 다를 수 있습니다.
|
||||
:::
|
||||
|
||||
## AIRI에서 설정하기
|
||||
|
||||
1. 웹 버전에서 **설정 → 제공자 → 전사 → Web Speech API**를 여세요.
|
||||
2. **Recognition Language**를 선택한 뒤, 필요에 따라 **Continuous Recognition**과 **Show Interim Results**를 설정하세요.
|
||||
|
||||
## 설정 확인
|
||||
|
||||
1. **설정 → 모듈 → 청각**으로 이동해 Web Speech API와 오디오 입력 장치를 선택하세요.
|
||||
2. 브라우저의 마이크 접근을 허용하고 짧은 음성 입력 테스트를 시작하세요.
|
||||
3. AIRI에 전사 결과가 표시되는지 확인하세요.
|
||||
|
||||
## 문제 해결
|
||||
|
||||
전사 결과가 표시되지 않으면 브라우저의 마이크 권한, 선택한 입력 장치, 인식 언어를 확인하세요. 브라우저가 이 API를 지원하지 않으면 로컬 또는 클라우드 전사 제공자를 대신 사용하세요.
|
||||
@@ -0,0 +1,58 @@
|
||||
---
|
||||
title: 비전 설정
|
||||
description: AIRI의 비전 모듈에 사용할 이미지 이해 제공자와 모델 선택
|
||||
---
|
||||
|
||||
비전 모듈은 캡처한 이미지를 이미지 입력을 지원하는 모델로 보냅니다. 비전 제공자는 채팅 제공자와 같은 종류의 필드를 사용하지만, AIRI는 두 설정을 별도로 저장합니다. 비전 제공자 페이지에서 자격 증명을 다시 입력하세요.
|
||||
|
||||
::: info 왜 필드가 똑같아 보이나요?
|
||||
같은 서비스가 채팅 모델과 이미지 이해 모델을 함께 제공하는 경우가 많아 양식이 동일한 필드를 사용합니다. 저장된 값은 서로 독립적이며, 이미지 입력을 명시적으로 지원하는 모델을 반드시 선택해야 합니다.
|
||||
:::
|
||||
|
||||
::: warning 화면 비전을 사용하기 전에 Vision Capture를 활성화해야 합니다
|
||||
비전 서비스 제공자와 모델만 설정하는 경우에는 이 도구를 활성화할 필요가 없습니다.
|
||||
|
||||
AIRI가 화면이나 창을 분석하게 하려면 **시스템 → 개발자 → Vision Capture**를 열고, 필요한 경우 화면 녹화 권한을 부여한 뒤 창이나 디스플레이를 선택하고 **Start ticker**를 클릭하세요. 결과를 현재 캐릭터에게 보내려면 **Publish to character**를 활성화하세요.
|
||||
|
||||
Vision Capture는 현재의 데스크톱 디버깅/개발 워크플로이며, 페이지를 벗어나면 캡처 루프가 중지됩니다. 전체 안내는 [데스크톱 개발자 도구](/ko/docs/contributing/desktop-developer-tools#vision-capture)를 참고하세요.
|
||||
:::
|
||||
|
||||
## 비전 제공자 선택
|
||||
|
||||
1. **설정 → 제공자 → 비전**을 여세요.
|
||||
2. 설정할 비전 제공자를 선택하세요.
|
||||
3. 이 페이지에서 자격 증명을 입력하세요. API Key, Base URL, Azure 리소스 정보, AWS Region 등 필드는 채팅 제공자 버전과 동일하지만, 저장되는 값은 별개입니다.
|
||||
|
||||
필요하다면 채팅과 비전 양쪽에 같은 계정 자격 증명을 입력할 수 있습니다. 채팅 제공자에 자격 증명을 저장해도 비전 제공자에 자동으로 채워지지는 않습니다.
|
||||
|
||||
::: warning 이미지 및 자격 증명 보안
|
||||
시각 분석은 캡처한 프레임을 선택한 제공자에게 전송합니다. API Key, 비밀번호, 개인 정보, 공유 권한이 없는 콘텐츠는 캡처하지 마세요. 클라우드 자격 증명은 절대 커밋하거나, 스크린샷으로 남기거나, 공유하지 마세요.
|
||||
:::
|
||||
|
||||
## 비전 모델 선택
|
||||
|
||||
1. **설정 → 모듈 → 비전**을 여세요.
|
||||
2. 방금 설정한 제공자를 선택하세요.
|
||||
3. 이미지 입력을 지원하는 모델을 선택하세요.
|
||||
4. **Capture interval**을 설정해 비전 티커가 프레임을 캡처하는 주기를 조절하세요.
|
||||
|
||||
데스크톱에서는 위에서 설명한 대로 현재 화면이나 창 소스를 **시스템 → 개발자 → Vision Capture**에서 별도로 선택합니다.
|
||||
|
||||
## 설정 확인
|
||||
|
||||
1. 민감한 정보가 없는 창을 캡처하세요.
|
||||
2. 시각 분석을 실행하세요.
|
||||
3. AIRI가 캡처된 프레임으로부터 설명이나 기타 컨텍스트를 받는지 확인하세요.
|
||||
|
||||
## 로컬 시각 모델
|
||||
|
||||
Ollama와 LM Studio를 로컬 비전 제공자로 사용할 수 있습니다. 이미지 입력을 지원하는 모델을 실행하고 AIRI가 해당 서비스에 접근할 수 있는지 확인하세요. 그런 다음 비전 제공자 페이지에서 해당 Base URL을 입력하거나 그대로 두고 **설정 → 모듈 → 비전**에서 모델을 선택하세요.
|
||||
|
||||
## 문제 해결
|
||||
|
||||
| 문제 | 해결 방법 |
|
||||
| --- | --- |
|
||||
| 제공자 유효성 검사가 통과되지 않음 | 채팅 제공자가 이미 설정되어 있어도 API Key, Azure Resource Name, AWS Region 등 비전에 필요한 필드를 모두 입력하세요. |
|
||||
| 모델이 이미지를 분석하지 못함 | 모델이 이미지 입력을 명시적으로 지원하는지 확인하고 호환되는 비전 모델을 선택하세요. |
|
||||
| 로컬 모델에 접근할 수 없음 | 로컬 서비스가 실행 중인지, Base URL·포트·CORS·LAN 접근 설정이 올바른지 확인하세요. |
|
||||
| 요청이 거부되거나 할당량이 소진됨 | 계정 권한, API Key, 지역별 모델 제공 여부, 할당량, 네트워크 접근을 확인하세요. |
|
||||
@@ -0,0 +1,59 @@
|
||||
---
|
||||
title: 웹 검색 설정
|
||||
description: Tavily로 AIRI가 대화 중에 최신 정보를 찾을 수 있게 설정
|
||||
---
|
||||
|
||||
웹 검색을 사용하면 AIRI가 최신 정보나 낯선 정보를 인터넷에서 조회할 수 있습니다. 이 기능은 사용자의 Tavily API Key를 사용합니다. 도구가 활성화되어 있고 선택한 채팅 모델이 도구 호출을 지원하면, AIRI는 대화 중에 검색하고 반환된 출처를 인용할 수 있습니다.
|
||||
|
||||
## 사전 준비
|
||||
|
||||
- AIRI가 설치되어 실행 중입니다.
|
||||
- Tavily 계정이 있고 [Tavily](https://tavily.com/) 콘솔에서 발급받은 API Key가 있습니다.
|
||||
- 선택한 채팅 제공자와 모델이 도구 호출을 지원합니다.
|
||||
|
||||
::: warning API Key 보안
|
||||
Tavily API Key는 현재 기기에만 저장해야 합니다. 저장소에 제출하거나, 다른 사람에게 보내거나, 캐릭터 카드·저널·스크린샷에 포함하지 마세요. 키가 유출된 것으로 의심되면 즉시 폐기하고 Tavily 콘솔에서 새 키를 만드세요.
|
||||
:::
|
||||
|
||||
## 설정 단계
|
||||
|
||||
1. **설정 → 모듈 → Web Search**를 여세요.
|
||||
2. **Enable Web Search**를 켜세요.
|
||||
3. **Tavily API Key**에 API Key를 붙여넣으세요.
|
||||
4. **Web search is ready to use!** 메시지가 표시되면 채팅으로 돌아갈 수 있습니다. 설정은 자동으로 저장되며 별도의 저장 버튼은 없습니다.
|
||||
|
||||
스위치를 끄거나 API Key를 지우면 AIRI는 더 이상 Tavily로 검색 요청을 보내지 않습니다.
|
||||
|
||||
## AIRI는 언제 검색하나요?
|
||||
|
||||
AIRI는 사용자가 검색을 요청할 때, 또는 뉴스, 가격, 최근 릴리스, 실시간 데이터, 갱신된 문서처럼 질문에 최신 정보가 필요할 때 검색할 수 있습니다.
|
||||
|
||||
더 집중된 결과를 얻으려면 목표와 범위를 명시적으로 말하세요:
|
||||
|
||||
- "AIRI 최신 안정 버전의 릴리스 노트를 검색하고 링크를 첨부해 줘."
|
||||
- "Tavily 공식 문서에서 API Key 관련 안내를 찾아 줘."
|
||||
- "`github.com/moeru-ai/airi`의 최근 일주일 업데이트만 검색해 줘."
|
||||
|
||||
검색 결과에는 출처 링크가 포함됩니다. 확보된 결과가 충분하지 않으면 AIRI는 추가로 검색하거나 불확실하다는 점을 분명히 밝혀야 합니다.
|
||||
|
||||
## 개인정보, 신뢰성 및 보안
|
||||
|
||||
검색할 때마다 질의 텍스트가 Tavily로 전송됩니다. API Key, 비밀번호, 액세스 토큰, 사적인 주소, 기타 민감한 정보를 포함하지 마세요. 검색 결과는 부정확하거나, 오래되었거나, 편향되어 있을 수 있습니다.
|
||||
|
||||
::: warning 중요한 정보는 직접 확인하세요
|
||||
검색 결과는 참고 자료로만 AIRI에 제공되며 사용자의 원래 요청을 바꾸지 않습니다. 의료, 법률, 금융 정보는 링크된 출처를 직접 검토하고 공식 안내나 자격을 갖춘 전문가와 상의하세요.
|
||||
:::
|
||||
|
||||
## FAQ
|
||||
|
||||
### Tavily는 설정 완료로 표시되는데 AIRI가 검색하지 않습니다
|
||||
|
||||
**Enable Web Search**가 켜져 있는지, 선택한 채팅 모델이 도구 호출을 지원하는지 확인하세요. 그런 다음 AIRI에게 "검색해서 출처 링크를 포함해 줘"라고 요청해 보세요. 그래도 검색하지 않으면 제공자의 도구 호출 지원 여부를 확인하세요.
|
||||
|
||||
### API Key, 권한 또는 할당량 오류가 발생합니다
|
||||
|
||||
Tavily 콘솔로 돌아가 키가 올바르고 여전히 유효한지 확인하고, 계정의 사용 가능한 크레딧이나 접근 권한을 확인하세요. 복사할 때 앞뒤 공백이나 줄바꿈이 들어가지 않게 하세요. 키를 변경했다면 새 키를 AIRI에 붙여넣으세요.
|
||||
|
||||
### 검색 결과가 부정확하거나 충분히 최신이 아닙니다
|
||||
|
||||
"최근 일주일만 확인해 줘", "공식 문서만 사용해 줘"처럼 기간, 지역, 선호하는 출처를 명시하세요. 중요한 정보는 인용된 링크를 열어 직접 확인하세요. 검색 결과는 전문가의 조언이나 독립적인 판단을 대체하지 않습니다.
|
||||
@@ -1,38 +1,65 @@
|
||||
---
|
||||
title: 캐릭터 카드 템플릿
|
||||
description: Project AIRI용 Character Card V3 JSON 템플릿입니다.
|
||||
description: AIRI Card 패키지용 Character Card V3 card.json 템플릿
|
||||
---
|
||||
|
||||
이 템플릿은 새 AIRI 캐릭터를 만들 때 쓸 수 있는 최소한의 Character Card V3 구조를 제공합니다. 아래 JSON을 복사한 뒤 예시 값을 여러분의 캐릭터 설정으로 바꾸고, 필드 이름과 중첩 구조는 그대로 유지하세요.
|
||||
이 문서는 AIRI Card 패키지 안의 `card.json` 파일에 사용할 수 있는 최소한의 Character Card V3 템플릿입니다. 필드 이름과 계층 구조는 그대로 유지하면서 예시 내용을 여러분의 캐릭터 설정으로 바꾸세요.
|
||||
|
||||
::: warning JSON 파일만으로는 가져올 수 없습니다
|
||||
현재 AIRI Card 업로드 컨트롤은 루트에 `manifest.json`과 `card.json`이 모두 들어 있는 `.zip` 패키지만 받습니다. 아래에 보이는 JSON만 저장해서 그대로 업로드하면 실패합니다.
|
||||
:::
|
||||
|
||||
::: tip 작성 요령
|
||||
- `name`, `description`, `personality`, `scenario`, `first_mes`부터 채워 보세요.
|
||||
- 아직 필요하지 않은 선택 필드는 비워 두어도 됩니다.
|
||||
- 가져오거나 공유하기 전에 최종 내용이 여전히 유효한 JSON인지 확인하세요.
|
||||
- 사용하지 않는 선택 필드는 비워 두세요.
|
||||
- 패키징하거나 공유하기 전에 최종 내용이 유효한 JSON인지 확인하세요.
|
||||
:::
|
||||
|
||||
## 템플릿
|
||||
## 패키지 구조
|
||||
|
||||
```text
|
||||
my-airi-card.zip
|
||||
├── manifest.json
|
||||
└── card.json
|
||||
```
|
||||
|
||||
다음의 최소 `manifest.json`을 사용하세요:
|
||||
|
||||
```json
|
||||
{
|
||||
"format": "airi-character-card",
|
||||
"version": 1,
|
||||
"card": {
|
||||
"path": "card.json",
|
||||
"spec": "chara_card_v3"
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
AIRI가 내보낸 패키지에는 `models/` 아래에 지원되는 표시 모델이 함께 들어 있고 `manifest.json`에 해당 정보가 기술되어 있을 수도 있습니다. 표시 모델을 동봉하지 않는 카드라면 위의 두 파일 구조만으로 충분합니다.
|
||||
|
||||
::: warning AIRI Card 패키지는 무손실 CCv3 백업이 아닙니다
|
||||
AIRI는 명시적 화이트리스트에 포함된 캐릭터 필드와 AIRI 모듈 설정만 가져옵니다. 아래 템플릿에 표시된 필드는 보존하지만, `group_only_greetings`, `mes_example`, `creator`, `tags` 같은 지원되지 않는 CCv3 메타데이터는 버립니다. 서드파티 확장과 `extensions.airi` 안의 지원되지 않는 필드도 제거됩니다. 무손실 백업이 필요하다면 원본 카드를 별도로 보관하세요.
|
||||
:::
|
||||
|
||||
## `card.json` 템플릿
|
||||
|
||||
```json
|
||||
{
|
||||
"spec": "chara_card_v3",
|
||||
"spec_version": "3.0",
|
||||
"data": {
|
||||
"name": "예시 캐릭터",
|
||||
"nickname": "예시",
|
||||
"description": "이 캐릭터가 어떤 인물인지 짧게 설명합니다.",
|
||||
"personality": "호기심 많고, 따뜻하며, 장난기가 있습니다.",
|
||||
"scenario": "캐릭터가 사용자를 처음 만나는 상황입니다.",
|
||||
"first_mes": "안녕하세요! 만나서 반가워요.",
|
||||
"name": "Example Character",
|
||||
"nickname": "Example",
|
||||
"description": "A short description of who this character is.",
|
||||
"personality": "Curious, warm, and a little playful.",
|
||||
"scenario": "This character is meeting the user for the first time.",
|
||||
"first_mes": "Hello! Nice to meet you.",
|
||||
"alternate_greetings": [],
|
||||
"group_only_greetings": [],
|
||||
"mes_example": "",
|
||||
"creator": "당신의 이름",
|
||||
"creator_notes": "",
|
||||
"character_version": "1.0.0",
|
||||
"system_prompt": "",
|
||||
"post_history_instructions": "",
|
||||
"tags": ["example"],
|
||||
"extensions": {}
|
||||
}
|
||||
}
|
||||
|
||||
@@ -1,22 +1,22 @@
|
||||
---
|
||||
title: 데스크톱 빠른 시작
|
||||
description: 데스크톱에서 Project AIRI를 시작하는 방법
|
||||
description: 데스크톱 버전을 시작하는 방법
|
||||
---
|
||||
|
||||
## 대화 시작하기
|
||||
## 먼저 대화 시작하기
|
||||
|
||||
AIRI를 설치하고 실행한 뒤, 가장 빠르게 대화를 시작하는 방법은 온보딩 과정을 끝까지 마치는 것입니다.
|
||||
AIRI를 설치하고 실행한 뒤 온보딩 과정을 완료하세요:
|
||||
|
||||
1. AIRI가 물어보면 사용할 언어를 선택합니다.
|
||||
2. **직접 프로바이더 설정하기**를 선택하거나, 이미 AIRI 계정을 쓰고 있다면 로그인합니다.
|
||||
3. OpenRouter, OpenAI 호환 API, DeepSeek, Ollama, Qwen, Gemini, Claude 등 채팅 프로바이더를 고릅니다.
|
||||
4. 필요한 API 키나 로컬 엔드포인트 정보를 입력합니다.
|
||||
5. 채팅 모델을 고른 뒤 저장하고 계속 진행합니다.
|
||||
6. 메인 캐릭터 창에서 컨트롤 아일랜드 오른쪽 아래의 **확장** 버튼을 클릭합니다.
|
||||
7. **채팅 열기**를 클릭하고 메시지를 입력해 전송합니다.
|
||||
1. 환영 화면에서 필요하다면 오른쪽 위의 <span class="i-lucide:globe inline-block align-[-0.125em]" aria-hidden="true"></span> **지구본 버튼**을 클릭해 인터페이스 언어를 변경하세요.
|
||||
2. **직접 제공자 설정하기**를 선택하거나, 공식 AIRI 제공자를 사용하려면 **로그인**을 선택하세요.
|
||||
3. OpenRouter, OpenAI Compatible, DeepSeek, Ollama, Google Gemini, Anthropic 같은 채팅 제공자를 선택하세요.
|
||||
4. API Key, 로컬 서비스 주소 등 필요한 정보를 입력하세요.
|
||||
5. 채팅 모델을 선택한 뒤 **저장하고 계속하기**를 선택하세요.
|
||||
6. 메인 캐릭터 창으로 돌아온 뒤, 오른쪽 아래 컨트롤 아일랜드에서 **확장**을 클릭하세요.
|
||||
7. **채팅 열기**를 클릭하고 메시지를 입력해 전송하세요.
|
||||
|
||||
::: tip Ollama를 로컬에서 쓰시나요?
|
||||
시스템 환경 변수로 `OLLAMA_ORIGINS=*`를 설정한 다음, Ollama를 재시작하고 나서 AIRI에서 선택하세요.
|
||||
Ollama는 기본적으로 데스크톱 버전의 개발용 origin과 패키징된 앱 origin에서 오는 요청을 허용합니다. 따라서 로컬 설정에서는 보통 `OLLAMA_ORIGINS`가 필요하지 않습니다. 기본값이 아닌 원격 웹 origin에서 CORS 오류가 발생하면 해당 origin을 정확히 `OLLAMA_ORIGINS`에 추가한 뒤 Ollama를 재시작하세요. 와일드카드를 사용하거나 Ollama를 공개 인터넷에 노출하지 마세요.
|
||||
:::
|
||||
|
||||
<br />
|
||||
@@ -27,39 +27,39 @@ AIRI를 설치하고 실행한 뒤, 가장 빠르게 대화를 시작하는 방
|
||||
|
||||
## 화면 구성
|
||||
|
||||
Stage Tamagotchi 라고도 부르는 데스크톱 버전은 보통 다음과 같은 화면 요소로 이루어집니다.
|
||||
데스크톱 버전은 보통 다음 인터페이스로 구성됩니다:
|
||||
|
||||
- **메인 캐릭터 창**: 항상 바탕화면 위에 떠 있는 Live2D / VRM 무대입니다.
|
||||
- **컨트롤 아일랜드**: 캐릭터 창 오른쪽 아래에 있는 작은 버튼 묶음입니다.
|
||||
- **메인 캐릭터 창**: Live2D, Spine, VRM, MMD, Tachie를 지원하는 바탕화면 상주형 캐릭터 무대입니다.
|
||||
- **컨트롤 아일랜드**: 메인 캐릭터 창 오른쪽 아래에 있는 작은 버튼 묶음입니다.
|
||||
- **채팅 창**: 컨트롤 아일랜드에서 여는 대화 창입니다.
|
||||
- **설정 창**: 프로바이더, 캐릭터, 모델, 모듈, 데이터, 연결, 시스템 설정을 다룹니다.
|
||||
- **시스템 트레이 메뉴**: 크기, 정렬, 설정, 자막, 위젯, 종료 동작을 제공합니다.
|
||||
- **설정 창**: 제공자, 프로필, 모델, 모듈, 데이터, 연결, 시스템 옵션을 설정합니다.
|
||||
- **시스템 트레이 메뉴**: 창 크기와 위치를 조정하고, 설정을 열고, 자막과 위젯을 관리하고, AIRI를 종료할 수 있습니다.
|
||||
|
||||
캐릭터 창이 숨겨졌다면 AIRI 트레이 아이콘을 클릭하거나 트레이 메뉴에서 **표시**를 선택해 다시 불러올 수 있습니다.
|
||||
메인 캐릭터 창이 숨겨졌다면 AIRI 트레이 아이콘을 클릭하거나 트레이 메뉴에서 **표시**를 선택해 다시 불러올 수 있습니다.
|
||||
|
||||
## 컨트롤 아일랜드
|
||||
|
||||
컨트롤 아일랜드는 평소에 데스크톱 앱을 조작하기에 가장 편리한 곳입니다.
|
||||
컨트롤 아일랜드는 데스크톱 앱을 일상적으로 사용할 때의 주요 진입점입니다.
|
||||
|
||||
- **확장**을 클릭하면 더 많은 동작이 나타납니다.
|
||||
- **채팅 열기**를 클릭하면 채팅 창이 열립니다.
|
||||
- **설정 열기**를 클릭하면 프로바이더, 모델, 모듈, 캐릭터, 시스템 설정을 구성할 수 있습니다.
|
||||
- **프로필 전환**을 클릭하면 활성 캐릭터 카드를 바꿀 수 있습니다.
|
||||
- 무대를 다시 불러와야 할 때는 **새로고침**을 클릭합니다.
|
||||
- **설정 열기**를 클릭하면 제공자, 모델, 모듈, 프로필, 시스템 설정을 구성할 수 있습니다.
|
||||
- **프로필 전환**을 클릭하면 현재 캐릭터 카드를 바꿀 수 있습니다.
|
||||
- 필요하면 **새로고침**을 클릭해 무대를 다시 불러올 수 있습니다.
|
||||
- 라이트/다크 아이콘을 클릭하면 테마가 바뀝니다.
|
||||
- 핀 아이콘을 클릭하면 항상 위에 표시를 켜고 끌 수 있습니다.
|
||||
- 핀 아이콘을 클릭하면 **항상 위에 고정**을 켜고 끌 수 있습니다.
|
||||
- 눈 아이콘을 클릭하면 **자동 숨김** / **항상 표시**를 전환할 수 있습니다.
|
||||
- 마이크 버튼으로 청각 관련 설정을 엽니다.
|
||||
- 이동 버튼을 드래그해 캐릭터 창의 위치를 옮깁니다.
|
||||
- **청각 컨트롤 열기**를 클릭하면 음성 입력 컨트롤이 열립니다.
|
||||
- **드래그로 창 이동**을 드래그해 메인 캐릭터 창을 옮길 수 있습니다.
|
||||
|
||||
## 자동 숨김
|
||||
## 호버 시 숨김
|
||||
|
||||
눈 버튼은 AIRI가 완전히 상호작용 가능한 상태를 유지할지, 아니면 작업하는 동안 시야와 클릭 방해를 부드럽게 줄일지를 결정합니다.
|
||||
눈 아이콘은 AIRI가 완전히 상호작용 가능한 상태를 유지할지, 아니면 작업하는 동안 방해가 되지 않도록 흐려질지를 결정합니다.
|
||||
|
||||
- **항상 표시**는 캐릭터를 계속 보이게 하고 클릭도 가능하게 둡니다.
|
||||
- **자동 숨김**은 커서가 가까이 오면 캐릭터와 UI를 흐리게 만들고, 클릭이 아래 앱으로 통과하도록 합니다.
|
||||
- **자동 숨김**은 커서가 가까이 오면 캐릭터와 인터페이스를 흐리게 만들어 아래에 있는 애플리케이션을 더 쉽게 클릭할 수 있게 합니다.
|
||||
|
||||
자동 숨김을 처음 켜면 AIRI가 동작 방식을 설명하는 짧은 안내를 보여 줍니다. AIRI를 클릭하기 어려워졌다면 컨트롤 아일랜드 근처로 커서를 옮긴 뒤 눈 버튼을 다시 클릭하세요.
|
||||
호버 시 숨김을 처음 켜면 AIRI가 짧은 안내를 보여 줍니다. AIRI를 클릭하기 어려워졌다면 컨트롤 아일랜드 근처로 커서를 옮긴 뒤 눈 아이콘을 다시 클릭해 끄세요.
|
||||
|
||||
<div rounded-lg overflow-hidden>
|
||||
<video autoplay loop muted class="scale-180 translate-x--30 translate-y--2 lg:scale-150 lg:translate-x--40">
|
||||
@@ -69,7 +69,7 @@ Stage Tamagotchi 라고도 부르는 데스크톱 버전은 보통 다음과 같
|
||||
|
||||
## 이동과 크기 조절
|
||||
|
||||
캐릭터 창을 옮기려면 컨트롤 아일랜드 오른쪽 아래의 이동 버튼을 드래그하세요.
|
||||
메인 캐릭터 창을 옮기려면 컨트롤 아일랜드 오른쪽 아래의 이동 버튼을 드래그하세요.
|
||||
|
||||
<div rounded-lg overflow-hidden>
|
||||
<video autoplay loop muted class="scale-225 translate-x--45 translate-y--5 lg:scale-200 lg:translate-x--80 lg:translate-y--5">
|
||||
@@ -77,13 +77,13 @@ Stage Tamagotchi 라고도 부르는 데스크톱 버전은 보통 다음과 같
|
||||
</video>
|
||||
</div>
|
||||
|
||||
Windows에서는 창의 가장자리나 모서리를 드래그해 캐릭터 창 크기를 조절할 수 있습니다. 트레이 메뉴에도 몇 가지 빠른 프리셋이 있습니다.
|
||||
Windows에서는 창의 가장자리나 모서리를 드래그해 크기를 조절할 수 있습니다. 트레이 메뉴에도 자주 쓰는 몇 가지 크기가 준비되어 있습니다:
|
||||
|
||||
1. AIRI 트레이 아이콘을 오른쪽 클릭합니다.
|
||||
2. **크기 조절**을 엽니다.
|
||||
3. **권장**, **전체 높이**, **절반 높이**, **전체 화면** 중 하나를 고릅니다.
|
||||
1. AIRI 트레이 아이콘을 오른쪽 클릭하세요.
|
||||
2. **크기 조절**을 여세요.
|
||||
3. **권장 (450x600)**, **전체 높이**, **절반 높이**, **전체 화면** 중 하나를 선택하세요.
|
||||
|
||||
같은 트레이 메뉴의 **정렬 위치**를 이용하면 창을 화면 중앙이나 모서리에 배치할 수 있습니다.
|
||||
같은 트레이 메뉴의 **정렬 위치**를 이용하면 창을 화면 중앙이나 네 모서리로 옮길 수 있습니다.
|
||||
|
||||
<div rounded-lg overflow-hidden>
|
||||
<video autoplay loop muted class="scale-160 translate-x--20 lg:scale-150 lg:translate-x--40 lg:translate-y-10">
|
||||
@@ -93,12 +93,12 @@ Windows에서는 창의 가장자리나 모서리를 드래그해 캐릭터 창
|
||||
|
||||
## 확인해 볼 만한 설정
|
||||
|
||||
첫 대화가 잘 동작한 뒤에 살펴보면 좋은 페이지들입니다.
|
||||
첫 대화를 마친 뒤 다음 페이지들을 살펴보세요:
|
||||
|
||||
- **서비스 소스**: 채팅, 음성, 전사, 그림 프로바이더를 추가하거나 수정합니다.
|
||||
- **바디 모듈**: 의식, 목소리, 청각, 시각, 기억, Discord, Minecraft, Factorio, MCP 등 각 모듈에 AIRI가 어떤 프로바이더를 쓸지 고릅니다.
|
||||
- **캐릭터 모델**: Live2D와 VRM 모델을 전환하거나 직접 만든 모델을 불러옵니다.
|
||||
- **AIRI 캐릭터 카드**: 활성 캐릭터를 바꾸거나 새로 만듭니다.
|
||||
- **시스템**: 언어, 테마, 분석 수집 여부, 데스크톱 전용 옵션을 설정합니다.
|
||||
- **제공자**: 채팅, 비전, 음성 합성, 전사, Artistry 제공자를 추가하거나 수정합니다.
|
||||
- **모듈**: 의식, 음성 합성, 청각, 비전, 기억, Discord, Minecraft, Factorio, MCP 등 각 모듈에 사용할 서비스를 선택합니다.
|
||||
- **모델**: 지원되는 2D/3D 모델을 전환하거나 직접 만든 모델을 불러옵니다.
|
||||
- **AIRI 카드**: 현재 캐릭터를 바꾸거나 새 캐릭터 카드를 만듭니다.
|
||||
- **시스템**: 언어, 테마, 사용 분석 설정, 데스크톱 전용 옵션을 설정합니다.
|
||||
|
||||
일부 모듈은 아직 실험적이며 로컬 소스 설정이나 외부 서비스가 필요할 수 있습니다. Windows를 중심으로 한 더 자세한 안내는 [전체 데스크톱 사용 설명서](./setup-and-use/)를 참고하세요.
|
||||
일부 모듈은 실험적이며 로컬 소스 설정이나 추가 서비스가 필요합니다. 자세한 안내는 [전체 데스크톱 사용 설명서](./setup-and-use/)를 참고하세요.
|
||||
|
||||
File diff suppressed because it is too large
Load Diff
@@ -1,4 +1,57 @@
|
||||
---
|
||||
title: 웹 버전 가이드
|
||||
title: 웹 버전 시작하기
|
||||
description: Project AIRI 웹 버전 사용법
|
||||
---
|
||||
|
||||
## AIRI에 오신 것을 환영합니다!
|
||||
|
||||
AIRI를 처음 열면, 필요하다면 오른쪽 위의 지구본 버튼으로 인터페이스 언어를 변경하세요. 그런 다음 **직접 제공자 설정하기**를 선택하거나, 공식 AIRI 제공자를 사용하려면 **로그인**을 선택하세요.
|
||||
|
||||
### 채팅 제공자 선택
|
||||
|
||||
OpenAI, DeepSeek, Ollama 같은 채팅 제공자를 선택하세요. OpenAI API를 구현한 다른 서비스를 사용하려면 **OpenAI Compatible**을 선택하고 해당 서비스의 API Key와 문서에 안내된 Base URL을 모두 입력하세요. 스크린샷은 SiliconFlow를 예시로 사용합니다.
|
||||
|
||||
|
||||
|
||||
### 모델 선택
|
||||
|
||||
호환되는 채팅 모델을 선택한 뒤 **저장하고 계속하기**를 선택하세요.
|
||||
|
||||
::: tip
|
||||
|
||||
추론 모델은 응답에 시간이 더 걸릴 수 있습니다. 더 빠른 대화를 원한다면 비추론 모델을 선택하세요.
|
||||
|
||||
:::
|
||||
|
||||
### 첫 대화 시작하기
|
||||
|
||||
채팅 상자에 텍스트를 입력해 AIRI에게 보내세요.
|
||||
|
||||
|
||||
## 눈, 귀, 그리고 입
|
||||
|
||||
AIRI는 텍스트 대화 외에도 다양한 상호작용 방식을 지원합니다. 오른쪽 위의 **설정 → 모듈**을 열어 더 많은 기능을 설정하세요.
|
||||
|
||||
### AIRI가 말하게 하기
|
||||
|
||||
**설정 → 제공자 → 음성 합성**을 열어 음성 합성 제공자를 설정하세요. 그런 다음 **설정 → 모듈 → 음성 합성**을 열어 제공자, 모델, 목소리를 선택하세요.
|
||||
|
||||
### 음성 입력 활성화
|
||||
|
||||
**설정 → 제공자 → 전사**를 열어 전사 제공자를 설정하세요. 그런 다음 **설정 → 모듈 → 청각**을 열어 제공자와 모델을 선택하고 사용 가능한 마이크를 고르세요. 메인 페이지의 마이크 버튼으로 청각 컨트롤을 열 수 있습니다.
|
||||
|
||||
### 비전 캡처는 현재 데스크톱 전용
|
||||
|
||||
화면·창 캡처는 현재 데스크톱 버전에서 사용할 수 있습니다. 제공자 설정과 데스크톱 Vision Capture 워크플로는 [비전 설정](../config/vision.md)을 참고하세요.
|
||||
|
||||
## 캐릭터 카드
|
||||
|
||||
AIRI에는 "ReLU"라는 캐릭터 카드가 기본으로 포함되어 있으며, 직접 캐릭터 카드를 만들 수도 있습니다. 메인 페이지 오른쪽 위의 캐릭터 전환 버튼을 사용하거나 설정에서 카드를 전환하세요.
|
||||
|
||||
### 캐릭터 카드 내용
|
||||
|
||||
캐릭터 카드는 AIRI의 이름, 설명, 성격, 시나리오, 인사말을 정의합니다. 캐릭터 카드로 AIRI의 정체성과 행동을 원하는 대로 바꿀 수 있습니다.
|
||||
|
||||
### 캐릭터 카드 설정
|
||||
|
||||
캐릭터 카드에는 모듈 설정을 저장할 수 있습니다. 따라서 프로필을 전환하면 캐릭터와 그에 연결된 모델 선택이 함께 바뀝니다.
|
||||
|
||||
Reference in New Issue
Block a user