본 문서는 영어 원본을 기계 번역한 것입니다. 번역본과 영어 원본 사이에 내용이 상충할 경우 영어 원본이 우선합니다. 영어 원본 보기

AI 제공자 및 API 키

Caiioo는 소수의 제공자를 통해 500개 이상의 AI 모델에 연결됩니다. 사용자가 직접 API 키를 가져오므로, 제공자에게 직접 비용을 지불하며 Caiioo는 사용자의 지출에 관여하지 않습니다.

지원되는 제공자

현재 두 가지 제공자를 일반적으로 사용할 수 있습니다:

  • OpenRouter (기본값) — 단일 키로 Anthropic Claude, Google Gemini, OpenAI GPT, Mistral, Groq, Llama 등을 포함한 500개 이상의 모델을 사용할 수 있습니다. 대부분의 사용자에게 권장되는 방식입니다. Caiioo의 도구는 OpenRouter의 모델 레지스트리를 기반으로 작동하며, 하나의 키만 관리하면 됩니다.
  • Ollama — 오픈 소스 모델을 로컬 기기에서 실행합니다. 완전히 비공개이며 인터넷이 필요 없고 무료입니다. 오프라인 작업이나 추론에 대한 절대적인 제어가 필요할 때 유용합니다.

Anthropic, Google Gemini, OpenAI, Poe 및 MLX에 대한 직접 연결은 계획되어 있으나 아직 일반에 공개되지 않았습니다. 현재로서는 OpenRouter 키를 통해 해당 모델들을 사용하세요.

정책에 대해서는 이용약관을 참조하세요.

시작하기 (두 가지 옵션)

옵션 1: 무료 제공 키 사용하기

Caiioo를 즉시 체험해 볼 수 있도록 무료 OpenRouter 키를 제공합니다. 이 키는 사용 제한이 있는 일부 무료 모델에 접근할 수 있어 테스트용으로 완벽합니다.

계속 사용하시려면 Caiioo를 열고 바로 채팅을 시작하세요. 별도의 설정은 필요하지 않습니다. Pro 구독자는 기존 잔액 외에 이 키에 자동으로 적용되는 월 $5의 OpenRouter 크레딧 보너스를 추가로 받게 됩니다.

크레딧 소모 도구—이미지, 비디오, 음악 생성, 고급 OCR, Perplexity AI 검색—는 단순한 키가 아니라 OpenRouter 크레딧이 필요합니다. 무료 제공 키에서는 이러한 도구 사용 시 "크레딧 없음"으로 표시됩니다. 이를 해결하려면 두 가지 방법이 있습니다: 설정 > AI Providers에서 본인의 OpenRouter API 키를 입력(BYOK)하거나, Caiioo 플랜을 업그레이드하세요. 유료 플랜은 매달 이 제공 키에 크레딧을 충전해 주므로 해당 도구들을 바로 사용할 수 있습니다.

옵션 2: 본인 키 사용 (BYOK)

무료 티어의 제한 없이 모든 기능을 사용하고 싶으신가요? 본인의 키를 추가하세요.

OpenRouter (권장):

  1. openrouter.ai에서 가입하고 API 키를 생성합니다.
  2. 설정 → AI Provider로 이동합니다.
  3. OpenRouter를 선택하고 키를 붙여넣습니다.
  4. 완료되었습니다 — 키는 사용자의 기기에만 저장되며 Caiioo 서버로 전송되지 않습니다.

Ollama (로컬):

  1. ollama.com에서 Ollama를 설치하고 모델을 가져옵니다 (ollama pull llama3.2).
  2. 설정 → AI Provider로 이동합니다.
  3. Ollama를 선택하고 서버 URL을 확인합니다 (기본값 http://localhost:11434).
  4. 로컬에 설치된 모델 중 하나를 선택합니다.

로컬 채팅 모델을 선택한 경우, 데이터를 원격 AI 제공업체로 전송해야 하는 AI 기반 도구들은 실행 전 사용자의 승인을 먼저 요청합니다. 자세한 내용은 Privacy & Data → Remote AI Providers를 참조하세요.

Default Model 및 Max Steps를 보여주는 모델 설정 화면

Quick Tasks 모델

스레드 제목 생성, 의도 분류, 호출할 도구 선택 및 기타 짧은 보조 쿼리와 같이 Caiioo가 백그라운드에서 자동으로 사용하는 별도의 저렴한 모델입니다. 사용자가 직접 프롬프트를 입력하지는 않습니다. 설정 → Model Config에서 구성할 수 있습니다 (작은 OpenRouter 무료 모델이나 로컬 Ollama 모델이면 충분합니다). 설정하지 않은 경우 시스템은 기본 모델을 대신 사용합니다.

도구용 BYOA (본인 인증 사용) — Pro

BYOA는 BYOK와 다릅니다. LLM용이 아니라 도구 연결(Google Workspace, Microsoft 365, GitHub 등)을 위한 것입니다. Pro 등급에서는 조직에서 Caiioo의 기본 클라이언트 ID를 허용하지 않을 때 설정 → 사용자 정의 OAuth를 통해 본인의 OAuth 클라이언트를 연결할 수 있습니다:

  • Google Workspace 마법사 — Google Cloud 프로젝트를 생성하고 클라이언트 ID와 비밀번호를 붙여넣는 과정을 안내합니다
  • Microsoft 365 마법사 — Azure 등록 앱에 대해 동일한 흐름을 제공합니다
  • 사용자 정의 제공자 추가 — 이를 지원하는 모든 제공자에 대한 일반적인 OAuth 2.0 흐름입니다

마법사는 자격 증명을 자격 증명 보관함에 직접 기록합니다. 기기를 절대 떠나지 않습니다.

API 키 보안

사용자의 API 키는 기기에 로컬로 저장됩니다. Caiioo 서버로 절대 전송되지 않습니다. 요청을 보낼 때 키는 AI 제공업체로 직접 전송됩니다. 자세한 내용은 개인정보 및 데이터를 참조하세요.

성능은 선택한 모델에 달려 있습니다

Caiioo는 도구, 컨텍스트, 다단계 워크플로와 같은 오케스트레이션을 처리합니다. 하지만 AI 응답의 품질은 선택한 모델에 따라 결정됩니다.

복잡한 작업의 경우 (조사, 분석, 긴 문서): Claude Sonnet, GPT급 또는 Gemini Pro와 같은 최첨단 모델을 사용하세요. OpenRouter 키를 통해 모두 접근 가능합니다. 이러한 모델은 다단계 추론과 도구 사용을 가장 잘 처리합니다.

빠른 답변의 경우 (질문, 요약, 간단한 편집): Claude Haiku, 작은 GPT 또는 Gemini Flash 변체와 같은 빠른 모델이 더 저렴하고 빠릅니다. 일상적인 작업에 완벽합니다.

실험용: OpenRouter를 사용하면 하나의 API 키로 500개 이상의 모델을 시도해 볼 수 있습니다. 단일 제공자에 얽매이지 않고 워크플로에 가장 적합한 모델을 찾아보세요.

오프라인 / 완전 비공개 작업: Ollama는 사용자의 컴퓨터에서 오픈 소스 모델을 실행합니다. 클라우드 모델보다 느릴 수 있지만, 어떤 데이터도 하드웨어를 떠나지 않습니다.

Caiioo의 도구, 컨텍스트 레이어 및 오케스트레이션은 사용자가 선택한 모델의 능력을 증폭시킵니다. 좋은 모델은 적절한 컨텍스트와 도구를 만날 때 훌륭해집니다.

참고 항목

This guide is maintained by the Caiioo team using Slate, our built-in editor.