> ## Documentation Index
> Fetch the complete documentation index at: https://apidoc.cometapi.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Cherry Studio에서 CometAPI 사용하기

> 이 가이드를 사용해 base URL, API key, 그리고 model 또는 provider 옵션을 설정하여 Cherry Studio를 CometAPI와 함께 구성하세요.

[CherryStudio](https://docs.cherry-ai.com/cherrystudio/download)는 여러 model provider를 지원하는 AI 데스크톱 앱입니다. CometAPI를 사용자 지정 OpenAI 호환 provider로 추가하면 우리 플랫폼의 모든 model을 사용할 수 있습니다.

## 사전 준비 사항

* [CherryStudio](https://docs.cherry-ai.com/cherrystudio/download) 설치
* 활성 API key가 있는 [CometAPI](https://www.cometapi.com) 계정

## 설정

<Steps>
  <Step title="CometAPI API 키 가져오기">
    [CometAPI 대시보드](https://www.cometapi.com/console)에 로그인합니다. **Add API Key**를 클릭한 다음 키와 기본 URL(`https://api.cometapi.com`)을 복사합니다.

    <Frame>
      <img src="https://mintcdn.com/cometapi/SZhlxZhCnMLn__BW/images/overview/810968_364191.png?fit=max&auto=format&n=SZhlxZhCnMLn__BW&q=85&s=aef81a83f29f8eb16655ed4060425f50" alt="CometAPI 대시보드 — API 키 추가" width="3824" height="1892" data-path="images/overview/810968_364191.png" />
    </Frame>

    <Frame>
      <img src="https://mintcdn.com/cometapi/HhtmQffktazbxUvS/images/overview/810968_364193.png?fit=max&auto=format&n=HhtmQffktazbxUvS&q=85&s=d893f659267150d0faf45f99eb5dffc1" alt="CometAPI API 키와 기본 URL" width="2434" height="1232" data-path="images/overview/810968_364193.png" />
    </Frame>
  </Step>

  <Step title="CometAPI를 provider로 추가">
    CherryStudio **Settings** → **Model Services**를 엽니다. **Add**를 클릭하고 provider 이름(예: `CometAPI`)을 지정한 다음, provider 유형으로 **OpenAI**를 선택하고 **OK**를 클릭합니다. **API Address** 필드에 `https://api.cometapi.com`을 입력하고 **Key** 필드에 키를 붙여넣습니다.

    <Frame>
      <img src="https://mintcdn.com/cometapi/E4FFvyMYmaOZoldp/images/integrations/810968_355194.png?fit=max&auto=format&n=E4FFvyMYmaOZoldp&q=85&s=93a035c01494c21065a134748e396381" alt="CherryStudio 모델 서비스 — provider 추가 대화상자" width="1078" height="606" data-path="images/integrations/810968_355194.png" />
    </Frame>

    <Frame>
      <img src="https://mintcdn.com/cometapi/E4FFvyMYmaOZoldp/images/integrations/810968_355195.png?fit=max&auto=format&n=E4FFvyMYmaOZoldp&q=85&s=f6edb15b1848812555d0cac24282afcf" alt="CometAPI용 API 주소 및 키 필드가 입력된 모습" width="1056" height="600" data-path="images/integrations/810968_355195.png" />
    </Frame>
  </Step>

  <Step title="모델 추가">
    **Add Model**을 클릭하고 사용하려는 현재 model ID를 입력합니다. 여러 모델을 추가할 수 있습니다.

    <Frame>
      <img src="https://mintcdn.com/cometapi/E4FFvyMYmaOZoldp/images/integrations/810968_355196.png?fit=max&auto=format&n=E4FFvyMYmaOZoldp&q=85&s=9b9f17fe4287de67735320ec5b464e65" alt="사용자 지정 모델이 추가된 CherryStudio 모델 목록" width="1059" height="599" data-path="images/integrations/810968_355196.png" />
    </Frame>
  </Step>

  <Step title="연결 테스트">
    채팅을 열고 테스트 메시지를 보냅니다. 응답이 성공적으로 오면 설정이 정상적으로 작동하는 것입니다.

    <Frame>
      <img src="https://mintcdn.com/cometapi/E4FFvyMYmaOZoldp/images/integrations/810968_360313.png?fit=max&auto=format&n=E4FFvyMYmaOZoldp&q=85&s=305c5fdce1017d6942aa1176b64f3a96" alt="성공적인 응답을 보여주는 CherryStudio 채팅" width="1069" height="590" data-path="images/integrations/810968_360313.png" />
    </Frame>
  </Step>
</Steps>

<Tip>
  더 많은 모델을 추가하려면 provider 설정으로 돌아가 **Add Model**을 다시 클릭합니다.

  <Frame>
    <img src="https://mintcdn.com/cometapi/E4FFvyMYmaOZoldp/images/integrations/810968_355199.png?fit=max&auto=format&n=E4FFvyMYmaOZoldp&q=85&s=da182754d5fae90778c2c9cc9d5b5727" alt="다른 사용자 지정 모델이 추가된 CherryStudio 설정" width="1075" height="609" data-path="images/integrations/810968_355199.png" />
  </Frame>
</Tip>

<script type="application/ld+json">
  {`
    {
    "@context": "https://schema.org",
    "@graph": [
      {
        "@type": "HowTo",
        "@id": "https://apidoc.cometapi.com/integrations/cherrystudio#howto",
        "name": "CometAPI와 함께 Cherry Studio 사용하기",
        "description": "이 가이드를 사용해 기본 URL, API 키, 모델 또는 provider 옵션을 설정하여 Cherry Studio를 CometAPI와 함께 구성하세요.",
        "step": [
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/cherrystudio#step-1",
            "position": 1,
            "name": "CometAPI API 키 가져오기",
            "text": "CometAPI 계정을 만들거나 연 다음, 대시보드에서 활성 API 키를 복사합니다."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/cherrystudio#step-2",
            "position": 2,
            "name": "CometAPI를 provider로 추가",
            "text": "CometAPI와 함께 Cherry Studio 사용하기 가이드의 CometAPI를 provider로 추가 단계를 완료합니다."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/cherrystudio#step-3",
            "position": 3,
            "name": "모델 추가",
            "text": "CometAPI와 함께 Cherry Studio 사용하기 가이드의 모델 추가 단계를 완료합니다."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/cherrystudio#step-4",
            "position": 4,
            "name": "연결 테스트",
            "text": "CometAPI Models 페이지에서 현재 model ID를 선택한 다음 integration에서 테스트 요청을 보냅니다."
          }
        ]
      },
      {
        "@type": "BreadcrumbList",
        "itemListElement": [
          {
            "@type": "ListItem",
            "position": 1,
            "name": "CometAPI 문서",
            "item": "https://apidoc.cometapi.com/"
          },
          {
            "@type": "ListItem",
            "position": 2,
            "name": "통합",
            "item": "https://apidoc.cometapi.com/integrations"
          },
          {
            "@type": "ListItem",
            "position": 3,
            "name": "CometAPI와 함께 Cherry Studio 사용하기",
            "item": "https://apidoc.cometapi.com/integrations/cherrystudio"
          }
        ]
      }
    ]
    }
    `}
</script>