> ## 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.

# Dify를 CometAPI에 연결하기

> 이 가이드를 사용해 base URL, API key, model 또는 provider 옵션을 설정하여 Dify를 CometAPI에 연결하세요.

[Dify](https://dify.ai)는 오픈소스 LLM 애플리케이션 개발 플랫폼입니다. CometAPI에 연결하면 Dify의 워크플로, 챗봇, 에이전트 빌더 안에서 현재 CometAPI model ID를 사용할 수 있습니다.

## 사전 요구 사항

* 활성 API key가 있는 CometAPI 계정 — [로그인하여 발급받기](https://www.cometapi.com)
* Dify 계정 — [cloud](https://cloud.dify.ai/signin) 또는 self-hosted

## 방법 1: CometAPI 플러그인(권장)

가장 쉽게 연결하는 방법입니다. Dify Marketplace는 통합을 자동으로 처리하는 공식 CometAPI 플러그인을 제공합니다.

<Steps>
  <Step title="CometAPI API key 가져오기">
    [CometAPI 대시보드](https://www.cometapi.com/console)에 로그인하세요. **Add API Key**를 클릭하고 key를 복사합니다.

    <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="Add API Key 버튼과 key 목록이 표시된 CometAPI 대시보드" 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="base URL https://api.cometapi.com이 표시된 CometAPI API key 상세 정보" width="2434" height="1232" data-path="images/overview/810968_364193.png" />
    </Frame>
  </Step>

  <Step title="Dify에 CometAPI 플러그인 설치하기">
    Dify에서 **Plugins** → **Install Plugin** → **Marketplace**로 이동합니다. `cometapi`를 검색해 설치하세요.

    <Frame>
      <img src="https://mintcdn.com/cometapi/E4FFvyMYmaOZoldp/images/integrations/810968_360267.png?fit=max&auto=format&n=E4FFvyMYmaOZoldp&q=85&s=85e4b1a60c912aa98c182ed731cde19f" alt="CometAPI 플러그인이 표시된 Dify 플러그인 마켓플레이스 검색 결과" width="1875" height="916" data-path="images/integrations/810968_360267.png" />
    </Frame>

    <Frame>
      <img src="https://mintcdn.com/cometapi/E4FFvyMYmaOZoldp/images/integrations/810968_360269.png?fit=max&auto=format&n=E4FFvyMYmaOZoldp&q=85&s=695d0f5fde8d4c8aad398048b3b504fd" alt="Dify의 CometAPI 플러그인 설치 확인 대화상자" width="1865" height="896" data-path="images/integrations/810968_360269.png" />
    </Frame>
  </Step>

  <Step title="API key 추가하기">
    **Settings** → **Model Provider** → **CometAPI** → **Open Settings**로 이동합니다. CometAPI API key를 붙여넣고 **Save**를 클릭하세요.
  </Step>

  <Step title="모델 추가하기">
    [CometAPI Models 페이지](/ko/overview/models)에서 model ID를 입력하고 **Add**를 클릭합니다.

    <Frame>
      <img src="https://mintcdn.com/cometapi/SZhlxZhCnMLn__BW/images/integrations/810968_362636.png?fit=max&auto=format&n=SZhlxZhCnMLn__BW&q=85&s=9aee58e6532ba58d69eb7673e6c45293" alt="CometAPI 구성 양식이 표시된 Dify model provider 설정" width="1256" height="880" data-path="images/integrations/810968_362636.png" />
    </Frame>

    <Frame>
      <img src="https://mintcdn.com/cometapi/SZhlxZhCnMLn__BW/images/integrations/810968_362637.png?fit=max&auto=format&n=SZhlxZhCnMLn__BW&q=85&s=46c8b360d87cfad2adc1cd9f18dd7f25" alt="CometAPI 모델이 성공적으로 추가된 Dify model 목록" width="1935" height="870" data-path="images/integrations/810968_362637.png" />
    </Frame>
  </Step>

  <Step title="연결 테스트하기">
    챗봇 또는 워크플로를 생성하고 CometAPI 모델을 선택합니다. 테스트 메시지를 보내세요 — 응답이 성공적으로 오면 통합이 정상적으로 작동하는 것입니다.

    <Frame>
      <img src="https://mintcdn.com/cometapi/SZhlxZhCnMLn__BW/images/integrations/810968_362638.png?fit=max&auto=format&n=SZhlxZhCnMLn__BW&q=85&s=c729bbc0f3bef82a89305434c08ec313" alt="CometAPI 모델의 성공적인 응답이 표시된 Dify 채팅 인터페이스" width="1910" height="924" data-path="images/integrations/810968_362638.png" />
    </Frame>
  </Step>
</Steps>

## 방법 2: OpenAI 호환 provider

CometAPI 플러그인에서 지원하지 않는 Claude, Grok, Gemini 같은 모델을 추가하거나 사용자 지정 model name을 사용하려면 이 방법을 사용하세요.

<Steps>
  <Step title="model provider 설정 열기">
    **Settings** → **Model Provider** → **OpenAI-API-compatible** → **Add Model**로 이동합니다.
  </Step>

  <Step title="모델 구성하기">
    다음 필드를 입력합니다:

    | 필드           | 값                              |
    | ------------ | ------------------------------ |
    | 모델 유형        | LLM                            |
    | 모델 이름        | CometAPI의 model ID(정확히 일치해야 함) |
    | API key      | CometAPI API key               |
    | API base URL | `https://api.cometapi.com/v1`  |

    **Save**를 클릭하세요.

    <Frame>
      <img src="https://mintcdn.com/cometapi/E4FFvyMYmaOZoldp/images/integrations/810968_354447.png?fit=max&auto=format&n=E4FFvyMYmaOZoldp&q=85&s=a6752a58cf43a3c7658da7b276ed5c1e" alt="CometAPI 값이 입력된 Dify OpenAI 호환 provider 양식" width="1910" height="1009" data-path="images/integrations/810968_354447.png" />
    </Frame>

    <Frame>
      <img src="https://mintcdn.com/cometapi/E4FFvyMYmaOZoldp/images/integrations/810968_354448.png?fit=max&auto=format&n=E4FFvyMYmaOZoldp&q=85&s=18caf18d11f4f0aa6741471016bcb14f" alt="새로 저장된 CometAPI 호환 모델 항목이 표시된 Dify model 목록" width="1953" height="965" data-path="images/integrations/810968_354448.png" />
    </Frame>
  </Step>
</Steps>

<Tip>
  모델 식별자는 [CometAPI Models 페이지](/ko/overview/models)를 참고하세요. Dify의 model ID는 CometAPI에서 사용하는 식별자와 정확히 일치해야 합니다.
</Tip>

## 문제 해결

<AccordionGroup>
  <Accordion title="API 키가 작동하지 않습니다">
    API 키가 올바르고 사용 가능한 잔액이 있는지 확인하세요.
  </Accordion>

  <Accordion title="model ID가 작동하지 않습니다">
    model ID가 CometAPI에서 기대하는 값과 정확히 일치하는지 확인하세요.
  </Accordion>

  <Accordion title="API base URL이 작동하지 않습니다">
    OpenAI 호환 방식의 경우 API base URL에 `/v1`이 포함되어 있는지 확인하세요.
  </Accordion>

  <Accordion title="추가 도움말">
    [CometAPI 지원 페이지](https://www.cometapi.com/support/)를 방문하세요.
  </Accordion>
</AccordionGroup>

<script type="application/ld+json">
  {`
    {
    "@context": "https://schema.org",
    "@graph": [
      {
        "@type": "HowTo",
        "@id": "https://apidoc.cometapi.com/integrations/dify#howto",
        "name": "Dify를 CometAPI에 연결",
        "description": "이 가이드를 사용해 base URL, API 키, 그리고 model 또는 provider 옵션을 설정하여 Dify를 CometAPI에 연결하세요.",
        "step": [
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/dify#step-1",
            "position": 1,
            "name": "CometAPI API 키 가져오기",
            "text": "CometAPI 계정을 만들거나 열고, 대시보드에서 활성 API 키를 복사하세요."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/dify#step-2",
            "position": 2,
            "name": "Dify에서 CometAPI 플러그인 설치",
            "text": "Dify를 CometAPI에 연결 가이드의 Dify에서 CometAPI 플러그인 설치 단계를 완료하세요."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/dify#step-3",
            "position": 3,
            "name": "API 키 추가",
            "text": "Dify를 CometAPI에 연결 가이드의 API 키 추가 단계를 완료하세요."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/dify#step-4",
            "position": 4,
            "name": "모델 추가",
            "text": "Dify를 CometAPI에 연결 가이드의 모델 추가 단계를 완료하세요."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/dify#step-5",
            "position": 5,
            "name": "연결 테스트",
            "text": "CometAPI Models 페이지에서 현재 model ID를 선택한 다음, 통합에서 테스트 요청을 보내세요."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/dify#step-6",
            "position": 6,
            "name": "모델 provider 설정 열기",
            "text": "Dify를 CometAPI에 연결 가이드의 모델 provider 설정 열기 단계를 완료하세요."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/dify#step-7",
            "position": 7,
            "name": "모델 구성",
            "text": "Dify를 CometAPI에 연결 가이드의 모델 구성 단계를 완료하세요."
          }
        ]
      },
      {
        "@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": "Dify를 CometAPI에 연결",
            "item": "https://apidoc.cometapi.com/integrations/dify"
          }
        ]
      }
    ]
    }
    `}
</script>