> For the complete documentation index, see [llms.txt](https://docs.avis.net/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.avis.net/vi/huong-dan/get-started/avis-api-key.md).

# Cách lấy API Key

API key là thông tin xác thực để code của bạn gửi request đến Avis API và truy cập hơn 300 mô hình. Bạn có thể tạo, đặt giới hạn chi tiêu và thu hồi key ngay trong hồ sơ; mọi key đều tính phí vào số dư credit Avis của bạn.

**Cảnh báo:** Hãy coi API key như mật khẩu. Key cho phép chi tiêu từ số dư tài khoản trong phạm vi giới hạn bạn đặt. Không bao giờ commit key vào repository công khai, chia sẻ trong ảnh chụp màn hình hoặc đưa vào code phía client.

***

## Tạo API Key

**Bước 1:** Truy cập [avis.net/profile/api-keys](https://www.avis.net/profile/api-keys), hoặc mở [hồ sơ của bạn](https://www.avis.net/profile/) và chọn **API Keys**.

**Bước 2:** Nhấn **Create New API Keys**.

<figure><img src="https://1381001042-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBqtOszkBUadA4v68IeIc%2Fuploads%2Fgit-blob-0fc5203216cc8c9d2dede58b4bb717e14a100182%2Fimg1.png?alt=media" alt=""><figcaption></figcaption></figure>

**Bước 3:** Thiết lập các thông số của key:

* **Name:** tên để bạn dễ nhận biết key sau này (dưới 50 ký tự).
* **Spend limit daily:** mức chi tiêu tối đa của key trong một ngày.
* **Spend limit weekly:** mức tối đa trong một tuần (tính cuốn chiếu).
* **Spend limit monthly:** mức tối đa trong một tháng (tính cuốn chiếu).
* **Spend limit total:** mức trần trọn đời cho key này.

<figure><img src="https://1381001042-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBqtOszkBUadA4v68IeIc%2Fuploads%2Fgit-blob-744755a1d57a82bb7d8726c68143004e1a26364b%2Fimg2.png?alt=media" alt=""><figcaption></figcaption></figure>

**Bước 4:** Khi hoàn tất, nhấn **Confirm**.

**Bước 5:** Sao chép API key, sau đó nhấn **Done**.

<figure><img src="https://1381001042-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBqtOszkBUadA4v68IeIc%2Fuploads%2Fgit-blob-d60cf677c3b576df938bf5997770009e8c67c489%2Fimg3.png?alt=media" alt=""><figcaption></figcaption></figure>

**Bảo vệ key của bạn**

* Hãy coi key như mật khẩu. Không bao giờ commit vào repo, đưa vào code phía client hoặc chia sẻ qua ảnh chụp màn hình hay đoạn chat.
* Lưu key trong trình quản lý bí mật (secrets manager) hoặc biến môi trường, không lưu dạng văn bản thuần.
* Đặt giới hạn chi tiêu cho mọi key để nếu bị lộ cũng không phát sinh chi phí vô hạn.
* Dùng key riêng cho từng ứng dụng hoặc môi trường. Điều đó giới hạn phạm vi ảnh hưởng: nếu một key bị lộ, bạn chỉ cần thu hồi key đó mà không làm hỏng các tích hợp khác.

**Nếu key bị lộ**, hãy thu hồi ngay, sau đó tạo key thay thế và cập nhật các ứng dụng bị ảnh hưởng. Đừng chờ xác nhận có bị lạm dụng hay không — key đã thu hồi không thể bị lạm dụng, và chi phí thay key thấp hơn nhiều so với thiệt hại khi để key bị lộ tiếp tục hoạt động.

***

## Quản lý API Key

Sau khi tạo, bạn có thể quản lý key bất cứ lúc nào từ cùng trang **API Keys**:

* **Copy** API key thêm một lần — *(chỉ khi nền tảng vẫn hiển thị; thông thường key đầy đủ chỉ hiện một lần khi tạo).*
* **Edit** key — cập nhật tên hoặc giới hạn chi tiêu.
* **Delete** key — thu hồi vĩnh viễn.

<figure><img src="https://1381001042-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBqtOszkBUadA4v68IeIc%2Fuploads%2Fgit-blob-5cd0d537a37ad05efc0f5b4b5f8cd8d84e61673c%2Fimg4.png?alt=media" alt=""><figcaption></figcaption></figure>

**Lưu ý:** Việc xóa key có hiệu lực ngay lập tức và không thể hoàn tác. Mọi ứng dụng vẫn đang dùng key đó sẽ ngừng hoạt động, vì vậy hãy cập nhật key mới cho ứng dụng trước khi xóa key cũ.

***

## Tiếp theo

* Đảm bảo bạn có credit để sử dụng, xem [Cách nạp tiền vào số dư](/vi/huong-dan/get-started/avis-topup.md).
* Mới dùng Avis? Bắt đầu với [Cách đăng nhập/ đăng ký](/vi/huong-dan/get-started/avis-login-signup.md).

***

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

### Avis API key dùng để làm gì?

Key dùng để xác thực request của bạn tới Avis API, cho phép ứng dụng truy cập hơn 300 mô hình của Avis để tạo video, hình ảnh, âm thanh và văn bản bằng code. Mọi request thực hiện bằng key đều được tính phí vào số dư credit của bạn.

### Tôi có thể xem lại key sau khi tạo không?

Key đầy đủ chỉ hiển thị một lần khi tạo, vì vậy hãy sao chép và lưu trữ an toàn ngay lúc đó. Nếu làm mất, hãy tạo key mới và xóa key cũ.

### Giới hạn chi tiêu hoạt động như thế nào?

Mỗi giới hạn quy định mức tối đa một key có thể chi tiêu trong khoảng thời gian tương ứng — ngày, tuần, tháng hoặc tổng cộng. Đây là biện pháp bảo vệ trước việc sử dụng mất kiểm soát hoặc key bị lộ; request sẽ bị từ chối khi chạm giới hạn.

### Điều gì xảy ra khi tôi xóa một key?

Key bị thu hồi ngay lập tức và vĩnh viễn. Mọi ứng dụng đang dùng key sẽ ngừng hoạt động, vì vậy hãy thay key mới trước.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.avis.net/vi/huong-dan/get-started/avis-api-key.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
