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

AI 제공자 및 API 키

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

지원되는 제공업체

현재 Settings > AI Setup > AI Provider에서 11개의 클라우드 및 로컬 제공업체를 이용할 수 있습니다:

  • OpenRouter(기본값) — 단 하나의 키로 Anthropic Claude, Google Gemini, OpenAI GPT, Mistral, Groq, Llama, DeepSeek, Qwen 등을 포함한 500개 이상의 모델을 사용할 수 있습니다. 대부분의 사용자에게 권장되는 방식입니다. Caiioo의 도구들은 OpenRouter의 모델 레지스트리를 기준으로 작동하며, 단 하나의 키만 관리하면 됩니다.
  • Google AI — 자체 Google AI 키를 사용하여 Gemini API에 직접 연결합니다. Google은 실질적인 무료 할당량을 제공하므로, 신용카드 등록 없이도 네이티브 사고(thinking) 기능과 최대 2M 컨텍스트를 갖춘 최첨단 모델을 실행할 수 있는 실질적인 방법입니다. Settings에서 무료 키를 발급받는 과정을 안내합니다.
  • Anthropic — 자체 Anthropic 키를 사용하여 Claude API에 직접 연결하며, 도구 사용과 함께 네이티브 확장 사고 기능을 지원합니다. console.anthropic.com에서 키를 생성하거나, Claude 계정에 대한 액세스를 승인하여 Caiioo가 키를 생성하도록 할 수 있습니다. 해당 키의 요금은 Anthropic Console 계정으로 청구되며, Caiioo는 키 생성에 사용된 Claude 로그인 정보를 보관하지 않습니다. Anthropic은 Claude Pro 또는 Max 구독을 다른 앱에서 사용하는 것을 허용하지 않으므로, Caiioo의 Claude는 구독 기반이 아닌 Console 키 또는 OpenRouter를 통해 실행됩니다.
  • xAI (Grok) — api.x.ai를 통해 Grok 모델에 직접 액세스합니다. xAI 콘솔 API 키로 연결하거나, Grok 계정으로 로그인(SuperGrok 또는 X Premium+ 구독)하여 브라우저에서 액세스를 승인하면 복사할 키 없이 바로 연결됩니다. 참고: xAI는 자체 정책에 따라 계정 및 구독 등급별로 API 액세스를 활성화합니다. 연결 후 권한 오류로 인해 대화가 실패하는 경우, xAI API 키를 대신 사용하세요.
  • OpenAI — 자체 OpenAI API 키를 사용하여 OpenAI 모델에 직접 연결하거나, ChatGPT 계정으로 로그인하여 키 대신 ChatGPT 구독을 통해 Caiioo를 실행할 수 있습니다.
  • CometAPI — 하나의 종량제 CometAPI 키를 통해 500개 이상의 모델(GPT, Claude, Gemini, DeepSeek 등)을 이용할 수 있습니다. 모델 선택기에는 카탈로그에 대한 벤치마크 등급 메달이 표시되며, 전체 CometAPI 사용량은 Settings에서 추적됩니다.
  • Poe — 하나의 Poe API 키를 통해 Anthropic, Google, OpenAI, xAI, Meta 등의 모델을 이용할 수 있으며, 토큰당 달러가 아닌 Poe 구독 포인트로 청구됩니다. 남은 포인트 잔액과 스레드에서 사용된 포인트가 앱에 모두 표시됩니다. poe.com/api/keys에서 키를 발급받으세요.
  • Ollama — 오픈 소스 모델을 로컬 머신에서 실행합니다(기본값: http://localhost:11434). 비공개로 유지되며, 인터넷 연결이 필요 없고, 무료입니다. Ollama Cloud 또한 선택적 API 키를 통해 작동합니다.
  • vLLM, Unsloth, 및 MLX (Pro) — vLLM(기본값: http://localhost:8000), Unsloth(기본값: http://localhost:8000), 또는 MLX(Apple Silicon 기준 기본값: http://localhost:8080)를 실행하는 로컬 또는 네트워크 OpenAI 호환 추론 서버에 선택적 베어러 토큰을 사용하여 연결합니다. 스마트폰이나 브라우저에서 데스크톱에 호스팅된 대화로 참여할 때, Caiioo는 해당 데스크톱의 로컬 서버에 있는 모델들을 자동으로 나열하고 실행합니다.

정책에 대한 자세한 내용은 Terms of Use를 참조하세요.

시작하기 (두 가지 옵션)

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

Caiioo를 즉시 사용해 볼 수 있도록 무료 OpenRouter 키를 제공합니다. 사용량 제한이 있는 엄선된 무료 모델에 액세스할 수 있어 기능을 테스트하기에 안성맞춤입니다.

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

기본 제공 키를 사용하는 동안에는 Settings의 OpenRouter 키 필드가 비어 있는 대신 해당 내용이 표시됩니다. Caiioo 계정 키를 사용 중이라는 안내와 남은 잔액을 확인할 수 있습니다. 키는 기기에 저장되며, Private Sync를 켜면 기본 제공 키와 자체 OpenRouter 키가 모두 암호화된 백업에 포함되어 다른 기기로 동기화됩니다.

크레딧을 소모하는 도구들(이미지, 비디오, 음악 생성, 고급 OCR, Perplexity AI 검색)은 단순한 키뿐만 아니라 OpenRouter 크레딧이 필요합니다. 제공된 무료 키를 사용할 경우 이러한 도구에는 "no credits"가 표시됩니다. 해결 방법은 두 가지가 있습니다. Settings > AI Setup > AI Provider에서 자체 OpenRouter API 키를 입력(BYOK)하거나, Caiioo 요금제를 업그레이드하는 것입니다. 유료 요금제는 매월 동일한 기본 제공 키에 크레딧을 충전해 주므로 도구를 바로 사용할 수 있습니다.

옵션 2: 자체 키 사용 (BYOK)

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

OpenRouter (권장):

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

Google AI (Gemini 직접 연결):

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

Anthropic (Claude 직접 연결):

  1. Settings → AI Setup → AI Provider로 이동하여 Anthropic을 선택합니다.
  2. Anthropic credentials 옆의 Manage를 클릭합니다.
  3. Create a key from your Claude account를 클릭합니다.
  4. 브라우저에서 액세스를 승인하고, 인증 코드를 복사하여 Caiioo에 다시 붙여넣은 뒤 Connect를 클릭합니다.

Add API key를 클릭하고 Anthropic Console에서 생성한 키를 직접 붙여넣을 수도 있습니다.

Poe:

  1. Settings → AI Setup → AI Provider로 이동하여 Poe를 선택합니다.
  2. poe.com/api/keys에서 키를 생성합니다. 키 필드 아래의 안내 링크를 통해서도 이동할 수 있습니다.
  3. Poe API Key에 키를 붙여넣습니다.

키 아래에 포인트 잔액이 표시됩니다. 대화 비용은 Poe 포인트와 달러로 모두 표시됩니다.

Ollama, vLLM, Unsloth 또는 MLX (로컬 및 네트워크 서버):

  1. 로컬 모델 서버를 시작합니다(Ollama는 http://localhost:11434, vLLM 또는 Unsloth는 http://localhost:8000, MLX는 http://localhost:8080).
  2. Settings > AI Setup > AI Provider로 이동합니다.
  3. Ollama, vLLM, Unsloth 또는 MLX를 선택하고, 서버 URL(네트워크 상의 원격 서버인 경우 선택적 API 키/토큰)을 확인한 뒤 호스트가 제공하는 모델 중 하나를 선택합니다.

로컬 채팅 모델을 선택하면, 원격 AI 제공자에게 데이터를 전송할 수 있는 AI 기반 도구가 사전에 승인을 요청할 수 있습니다. 자세한 내용은 Privacy & Data → Tools That Use Another AI Provider를 참조하세요.

Default Model 및 Max Steps를 보여주는 모델 구성

하나의 Caiioo Router 및 추론 강도 제어

별도의 라우터 모드 중에서 선택하거나 작업에 적합한 모델을 추측하는 대신, 작성창(또는 설정 > AI 설정 > 모델 구성)에서 모델 선택기를 열어 Caiioo Router와 추론 강도를 사용하세요.

  • Caiioo Router: 모델 선택기 상단에서 Caiioo Router를 선택하면 두 개의 실시간 슬라이더가 나타납니다.
    • 비용 ↔ 지능 — 빠르고 경제적인 일상적 대화는 최저 비용, 최고의 가성비는 균형, 최첨단 추론은 최고 지능 쪽으로 슬라이드하세요.
    • 환각 방지 — 정확성이 가장 중요할 때 사실적 근거 및 출처 인용 엄격도에 더 높은 가중치를 부여합니다.
    • 두 슬라이더 중 하나를 움직이면 아래의 모델 목록이 실시간으로 필터링되고 재정렬되어 선호도와 일치하는 모델을 확인할 수 있습니다.
  • 추론 강도 제어: 선택한 모델(또는 Caiioo Router)이 추론 강도를 지원하는 경우 모델 선택기에 추론 강도 컨트롤이 바로 표시됩니다. 자동(또는 모델이 지원하는 바에 따라 끄기, 낮음, 중간, 높음, 최대)을 선택하세요. Caiioo Router는 고정된 기본값을 가정하는 대신 대화에서 선택한 추론 강도 수준에 맞춰 모델 순위를 매기고 선택합니다.

빠른 작업 모델

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

도구용 BYOA(자체 인증 사용) — Pro

BYOA는 BYOK와 다릅니다. LLM이 아닌 도구 연결(Google Workspace, Microsoft 365, GitHub 등)을 위한 것입니다. Pro 요금제에서는 조직에서 Caiioo의 기본 클라이언트 ID를 허용 목록에 추가하지 않는 경우, 설정 → 커넥터 → 추가 → 사용자 지정 OAuth 앱을 통해 자체 OAuth 클라이언트를 연결할 수 있습니다:

  • 자체 Google OAuth 앱 사용 — Google Cloud 프로젝트를 생성하고 클라이언트 ID 및 보안 비밀번호를 입력하는 단계 안내
  • 자체 Microsoft Azure 앱 사용 — Azure에 등록된 앱을 위한 동일한 절차
  • 사용자 지정 OAuth 제공업체 추가 — 지원하는 모든 제공업체를 위한 범용 OAuth 2.0 절차

마법사를 통해 자격 증명이 사용자 기기에 저장되며, 기기 외부로 절대 전송되지 않습니다.

제공업체당 여러 계정 또는 키 유지

각 제공업체마다 업무용 키와 개인용 키, 또는 로그인된 계정과 API 키처럼 둘 이상의 자격 증명을 저장하고 한 번에 하나씩 사용할 수 있습니다. 더 이상 키를 덮어쓰고 나중에 다시 붙여넣을 필요가 없습니다.

설정 > 커넥터에서 관리하세요. 각 제공업체는 AI 모델 유형의 한 행으로 표시되며, 해당 행을 열면 계정과 키 목록이 표시됩니다. 또는 설정 > AI 설정 > AI 제공업체에서 제공업체 옆의 관리를 클릭해도 됩니다. 각 자격 증명에 이름(예: "회사")을 지정할 수 있고, 활성 자격 증명에는 사용 중 배지가 표시되며, 사용을 한 번 클릭하여 전환할 수 있습니다. Caiioo에서 자격 증명을 삭제해도 제공업체 쪽의 자격 증명은 취소되지 않으며, 해당 계정은 그대로 유지되어 나중에 다시 추가할 수 있습니다.

API 키 보안

API 키는 기기에 로컬로 저장됩니다. 비공개 동기화가 켜져 있으면, 키와 연결된 공급자 계정은 동기화 백업에 들어가기 전에 기기에서 암호화된 후 다른 기기에서만 해독됩니다. Caiioo 서버는 읽을 수 있는 자격 증명을 절대 받지 않습니다. 요청을 수행할 때 대화를 실행하는 기기는 자체 활성 자격 증명을 AI 공급자에게 직접 보냅니다. 자세한 내용은 프라이버시 및 데이터를 참조하세요.

성능은 모델에 따라 달라집니다

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

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

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

실험 목적의 경우: OpenRouter를 사용하면 하나의 API 키로 500개 이상의 모델을 사용해 볼 수 있습니다. 단일 공급업체에 종속되지 않고 워크플로에 가장 적합한 모델을 찾아보세요.

모델 선택 도구는 각 모델을 실제로 제공하는 공급업체의 기능을 설명하며, 측정 결과가 있는 경우 벤치마크 메달을 표시합니다. 새로 출시되었거나 측정되지 않은 모델도 계속 표시되며, 아직 메달이 부여되지 않았을 뿐입니다. 총비용은 서비스 제공업체의 공시 요율을 사용합니다. Caiioo가 요율을 확인할 수 없는 경우, 추정치를 사용하는 대신 비용 표시를 생략합니다.

두 가지 메달, 두 가지 질문. 모델은 다음 항목 중 하나 또는 둘 다에 대해 금, 은, 동메달을 획득할 수 있습니다:

  • Best for Caiioo는 오직 기능만을 기준으로 순위를 매깁니다. 가격은 고려되지 않으므로, 저렴하고 빠른 모델이 '최고(Best)' 항목에서 선두를 차지할 수는 없습니다.
  • Value for Caiioo는 가격을 고려한 항목으로, 비용 대비 얻을 수 있는 최고의 품질을 의미합니다.

Caiioo Router는 이러한 동일한 벤치마크 측정값을 직접 사용합니다. Balanced 또는 Lowest cost 쪽으로 슬라이더를 조정하면 품질과 함께 가격을 고려하며, Highest intelligence 쪽으로 이동하면 성능을 우선시합니다. 선택 도구에 표시되는 기준은 앱이 실제로 선택하는 기준과 동일합니다.

메달 뒤에 숨겨진 측정값을 확인하세요. Model Intelligence(Caiioo Benchmarks, Pro)는 품질, 처리량(throughput), 첫 번째 토큰 생성 시간(time-to-first-token), 도구 정확도 및 가격을 비교하며, 각 수치의 출처와 가치 점수 산정에 반영된 요소를 포함한 방법론을 명시합니다. 각 작업 유형별 순위는 한 번 게시된 후 앱과 caiioo.ai의 리더보드 모두에서 참조되므로, 라우팅이 선택하는 기준과 리더보드에 표시되는 내용은 동일합니다. 리더보드에는 전체 순위뿐만 아니라 코딩, 연구, 글쓰기 등에서 어떤 모델이 우수한지 확인하고 싶을 때 유용한 Best by Use Case 분석도 추가로 제공됩니다.

Creativity 슬라이더 관련 안내: 최신 모델(Claude Sonnet 5 이상 등)은 자체적으로 창의성을 관리하며 temperature 설정을 허용하지 않습니다. 이러한 모델을 선택하면 Model Configuration의 Creativity 슬라이더가 짧은 안내 문구와 함께 비활성화되는데, 이는 정상적인 동작이며 버그가 아닙니다.

오프라인 / 완전한 프라이빗 작업의 경우: Ollama를 사용하면 로컬 기기에서 오픈 소스 모델을 실행할 수 있습니다. 클라우드 프론티어 모델보다는 느리지만, 어떤 데이터도 하드웨어 외부로 유출되지 않습니다.

Caiioo의 도구, 컨텍스트 레이어, 오케스트레이션은 어떤 모델을 선택하든 그 역량을 극대화합니다. 좋은 모델도 적절한 컨텍스트와 도구가 함께 주어지면 뛰어난 모델로 거듭납니다.

참고 항목

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