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

AI 제공자 및 API 키

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

지원되는 제공업체

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

  • OpenRouter (기본값) — 단일 키로 Anthropic Claude, Google Gemini, OpenAI GPT, Mistral, Groq, Llama 등을 포함한 500개 이상의 모델을 이용할 수 있습니다. 대부분의 사용자에게 추천되는 방식입니다. Caiioo의 도구는 OpenRouter의 모델 레지스트리를 기대하며 하나의 키만 관리하면 됩니다.
  • Google AI — 본인의 Google AI 키로 Gemini API에 직접 연결합니다. Google은 실질적인 무료 할당량을 제공하므로, 신용카드 없이 네이티브 사고 기능과 최대 2M 컨텍스트를 지원하는 최첨단 모델을 실행할 수 있는 방법입니다. 설정에서 무료 키를 발급받는 방법을 안내합니다.
  • xAI (Grok) — api.x.ai를 통해 Grok 모델에 직접 액세스합니다. xAI 콘솔 API 키로 연결하거나 Grok 계정으로 로그인(SuperGrok 또는 X Premium+ 구독)하여 브라우저에서 액세스를 승인하면 키를 복사할 필요 없이 연결됩니다. 참고: xAI는 자체적으로 계정 및 구독 등급별로 API 액세스를 활성화합니다. 연결 후 권한 오류로 채팅이 실패하는 경우 대신 xAI API 키를 사용하세요.
  • CometAPI — 종량제 CometAPI 키 하나로 500개 이상의 모델(GPT, Claude, Gemini, DeepSeek 등)을 이용할 수 있습니다. 모델 선택기에는 카탈로그에 대한 벤치마크 등급 메달이 표시되며, 총 CometAPI 사용량은 설정에서 추적됩니다.
  • Ollama — 컴퓨터에서 오픈 소스 모델을 로컬로 실행합니다. 완전 비공개이며 인터넷이 필요 없고 무료입니다. 오프라인 작업이나 추론에 대한 절대적인 제어가 필요할 때 유용합니다. (Ollama Cloud는 선택적 API 키로도 작동합니다.)

다른 제공업체(Anthropic, OpenAI, Poe, MLX 등)에 대한 직접 연결은 테스트 중이며 아직 일반 공개되지 않았습니다. 당분간은 OpenRouter 키를 통해 해당 모델들을 사용하세요. 그것이 OpenRouter의 존재 이유입니다.

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

시작하기 (두 가지 옵션)

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

Caiioo를 즉시 체험할 수 있도록 무료 OpenRouter 키를 제공합니다. 사용량 제한이 있는 일부 무료 모델에 액세스할 수 있어 테스트 용도로 적합합니다.

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

포함된 키를 사용하는 동안, 설정의 OpenRouter 키 필드는 비어 있는 것처럼 보이는 대신 Caiioo의 계정 키와 남은 잔액을 사용하고 있다는 안내 문구가 표시됩니다. 포함된 키는 설정한 기기에 유지되며, 사용자의 자체 OpenRouter 키 역시 기기별로 저장되므로 Private Sync를 켠 후에만 다른 기기에 표시됩니다.

크레딧 소모 도구(이미지, 비디오, 음악 생성, 고급 OCR, Perplexity AI 검색)는 키뿐만 아니라 OpenRouter 크레딧이 필요합니다. 무료 제공 키에서는 이러한 도구들이 "크레딧 없음"으로 표시됩니다. 해결 방법은 두 가지입니다: 설정 > AI Providers에서 자신의 OpenRouter API 키를 입력(BYOK)하거나, Caiioo 플랜을 업그레이드하는 것입니다. 유료 플랜은 매월 이 동일한 제공 키에 크레딧을 충전해 주므로 이러한 도구들이 바로 작동합니다.

옵션 2: 자체 키 가져오기 (BYOK)

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

OpenRouter (권장):

  1. openrouter.ai에 가입하고 API 키를 생성합니다.
  2. 설정(Settings) → AI Provider로 이동합니다.
  3. OpenRouter를 선택하고 키를 붙여넣거나, Sign in with OpenRouter를 클릭하여 아무것도 복사하지 않고 계정을 연결합니다.
  4. 완료되었습니다. 키는 기기에 유지되며 Caiioo의 서버로 절대 전송되지 않습니다.

Google AI (Gemini 직접 연동):

  1. 설정(Settings) → AI Provider로 이동하여 Google AI를 선택합니다.
  2. 안내에 따라 "무료 키 발급" 단계를 진행합니다(Google AI Studio에서는 신용 카드 없이 무료로 키를 발급합니다).
  3. 키를 붙여넣습니다. 키는 기기에 유지되며 요청은 Google로 직접 전송됩니다.

Ollama (로컬):

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

로컬 채팅 모델을 선택하면 데이터를 원격 AI 제공업체로 전송하는 AI 기반 도구들은 먼저 승인을 요청합니다. Privacy & Data → Remote AI Providers를 참조하세요.

기본 모델 및 최대 단계를 보여주는 모델 구성

빠른 작업 모델 (Quick Tasks Model)

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

도구를 위한 BYOA (Bring Your Own Auth) — Pro

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

  • 자체 Google OAuth 앱 사용 — Google Cloud 프로젝트를 만들고 클라이언트 ID 및 시크릿을 붙여넣는 과정을 안내합니다.
  • 자체 Microsoft Azure 앱 사용 — Azure에 등록된 앱과 동일한 흐름입니다.
  • 사용자 지정 OAuth 공급자 추가 — 이를 지원하는 모든 공급자를 위한 일반 OAuth 2.0 흐름입니다.

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

API 키 보안

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

성능은 사용하는 모델에 따라 다릅니다

Caiioo는 도구, 컨텍스트, 다단계 워크플로 등 오케스트레이션을 처리합니다. 그러나 AI 응답의 품질은 어떤 모델을 선택하느냐에 달려 있습니다.

복잡한 작업의 경우 (연구, 분석, 긴 문서): OpenRouter 키를 통해 액세스할 수 있는 Claude Sonnet, GPT 급 또는 Gemini Pro와 같은 프론티어 모델을 사용하세요. 다단계 추론과 도구 사용을 가장 잘 처리합니다.

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

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

창의성 슬라이더에 대한 참고 사항: 최신 모델(Claude Sonnet 5 및 이후 버전 등)은 자체 창의성을 관리하며 온도(temperature) 설정을 지원하지 않습니다. 해당 모델을 선택하면 모델 구성의 창의성 슬라이더가 짧은 안내 문구와 함께 비활성화됩니다. 이는 버그가 아닌 정상적인 동작입니다.

오프라인 / 완전 비공개 작업의 경우: Ollama는 기기에서 오픈 소스 모델을 실행합니다. 클라우드 프론티어 모델보다 느리지만, 하드웨어 외부로 데이터가 유출되지 않습니다.

Caiioo의 도구, 컨텍스트 레이어, 오케스트레이션은 사용자가 선택한 모델의 성능을 극대화합니다. 좋은 모델은 작업할 수 있는 올바른 컨텍스트와 도구가 주어질 때 훌륭한 모델이 됩니다.

참고 항목

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