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

# Kết nối Dify với CometAPI

> Sử dụng hướng dẫn này để kết nối Dify với CometAPI bằng cách thiết lập base URL, API key và các tùy chọn model hoặc provider.

[Dify](https://dify.ai) là một nền tảng phát triển ứng dụng LLM mã nguồn mở. Bằng cách kết nối với CometAPI, bạn có thể sử dụng các model ID hiện có của CometAPI bên trong trình tạo workflow, chatbot và agent của Dify.

## Điều kiện tiên quyết

* Một tài khoản CometAPI với API key đang hoạt động — [đăng nhập để lấy](https://www.cometapi.com)
* Một tài khoản Dify — [cloud](https://cloud.dify.ai/signin) hoặc tự host

## Phương pháp 1: Plugin CometAPI (khuyến nghị)

Đây là cách kết nối dễ nhất. Dify Marketplace cung cấp plugin CometAPI chính thức, tự động xử lý việc tích hợp.

<Steps>
  <Step title="Lấy CometAPI API key của bạn">
    Đăng nhập vào [bảng điều khiển CometAPI](https://www.cometapi.com/console). Nhấp vào **Add API Key** và sao chép key của bạn.

    <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="Bảng điều khiển CometAPI hiển thị nút Add API Key và danh sách key" 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="Chi tiết CometAPI API key hiển thị base URL https://api.cometapi.com" width="2434" height="1232" data-path="images/overview/810968_364193.png" />
    </Frame>
  </Step>

  <Step title="Cài đặt plugin CometAPI trong Dify">
    Trong Dify, đi đến **Plugins** → **Install Plugin** → **Marketplace**. Tìm `cometapi` và cài đặt.

    <Frame>
      <img src="https://mintcdn.com/cometapi/E4FFvyMYmaOZoldp/images/integrations/810968_360267.png?fit=max&auto=format&n=E4FFvyMYmaOZoldp&q=85&s=85e4b1a60c912aa98c182ed731cde19f" alt="Kết quả tìm kiếm trong marketplace plugin của Dify hiển thị plugin CometAPI" 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="Hộp thoại xác nhận cài đặt plugin CometAPI trong Dify" width="1865" height="896" data-path="images/integrations/810968_360269.png" />
    </Frame>
  </Step>

  <Step title="Thêm API key của bạn">
    Đi đến **Settings** → **Model Provider** → **CometAPI** → **Open Settings**. Dán CometAPI API key của bạn và nhấp **Save**.
  </Step>

  <Step title="Thêm model">
    Nhập model ID từ [trang CometAPI Models](/vi/overview/models) và nhấp **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="Cài đặt model provider của Dify hiển thị biểu mẫu cấu hình CometAPI" 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="Danh sách model trong Dify với các model CometAPI đã được thêm thành công" width="1935" height="870" data-path="images/integrations/810968_362637.png" />
    </Frame>
  </Step>

  <Step title="Kiểm tra kết nối">
    Tạo một chatbot hoặc workflow và chọn model CometAPI. Gửi một tin nhắn thử — phản hồi thành công xác nhận rằng tích hợp đang hoạt động.

    <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="Giao diện chat của Dify hiển thị phản hồi thành công từ model CometAPI" width="1910" height="924" data-path="images/integrations/810968_362638.png" />
    </Frame>
  </Step>
</Steps>

## Phương pháp 2: Provider tương thích OpenAI

Sử dụng phương pháp này để thêm các model chưa được plugin CometAPI hỗ trợ, chẳng hạn như Claude, Grok hoặc Gemini — hoặc để dùng tên model tùy chỉnh.

<Steps>
  <Step title="Mở cài đặt model provider">
    Đi đến **Settings** → **Model Provider** → **OpenAI-API-compatible** → **Add Model**.
  </Step>

  <Step title="Cấu hình model">
    Điền các trường sau:

    | Field        | Value                                      |
    | ------------ | ------------------------------------------ |
    | Loại trường  | LLM                                        |
    | Tên model    | Model ID từ CometAPI (phải khớp chính xác) |
    | API key      | CometAPI API key của bạn                   |
    | API base URL | `https://api.cometapi.com/v1`              |

    Nhấp **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="Biểu mẫu provider tương thích OpenAI của Dify với các giá trị CometAPI đã được điền" 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="Danh sách model trong Dify hiển thị một mục model tương thích CometAPI mới được lưu" width="1953" height="965" data-path="images/integrations/810968_354448.png" />
    </Frame>
  </Step>
</Steps>

<Tip>
  Để biết các định danh model, hãy tham khảo [trang CometAPI Models](/vi/overview/models). Model ID trong Dify phải khớp chính xác với định danh được sử dụng trong CometAPI.
</Tip>

## Khắc phục sự cố

<AccordionGroup>
  <Accordion title="API key không hoạt động">
    Xác nhận rằng API key là chính xác và còn số dư khả dụng.
  </Accordion>

  <Accordion title="model ID không hoạt động">
    Xác nhận rằng model ID khớp chính xác với những gì CometAPI yêu cầu.
  </Accordion>

  <Accordion title="API base URL không hoạt động">
    Xác nhận rằng API base URL bao gồm `/v1` cho phương thức tương thích OpenAI.
  </Accordion>

  <Accordion title="Trợ giúp thêm">
    Truy cập [trang hỗ trợ 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": "Kết nối Dify với CometAPI",
        "description": "Sử dụng hướng dẫn này để kết nối Dify với CometAPI bằng cách thiết lập base URL, API key và các tùy chọn model hoặc provider.",
        "step": [
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/dify#step-1",
            "position": 1,
            "name": "Lấy API key CometAPI của bạn",
            "text": "Tạo hoặc mở tài khoản CometAPI của bạn, sau đó sao chép một API key đang hoạt động từ dashboard."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/dify#step-2",
            "position": 2,
            "name": "Cài đặt plugin CometAPI trong Dify",
            "text": "Hoàn thành bước Cài đặt plugin CometAPI trong Dify trong hướng dẫn Kết nối Dify với CometAPI."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/dify#step-3",
            "position": 3,
            "name": "Thêm API key của bạn",
            "text": "Hoàn thành bước Thêm API key của bạn trong hướng dẫn Kết nối Dify với CometAPI."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/dify#step-4",
            "position": 4,
            "name": "Thêm model",
            "text": "Hoàn thành bước Thêm model trong hướng dẫn Kết nối Dify với CometAPI."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/dify#step-5",
            "position": 5,
            "name": "Kiểm tra kết nối",
            "text": "Chọn một model ID hiện tại từ trang CometAPI Models, sau đó gửi một yêu cầu kiểm tra từ phần tích hợp."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/dify#step-6",
            "position": 6,
            "name": "Mở cài đặt provider model",
            "text": "Hoàn thành bước Mở cài đặt provider model trong hướng dẫn Kết nối Dify với CometAPI."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/dify#step-7",
            "position": 7,
            "name": "Cấu hình model",
            "text": "Hoàn thành bước Cấu hình model trong hướng dẫn Kết nối Dify với CometAPI."
          }
        ]
      },
      {
        "@type": "BreadcrumbList",
        "itemListElement": [
          {
            "@type": "ListItem",
            "position": 1,
            "name": "Tài liệu CometAPI",
            "item": "https://apidoc.cometapi.com/"
          },
          {
            "@type": "ListItem",
            "position": 2,
            "name": "Tích hợp",
            "item": "https://apidoc.cometapi.com/integrations"
          },
          {
            "@type": "ListItem",
            "position": 3,
            "name": "Kết nối Dify với CometAPI",
            "item": "https://apidoc.cometapi.com/integrations/dify"
          }
        ]
      }
    ]
    }
    `}
</script>