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

# Bắt đầu với CometAPI: tạo API key và thực hiện lệnh gọi đầu tiên

> Bắt đầu với CometAPI bằng cách tạo API key, thiết lập base URL và gửi yêu cầu API đầu tiên bằng curl, Python hoặc Node.js.

## Tạo tài khoản và API key

Tạo tài khoản CometAPI và API key trước khi bạn gọi API.

<Steps>
  <Step title="Đăng nhập hoặc tạo tài khoản">
    Mở [trang đăng nhập CometAPI](https://www.cometapi.com/console/login). Tiếp tục với Google, tiếp tục với GitHub, hoặc nhập email hoặc tên người dùng của bạn. Nếu bạn chưa có tài khoản, hãy hoàn tất việc tạo tài khoản từ trang này.

    <Frame>
      <img src="https://mintcdn.com/cometapi/BtE3Lagaukxd3efj/images/overview/cometapi-console-login.png?fit=max&auto=format&n=BtE3Lagaukxd3efj&q=85&s=988bee0055bf1ce2552a8d877a48a97d" alt="Trang đăng nhập CometAPI với các tùy chọn đăng nhập bằng Google, GitHub và email" width="1280" height="720" data-path="images/overview/cometapi-console-login.png" />
    </Frame>
  </Step>

  <Step title="Mở API keys">
    Sau khi đăng nhập, mở [trang API key](https://www.cometapi.com/console/token). Bạn cũng có thể chọn **API Keys** trong thanh bên của bảng điều khiển.
  </Step>

  <Step title="Tạo API key">
    Nhấp vào **Create API Key**, nhập một tên rõ ràng như `local-test`, và giữ **Unlimited Quota** được bật cho lần kiểm tra đầu tiên trừ khi bạn muốn đặt giới hạn chi tiêu. Nhấp vào **Create**.

    <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="Trang API keys của CometAPI với nút Create API Key và hộp thoại tạo được làm nổi bật" width="3824" height="1892" data-path="images/overview/810968_364191.png" />
    </Frame>
  </Step>

  <Step title="Sao chép API key">
    Nhấp vào nút sao chép trong cột **Key**. Lưu key đã sao chép vào biến môi trường phía máy chủ hoặc tệp `.env` cục bộ. Không dán API key thật vào kho lưu trữ công khai, mã frontend, ảnh chụp màn hình hoặc phiếu hỗ trợ.

    <Frame>
      <img src="https://mintcdn.com/cometapi/HhtmQffktazbxUvS/images/overview/810968_364193.png?fit=max&auto=format&n=HhtmQffktazbxUvS&q=85&s=d893f659267150d0faf45f99eb5dffc1" alt="Bảng API keys của CometAPI với nút sao chép được làm nổi bật cho một API key đã được che" width="2434" height="1232" data-path="images/overview/810968_364193.png" />
    </Frame>
  </Step>
</Steps>

Các ví dụ yêu cầu đọc `COMETAPI_KEY` từ môi trường của bạn.

## Lưu API key của bạn trên máy cục bộ

Để kiểm tra cục bộ, hãy export API key của bạn dưới dạng biến môi trường:

```bash theme={null}
read -rsp "CometAPI API key: " COMETAPI_KEY
printf '\n'
export COMETAPI_KEY
```

## Base URL

Sử dụng base URL này cho các SDK tương thích OpenAI và các lệnh gọi API:

```text theme={null}
https://api.cometapi.com/v1
```

## Chuyển từ OpenAI trong 30 giây

Sau khi bạn có API key CometAPI, hãy dùng khác biệt hai thiết lập này khi chuyển một client SDK OpenAI sang CometAPI:

```diff theme={null}
- base_url="https://api.openai.com/v1"
- api_key=os.environ["OPENAI_API_KEY"]
+ base_url="https://api.cometapi.com/v1"
+ api_key=os.environ["COMETAPI_KEY"]
```

CometAPI sử dụng các định dạng yêu cầu tương thích OpenAI cho các quy trình làm việc phổ biến về văn bản, hình ảnh, âm thanh và video. Nếu ứng dụng của bạn đã sử dụng OpenAI SDK, hãy bắt đầu bằng cách thay đổi base URL và API key.

## Thực hiện lệnh gọi đầu tiên

Sau khi bạn thiết lập `COMETAPI_KEY` trong môi trường của mình, hãy thay `your-model-id` bằng một model ID hiện tại từ [trang Models](/vi/overview/models).

<CodeGroup>
  ```bash cURL theme={null}
  curl https://api.cometapi.com/v1/chat/completions \
    -H "Authorization: Bearer $COMETAPI_KEY" \
    -H "Content-Type: application/json" \
    -d '{
      "model": "your-model-id",
      "messages": [
        {
          "role": "user",
          "content": "Write a one-sentence bedtime story."
        }
      ]
    }'
  ```

  ```python Python theme={null}
  import os
  from openai import OpenAI

  client = OpenAI(
      api_key=os.environ["COMETAPI_KEY"],
      base_url="https://api.cometapi.com/v1",
  )

  completion = client.chat.completions.create(
      model="your-model-id",
      messages=[
          {
              "role": "user",
              "content": "Write a one-sentence bedtime story.",
          }
      ],
  )

  print(completion.choices[0].message.content)
  ```

  ```javascript Node.js theme={null}
  import OpenAI from "openai";

  const client = new OpenAI({
    apiKey: process.env.COMETAPI_KEY,
    baseURL: "https://api.cometapi.com/v1",
  });

  const completion = await client.chat.completions.create({
    model: "your-model-id",
    messages: [
      {
        role: "user",
        content: "Write a one-sentence bedtime story.",
      },
    ],
  });

  console.log(completion.choices[0].message.content);
  ```
</CodeGroup>

## Chọn một model

Chọn một model ID từ [trang Models](/vi/overview/models), sau đó truyền giá trị đó vào trường `model`.

| Mục tiêu                          | Bắt đầu ở đâu                                                                                                                                    |
| --------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------ |
| Trò chuyện hoặc văn bản tổng quát | Sử dụng một model GPT, Claude, Gemini, DeepSeek hoặc model chat khác với [Chat Completions](/api/text/chat).                                     |
| Viết mã và suy luận               | Sử dụng model coding hoặc reasoning với [Responses](/api/text/responses) khi model yêu cầu API Responses.                                        |
| Tạo hình ảnh                      | Sử dụng model hình ảnh với [Create image](/api/image/openai/images) hoặc hướng dẫn hình ảnh dành riêng cho từng nhà cung cấp.                    |
| Tạo video                         | Sử dụng model video với trang API video phù hợp với quy trình làm việc của nhà cung cấp, chẳng hạn như [Create video](/api/video/sora-2/create). |

## Tiếp theo là gì

* Đối với lỗi request, xem [Error Codes & Handling](/vi/errors/error-codes-handling).
* Để biết hướng dẫn retry, xem [cách xử lý rate limits](/api/text/chat#how-to-handle-rate-limits).
* Đối với cách sử dụng theo từng model, hãy bắt đầu với [Chat Completions](/api/text/chat), [Responses](/api/text/responses), [Create image](/api/image/openai/images) hoặc [Create video](/api/video/sora-2/create).
* Để biết chi tiết về thanh toán, xem [About Pricing](/vi/pricing/about-pricing).
* Để mời thành viên nhóm và quản lý Credits dùng chung, hãy xem [Quản lý nhóm bằng Workspace](/vi/workspace/overview).
* Nếu cần trợ giúp, xem [Help Center](/vi/support/help-center) hoặc liên hệ [bộ phận hỗ trợ CometAPI](https://www.cometapi.com/support/).

## Câu hỏi thường gặp

<AccordionGroup>
  <Accordion title="Làm thế nào để tạo tài khoản CometAPI?">
    Mở [trang đăng nhập CometAPI](https://www.cometapi.com/console/login), sau đó tiếp tục với Google, tiếp tục với GitHub, hoặc nhập email hay tên người dùng của bạn. Nếu bạn chưa có tài khoản, hãy hoàn tất việc tạo tài khoản ngay trên cùng trang đó.
  </Accordion>

  <Accordion title="Làm thế nào để lấy API key của CometAPI?">
    Mở [trang API key](https://www.cometapi.com/console/token) trong dashboard CometAPI, nhấp vào **Create API Key**, nhập tên, nhấp **Create**, rồi sao chép API key đã được tạo. Hãy dùng `$COMETAPI_KEY` trong các ví dụ thay cho API key thật.
  </Accordion>

  <Accordion title="Tôi nên lưu API key ở đâu?">
    Lưu API key của bạn trong biến môi trường phía máy chủ hoặc tệp `.env` cục bộ. Không commit nó vào kho lưu trữ công khai, không dán vào mã frontend, không đưa vào ảnh chụp màn hình, và không gửi trong phiếu hỗ trợ.
  </Accordion>

  <Accordion title="Base URL của CometAPI cho các lệnh gọi API là gì?">
    Sử dụng `https://api.cometapi.com/v1` cho các SDK tương thích OpenAI và các endpoint như `/v1/chat/completions`.
  </Accordion>

  <Accordion title="CometAPI có hoạt động với OpenAI Python SDK không?">
    Có. Tạo một client `OpenAI`, đặt `api_key` thành API key CometAPI của bạn, và đặt `base_url` thành `https://api.cometapi.com/v1`.
  </Accordion>

  <Accordion title="Làm thế nào để chuyển từ OpenAI sang CometAPI?">
    Thay đổi base URL thành `https://api.cometapi.com/v1`, thay API key bằng API key CometAPI của bạn, và dùng model ID CometAPI từ [trang Models](/vi/overview/models).
  </Accordion>

  <Accordion title="Tôi nên dùng model ID nào trước?">
    Chọn model ID theo trường hợp sử dụng. Bắt đầu từ [trang Models](/vi/overview/models), sau đó chọn model chat, coding, image hoặc video phù hợp với trang API mà bạn dự định gọi.
  </Accordion>

  <Accordion title="CometAPI hỗ trợ những ngôn ngữ lập trình nào?">
    CometAPI hoạt động với mọi ngôn ngữ lập trình có thể gửi yêu cầu HTTPS. Hãy bắt đầu với các ví dụ curl, Python và Node.js trên trang này, hoặc dùng SDK tương thích OpenAI cho phép bạn ghi đè base URL.
  </Accordion>

  <Accordion title="CometAPI có cung cấp bản dùng thử miễn phí hoặc API key miễn phí không?">
    Bạn có thể tạo API key CometAPI từ dashboard. Để kiểm tra khả năng sử dụng bản dùng thử miễn phí, số credit dùng thử miễn phí và chi tiết thanh toán, hãy xem [trang giá CometAPI](https://www.cometapi.com/pricing/) và [Giới thiệu về giá](/vi/pricing/about-pricing).
  </Accordion>
</AccordionGroup>

<script type="application/ld+json">
  {`
    {
    "@context": "https://schema.org",
    "@graph": [
      {
        "@type": "HowTo",
        "name": "Hướng dẫn nhanh CometAPI: Tạo API key và thực hiện lệnh gọi đầu tiên",
        "description": "Hướng dẫn nhanh CometAPI cho người dùng lần đầu: đăng nhập, tạo API key, sao chép key, đặt base URL và thực hiện lệnh gọi API đầu tiên bằng curl, Python hoặc Node.js.",
        "step": [
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/overview/quick-start#sign-in-or-create-an-account",
            "name": "Đăng nhập hoặc tạo tài khoản",
            "text": "Mở https://www.cometapi.com/console/login và tiếp tục với Google, GitHub hoặc email."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/overview/quick-start#open-api-keys",
            "name": "Mở API key",
            "text": "Sau khi đăng nhập, mở https://www.cometapi.com/console/token hoặc chọn API Keys trong thanh bên của dashboard."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/overview/quick-start#create-an-api-key",
            "name": "Tạo API key",
            "text": "Nhấp vào Create API Key, nhập tên, chọn thiết lập quota và nhấp Create."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/overview/quick-start#copy-the-api-key",
            "name": "Sao chép API key",
            "text": "Nhấp vào nút sao chép trong cột Key và lưu key trong biến môi trường phía máy chủ hoặc tệp .env cục bộ."
          },
          {
            "@type": "HowToStep",
            "name": "Đặt base URL",
            "text": "Sử dụng https://api.cometapi.com/v1 làm base URL cho các SDK tương thích OpenAI và các lệnh gọi API."
          },
          {
            "@type": "HowToStep",
            "name": "Thực hiện lệnh gọi đầu tiên",
            "text": "Gọi /v1/chat/completions bằng curl, Python hoặc Node.js, và thay your-model-id bằng model ID hiện tại từ trang Models của CometAPI."
          }
        ]
      },
      {
        "@type": "FAQPage",
        "mainEntity": [
          {
            "@type": "Question",
            "name": "Làm thế nào để tạo tài khoản CometAPI?",
            "acceptedAnswer": {
              "@type": "Answer",
              "text": "Mở trang đăng nhập CometAPI và tiếp tục với Google, GitHub hoặc email. Nếu bạn chưa có tài khoản, hãy hoàn tất việc tạo tài khoản ngay trên cùng trang đó."
            }
          },
          {
            "@type": "Question",
            "name": "Làm thế nào để lấy API key của CometAPI?",
            "acceptedAnswer": {
              "@type": "Answer",
              "text": "Mở trang API key trong dashboard CometAPI, nhấp vào Create API Key, nhập tên, nhấp Create và sao chép API key đã được tạo."
            }
          },
          {
            "@type": "Question",
            "name": "Tôi nên lưu API key ở đâu?",
            "acceptedAnswer": {
              "@type": "Answer",
              "text": "Lưu API key của bạn trong biến môi trường phía máy chủ hoặc tệp .env cục bộ. Không commit nó vào kho lưu trữ công khai, không dán vào mã frontend, không đưa vào ảnh chụp màn hình, và không gửi trong phiếu hỗ trợ."
            }
          },
          {
            "@type": "Question",
            "name": "Base URL của CometAPI cho các lệnh gọi API là gì?",
            "acceptedAnswer": {
              "@type": "Answer",
              "text": "Sử dụng https://api.cometapi.com/v1 cho các SDK và endpoint tương thích OpenAI."
            }
          },
          {
            "@type": "Question",
            "name": "CometAPI có hoạt động với OpenAI Python SDK không?",
            "acceptedAnswer": {
              "@type": "Answer",
              "text": "Có. Tạo một client OpenAI, đặt api_key thành API key CometAPI của bạn, và đặt base_url thành https://api.cometapi.com/v1."
            }
          },
          {
            "@type": "Question",
            "name": "Làm thế nào để chuyển từ OpenAI sang CometAPI?",
            "acceptedAnswer": {
              "@type": "Answer",
              "text": "Thay đổi base URL thành https://api.cometapi.com/v1, thay API key bằng API key CometAPI của bạn, và dùng model ID CometAPI từ trang Models."
            }
          },
          {
            "@type": "Question",
            "name": "Tôi nên dùng model ID nào trước?",
            "acceptedAnswer": {
              "@type": "Answer",
              "text": "Chọn model ID theo trường hợp sử dụng. Bắt đầu từ trang Models, sau đó chọn model chat, coding, image hoặc video phù hợp với trang API mà bạn dự định gọi."
            }
          },
          {
            "@type": "Question",
            "name": "CometAPI hỗ trợ những ngôn ngữ lập trình nào?",
            "acceptedAnswer": {
              "@type": "Answer",
              "text": "CometAPI hoạt động với mọi ngôn ngữ lập trình có thể gửi yêu cầu HTTPS. Hãy bắt đầu với các ví dụ curl, Python và Node.js, hoặc dùng SDK tương thích OpenAI cho phép bạn ghi đè base URL."
            }
          },
          {
            "@type": "Question",
            "name": "CometAPI có cung cấp bản dùng thử miễn phí hoặc API key miễn phí không?",
            "acceptedAnswer": {
              "@type": "Answer",
              "text": "Bạn có thể tạo API key CometAPI từ dashboard. Để kiểm tra khả năng sử dụng bản dùng thử miễn phí, số credit dùng thử miễn phí và chi tiết thanh toán, hãy xem trang giá CometAPI và trang Giới thiệu về giá."
            }
          }
        ]
      }
    ]
    }
    `}
</script>