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

AI 제공자 및 API 키

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

지원되는 제공업체

현재 7개의 제공업체를 일반적으로 사용할 수 있습니다:

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

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

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

시작하기 (두 가지 옵션)

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

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

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

포함된 키를 사용하는 동안에는 설정의 OpenRouter 키 필드가 비어 있는 대신 Caiioo의 계정 키와 남은 잔액을 사용하고 있다는 메모가 표시됩니다. 키는 기기에 저장되며, Private Sync가 켜져 있는 경우 포함된 키와 사용자의 OpenRouter 키가 암호화된 백업 내에서 다른 기기로 동기화됩니다.

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

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

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

OpenRouter (권장):

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

Google AI (직접 Gemini 연결):

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

Anthropic (직접 Claude 연결):

  1. 설정 → AI 설정 → AI 공급자로 이동하여 Anthropic을 선택합니다.
  2. Anthropic 자격 증명 옆의 관리를 클릭합니다.
  3. 연결된 계정 아래에서 Claude 계정에서 키 생성을 클릭합니다.
  4. 브라우저에서 액세스를 승인하고, 인증 코드를 복사하여 Caiioo에 붙여넣은 뒤 연결을 클릭합니다.

또한 API 키 추가를 클릭하여 Anthropic 콘솔에서 생성한 키를 붙여넣을 수도 있습니다.

Poe:

  1. 설정 → AI 설정 → AI 공급자로 이동하여 Poe를 선택합니다.
  2. poe.com/api/keys에서 키를 생성합니다(키 필드 아래의 메모에도 링크가 있습니다).
  3. Poe API Key에 키를 붙여넣습니다.

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

Ollama (로컬):

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

로컬 채팅 모델을 선택하면 데이터를 원격 AI 공급자로 전송하는 AI 기반 도구가 먼저 승인을 요청합니다. 개인정보 보호 및 데이터 → 원격 AI 공급자를 참조하세요.

기본 모델 및 최대 단계가 표시된 모델 설정

빠른 작업 모델

스레드 제목 생성, 의도 분류, 호출할 도구 선택 및 기타 간단한 도우미 쿼리와 같은 작업에 Caiioo가 백그라운드에서 자동으로 사용하는 별도의 더 저렴한 모델입니다. 사용자가 직접 프롬프트를 입력할 일은 없습니다. 설정 → AI 설정 → 모델 설정에서 구성할 수 있습니다(작은 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 2.0 흐름인 사용자 지정 OAuth 공급자 추가

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

공급자별로 여러 계정 또는 키 유지

모든 공급자는 둘 이상의 자격 증명을 가질 수 있습니다(업무용 키와 개인용 키, 또는 로그인한 계정과 API 키). 한 번에 하나씩 사용할 수 있습니다. 더 이상 키를 덮어쓰고 나중에 다시 붙여넣을 필요가 없습니다.

설정 > 계정 > 계정 권한 및 허가의 AI 공급자 계정(연결된 계정 및 API 키 탭 포함)에서 관리하거나, 설정 > AI Setup > 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' 항목에서 1위를 차지할 수는 없습니다.
  • Value for Caiioo는 가격 대비 가치를 평가합니다. 즉, 비용 대비 얻을 수 있는 최고의 품질을 의미합니다.

자동 라우팅 역시 동일한 구분을 따릅니다. Value Router는 비용을 고려하지만, 다른 라우터들은 그렇지 않습니다. 선택기에서 확인하는 정보는 앱이 실제로 모델을 선택하는 기준과 일치합니다.

메달 뒤에 숨겨진 측정 지표 확인하기. Model Intelligence(Caiioo Benchmarks, Pro)는 품질, 처리량(throughput), 첫 번째 토큰 생성 시간(time-to-first-token), 도구 정확도 및 가격을 비교하며, 각 수치의 출처와 가치 점수(value score)에 반영된 요소를 포함한 방법론을 명확히 설명합니다. 각 작업 유형별 순위는 게시된 후 앱과 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.