# HfApi Client

Dưới đây là tài liệu cho lớp `HfApi`, đóng vai trò là lớp bọc Python cho API của Hugging Face Hub.

Tất cả các phương thức từ `HfApi` cũng có thể được truy cập trực tiếp từ gốc của gói. Cả hai cách tiếp cận đều được mô tả chi tiết bên dưới.

Việc sử dụng phương pháp root đơn giản hơn nhưng lớp [HfApi](/docs/huggingface_hub/v2.4.0/vi/package_reference/hf_api#huggingface_hub.HfApi) mang lại cho bạn nhiều sự linh hoạt hơn. Cụ thể, bạn có thể truyền một token sẽ được tái sử dụng trong tất cả các cuộc gọi HTTP. Điều này khác với `hf auth login` hoặc [login()](/docs/huggingface_hub/v2.4.0/vi/package_reference/authentication#huggingface_hub.login) vì token không được lưu trữ trên máy. Bạn cũng có thể cung cấp một endpoint khác hoặc cấu hình user-agent tùy chỉnh.

```python
from huggingface_hub import HfApi, list_models

# Use root method
models = list_models()

# Or configure a HfApi client
hf_api = HfApi(
    endpoint="https://huggingface.co", # Can be a Private Hub endpoint.
    token="hf_xxx", # Token is not persisted on the machine.
)
models = hf_api.list_models()
```

## HfApi[[huggingface_hub.HfApi]]

#### huggingface_hub.HfApi[[huggingface_hub.HfApi]]

```python
huggingface_hub.HfApi(endpoint: str | None = None, token: str | bool | None = None, library_name: str | None = None, library_version: str | None = None, user_agent: dict | str | None = None, headers: dict[str, str] | None = None)
```

[Nguồn](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L2127)

**Tham số:**

endpoint (`str`, *tùy chọn*) : Điểm cuối của Hub. Mặc định là .

token (`bool` hoặc `str`, *tùy chọn*) : Một token truy cập người dùng hợp lệ (chuỗi). Mặc định là token được lưu cục bộ, đây là phương pháp xác thực được khuyến nghị (xem https://huggingface.co/docs/huggingface_hub/quick-start#authentication). Để tắt xác thực, truyền `False`.

library_name (`str`, *tùy chọn*) : Tên của thư viện đang thực hiện yêu cầu HTTP. Sẽ được thêm vào tiêu đề user-agent. Ví dụ: `"transformers"`.

library_version (`str`, *tùy chọn*) : Phiên bản của thư viện đang thực hiện yêu cầu HTTP. Sẽ được thêm vào tiêu đề user-agent. Ví dụ: `"4.24.0"`.

user_agent (`str`, `dict`, *tùy chọn*) : Thông tin user agent dưới dạng một từ điển hoặc một chuỗi duy nhất. Nó sẽ được bổ sung thông tin về các gói đã cài đặt.

headers (`dict`, *tùy chọn*) : Các tiêu đề bổ sung được gửi kèm theo mỗi yêu cầu. Ví dụ: `{"X-My-Header": "value"}`. Các tiêu đề được truyền ở đây có độ ưu tiên cao hơn các tiêu đề mặc định.

Client để tương tác với Hugging Face Hub qua HTTP.

Client được khởi tạo với một số cài đặt cấp cao được sử dụng trong tất cả các yêu cầu gửi đến Hub (điểm cuối HF, xác thực, user agents...). Việc sử dụng client `HfApi` được khuyến khích nhưng không bắt buộc, vì tất cả các phương thức công khai của nó đều được phơi bày trực tiếp ở gốc của `huggingface_hub`.

#### accept_access_request[[huggingface_hub.HfApi.accept_access_request]]

```python
accept_access_request(repo_id: str, user: str | None = None, request_id: str | None = None, repo_type: str | None = None, token: bool | str | None = None)
```

[Nguồn](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L10873)

**Tham số:**

repo_id (`str`) : id của repo để chấp nhận yêu cầu cấp quyền truy cập.

user (`str`, *tùy chọn*) : Tên người dùng của người dùng mà yêu cầu truy cập nên được chấp nhận. Phải cung cấp đúng một trong `user` hoặc `request_id`.

request_id (`str`, *tùy chọn*) : id của yêu cầu truy cập cần chấp nhận (xem `AccessRequest`). Bắt buộc khi repo được cấu hình để không chia sẻ tên người dùng của người yêu cầu. Phải cung cấp đúng một trong `user` hoặc `request_id`.

repo_type (`str`, *tùy chọn*) : Kiểu kho cần chấp nhận yêu cầu truy cập. Phải là một trong `model`, `dataset` hoặc `space`. Mặc định là `model`.

token (`bool` hoặc `str`, *tùy chọn*) : Một token truy cập người dùng hợp lệ (chuỗi). Mặc định là token được lưu cục bộ, đây là phương pháp xác thực được khuyến nghị (xem https://huggingface.co/docs/huggingface_hub/quick-start#authentication). Để tắt xác thực, truyền `False`.

**Gây ra:** `HfHubHTTPError`

- `HfHubHTTPError` -- HTTP 400 nếu kho không được bảo vệ.
- `HfHubHTTPError` -- HTTP 403 nếu bạn chỉ có quyền truy cập chỉ đọc vào kho. Điều này có thể xảy ra nếu bạn không có vai trò `write` hoặc `admin` trong tổ chức mà kho thuộc về, hoặc nếu bạn đã truyền một token `read`.
- `HfHubHTTPError` -- HTTP 404 nếu người dùng không tồn tại trên Hub.
- `HfHubHTTPError` -- HTTP 404 nếu không tìm thấy yêu cầu truy cập của người dùng.
- `HfHubHTTPError` -- HTTP 404 nếu yêu cầu truy cập của người dùng đã có trong danh sách được chấp nhận.

Chấp nhận yêu cầu truy cập từ một người dùng cho một kho có kiểm soát (gated repo) cụ thể.

Khi yêu cầu được chấp nhận, người dùng sẽ có thể tải xuống bất kỳ tệp nào trong repo và truy cập tab cộng đồng. Nếu chế độ phê duyệt là tự động, bạn không cần phải chấp nhận yêu cầu thủ công. Một yêu cầu đã được chấp nhận có thể bị hủy hoặc từ chối vào bất kỳ lúc nào bằng cách sử dụng [cancel_access_request()](/docs/huggingface_hub/v2.4.0/vi/package_reference/hf_api#huggingface_hub.HfApi.cancel_access_request) và [reject_access_request()](/docs/huggingface_hub/v2.4.0/vi/package_reference/hf_api#huggingface_hub.HfApi.reject_access_request).

Để biết thêm thông tin về các kho lưu trữ có kiểm soát, hãy xem https://huggingface.co/docs/hub/models-gated.

#### add_collection_item[[huggingface_hub.HfApi.add_collection_item]]

```python
add_collection_item(collection_slug: str, item_id: str, item_type: CollectionItemType_T, note: str | None = None, exists_ok: bool = False, token: bool | str | None = None)
```

[Nguồn](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L10411)

**Tham số:**

collection_slug (`str`) : Slug của bộ sưu tập cần cập nhật. Ví dụ: `"TheBloke/recent-models-64f9a55bb3115b4f513ec026"`.

item_id (`str`) : Id của mục cần thêm vào bộ sưu tập. Sử dụng repo_id cho repos/spaces/datasets, paper id cho papers, slug của một bộ sưu tập khác (ví dụ: `"moonshotai/kimi-k2"`) hoặc bucket id (ví dụ: `"namespace/bucket-name"`).

item_type (`str`) : Kiểu của mục cần thêm. Có thể là một trong `"model"`, `"dataset"`, `"space"`, `"paper"`, `"collection"` hoặc `"bucket"`.

note (`str`, *tùy chọn*) : Ghi chú đính kèm cho mục trong bộ sưu tập. Kích thước tối đa của một ghi chú là 500 ký tự.

exists_ok (`bool`, *tùy chọn*) : Nếu `True`, không gây ra lỗi nếu mục đã tồn tại.

token (`bool` hoặc `str`, *tùy chọn*) : Một token truy cập người dùng hợp lệ (chuỗi). Mặc định là token được lưu cục bộ, đây là phương pháp xác thực được khuyến nghị (xem https://huggingface.co/docs/huggingface_hub/quick-start#authentication). Để tắt xác thực, truyền `False`.

**Gây ra:** `HfHubHTTPError`

- `HfHubHTTPError` -- HTTP 403 nếu bạn chỉ có quyền truy cập chỉ đọc vào kho. Điều này có thể xảy ra nếu bạn không có vai trò `write` hoặc `admin` trong tổ chức mà kho thuộc về, hoặc nếu bạn đã truyền một token `read`.
- `HfHubHTTPError` -- HTTP 404 nếu mục bạn cố thêm vào bộ sưu tập không tồn tại trên Hub.
- `HfHubHTTPError` -- HTTP 409 nếu mục bạn cố thêm vào bộ sưu tập đã có trong bộ sưu tập (và exists_ok=False)

Thêm một mục vào bộ sưu tập trên Hub.

Trả về: [Collection](/docs/huggingface_hub/v2.4.0/vi/package_reference/collections#huggingface_hub.Collection)

Ví dụ:

```py
>>> from huggingface_hub import add_collection_item
>>> collection = add_collection_item(
...     collection_slug="davanstrien/climate-64f99dc2a5067f6b65531bab",
...     item_id="pierre-loic/climate-news-articles",
...     item_type="dataset"
... )
>>> collection.items[-1].item_id
"pierre-loic/climate-news-articles"
# ^item got added to the collection on last position

# Add item with a note
>>> add_collection_item(
...     collection_slug="davanstrien/climate-64f99dc2a5067f6b65531bab",
...     item_id="datasets/climate_fever",
...     item_type="dataset",
...     note="This dataset adopts the FEVER methodology that consists of 1,535 real-world claims regarding climate-change collected on the internet."
... )
(...)
```

#### add_space_secret[[huggingface_hub.HfApi.add_space_secret]]

```python
add_space_secret(repo_id: str, key: str, value: str, description: str | None = None, token: bool | str | None = None)
```

[Nguồn](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L8043)

**Tham số:**

repo_id (`str`) : ID của kho cần cập nhật. Ví dụ: `"bigcode/in-the-stack"`.

key (`str`) : Khóa bí mật. Ví dụ: `"GITHUB_API_KEY"`

value (`str`) : Giá trị bí mật. Ví dụ: `"your_github_api_key"`.

description (`str`, *tùy chọn*) : Mô tả bí mật. Ví dụ: `"Github API key to access the Github API"`.

token (`bool` hoặc `str`, *tùy chọn*) : Một token truy cập người dùng hợp lệ (chuỗi). Mặc định là token được lưu cục bộ, đây là phương pháp xác thực được khuyến nghị (xem https://huggingface.co/docs/huggingface_hub/quick-start#authentication). Để tắt xác thực, truyền `False`.

Thêm hoặc cập nhật một bí mật trong một Space.

Secrets cho phép thiết lập các khóa hoặc token bí mật cho một Space mà không cần hardcode chúng. Để biết thêm chi tiết, xem https://huggingface.co/docs/hub/spaces-overview#managing-secrets.

#### add_space_variable[[huggingface_hub.HfApi.add_space_variable]]

```python
add_space_variable(repo_id: str, key: str, value: str, description: str | None = None, token: bool | str | None = None)
```

[Nguồn](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L8169)

**Tham số:**

repo_id (`str`) : ID của kho cần cập nhật. Ví dụ: `"bigcode/in-the-stack"`.

key (`str`) : Khóa biến. Ví dụ: `"MODEL_REPO_ID"`

value (`str`) : Giá trị biến. Ví dụ: `"the_model_repo_id"`.

description (`str`) : Mô tả của biến. Ví dụ: `"Model Repo ID of the implemented model"`.

token (`bool` hoặc `str`, *tùy chọn*) : Một token truy cập người dùng hợp lệ (chuỗi). Mặc định là token được lưu cục bộ, đây là phương pháp xác thực được khuyến nghị (xem https://huggingface.co/docs/huggingface_hub/quick-start#authentication). Để tắt xác thực, truyền `False`.

Thêm hoặc cập nhật một biến trong một Space.

Biến cho phép thiết lập các biến môi trường cho một Space mà không cần hardcode chúng. Để biết thêm chi tiết, xem https://huggingface.co/docs/hub/spaces-overview#managing-secrets-and-environment-variables

#### auth_check[[huggingface_hub.HfApi.auth_check]]

```python
auth_check(repo_id: str, repo_type: str | None = None, token: bool | str | None = None, write: bool = False)
```

[Nguồn](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L12047)

**Tham số:**

repo_id (`str`) : Kho cần kiểm tra quyền truy cập. Định dạng nên là `"user/repo_name"`. Ví dụ: `"user/my-cool-model"`.

repo_type (`str`, *tùy chọn*) : Kiểu của kho. Phải là một trong `"model"`, `"dataset"` hoặc `"space"`. Nếu không được chỉ định, giá trị mặc định là `"model"`.

token (`Union[bool, str, None]`, *tùy chọn*) : Một token truy cập người dùng hợp lệ. Nếu không được cung cấp, token được lưu cục bộ sẽ được sử dụng, đây là phương thức xác thực được khuyến nghị. Đặt thành `False` để tắt xác thực. Tham khảo: https://huggingface.co/docs/huggingface_hub/quick-start#authentication.

write (`bool`, *tuỳ chọn*) : Nếu `True`, kiểm tra xem người dùng có quyền ghi nội dung trên kho lưu trữ hay không. Nếu `False` (mặc định), chỉ kiểm tra quyền đọc.

**Gây ra:** [RepositoryNotFoundError](/docs/huggingface_hub/v2.4.0/vi/package_reference/utilities#huggingface_hub.errors.RepositoryNotFoundError) hoặc [GatedRepoError](/docs/huggingface_hub/v2.4.0/vi/package_reference/utilities#huggingface_hub.errors.GatedRepoError)

- [RepositoryNotFoundError](/docs/huggingface_hub/v2.4.0/vi/package_reference/utilities#huggingface_hub.errors.RepositoryNotFoundError) --  Được ném ra nếu kho không tồn tại, là riêng tư, hoặc người dùng không có quyền truy cập. Điều này có thể xảy ra nếu `repo_id` hoặc `repo_type` không chính xác, hoặc nếu kho là riêng tư nhưng người dùng chưa xác thực.

- [GatedRepoError](/docs/huggingface_hub/v2.4.0/vi/package_reference/utilities#huggingface_hub.errors.GatedRepoError) -- Được ném ra nếu kho dữ liệu tồn tại nhưng được bảo vệ và người dùng không được cấp quyền truy cập.

Kiểm tra xem token người dùng được cung cấp có quyền truy cập vào một kho lưu trữ cụ thể trên Hugging Face Hub hay không.

Phương thức này xác minh xem người dùng, đã xác thực thông qua token được cung cấp, có quyền truy cập vào kho lưu trữ được chỉ định hay không. Nếu kho lưu trữ không được tìm thấy hoặc người dùng không có quyền hạn cần thiết để truy cập, phương thức sẽ ném ra một ngoại lệ phù hợp.

Ví dụ:

Kiểm tra xem người dùng có quyền truy cập vào kho lưu trữ hay không:

```python
>>> from huggingface_hub import auth_check
>>> from huggingface_hub.utils import GatedRepoError, RepositoryNotFoundError

try:
    auth_check("user/my-cool-model")
except GatedRepoError:
    # Handle gated repository error
    print("You do not have permission to access this gated repository.")
except RepositoryNotFoundError:
    # Handle repository not found error
    print("The repository was not found or you do not have access.")
```

Trong ví dụ này:
- Nếu người dùng có quyền truy cập, phương thức sẽ hoàn tất thành công.
- Nếu kho lưu trữ bị hạn chế hoặc không tồn tại, các ngoại lệ phù hợp sẽ được ném ra, cho phép người dùng
để xử lý chúng một cách phù hợp.

#### batch_bucket_files[[huggingface_hub.HfApi.batch_bucket_files]]

```python
batch_bucket_files(bucket_id: str, add: list[tuple[str | Path | bytes, str]] | None = None, copy: list[tuple[str, str, str, str]] | None = None, delete: list[str] | None = None, token: str | bool | None = None)
```

[Nguồn](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L14729)

**Tham số:**

bucket_id (`str`) : ID của bucket (ví dụ: `"username/my-bucket"`).

add (`list` của `tuple`, *tuỳ chọn*) : Các tệp cần tải lên. Mỗi phần tử là một tuple `(source, destination)` trong đó `source` là đường dẫn đến tệp cục bộ (`str` hoặc `Path`) hoặc nội dung `bytes` thô, và `destination` là đường dẫn trong bucket.

copy (`list` của `tuple`, *optional*) : Các tệp để sao chép theo xet hash. Mỗi phần tử là một tuple `(source_repo_type, source_repo_id, xet_hash, destination)` trong đó: - `source_repo_type` là kiểu của kho lưu trữ nguồn: `"model"`, `"dataset"`, `"space"` hoặc `"bucket"`. - `source_repo_id` là ID của kho lưu trữ hoặc bucket nguồn (ví dụ: `"username/my-model"`). - `xet_hash` là xet hash của tệp cần sao chép. - `destination` là đường dẫn đích trong bucket. Đây là thao tác phía máy chủ — không có dữ liệu nào được tải xuống hoặc tải lên lại.

delete (`list` của `str`, *tuỳ chọn*) : Đường dẫn của các tệp cần xoá khỏi bucket.

token (`bool` hoặc `str`, *tùy chọn*) : Một token truy cập người dùng hợp lệ (chuỗi). Mặc định là token được lưu cục bộ, đây là phương pháp xác thực được khuyến nghị (xem https://huggingface.co/docs/huggingface_hub/quick-start#authentication). Để tắt xác thực, truyền `False`.

**Gây ra:** `BucketBatchError`

- `BucketBatchError` -- Nếu máy chủ báo rằng một số thao tác đã thất bại. Lỗi được ném ra sau khi mọi thao tác đã được gửi, do đó các thao tác khác trong lô đã được áp dụng.

Thêm, sao chép và/hoặc xóa các tệp trong một bucket.

Đây là một thao tác phi giao dịch. Nếu xảy ra lỗi trong quá trình, một số tệp có thể đã được tải lên, sao chép hoặc xóa trong khi các tệp khác thì chưa.

Ví dụ:
```python
>>> from huggingface_hub import batch_bucket_files

# Upload files
>>> batch_bucket_files(
...     "username/my-bucket",
...     add=[
...         ("./model.safetensors", "models/model.safetensors"),
...         (b'{{"key": "value"}}', "config.json"),
...     ],
... )

# Copy xet files from another bucket or repo (server-side, no data transfer)
>>> batch_bucket_files(
...     "username/my-bucket",
...     copy=[
...         ("bucket", "username/source-bucket", "<xethash_1>", "models/model.safetensors"),
...         ("model", "username/my-model", "<xethash_2>", "models/config.safetensors"),
...     ],
... )

# Delete files
>>> batch_bucket_files("username/my-bucket", delete=["old-model.bin"])

# Upload and delete in one batch
>>> batch_bucket_files(
...     "username/my-bucket",
...     add=[("./new.txt", "new.txt")],
...     delete=["old.txt"],
... )
```

#### bucket_info[[huggingface_hub.HfApi.bucket_info]]

```python
bucket_info(bucket_id: str, token: bool | str | None = None)
```

[Nguồn](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L14058)

**Tham số:**

bucket_id (`str`) : ID của bucket (ví dụ: `"username/my-bucket"`).

token (`bool` hoặc `str`, *tùy chọn*) : Một token truy cập người dùng hợp lệ (chuỗi). Mặc định là token được lưu cục bộ, đây là phương pháp xác thực được khuyến nghị (xem https://huggingface.co/docs/huggingface_hub/quick-start#authentication). Để tắt xác thực, truyền `False`.

**Trả về:** [BucketInfo](/docs/huggingface_hub/v2.4.0/vi/package_reference/hf_api#huggingface_hub.BucketInfo)

Thông tin về bucket.

**Lỗi:** `BucketNotFoundError` hoặc ``or``

- `BucketNotFoundError` -- Nếu không tìm thấy bucket. Điều này có thể là do bucket không tồn tại,
- ``or`` -- vì nó được đặt ở chế độ `private` và bạn không có quyền truy cập.

Lấy thông tin về một bucket cụ thể trên Hub.

Ví dụ:
```python
>>> from huggingface_hub import bucket_info
>>> info = bucket_info(bucket_id="Wauplin/first-bucket")
>>> info.id
'Wauplin/first-bucket'
>>> info.private
False
>>> info.created_at
datetime.datetime(2026, 2, 6, 17, 37, 57, tzinfo=datetime.timezone.utc)
>>> info.size
551879671
>>> info.total_files
12
```

#### cancel_access_request[[huggingface_hub.HfApi.cancel_access_request]]

```python
cancel_access_request(repo_id: str, user: str | None = None, request_id: str | None = None, repo_type: str | None = None, token: bool | str | None = None)
```

[Nguồn](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L10823)

**Tham số:**

repo_id (`str`) : id của repo để hủy yêu cầu cấp quyền truy cập.

user (`str`, *tùy chọn*) : Tên người dùng của người dùng mà yêu cầu truy cập cần được hủy bỏ. Phải cung cấp đúng một trong `user` hoặc `request_id`.

request_id (`str`, *tùy chọn*) : id của yêu cầu truy cập cần hủy (xem `AccessRequest`). Bắt buộc khi repo được cấu hình để không chia sẻ tên người dùng của người yêu cầu. Phải cung cấp đúng một trong `user` hoặc `request_id`.

repo_type (`str`, *tùy chọn*) : Kiểu của kho cần hủy yêu cầu truy cập. Phải là một trong `model`, `dataset` hoặc `space`. Mặc định là `model`.

token (`bool` hoặc `str`, *tùy chọn*) : Một token truy cập người dùng hợp lệ (chuỗi). Mặc định là token được lưu cục bộ, đây là phương pháp xác thực được khuyến nghị (xem https://huggingface.co/docs/huggingface_hub/quick-start#authentication). Để tắt xác thực, truyền `False`.

**Gây ra:** `HfHubHTTPError`

- `HfHubHTTPError` -- HTTP 400 nếu kho không được bảo vệ.
- `HfHubHTTPError` -- HTTP 403 nếu bạn chỉ có quyền truy cập chỉ đọc vào kho. Điều này có thể xảy ra nếu bạn không có vai trò `write` hoặc `admin` trong tổ chức mà kho thuộc về, hoặc nếu bạn đã truyền một token `read`.
- `HfHubHTTPError` -- HTTP 404 nếu người dùng không tồn tại trên Hub.
- `HfHubHTTPError` -- HTTP 404 nếu không tìm thấy yêu cầu truy cập của người dùng.
- `HfHubHTTPError` -- HTTP 404 nếu yêu cầu truy cập của người dùng đã có trong danh sách chờ.

Hủy yêu cầu truy cập từ một người dùng đối với một kho có kiểm soát (gated repo) cụ thể.

Một yêu cầu đã bị hủy sẽ quay lại danh sách chờ và người dùng sẽ mất quyền truy cập vào kho.

Để biết thêm thông tin về các kho lưu trữ có kiểm soát, hãy xem https://huggingface.co/docs/hub/models-gated.

#### cancel_job[[huggingface_hub.HfApi.cancel_job]]

```python
cancel_job(job_id: str, namespace: str | None = None, token: bool | str | None = None)
```

[Nguồn](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L12757)

**Tham số:**

job_id (`str`) : ID của Job.

namespace (`str`, *tùy chọn*) : Không gian tên nơi Job đang chạy. Mặc định là không gian tên của người dùng hiện tại.

token (`bool` hoặc `str`, *tùy chọn*) : Một token truy cập người dùng hợp lệ. Nếu không được cung cấp, token được lưu cục bộ sẽ được sử dụng, đây là phương thức xác thực được khuyến nghị. Đặt thành `False` để tắt xác thực. Tham khảo: https://huggingface.co/docs/huggingface_hub/quick-start#authentication.

Hủy một Job tính toán trên hạ tầng của Hugging Face.

#### change_discussion_status[[huggingface_hub.HfApi.change_discussion_status]]

```python
change_discussion_status(repo_id: str, discussion_num: int, new_status: Literal['open', 'closed'], token: bool | str | None = None, comment: str | None = None, repo_type: str | None = None)
```

[Nguồn](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L7756)

**Tham số:**

repo_id (`str`) : Một namespace (người dùng hoặc tổ chức) và tên kho, được phân tách bằng `/`.

discussion_num (`int`) : Số thứ tự của Discussion hoặc Pull Request. Phải là một số nguyên dương.

new_status (`str`) : Trạng thái mới cho cuộc thảo luận, là `"open"` hoặc `"closed"`.

comment (`str`, *tùy chọn*) : Một bình luận tùy chọn để đăng kèm theo việc thay đổi trạng thái.

repo_type (`str`, *tùy chọn*) : Đặt thành `"dataset"` hoặc `"space"` nếu tải lên một dataset hoặc space, `None` hoặc `"model"` nếu tải lên một model. Mặc định là `None`.

token (`bool` hoặc `str`, *tùy chọn*) : Một token truy cập người dùng hợp lệ (chuỗi). Mặc định là token được lưu cục bộ, đây là phương pháp xác thực được khuyến nghị (xem https://huggingface.co/docs/huggingface_hub/quick-start#authentication). Để tắt xác thực, truyền `False`.

**Trả về:** [DiscussionStatusChange](/docs/huggingface_hub/v2.4.0/vi/package_reference/community#huggingface_hub.DiscussionStatusChange)

sự kiện thay đổi trạng thái

Đóng hoặc mở lại một Discussion hoặc Pull Request.

Ví dụ:
```python
>>> HfApi().change_discussion_status(
...     repo_id="username/repo_name",
...     discussion_num=34,
...     new_status="closed"
... )
# DiscussionStatusChange(id='deadbeef0000000', type='status-change', ...)

```

> [!TIP]
> Gây ra các lỗi sau:
>
> - [`HTTPError`](https://requests.readthedocs.io/en/latest/api/#requests.HTTPError) nếu API HuggingFace trả về lỗi - [`ValueError`](https://docs.python.org/3/library/exceptions.html#ValueError) nếu giá trị của một số tham số không hợp lệ - [RepositoryNotFoundError](/docs/huggingface_hub/v2.4.0/vi/package_reference/utilities#huggingface_hub.errors.RepositoryNotFoundError) Nếu không tìm thấy kho cần tải xuống. Điều này có thể do kho không tồn tại, hoặc do kho được đặt ở chế độ `private` và bạn không có quyền truy cập.

#### comment_discussion[[huggingface_hub.HfApi.comment_discussion]]

```python
comment_discussion(repo_id: str, discussion_num: int, comment: str, token: bool | str | None = None, repo_type: str | None = None)
```

[Nguồn](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L7613)

**Tham số:**

repo_id (`str`) : Một namespace (người dùng hoặc tổ chức) và tên kho, được phân tách bằng `/`.

discussion_num (`int`) : Số thứ tự của Discussion hoặc Pull Request. Phải là một số nguyên dương.

comment (`str`) : Nội dung của bình luận cần tạo. Bình luận hỗ trợ định dạng markdown.

repo_type (`str`, *tùy chọn*) : Đặt thành `"dataset"` hoặc `"space"` nếu tải lên một dataset hoặc space, `None` hoặc `"model"` nếu tải lên một model. Mặc định là `None`.

token (`bool` hoặc `str`, *tùy chọn*) : Một token truy cập người dùng hợp lệ (chuỗi). Mặc định là token được lưu cục bộ, đây là phương pháp xác thực được khuyến nghị (xem https://huggingface.co/docs/huggingface_hub/quick-start#authentication). Để tắt xác thực, truyền `False`.

**Trả về:** [DiscussionComment](/docs/huggingface_hub/v2.4.0/vi/package_reference/community#huggingface_hub.DiscussionComment)

bình luận vừa được tạo

Tạo một bình luận mới trên Discussion được chỉ định.

Ví dụ:
```python

>>> comment = """
... Hello @otheruser!
...
... # This is a title
...
... **This is bold**, *this is italic* and ~this is strikethrough~
... And [this](http://url) is a link
... """

>>> HfApi().comment_discussion(
...     repo_id="username/repo_name",
...     discussion_num=34,
...     comment=comment
... )
# DiscussionComment(id='deadbeef0000000', type='comment', ...)

```

> [!TIP]
> Gây ra các lỗi sau:
>
> - [`HTTPError`](https://requests.readthedocs.io/en/latest/api/#requests.HTTPError) nếu API HuggingFace trả về lỗi - [`ValueError`](https://docs.python.org/3/library/exceptions.html#ValueError) nếu giá trị của một số tham số không hợp lệ - [RepositoryNotFoundError](/docs/huggingface_hub/v2.4.0/vi/package_reference/utilities#huggingface_hub.errors.RepositoryNotFoundError) Nếu không tìm thấy kho cần tải xuống. Điều này có thể do kho không tồn tại, hoặc do kho được đặt ở chế độ `private` và bạn không có quyền truy cập.

#### copy_files[[huggingface_hub.HfApi.copy_files]]

```python
copy_files(source: str, destination: str, token: str | bool | None = None)
```

[Nguồn](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L14410)

**Tham số:**

source (`str`) : Vị trí nguồn dưới dạng URI `hf://`. Có thể là đường dẫn bucket (ví dụ: `"hf://buckets/my-bucket/path/to/file"`) hoặc đường dẫn repo (ví dụ: `"hf://username/my-model/weights.bin"`, `"hf://datasets/username/my-dataset/data/"`).

destination (`str`) : Vị trí đích dưới dạng URI `hf://` trỏ đến một bucket (ví dụ: `"hf://buckets/my-bucket/target/path"`) hoặc một kho (ví dụ: `"hf://username/my-model/target/path"`).

token (`bool` hoặc `str`, *tùy chọn*) : Một token truy cập người dùng hợp lệ (chuỗi). Mặc định là token được lưu cục bộ, đây là phương pháp xác thực được khuyến nghị (xem https://huggingface.co/docs/huggingface_hub/quick-start#authentication). Để tắt xác thực, truyền `False`.

**Lỗi:** ``ValueError``

- [`ValueError`](https://docs.python.org/3/library/exceptions.html#ValueError) -- Nếu URI nguồn/đích không hợp lệ hoặc nếu sao chép từ một bucket sang một repo.

Sao chép tệp giữa các vị trí trên Hub.

Sao chép tệp từ một bucket hoặc kho (mô hình, tập dữ liệu, space) sang một bucket hoặc kho khác. Hỗ trợ cả tệp riêng lẻ và toàn bộ thư mục.

Khi sao chép thư mục, việc thêm `/` ở cuối đường dẫn nguồn sử dụng ngữ nghĩa kiểu rsync: sao chép *nội dung* của thư mục vào đích, không lồng chính thư mục nguồn bên trong. Nếu không có `/` ở cuối, thư mục nguồn sẽ được lồng bên trong thư mục đích (giống như `cp -r`).

Khi sao chép từ một kho lưu trữ sang một bucket, các tệp `.gitattributes` sẽ được tự động loại trừ vì chúng là metadata đặc thù của git và không liên quan trong ngữ cảnh bucket.

Sao chép từ repo sang repo sử dụng [CommitOperationCopy](/docs/huggingface_hub/v2.4.0/vi/package_reference/hf_api#huggingface_hub.CommitOperationCopy) bên trong và tạo một commit trên kho đích. Sao chép từ bucket sang repo không được hỗ trợ.

> [!WARNING]
> Các bản sao phía máy chủ chỉ hoạt động trong cùng một [khu vực lưu trữ](https://huggingface.co/docs/hub/storage-regions).

Ví dụ:
```python
>>> from huggingface_hub import copy_files

# Copy a single file between buckets
>>> copy_files("hf://buckets/my-bucket/data.bin", "hf://buckets/other-bucket/data.bin")

# Copy a folder into another bucket (nests: backup/models/...)
>>> copy_files("hf://buckets/my-bucket/models", "hf://buckets/other-bucket/backup/")

# Copy folder contents (trailing /): files go directly into backup/
>>> copy_files("hf://buckets/my-bucket/models/", "hf://buckets/other-bucket/backup/")

# Copy a file from a model repo to a bucket
>>> copy_files("hf://username/my-model/model.safetensors", "hf://buckets/my-bucket/")

# Copy an entire dataset to a bucket
>>> copy_files("hf://datasets/username/my-dataset/", "hf://buckets/my-bucket/datasets/")

# Copy files between repositories
>>> copy_files("hf://username/source-model/", "hf://username/dest-model/")

# Copy a file from one repo to another
>>> copy_files("hf://username/source-model/config.json", "hf://username/dest-model/config.json")
```

#### create_branch[[huggingface_hub.HfApi.create_branch]]

```python
create_branch(repo_id: str, branch: str, revision: str | None = None, token: bool | str | None = None, repo_type: str | None = None, exist_ok: bool = False)
```

[Nguồn](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L6963)

**Tham số:**

repo_id (`str`) : Kho lưu trữ mà nhánh sẽ được tạo. Ví dụ: `"user/my-cool-model"`.

branch (`str`) : Tên của nhánh cần tạo.

revision (`str`, *tùy chọn*) : Bản sửa git để tạo nhánh từ đó. Nó có thể là tên nhánh hoặc OID/SHA của một commit, dưới dạng chuỗi hex. Mặc định là đầu của nhánh `"main"`.

token (`bool` hoặc `str`, *tùy chọn*) : Một token truy cập người dùng hợp lệ (chuỗi). Mặc định là token được lưu cục bộ, đây là phương pháp xác thực được khuyến nghị (xem https://huggingface.co/docs/huggingface_hub/quick-start#authentication). Để tắt xác thực, truyền `False`.

repo_type (`str`, *tùy chọn*) : Đặt thành `"dataset"` hoặc `"space"` nếu tạo nhánh trên một dataset hoặc space, `None` hoặc `"model"` nếu gắn thẻ cho một model. Mặc định là `None`.

exist_ok (`bool`, *tùy chọn*, mặc định là `False`) : Nếu `True`, không gây ra lỗi nếu nhánh đã tồn tại.

**Gây ra:** [RepositoryNotFoundError](/docs/huggingface_hub/v2.4.0/vi/package_reference/utilities#huggingface_hub.errors.RepositoryNotFoundError) hoặc [BadRequestError](/docs/huggingface_hub/v2.4.0/vi/package_reference/utilities#huggingface_hub.errors.BadRequestError) hoặc [HfHubHTTPError](/docs/huggingface_hub/v2.4.0/vi/package_reference/utilities#huggingface_hub.errors.HfHubHTTPError)

- [RepositoryNotFoundError](/docs/huggingface_hub/v2.4.0/vi/package_reference/utilities#huggingface_hub.errors.RepositoryNotFoundError) -- Nếu không tìm thấy kho (lỗi 404): repo_id/repo_type không đúng, kho là riêng tư nhưng chưa xác thực hoặc kho không tồn tại.
- [BadRequestError](/docs/huggingface_hub/v2.4.0/vi/package_reference/utilities#huggingface_hub.errors.BadRequestError) -- Nếu tham chiếu không hợp lệ cho một nhánh. Ví dụ: `refs/pr/5` hoặc 'refs/foo/bar'.
- [HfHubHTTPError](/docs/huggingface_hub/v2.4.0/vi/package_reference/utilities#huggingface_hub.errors.HfHubHTTPError) -- Nếu nhánh đã tồn tại trên kho (lỗi 409) và `exist_ok` được đặt thành `False`.

Tạo một nhánh mới cho một kho trên Hub, bắt đầu từ bản sửa đổi được chỉ định (mặc định là `main`). Để tìm một bản sửa đổi phù hợp với nhu cầu của bạn, bạn có thể sử dụng [list_repo_refs()](/docs/huggingface_hub/v2.4.0/vi/package_reference/hf_api#huggingface_hub.HfApi.list_repo_refs) hoặc [list_repo_commits()](/docs/huggingface_hub/v2.4.0/vi/package_reference/hf_api#huggingface_hub.HfApi.list_repo_commits).

#### create_bucket[[huggingface_hub.HfApi.create_bucket]]

```python
create_bucket(bucket_id: str, private: bool | None = None, visibility: Literal['public', 'private'] | None = None, resource_group_id: str | None = None, region: REPO_REGIONS | None = None, exist_ok: bool = False, token: bool | str | None = None)
```

[Nguồn](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L13950)

**Tham số:**

bucket_id (`str`) : Một namespace (người dùng hoặc tổ chức) và tên bucket được phân tách bằng `/`. Nếu không cung cấp namespace, bucket sẽ được tạo trong namespace của người dùng hiện tại.

private (`bool`, *tùy chọn*) : Xác định có làm cho bucket riêng tư hay không. Nếu là `None` (mặc định), bucket sẽ là công khai trừ khi mặc định của tổ chức là riêng tư. Không thể truyền cùng với `visibility`.

visibility (`Literal["public", "private"]`, *tùy chọn*) : Tính khả kiến của bucket. Có thể là `"public"` hoặc `"private"`. Nếu là `None` (mặc định), bucket sẽ là public trừ khi mặc định của tổ chức là private.

resource_group_id (`str`, *tùy chọn*) : Nhóm tài nguyên để tạo bucket. Nhóm tài nguyên chỉ khả dụng cho các tổ chức Enterprise Hub và cho phép xác định thành viên nào trong tổ chức có thể truy cập tài nguyên. ID của nhóm tài nguyên có thể tìm thấy trong URL của trang tài nguyên trên Hub (ví dụ: `"66670e5163145ca562cb1988"`). Để tìm hiểu thêm về nhóm tài nguyên, xem https://huggingface.co/docs/hub/en/security-resource-groups.

region (`Literal["us", "eu"]`, *tùy chọn*) : Vùng cloud để tạo bucket. Có thể là `"us"` hoặc `"eu"`. Nếu không được chỉ định, bucket sẽ được tạo trong vùng mặc định. Yêu cầu gói Team hoặc cao hơn.

exist_ok (`bool`, *tùy chọn*, mặc định là `False`) : Nếu `True`, sẽ không gây ra lỗi nếu bucket đã tồn tại.

token (`bool` hoặc `str`, *tùy chọn*) : Một token truy cập người dùng hợp lệ (chuỗi). Mặc định là token được lưu cục bộ, đây là phương pháp xác thực được khuyến nghị (xem https://huggingface.co/docs/huggingface_hub/quick-start#authentication). Để tắt xác thực, truyền `False`.

**Trả về:** [BucketUrl](/docs/huggingface_hub/v2.4.0/vi/package_reference/hf_api#huggingface_hub.BucketUrl)

URL của bucket mới được tạo, chứa các thuộc tính như `endpoint`, `namespace` và `bucket_id`.

Tạo một bucket trên Hub.

Ví dụ:
```python
>>> from huggingface_hub import create_bucket

>>> url = create_bucket(bucket_id="my-bucket")
>>> url.bucket_id
'user/my-bucket'
>>> url.url
'https://huggingface.co/buckets/user/my-bucket'
>>> url.uri.to_uri()
'hf://buckets/user/my-bucket'

>>> create_bucket(bucket_id="my-bucket", private=True, exist_ok=True)
BucketUrl(...)

>>> create_bucket(bucket_id="my-bucket", region="us")
BucketUrl(...)
```

#### create_collection[[huggingface_hub.HfApi.create_collection]]

```python
create_collection(title: str, namespace: str | None = None, description: str | None = None, private: bool = False, resource_group_id: str | None = None, exists_ok: bool = False, token: bool | str | None = None)
```

[Nguồn](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L10191)

**Tham số:**

title (`str`) : Tiêu đề của bộ sưu tập cần tạo. Ví dụ: `"Recent models"`.

namespace (`str`, *tùy chọn*) : Namespace của bộ sưu tập cần tạo (tên người dùng hoặc tổ chức). Mặc định sẽ là tên chủ sở hữu.

description (`str`, *tùy chọn*) : Mô tả của bộ sưu tập cần tạo. Kích thước tối đa cho mô tả là 150 ký tự.

private (`bool`, *tùy chọn*) : Xác định xem bộ sưu tập có nên là riêng tư hay không. Mặc định là `False` (tức là bộ sưu tập công khai).

resource_group_id (`str`, *tùy chọn*) : Gán bộ sưu tập cho nhóm tài nguyên của tổ chức sở hữu. Chỉ hợp lệ với các bộ sưu tập thuộc sở hữu của tổ chức. ID nhóm tài nguyên là chuỗi thập lục phân 24 ký tự.

exists_ok (`bool`, *tùy chọn*) : Nếu `True`, không gây ra lỗi nếu bộ sưu tập đã tồn tại.

token (`bool` hoặc `str`, *tùy chọn*) : Một token truy cập người dùng hợp lệ (chuỗi). Mặc định là token được lưu cục bộ, đây là phương pháp xác thực được khuyến nghị (xem https://huggingface.co/docs/huggingface_hub/quick-start#authentication). Để tắt xác thực, truyền `False`.

Tạo một Collection mới trên Hub.

Trả về: [Collection](/docs/huggingface_hub/v2.4.0/vi/package_reference/collections#huggingface_hub.Collection)

Ví dụ:

```py
>>> from huggingface_hub import create_collection
>>> collection = create_collection(
...     title="ICCV 2023",
...     description="Portfolio of models, papers and demos I presented at ICCV 2023",
... )
>>> collection.slug
"username/iccv-2023-64f9a55bb3115b4f513ec026"
```

#### create_commit[[huggingface_hub.HfApi.create_commit]]

```python
create_commit(repo_id: str, operations: Iterable[CommitOperation], commit_message: str, commit_description: str | None = None, token: str | bool | None = None, repo_type: str | None = None, revision: str | None = None, create_pr: bool | None = None, num_threads: int = 5, parent_commit: str | None = None, run_as_future: bool = False, _hot_reload: bool | None = None)
```

[Nguồn](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L5016)

**Tham số:**

repo_id (`str`) : Kho lưu trữ mà commit sẽ được tạo, ví dụ: `"username/custom_transformers"`

operations (`Iterable` của `~hf_api.CommitOperation`) : Một iterable chứa các thao tác cần đưa vào commit, bao gồm: - `~hf_api.CommitOperationAdd` để tải lên một tệp - `~hf_api.CommitOperationDelete` để xóa một tệp - `~hf_api.CommitOperationCopy` để sao chép một tệp  Các đối tượng thao tác sẽ bị thay đổi để bao gồm thông tin liên quan đến việc tải lên. Không tái sử dụng cùng một đối tượng cho nhiều commit.

commit_message (`str`) : Tóm tắt (dòng đầu tiên) của commit sẽ được tạo.

commit_description (`str`, *tùy chọn*) : Mô tả của commit sẽ được tạo

token (`bool` hoặc `str`, *tùy chọn*) : Một token truy cập người dùng hợp lệ (chuỗi). Mặc định là token được lưu cục bộ, đây là phương pháp xác thực được khuyến nghị (xem https://huggingface.co/docs/huggingface_hub/quick-start#authentication). Để tắt xác thực, truyền `False`.

repo_type (`str`, *tùy chọn*) : Đặt thành `"dataset"`, `"space"` hoặc `"kernel"` nếu tải lên kho dataset, space hoặc kernel, `None` hoặc `"model"` nếu tải lên model. Mặc định là `None`.

revision (`str`, *tùy chọn*) : Bản sửa git để commit từ. Mặc định là đầu của nhánh `"main"`.

create_pr (`boolean`, *tùy chọn*) : Có tạo Pull Request với commit đó hay không. Mặc định là `False`. Nếu `revision` không được đặt, PR sẽ được mở đối với nhánh `"main"`. Nếu `revision` được đặt và là một nhánh, PR sẽ được mở đối với nhánh này. Nếu `revision` được đặt và không phải là tên nhánh (ví dụ: một commit oid), một `RevisionNotFoundError` sẽ được trả về bởi máy chủ.

num_threads (`int`, *optional*) : Số lượng luồng đồng thời để tải tệp lên. Mặc định là 5. Đặt thành 2 có nghĩa là tối đa 2 tệp sẽ được tải lên đồng thời.

parent_commit (`str`, *tùy chọn*) : OID / SHA của commit cha, dưới dạng chuỗi hex. Các dạng viết tắt (7 ký tự đầu tiên) cũng được hỗ trợ. Nếu được chỉ định và `create_pr` là `False`, commit sẽ thất bại nếu `revision` không trỏ đến `parent_commit`. Nếu được chỉ định và `create_pr` là `True`, pull request sẽ được tạo từ `parent_commit`. Việc chỉ định `parent_commit` đảm bảo rằng repo không bị thay đổi trước khi commit các thay đổi, và đặc biệt hữu ích nếu repo được cập nhật / commit đồng thời.

run_as_future (`bool`, *tuỳ chọn*) : Có chạy phương thức này ở nền hay không. Các tác vụ nền được chạy tuần tự mà không chặn luồng chính. Truyền `run_as_future=True` sẽ trả về một đối tượng [Future](https://docs.python.org/3/library/concurrent.futures.html#future-objects). Mặc định là `False`.

**Trả về:** [CommitInfo](/docs/huggingface_hub/v2.4.0/vi/package_reference/hf_api#huggingface_hub.CommitInfo) hoặc `Future`

Thư mục [CommitInfo](/docs/huggingface_hub/v2.4.0/vi/package_reference/hf_api#huggingface_hub.CommitInfo) chứa thông tin về commit mới được tạo (commit hash, commit url, pr url, commit message,...). Nếu `run_as_future=True` được truyền vào, sẽ trả về một đối tượng Future sẽ chứa kết quả khi được thực thi.

**Lỗi:** ``ValueError`` hoặc [RepositoryNotFoundError](/docs/huggingface_hub/v2.4.0/vi/package_reference/utilities#huggingface_hub.errors.RepositoryNotFoundError)

- [`ValueError`](https://docs.python.org/3/library/exceptions.html#ValueError) -- Nếu thông báo commit trống.
- [`ValueError`](https://docs.python.org/3/library/exceptions.html#ValueError) -- Nếu commit cha không phải là OID commit hợp lệ.
- [`ValueError`](https://docs.python.org/3/library/exceptions.html#ValueError) -- Nếu một tệp README.md có phần metadata không hợp lệ được commit. Trong trường hợp này, commit sẽ thất bại sớm, trước khi cố gắng tải lên bất kỳ tệp nào.
- [`ValueError`](https://docs.python.org/3/library/exceptions.html#ValueError) -- Nếu `create_pr` là `True` và revision không phải là `None` cũng không phải là `"main"`.
- [RepositoryNotFoundError](/docs/huggingface_hub/v2.4.0/vi/package_reference/utilities#huggingface_hub.errors.RepositoryNotFoundError) -- Nếu không tìm thấy kho (lỗi 404): repo_id/repo_type không đúng, kho là riêng tư nhưng chưa xác thực hoặc kho không tồn tại.

Tạo một commit trong kho đã cho, xóa & tải lên các tệp khi cần.

> [!WARNING]
> Danh sách đầu vào `CommitOperation` sẽ bị thay đổi trong quá trình commit. Không tái sử dụng cùng các đối tượng cho nhiều lần commit.

> [!WARNING]
> `create_commit` giả định rằng repo đã tồn tại trên Hub. Nếu bạn gặp lỗi Client 404, hãy đảm bảo rằng bạn đã xác thực, token của bạn có các quyền cần thiết, và `repo_id` cùng `repo_type` được đặt đúng. Nếu repo chưa tồn tại, hãy tạo nó trước bằng [create_repo()](/docs/huggingface_hub/v2.4.0/vi/package_reference/hf_api#huggingface_hub.HfApi.create_repo).

> [!WARNING]
> `create_commit` bị giới hạn ở 25k tệp LFS và 1GB payload cho các tệp thông thường.

#### create_discussion[[huggingface_hub.HfApi.create_discussion]]

```python
create_discussion(repo_id: str, title: str, token: bool | str | None = None, description: str | None = None, repo_type: str | None = None, pull_request: bool = False)
```

[Nguồn](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L7440)

**Tham số:**

repo_id (`str`) : Một namespace (người dùng hoặc tổ chức) và tên kho, được phân tách bằng `/`.

title (`str`) : Tiêu đề của cuộc thảo luận. Độ dài tối đa là 200 ký tự và tối thiểu là 3 ký tự. Các khoảng trắng ở đầu và cuối sẽ bị loại bỏ.

token (`bool` hoặc `str`, *tùy chọn*) : Một token truy cập người dùng hợp lệ (chuỗi). Mặc định là token được lưu cục bộ, đây là phương pháp xác thực được khuyến nghị (xem https://huggingface.co/docs/huggingface_hub/quick-start#authentication). Để tắt xác thực, truyền `False`.

description (`str`, *tùy chọn*) : Mô tả tùy chọn cho Pull Request. Mặc định là `"Discussion opened with the huggingface_hub Python library"`

pull_request (`bool`, *tuỳ chọn*) : Có tạo Pull Request hay thảo luận hay không. Nếu `True`, sẽ tạo Pull Request. Nếu `False`, sẽ tạo thảo luận. Mặc định là `False`.

repo_type (`str`, *tùy chọn*) : Đặt thành `"dataset"` hoặc `"space"` nếu tải lên một dataset hoặc space, `None` hoặc `"model"` nếu tải lên một model. Mặc định là `None`.

Tạo một Discussion hoặc Pull Request.

Các Pull Request được tạo bằng chương trình sẽ ở trạng thái `"draft"`.

Việc tạo một Pull Request kèm theo các thay đổi cũng có thể được thực hiện ngay lập tức bằng [HfApi.create_commit()](/docs/huggingface_hub/v2.4.0/vi/package_reference/hf_api#huggingface_hub.HfApi.create_commit).

Trả về: [DiscussionWithDetails](/docs/huggingface_hub/v2.4.0/vi/package_reference/community#huggingface_hub.DiscussionWithDetails)

> [!TIP]
> Gây ra các lỗi sau:
>
> - [`HTTPError`](https://requests.readthedocs.io/en/latest/api/#requests.HTTPError) nếu API HuggingFace trả về lỗi - [`ValueError`](https://docs.python.org/3/library/exceptions.html#ValueError) nếu giá trị của một số tham số không hợp lệ - [RepositoryNotFoundError](/docs/huggingface_hub/v2.4.0/vi/package_reference/utilities#huggingface_hub.errors.RepositoryNotFoundError) Nếu không tìm thấy kho cần tải xuống. Điều này có thể do kho không tồn tại, hoặc do kho được đặt ở chế độ `private` và bạn không có quyền truy cập.

#### create_inference_endpoint[[huggingface_hub.HfApi.create_inference_endpoint]]

```python
create_inference_endpoint(name: str, repository: str, framework: str, accelerator: str, instance_size: str, instance_type: str, region: str, vendor: str, account_id: str | None = None, private_link_account_id: str | None = None, private_link_region: str | None = None, min_replica: int = 1, max_replica: int = 1, scaling_metric: InferenceEndpointScalingMetric | None = None, scaling_threshold: float | None = None, scale_to_zero_timeout: int | None = None, revision: str | None = None, task: str | None = None, custom_image: dict | None = None, container_registry_username: str | None = None, container_registry_password: str | None = None, container_command: list[str] | None = None, container_args: list[str] | None = None, env: dict[str, str] | None = None, secrets: dict[str, str] | None = None, type: InferenceEndpointType | str = <InferenceEndpointType.AUTHENTICATED: 'authenticated'>, domain: str | None = None, path: str | None = None, cache_http_responses: bool | None = None, tags: list[str] | None = None, namespace: str | None = None, token: bool | str | None = None)
```

[Nguồn](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L9205)

**Tham số:**

name (`str`) : Tên duy nhất cho Inference Endpoint mới.

repository (`str`) : Tên của kho mô hình liên quan đến Inference Endpoint (ví dụ: `"gpt2"`).

framework (`str`) : Khung machine learning được sử dụng cho mô hình (ví dụ: `"custom"`).

accelerator (`str`) : Bộ tăng tốc phần cứng sẽ được sử dụng cho suy luận (ví dụ: `"cpu"`).

instance_size (`str`) : Kích thước hoặc kiểu của instance được sử dụng để lưu trữ model (ví dụ: `"x4"`).

instance_type (`str`) : Kiểu instance trên cloud mà Inference Endpoint sẽ được triển khai (ví dụ: `"intel-icl"`).

region (`str`) : Vùng cloud mà Inference Endpoint sẽ được tạo (ví dụ: `"us-east-1"`).

vendor (`str`) : Nhà cung cấp đám mây hoặc nhà cung cấp nơi Inference Endpoint sẽ được triển khai (ví dụ: `"aws"`).

account_id (`str`, *tùy chọn*) : Đã bị hủy bỏ và bị bỏ qua. Hãy sử dụng `private_link_account_id` và `private_link_region` để cấu hình AWS PrivateLink.

private_link_account_id (`str`, *tùy chọn*) : ID tài khoản AWS được phép truy cập Inference Endpoint thông qua AWS PrivateLink. Yêu cầu `private_link_region`.

private_link_region (`str`, *tùy chọn*) : Vùng AWS của điểm vào PrivateLink (`"us-east-1"` hoặc `"eu-west-1"`), nơi VPC endpoint của `private_link_account_id` sẽ kết nối. Độc lập với `region` và `vendor` của compute.

min_replica (`int`, *optional*) : Số lượng tối thiểu các bản sao (instance) cần duy trì hoạt động cho Inference Endpoint. Để bật tính năng scale về zero, hãy đặt giá trị này thành 0 và điều chỉnh `scale_to_zero_timeout` cho phù hợp. Mặc định là 1.

max_replica (`int`, *optional*) : Số lượng bản sao (instance) tối đa để mở rộng cho Inference Endpoint. Mặc định là 1.

scaling_metric (`str` hoặc `InferenceEndpointScalingMetric `, *tuỳ chọn*) : Tham chiếu chỉ số để mở rộng. Là "pendingRequests" hoặc "hardwareUsage" khi được cung cấp. Mặc định là None (nghĩa là: để dịch vụ HF Endpoints chỉ định chỉ số).

scaling_threshold (`float`, *optional*) : Ngưỡng của chỉ số đo lường tỷ lệ mở rộng được sử dụng để kích hoạt việc mở rộng lên. Bỏ qua khi không cung cấp chỉ số đo lường tỷ lệ mở rộng. Mặc định là None (nghĩa là: để dịch vụ HF Endpoints chỉ định ngưỡng).

scale_to_zero_timeout (`int`, *optional*) : Thời lượng tính bằng phút trước khi một endpoint không hoạt động bị thu về mức không, hoặc không thu về mức không nếu được đặt là None và `min_replica` không phải 0. Mặc định là None.

revision (`str`, *tùy chọn*) : Phiên bản mô hình cụ thể để triển khai trên Inference Endpoint (ví dụ: `"6c0e6080953db56375760c0471a8c5f2929baf11"`).

task (`str`, *tùy chọn*) : Nhiệm vụ để triển khai mô hình (ví dụ: `"text-classification"`).

custom_image (`dict`, *tùy chọn*) : Ảnh container để chạy. Có thể là một dict có khóa theo biến thể ảnh (ví dụ `{"vLLM": {"url": "vllm/vllm-openai:v0.23.0", "port": 8000}}`, cũng như `sGLang`, `tgi`, `tei`, `llamacpp`, `hfServe`, ...), được chuyển tiếp nguyên vẹn, hoặc một dict phẳng mô tả một container tùy chỉnh (ví dụ `{"url": ..., "port": ...}`), được gửi dưới dạng `{"custom": ...}` (xem các ví dụ). Mặc định là ảnh do Hugging Face quản lý.

container_registry_username (`str`, *tùy chọn*) : Tên người dùng được sử dụng để xác thực với registry lưu trữ hình ảnh container tùy chỉnh.

container_registry_password (`str`, *tùy chọn*) : Mật khẩu được sử dụng để xác thực với registry lưu trữ hình ảnh container tùy chỉnh. Yêu cầu `container_registry_username`. Bỏ qua khỏi API payload khi không được cung cấp.

container_command (`list[str]`, *tùy chọn*) : Ghi đè lệnh entrypoint của container (tương ứng với `model.command` trong API payload). Hoạt động với cả các hình ảnh engine được quản lý (ví dụ: vLLM, SGLang) và các hình ảnh tùy chỉnh.

container_args (`list[str]`, *tùy chọn*) : Các đối số được thêm vào entrypoint của container (tương ứng với `model.args` trong API payload). Hoạt động với cả các image engine được quản lý (ví dụ: vLLM, SGLang) và các image tùy chỉnh.

env (`dict[str, str]`, *tùy chọn*) : Các biến môi trường không bí mật để tiêm vào môi trường của container.

secrets (`dict[str, str]`, *tùy chọn*) : Các giá trị bí mật để tiêm vào môi trường của container.

type ([`InferenceEndpointType]`, *tuỳ chọn*) : Kiểu của Inference Endpoint, có thể là `"authenticated"` (mặc định), `"public"` hoặc `"private"`.

domain (`str`, *tùy chọn*) : Miền tùy chỉnh cho triển khai Inference Endpoint, nếu được cấu hình, inference endpoint sẽ khả dụng tại miền này (ví dụ: `"my-new-domain.cool-website.woof"`).

path (`str`, *tùy chọn*) : Đường dẫn tùy chỉnh đến mô hình đã triển khai, phải bắt đầu bằng `/` (ví dụ: `"/models/google-bert/bert-base-uncased"`).

cache_http_responses (`bool`, *tùy chọn*) : Có nên lưu bộ nhớ đệm các phản hồi HTTP từ Inference Endpoint hay không. Mặc định là `False`.

tags (`list[str]`, *tùy chọn*) : Một danh sách các thẻ để liên kết với Inference Endpoint.

namespace (`str`, *tùy chọn*) : Không gian tên mà Inference Endpoint sẽ được tạo. Mặc định là không gian tên của người dùng hiện tại.

token (`bool` hoặc `str`, *tùy chọn*) : Một token truy cập người dùng hợp lệ (chuỗi). Mặc định là token được lưu cục bộ, đây là phương pháp xác thực được khuyến nghị (xem https://huggingface.co/docs/huggingface_hub/quick-start#authentication). Để tắt xác thực, truyền `False`.

**Trả về:** [InferenceEndpoint](/docs/huggingface_hub/v2.4.0/vi/package_reference/inference_endpoints#huggingface_hub.InferenceEndpoint)

thông tin về Inference Endpoint đã được cập nhật.

Tạo một Inference Endpoint mới.

Các giá trị `accelerator`, `instance_size`, `instance_type`, `region` và `vendor` có mối quan hệ phụ thuộc lẫn nhau; hãy sử dụng [list_inference_endpoints_hardware()](/docs/huggingface_hub/v2.4.0/vi/package_reference/hf_api#huggingface_hub.HfApi.list_inference_endpoints_hardware) để liệt kê các tổ hợp hợp lệ.

Ví dụ:
```python
>>> from huggingface_hub import HfApi
>>> api = HfApi()
>>> endpoint = api.create_inference_endpoint(
...     "my-endpoint-name",
...     repository="gpt2",
...     framework="pytorch",
...     task="text-generation",
...     accelerator="cpu",
...     vendor="aws",
...     region="us-east-1",
...     type="authenticated",
...     instance_size="x2",
...     instance_type="intel-icl",
... )
>>> endpoint
InferenceEndpoint(name='my-endpoint-name', status="pending",...)

# Run inference on the endpoint
>>> endpoint.client.text_generation(...)
"..."
```

```python
# Start an Inference Endpoint running Zephyr-7b-beta on TGI
>>> from huggingface_hub import HfApi
>>> api = HfApi()
>>> endpoint = api.create_inference_endpoint(
...     "aws-zephyr-7b-beta-0486",
...     repository="HuggingFaceH4/zephyr-7b-beta",
...     framework="pytorch",
...     task="text-generation",
...     accelerator="gpu",
...     vendor="aws",
...     region="us-east-1",
...     type="authenticated",
...     instance_size="x1",
...     instance_type="nvidia-a10g",
...     env={
...           "MAX_BATCH_PREFILL_TOKENS": "2048",
...           "MAX_INPUT_LENGTH": "1024",
...           "MAX_TOTAL_TOKENS": "1512",
...           "MODEL_ID": "/repository"
...         },
...     custom_image={
...         "healthRoute": "/health",
...         "url": "ghcr.io/huggingface/text-generation-inference:1.1.0",
...     },
...    secrets={"MY_SECRET_KEY": "secret_value"},
...    tags=["dev", "text-generation"],
... )
```

```python
# Start an Inference Endpoint running ProsusAI/finbert while scaling to zero in 15 minutes
>>> from huggingface_hub import HfApi
>>> api = HfApi()
>>> endpoint = api.create_inference_endpoint(
...     "finbert-classifier",
...     repository="ProsusAI/finbert",
...     framework="pytorch",
...     task="text-classification",
...     min_replica=0,
...     scale_to_zero_timeout=15,
...     accelerator="cpu",
...     vendor="aws",
...     region="us-east-1",
...     type="authenticated",
...     instance_size="x2",
...     instance_type="intel-icl",
... )
>>> endpoint.wait(timeout=300)
# Run inference on the endpoint
>>> endpoint.client.text_generation(...)
TextClassificationOutputElement(label='positive', score=0.8983615040779114)
```

#### create_inference_endpoint_from_catalog[[huggingface_hub.HfApi.create_inference_endpoint_from_catalog]]

```python
create_inference_endpoint_from_catalog(repo_id: str | None = None, recipe_id: str | None = None, name: str | None = None, accelerator: Literal['cpu', 'gpu', 'neuron'] | str | None = None, gguf_file: str | None = None, token: bool | str | None = None, namespace: str | None = None)
```

[Nguồn](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L9502)

**Tham số:**

repo_id (`str`, *tùy chọn*) : ID của model trong catalog để triển khai dưới dạng Inference Endpoint. Loại trừ lẫn nhau với `recipe_id`.

recipe_id (`str`, *tùy chọn*) : ID của công thức catalog cần triển khai (xem [InferenceCatalogRecipe](/docs/huggingface_hub/v2.4.0/vi/package_reference/inference_endpoints#huggingface_hub.InferenceCatalogRecipe)). Loại trừ lẫn nhau với `repo_id`.

name (`str`, *tùy chọn*) : Tên duy nhất cho Inference Endpoint mới. Nếu không được cung cấp, một tên ngẫu nhiên sẽ được tạo ra.

accelerator (`str`, *tùy chọn*) : Bộ tăng tốc phần cứng sẽ được sử dụng cho suy luận. Các giá trị có thể bao gồm `"cpu"`, `"gpu"` và `"neuron"`. Nếu không được cung cấp, máy chủ sẽ sử dụng giá trị mặc định phù hợp với mô hình. Chỉ hợp lệ với `repo_id`.

gguf_file (`str`, *tùy chọn*) : Tệp GGUF cần triển khai, dành cho các mô hình có một công thức cho mỗi mức lượng tử hóa (ví dụ: `"Qwen2.5-Coder-32B-Instruct-Q4_K_M.gguf"`). Chỉ hợp lệ khi dùng với `repo_id`.

token (`bool` hoặc `str`, *tùy chọn*) : Một token truy cập người dùng hợp lệ (chuỗi). Mặc định là token được lưu cục bộ, đây là phương pháp xác thực được khuyến nghị (xem https://huggingface.co/docs/huggingface_hub/quick-start#authentication).

namespace (`str`, *tùy chọn*) : Không gian tên mà Inference Endpoint sẽ được tạo. Mặc định là không gian tên của người dùng hiện tại.

**Trả về:** [InferenceEndpoint](/docs/huggingface_hub/v2.4.0/vi/package_reference/inference_endpoints#huggingface_hub.InferenceEndpoint)

thông tin về Inference Endpoint mới.

Tạo một Inference Endpoint mới từ Hugging Face Inference Catalog.

Mục tiêu của Inference Catalog là cung cấp một danh sách các mô hình được tuyển chọn, tối ưu cho suy luận và đã được kiểm tra với các cấu hình mặc định. Xem https://endpoints.huggingface.co/catalog để biết danh sách các mô hình có sẵn trong catalog.

Mỗi model trong catalog được triển khai thông qua một *recipe*: một tổ hợp phần cứng và engine đã được kiểm tra cho model đó. Truyền `repo_id` để triển khai recipe mặc định của một model, có thể thu hẹp thêm bằng `accelerator` và `gguf_file`, hoặc truyền `recipe_id` để triển khai một recipe cụ thể được liệt kê bởi [list_inference_catalog()](/docs/huggingface_hub/v2.4.0/vi/package_reference/hf_api#huggingface_hub.HfApi.list_inference_catalog).

> [!WARNING]
> `create_inference_endpoint_from_catalog` là thử nghiệm. API của nó có thể thay đổi trong tương lai. Vui lòng cung cấp phản hồi nếu bạn có bất kỳ đề xuất hoặc yêu cầu nào.

#### create_pull_request[[huggingface_hub.HfApi.create_pull_request]]

```python
create_pull_request(repo_id: str, title: str, token: bool | str | None = None, description: str | None = None, repo_type: str | None = None)
```

[Nguồn](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L7529)

**Tham số:**

repo_id (`str`) : Một namespace (người dùng hoặc tổ chức) và tên kho, được phân tách bằng `/`.

title (`str`) : Tiêu đề của cuộc thảo luận. Độ dài tối đa là 200 ký tự và tối thiểu là 3 ký tự. Các khoảng trắng ở đầu và cuối sẽ bị loại bỏ.

token (`bool` hoặc `str`, *tùy chọn*) : Một token truy cập người dùng hợp lệ (chuỗi). Mặc định là token được lưu cục bộ, đây là phương pháp xác thực được khuyến nghị (xem https://huggingface.co/docs/huggingface_hub/quick-start#authentication). Để tắt xác thực, truyền `False`.

description (`str`, *tùy chọn*) : Mô tả tùy chọn cho Pull Request. Mặc định là `"Discussion opened with the huggingface_hub Python library"`

repo_type (`str`, *tùy chọn*) : Đặt thành `"dataset"` hoặc `"space"` nếu tải lên một dataset hoặc space, `None` hoặc `"model"` nếu tải lên một model. Mặc định là `None`.

Tạo một Pull Request. Các Pull Request được tạo bằng chương trình sẽ ở trạng thái `"draft"`.

Việc tạo một Pull Request kèm theo các thay đổi cũng có thể được thực hiện ngay lập tức bằng [HfApi.create_commit()](/docs/huggingface_hub/v2.4.0/vi/package_reference/hf_api#huggingface_hub.HfApi.create_commit);

Đây là một lớp bọc quanh [HfApi.create_discussion()](/docs/huggingface_hub/v2.4.0/vi/package_reference/hf_api#huggingface_hub.HfApi.create_discussion).

Trả về: [DiscussionWithDetails](/docs/huggingface_hub/v2.4.0/vi/package_reference/community#huggingface_hub.DiscussionWithDetails)

> [!TIP]
> Gây ra các lỗi sau:
>
> - [`HTTPError`](https://requests.readthedocs.io/en/latest/api/#requests.HTTPError) nếu API HuggingFace trả về lỗi - [`ValueError`](https://docs.python.org/3/library/exceptions.html#ValueError) nếu giá trị của một số tham số không hợp lệ - [RepositoryNotFoundError](/docs/huggingface_hub/v2.4.0/vi/package_reference/utilities#huggingface_hub.errors.RepositoryNotFoundError) Nếu không tìm thấy kho cần tải xuống. Điều này có thể do kho không tồn tại, hoặc do kho được đặt ở chế độ `private` và bạn không có quyền truy cập.

#### create_repo[[huggingface_hub.HfApi.create_repo]]

```python
create_repo(repo_id: str, token: str | bool | None = None, private: bool | None = None, visibility: RepoVisibility_T | None = None, repo_type: str | None = None, exist_ok: bool = False, resource_group_id: str | None = None, region: REPO_REGIONS | None = None, space_sdk: str | None = None, space_hardware: SpaceHardware | None = None, space_sleep_time: int | None = None, space_secrets: list[dict[str, str]] | None = None, space_variables: list[dict[str, str]] | None = None, space_volumes: list[Volume] | None = None, space_template: str | None = None)
```

[Nguồn](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L4576)

**Tham số:**

repo_id (`str`) : Một namespace (người dùng hoặc tổ chức) và tên kho, được phân tách bằng `/`.

token (`bool` hoặc `str`, *tùy chọn*) : Một token truy cập người dùng hợp lệ (chuỗi). Mặc định là token được lưu cục bộ, đây là phương pháp xác thực được khuyến nghị (xem https://huggingface.co/docs/huggingface_hub/quick-start#authentication). Để tắt xác thực, truyền `False`.

private (`bool`, *tuỳ chọn*) : Xác định có làm cho kho riêng tư hay không. Nếu là `None` (mặc định), kho sẽ là công khai trừ khi mặc định của tổ chức là riêng tư. Giá trị này bị bỏ qua nếu kho đã tồn tại. Không thể truyền cùng với `visibility`.

visibility (`Literal["public", "private", "protected"]`, *tùy chọn*) : Tính khả kiến của kho. Có thể là `"public"` hoặc `"private"`, hoặc `"protected"` cho Spaces. Nếu là `None` (mặc định), kho sẽ là công khai trừ khi mặc định của tổ chức là riêng tư. Giá trị này bị bỏ qua nếu kho đã tồn tại.

repo_type (`str`, *tùy chọn*) : Đặt thành `"dataset"` hoặc `"space"` nếu tải lên một dataset hoặc space, `None` hoặc `"model"` nếu tải lên một model. Mặc định là `None`.

exist_ok (`bool`, *tùy chọn*, mặc định là `False`) : Nếu `True`, không gây ra lỗi nếu kho đã tồn tại.

resource_group_id (`str`, *tùy chọn*) : Nhóm tài nguyên để tạo kho. Nhóm tài nguyên chỉ khả dụng cho các tổ chức Enterprise Hub và cho phép xác định thành viên nào trong tổ chức có thể truy cập tài nguyên. ID của nhóm tài nguyên có thể tìm thấy trong URL của trang tài nguyên trên Hub (ví dụ: `"66670e5163145ca562cb1988"`). Để tìm hiểu thêm về nhóm tài nguyên, xem https://huggingface.co/docs/hub/en/security-resource-groups.

region (`Literal["us", "eu"]`, *tùy chọn*) : Vùng cloud để tạo kho. Có thể là `"us"` hoặc `"eu"`. Nếu không được chỉ định, kho sẽ được tạo trong vùng mặc định. Yêu cầu gói Team hoặc cao hơn.

space_sdk (`str`, *tùy chọn*) : Lựa chọn SDK để sử dụng nếu repo_type là "space". Có thể là "streamlit", "gradio", "docker" hoặc "static". Các Space `"static"` miễn phí cho tất cả mọi người. Các SDK khác chạy trên phần cứng tính toán: trên phần cứng `cpu-basic` miễn phí, chúng yêu cầu một gói đăng ký (PRO cho người dùng, Team hoặc Enterprise cho tổ chức), trong khi phần cứng trả phí chỉ yêu cầu thanh toán (phương thức thanh toán và tín dụng trả trước).

space_hardware (`SpaceHardware` hoặc `str`, *tùy chọn*) : Lựa chọn phần cứng nếu repo_type là "space". Xem [SpaceHardware](/docs/huggingface_hub/v2.4.0/vi/package_reference/space_runtime#huggingface_hub.SpaceHardware) để biết danh sách đầy đủ.

space_sleep_time (`int`, *optional*) : Số giây không hoạt động cần chờ trước khi một Space được đưa vào trạng thái ngủ. Đặt thành `-1` nếu bạn không muốn Space của mình ngủ (hành vi mặc định cho phần cứng đã nâng cấp). Đối với phần cứng miễn phí, bạn không thể cấu hình thời gian ngủ (giá trị được cố định ở mức 48 giờ không hoạt động). Xem https://huggingface.co/docs/hub/spaces-gpus#sleep-time để biết thêm chi tiết.

space_secrets (`list[dict[str, str]]`, *tùy chọn*) : Một danh sách các khóa bí mật cần thiết lập trong Space của bạn. Mỗi mục có dạng `{"key": ..., "value": ..., "description": ...}` trong đó description là tùy chọn. Để biết thêm chi tiết, xem https://huggingface.co/docs/hub/spaces-overview#managing-secrets.

space_variables (`list[dict[str, str]]`, *tùy chọn*) : Một danh sách các biến môi trường công khai để thiết lập trong Space của bạn. Mỗi mục có dạng `{"key": ..., "value": ..., "description": ...}` trong đó description là tùy chọn. Để biết thêm chi tiết, xem https://huggingface.co/docs/hub/spaces-overview#managing-secrets-and-environment-variables.

space_volumes (`list[Volume]`, *tùy chọn*) : Một danh sách các đối tượng [Volume](/docs/huggingface_hub/v2.4.0/vi/package_reference/jobs#huggingface_hub.Volume) để gắn vào Space khi tạo. Mỗi volume có một `type` (`"bucket"`, `"model"`, `"dataset"` hoặc `"space"`), một `source` (ID của repo hoặc bucket), một `mount_path` (đường dẫn bên trong container), và các trường tùy chọn `revision`, `read_only` và `path`. Chỉ áp dụng nếu repo_type là "space".

space_template (`str`, *tùy chọn*) : Khởi tạo Space mới từ một mẫu chính thức. Có thể là id của kho mẫu (ví dụ: `"SpacesExamples/jupyterlab"`) hoặc tên ngắn của nó (ví dụ: `"JupyterLab"`). Sử dụng [HfApi.list_space_templates()](/docs/huggingface_hub/v2.4.0/vi/package_reference/hf_api#huggingface_hub.HfApi.list_space_templates) để liệt kê các mẫu khả dụng. Chỉ áp dụng nếu repo_type là "space". Nếu mẫu được khuyến nghị là riêng tư và visibility không được đặt rõ ràng, Space sẽ được tạo ở chế độ riêng tư.

**Trả về:** [RepoUrl](/docs/huggingface_hub/v2.4.0/vi/package_reference/hf_api#huggingface_hub.RepoUrl)

URL của kho vừa được tạo. Giá trị là một lớp con của `str` chứa các thuộc tính như `endpoint`, `repo_type` và `repo_id`.

Tạo một kho trống trên HuggingFace Hub.

#### create_scheduled_job[[huggingface_hub.HfApi.create_scheduled_job]]

```python
create_scheduled_job(image: str, command: list[str], schedule: str, suspend: bool | None = None, concurrency: bool | None = None, env: dict[str, Any] | None = None, secrets: dict[str, Any] | None = None, flavor: JobHardware | str | None = None, timeout: int | float | str | None = None, attempts: int | None = None, name: str | None = None, labels: dict[str, str] | None = None, volumes: list[Volume] | None = None, expose: list[int] | None = None, expose_public: list[int] | None = None, resource_group_id: str | None = None, namespace: str | None = None, token: bool | str | None = None)
```

[Nguồn](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L13072)

**Tham số:**

image (`str`) : Ảnh Docker cần sử dụng. Ví dụ: `"ubuntu"`, `"python:3.12"`, `"pytorch/pytorch:2.6.0-cuda12.4-cudnn9-devel"`. Ví dụ với một ảnh từ Space: `"hf.co/spaces/lhoestq/duckdb"`.

command (`list[str]`) : Lệnh cần thực thi. Ví dụ: `["echo", "hello"]`.

schedule (`str`) : Một trong các giá trị "@annually", "@yearly", "@monthly", "@weekly", "@daily", "@hourly", hoặc một biểu thức lịch CRON (ví dụ: '0 9 * * 1' cho 9 giờ sáng mỗi thứ Hai).

suspend (`bool`, *tùy chọn*) : Nếu là True, Job được lên lịch sẽ bị tạm dừng. Mặc định là False.

concurrency (`bool`, *tùy chọn*) : Nếu là True, nhiều phiên bản của Job này có thể chạy đồng thời. Mặc định là False.

env (`dict[str, Any]`, *tùy chọn*) : Định nghĩa các biến môi trường cho Job.

secrets (`dict[str, Any]`, *tùy chọn*) : Định nghĩa các biến môi trường bí mật cho Job.

flavor (`str`, *tùy chọn*) : Kiểu phần cứng. Xem `JobHardware` để biết các giá trị có thể. Mặc định là `"cpu-basic"`.

timeout (`Union[int, float, str]`, *tùy chọn*) : Thời lượng tối đa cho Job: int với s (giây, mặc định), m (phút), h (giờ) hoặc d (ngày). Ví dụ: `300` hoặc `"5m"` cho 5 phút.

attempts (`int`, *optional*) : Số lần thử tối đa cho mỗi lần chạy, bao gồm cả lần thử ban đầu. Mặc định là 1.

name (`str`, *tuỳ chọn*) : Tên cho Job được lên lịch. Được lưu dưới dạng nhãn `name`. Không thể truyền cùng với khóa `name` trong `labels`. Tên không nhất thiết phải duy nhất. Mặc định là tên được suy ra từ image và command (kèm hậu tố hash ngắn).

labels (`dict[str, str]`, *tùy chọn*) : Nhãn để gắn cho công việc (cặp khóa-giá trị).

volumes (`list[Volume]`, *tùy chọn*) : Các Buckets hoặc Repos của Hugging Face để gắn làm volume trong container của job. Mỗi volume là một [Volume](/docs/huggingface_hub/v2.4.0/vi/package_reference/jobs#huggingface_hub.Volume) có `type` (`"bucket"`, `"model"`, `"dataset"` hoặc `"space"`), `source` (ví dụ `"username/my-bucket"`) và `mount_path` (ví dụ `"/data"`).

expose (`list[int]`, *optional*) : Các cổng container cần mở qua proxy của jobs. Mỗi cổng được liệt kê sẽ có thể truy cập trên tên miền jobs công khai (ví dụ: `https://<job_id>--8000.hf.jobs`). Việc truy cập luôn yêu cầu một HF token có quyền đọc vào namespace của job. Sử dụng `expose_public` cho truy cập không xác thực.

expose_public (`list[int]`, *optional*) : Các cổng cần phơi bày qua proxy của Jobs mà không cần xác thực. Chúng không cần được liệt kê trong `expose`.

resource_group_id (`str`, *tùy chọn*) : ID của nhóm tài nguyên để tạo Job được lên lịch. Được sử dụng để kiểm soát quyền truy cập vào các tài nguyên trong tổ chức và cho các tính năng gán chi phí/giới hạn chi tiêu. Nếu không được cung cấp, Job được lên lịch sẽ được tạo bên ngoài bất kỳ nhóm tài nguyên nào.

namespace (`str`, *tùy chọn*) : Không gian tên nơi Job sẽ được tạo. Mặc định là không gian tên của người dùng hiện tại.

token (`bool` hoặc `str`, *tùy chọn*) : Một token truy cập người dùng hợp lệ. Nếu không được cung cấp, token được lưu cục bộ sẽ được sử dụng, đây là phương thức xác thực được khuyến nghị. Đặt thành `False` để tắt xác thực. Tham khảo: https://huggingface.co/docs/huggingface_hub/quick-start#authentication.

Tạo các Job tính toán được lên lịch trên hạ tầng của Hugging Face.

Ví dụ:

Tạo Job được lên lịch đầu tiên của bạn:

```python
>>> from huggingface_hub import create_scheduled_job
>>> create_scheduled_job(image="python:3.12", command=["python", "-c" ,"print('Hello from HF compute!')"], schedule="@hourly")
```

Sử dụng biểu thức lịch CRON:

```python
>>> from huggingface_hub import create_scheduled_job
>>> create_scheduled_job(image="python:3.12", command=["python", "-c" ,"print('this runs every 5min')"], schedule="*/5 * * * *")
```

Tạo một GPU Job được lên lịch:

```python
>>> from huggingface_hub import create_scheduled_job
>>> image = "pytorch/pytorch:2.6.0-cuda12.4-cudnn9-devel"
>>> command = ["python", "-c", "import torch; print(f'This code ran with the following GPU: {torch.cuda.get_device_name()}')"]
>>> create_scheduled_job(image=image, command=command, flavor="a10g-small", schedule="@hourly")
```

#### create_scheduled_uv_job[[huggingface_hub.HfApi.create_scheduled_uv_job]]

```python
create_scheduled_uv_job(script: str, script_args: list[str] | None = None, schedule: str, suspend: bool | None = None, concurrency: bool | None = None, dependencies: list[str] | None = None, python: str | None = None, image: str | None = None, env: dict[str, Any] | None = None, secrets: dict[str, Any] | None = None, flavor: JobHardware | str | None = None, timeout: int | float | str | None = None, attempts: int | None = None, name: str | None = None, labels: dict[str, str] | None = None, volumes: list[Volume] | None = None, expose: list[int] | None = None, expose_public: list[int] | None = None, resource_group_id: str | None = None, namespace: str | None = None, token: bool | str | None = None)
```

[Nguồn](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L13551)

**Tham số:**

script (`str`) : Đường dẫn hoặc URL của script UV, hoặc một lệnh.

script_args (`list[str]`, *tùy chọn*) : Các đối số để truyền cho script hoặc lệnh.

schedule (`str`) : Một trong các giá trị "@annually", "@yearly", "@monthly", "@weekly", "@daily", "@hourly", hoặc một biểu thức lịch CRON (ví dụ: '0 9 * * 1' cho 9 giờ sáng mỗi thứ Hai).

suspend (`bool`, *tùy chọn*) : Nếu là True, Job được lên lịch sẽ bị tạm dừng. Mặc định là False.

concurrency (`bool`, *tùy chọn*) : Nếu là True, nhiều phiên bản của Job này có thể chạy đồng thời. Mặc định là False.

dependencies (`list[str]`, *tùy chọn*) : Các phụ thuộc cần dùng để chạy script UV.

python (`str`, *tùy chọn*) : Sử dụng một phiên bản Python cụ thể. Mặc định là 3.12.

image (`str`, *tùy chọn*, mặc định là "ghcr.io/astral-sh/uv --python3.12-bookworm"): Sử dụng hình ảnh Docker tùy chỉnh có cài đặt `uv`.

env (`dict[str, Any]`, *tùy chọn*) : Định nghĩa các biến môi trường cho Job.

secrets (`dict[str, Any]`, *tùy chọn*) : Định nghĩa các biến môi trường bí mật cho Job.

flavor (`str`, *tùy chọn*) : Kiểu phần cứng. Xem `JobHardware` để biết các giá trị có thể. Mặc định là `"cpu-basic"`.

timeout (`Union[int, float, str]`, *tùy chọn*) : Thời lượng tối đa cho Job: int với s (giây, mặc định), m (phút), h (giờ) hoặc d (ngày). Ví dụ: `300` hoặc `"5m"` cho 5 phút.

attempts (`int`, *optional*) : Số lần thử tối đa cho mỗi lần chạy, bao gồm cả lần thử ban đầu. Mặc định là 1.

name (`str`, *tuỳ chọn*) : Tên cho Job được lên lịch. Được lưu dưới dạng nhãn `name`. Không thể truyền cùng với khóa `name` trong `labels`. Tên không nhất thiết phải duy nhất. Mặc định là tên được suy ra từ script và các đối số của nó (kèm hậu tố hash ngắn).

labels (`dict[str, str]`, *tùy chọn*) : Nhãn để gắn cho công việc (cặp khóa-giá trị).

volumes (`list[Volume]`, *tùy chọn*) : Các Buckets hoặc Repos của Hugging Face để gắn làm volume trong container của job. Mỗi volume là một [Volume](/docs/huggingface_hub/v2.4.0/vi/package_reference/jobs#huggingface_hub.Volume) có `type` (`"bucket"`, `"model"`, `"dataset"` hoặc `"space"`), `source` (ví dụ `"username/my-bucket"`) và `mount_path` (ví dụ `"/data"`).

expose (`list[int]`, *optional*) : Các cổng container cần mở qua proxy của jobs. Mỗi cổng được liệt kê sẽ có thể truy cập trên tên miền jobs công khai (ví dụ: `https://<job_id>--8000.hf.jobs`). Việc truy cập luôn yêu cầu một HF token có quyền đọc vào namespace của job. Sử dụng `expose_public` cho truy cập không xác thực.

expose_public (`list[int]`, *optional*) : Các cổng cần phơi bày qua proxy của Jobs mà không cần xác thực. Chúng không cần được liệt kê trong `expose`.

resource_group_id (`str`, *tùy chọn*) : ID của nhóm tài nguyên để tạo Job được lên lịch. Được sử dụng để kiểm soát quyền truy cập vào các tài nguyên trong tổ chức và cho các tính năng gán chi phí/giới hạn chi tiêu. Nếu không được cung cấp, Job được lên lịch sẽ được tạo bên ngoài bất kỳ nhóm tài nguyên nào.

namespace (`str`, *tùy chọn*) : Không gian tên nơi Job sẽ được tạo. Mặc định là không gian tên của người dùng hiện tại.

token (`bool` hoặc `str`, *tùy chọn*) : Một token truy cập người dùng hợp lệ. Nếu không được cung cấp, token được lưu cục bộ sẽ được sử dụng, đây là phương thức xác thực được khuyến nghị. Đặt thành `False` để tắt xác thực. Tham khảo: https://huggingface.co/docs/huggingface_hub/quick-start#authentication.

Chạy một Job script UV trên hạ tầng của Hugging Face.

> [!WARNING]
> Khác với `hf jobs uv run`, phương pháp này bỏ qua bảng tùy chọn `[tool.hf-jobs]` mà một script UV có thể chứa trong phần header PEP 723 của nó (xem [Jobs guide](../guides/jobs#ship-the-launch-config-with-the-script)): cấu hình khởi chạy phải được truyền vào một cách tường minh tại đây.

Ví dụ:

Lịch chạy một script từ URL:

```python
>>> from huggingface_hub import create_scheduled_uv_job
>>> script = "https://raw.githubusercontent.com/huggingface/trl/refs/heads/main/trl/scripts/sft.py"
>>> script_args = ["--model_name_or_path", "Qwen/Qwen2-0.5B", "--dataset_name", "trl-lib/Capybara", "--push_to_hub"]
>>> create_scheduled_uv_job(script, script_args=script_args, dependencies=["trl"], flavor="a10g-small", schedule="@weekly")
```

Lịch một script cục bộ:

```python
>>> from huggingface_hub import create_scheduled_uv_job
>>> script = "my_sft.py"
>>> script_args = ["--model_name_or_path", "Qwen/Qwen2-0.5B", "--dataset_name", "trl-lib/Capybara", "--push_to_hub"]
>>> create_scheduled_uv_job(script, script_args=script_args, dependencies=["trl"], flavor="a10g-small", schedule="@weekly")
```

Lên lịch một lệnh:

```python
>>> from huggingface_hub import create_scheduled_uv_job
>>> script = "lighteval"
>>> script_args= ["endpoint", "inference-providers", "model_name=openai/gpt-oss-20b,provider=auto", "lighteval|gsm8k|0|0"]
>>> create_scheduled_uv_job(script, script_args=script_args, dependencies=["lighteval"], flavor="a10g-small", schedule="@weekly")
```

#### create_tag[[huggingface_hub.HfApi.create_tag]]

```python
create_tag(repo_id: str, tag: str, tag_message: str | None = None, revision: str | None = None, token: bool | str | None = None, repo_type: str | None = None, exist_ok: bool = False)
```

[Nguồn](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L7095)

**Tham số:**

repo_id (`str`) : Kho lưu trữ mà một commit sẽ được gắn thẻ. Ví dụ: `"user/my-cool-model"`.

tag (`str`) : Tên của thẻ cần tạo.

tag_message (`str`, *tùy chọn*) : Mô tả của thẻ cần tạo.

revision (`str`, *tùy chọn*) : Bản sửa git cần gắn thẻ. Có thể là tên nhánh hoặc OID/SHA của một commit, dưới dạng chuỗi hex. Các dạng viết tắt (7 ký tự đầu tiên) cũng được hỗ trợ. Mặc định là đầu của nhánh `"main"`.

token (`bool` hoặc `str`, *tùy chọn*) : Một token truy cập người dùng hợp lệ (chuỗi). Mặc định là token được lưu cục bộ, đây là phương pháp xác thực được khuyến nghị (xem https://huggingface.co/docs/huggingface_hub/quick-start#authentication). Để tắt xác thực, truyền `False`.

repo_type (`str`, *tùy chọn*) : Đặt thành `"dataset"` hoặc `"space"` nếu gắn thẻ một dataset hoặc space, `None` hoặc `"model"` nếu gắn thẻ một model. Mặc định là `None`.

exist_ok (`bool`, *tùy chọn*, mặc định là `False`) : Nếu `True`, không gây ra lỗi nếu thẻ đã tồn tại.

**Gây ra:** [RepositoryNotFoundError](/docs/huggingface_hub/v2.4.0/vi/package_reference/utilities#huggingface_hub.errors.RepositoryNotFoundError) hoặc [RevisionNotFoundError](/docs/huggingface_hub/v2.4.0/vi/package_reference/utilities#huggingface_hub.errors.RevisionNotFoundError) hoặc [HfHubHTTPError](/docs/huggingface_hub/v2.4.0/vi/package_reference/utilities#huggingface_hub.errors.HfHubHTTPError)

- [RepositoryNotFoundError](/docs/huggingface_hub/v2.4.0/vi/package_reference/utilities#huggingface_hub.errors.RepositoryNotFoundError) -- Nếu không tìm thấy kho (lỗi 404): repo_id/repo_type không đúng, kho là riêng tư nhưng chưa xác thực hoặc kho không tồn tại.
- [RevisionNotFoundError](/docs/huggingface_hub/v2.4.0/vi/package_reference/utilities#huggingface_hub.errors.RevisionNotFoundError) -- Nếu không tìm thấy revision (lỗi 404) trên kho.
- [HfHubHTTPError](/docs/huggingface_hub/v2.4.0/vi/package_reference/utilities#huggingface_hub.errors.HfHubHTTPError) -- Nếu nhánh đã tồn tại trên kho (lỗi 409) và `exist_ok` được đặt thành `False`.

Đánh dấu một commit cụ thể của một kho trên Hub.

#### create_webhook[[huggingface_hub.HfApi.create_webhook]]

```python
create_webhook(url: str | None = None, job_id: str | None = None, watched: list[dict | WebhookWatchedItem], domains: list[constants.WEBHOOK_DOMAIN_T] | None = None, secret: str | None = None, secrets: dict[str, str] | None = None, token: bool | str | None = None)
```

[Nguồn](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L11176)

**Tham số:**

url (`str`) : URL để gửi payload tới.

job_id (`str`) : ID của Job nguồn để kích hoạt bằng webhook payload trong biến môi trường WEBHOOK_PAYLOAD. Các biến môi trường bổ sung có sẵn để tiện lợi: WEBHOOK_REPO_ID, WEBHOOK_REPO_TYPE và WEBHOOK_SECRET.

watched (`list[WebhookWatchedItem]`) : Danh sách các [WebhookWatchedItem](/docs/huggingface_hub/v2.4.0/vi/package_reference/hf_api#huggingface_hub.WebhookWatchedItem) để webhook theo dõi. Các mục này có thể là users, orgs, models, datasets, spaces hoặc buckets. Các mục được theo dõi cũng có thể được cung cấp dưới dạng các từ điển thông thường.

domains (`list[Literal["repo", "discussion"]]`, optional) : Danh sách các miền cần theo dõi. Có thể là "repo", "discussion" hoặc cả hai. Mặc định là cả hai.

secret (`str`, tùy chọn) : Một bí mật để ký cho payload.

secrets (`dict[str, str]`, optional) : Các biến môi trường bí mật cho Job được kích hoạt bởi webhook (ví dụ: `{"HF_TOKEN": "hf_***"}`). Chỉ hợp lệ với `job_id`. Các bí mật của Job nguồn không được sao chép sang webhook, vì vậy hãy truyền chúng tại đây.

token (`bool` hoặc `str`, *tùy chọn*) : Một token truy cập người dùng hợp lệ (chuỗi). Mặc định là token được lưu cục bộ, đây là phương pháp xác thực được khuyến nghị (xem https://huggingface.co/docs/huggingface_hub/quick-start#authentication). Để tắt xác thực, truyền `False`.

**Trả về:** [WebhookInfo](/docs/huggingface_hub/v2.4.0/vi/package_reference/hf_api#huggingface_hub.WebhookInfo)

Thông tin về webhook mới được tạo.

Tạo một webhook mới.

Webhook có thể gửi payload đến một URL, hoặc kích hoạt một Job chạy trên hạ tầng của Hugging Face. Hàm này nên được gọi với một trong `url` hoặc `job_id`, nhưng không được dùng cả hai.

Ví dụ:

Tạo một webhook gửi payload đến một URL

```python
>>> from huggingface_hub import create_webhook
>>> payload = create_webhook(
...     watched=[{"type": "user", "name": "julien-c"}, {"type": "org", "name": "HuggingFaceH4"}],
...     url="https://webhook.site/a2176e82-5720-43ee-9e06-f91cb4c91548",
...     domains=["repo", "discussion"],
...     secret="my-secret",
... )
>>> print(payload)
WebhookInfo(
    id="654bbbc16f2ec14d77f109cc",
    url="https://webhook.site/a2176e82-5720-43ee-9e06-f91cb4c91548",
    job=None,
    watched=[WebhookWatchedItem(type="user", name="julien-c"), WebhookWatchedItem(type="org", name="HuggingFaceH4")],
    domains=["repo", "discussion"],
    secret="my-secret",
    disabled=False,
)
```

Chạy một Job sau đó tạo một webhook kích hoạt Job này

```python
>>> from huggingface_hub import create_webhook, run_job
>>> job = run_job(
...     image="ubuntu",
...     command=["bash", "-c", r"echo An event occurred in $WEBHOOK_REPO_ID: $WEBHOOK_PAYLOAD"],
... )
>>> payload = create_webhook(
...     watched=[{"type": "user", "name": "julien-c"}, {"type": "org", "name": "HuggingFaceH4"}],
...     job_id=job.id,
...     domains=["repo", "discussion"],
...     secret="my-secret",
... )
>>> print(payload)
WebhookInfo(
    id="654bbbc16f2ec14d77f109cc",
    url=None,
    job=JobSpec(
        docker_image='ubuntu',
        space_id=None,
        command=['bash', '-c', 'echo An event occurred in $WEBHOOK_REPO_ID: $WEBHOOK_PAYLOAD'],
        arguments=[],
        environment={},
        secrets=[],
        flavor='cpu-basic',
        timeout=None,
        tags=None,
        arch=None
    ),
    watched=[WebhookWatchedItem(type="user", name="julien-c"), WebhookWatchedItem(type="org", name="HuggingFaceH4")],
    domains=["repo", "discussion"],
    secret="my-secret",
    disabled=False,
)
```

#### dataset_info[[huggingface_hub.HfApi.dataset_info]]

```python
dataset_info(repo_id: str, revision: str | None = None, timeout: float | None = None, files_metadata: bool = False, expand: list[ExpandDatasetProperty_T] | None = None, token: bool | str | None = None)
```

[Nguồn](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L3219)

**Tham số:**

repo_id (`str`) : Một namespace (người dùng hoặc tổ chức) và tên kho, được phân tách bằng `/`.

revision (`str`, *tùy chọn*) : Phiên bản của kho dữ liệu để lấy thông tin.

timeout (`float`, *optional*) : Có nên đặt thời gian chờ (timeout) cho yêu cầu đến Hub hay không.

files_metadata (`bool`, *tuỳ chọn*) : Có lấy hay không lấy siêu dữ liệu cho các tệp trong kho (kích thước, siêu dữ liệu LFS, v.v.). Mặc định là `False`.

expand (`list[ExpandDatasetProperty_T]`, *optional*) : Danh sách các thuộc tính cần trả về trong phản hồi. Khi được sử dụng, chỉ các thuộc tính trong danh sách sẽ được trả về. Tham số này không thể được sử dụng nếu `files_metadata` được truyền vào. Các giá trị có thể là `"author"`, `"cardData"`, `"citation"`, `"createdAt"`, `"disabled"`, `"description"`, `"downloads"`, `"downloadsAllTime"`, `"gated"`, `"lastModified"`, `"likes"`, `"mainSize"`, `"paperswithcode_id"`, `"private"`, `"siblings"`, `"sha"`, `"tags"`, `"trendingScore"`, `"usedStorage"`, và `"resourceGroup"`.

token (`bool` hoặc `str`, *tùy chọn*) : Một token truy cập người dùng hợp lệ (chuỗi). Mặc định là token được lưu cục bộ, đây là phương pháp xác thực được khuyến nghị (xem https://huggingface.co/docs/huggingface_hub/quick-start#authentication). Để tắt xác thực, truyền `False`.

**Trả về:** [hf_api.DatasetInfo](/docs/huggingface_hub/v2.4.0/vi/package_reference/hf_api#huggingface_hub.DatasetInfo)

Thông tin về kho dữ liệu.

Lấy thông tin về một tập dữ liệu cụ thể trên huggingface.co.

Dataset có thể là private nếu bạn truyền vào một token hợp lệ.

> [!TIP]
> Gây ra các lỗi sau:
>
> - [RepositoryNotFoundError](/docs/huggingface_hub/v2.4.0/vi/package_reference/utilities#huggingface_hub.errors.RepositoryNotFoundError) Nếu không tìm thấy kho cần tải xuống. Điều này có thể do kho không tồn tại, hoặc do kho được đặt ở chế độ `private` và bạn không có quyền truy cập. - [RevisionNotFoundError](/docs/huggingface_hub/v2.4.0/vi/package_reference/utilities#huggingface_hub.errors.RevisionNotFoundError) Nếu không tìm thấy phiên bản cần tải xuống.

#### delete_branch[[huggingface_hub.HfApi.delete_branch]]

```python
delete_branch(repo_id: str, branch: str, token: bool | str | None = None, repo_type: str | None = None)
```

[Nguồn](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L7043)

**Tham số:**

repo_id (`str`) : Kho lưu trữ mà một nhánh sẽ bị xóa. Ví dụ: `"user/my-cool-model"`.

branch (`str`) : Tên của nhánh cần xóa.

token (`bool` hoặc `str`, *tùy chọn*) : Một token truy cập người dùng hợp lệ (chuỗi). Mặc định là token được lưu cục bộ, đây là phương pháp xác thực được khuyến nghị (xem https://huggingface.co/docs/huggingface_hub/quick-start#authentication). Để tắt xác thực, truyền `False`.

repo_type (`str`, *tùy chọn*) : Đặt thành `"dataset"` hoặc `"space"` nếu tạo nhánh trên một dataset hoặc space, `None` hoặc `"model"` nếu gắn thẻ cho một model. Mặc định là `None`.

**Gây ra:** [RepositoryNotFoundError](/docs/huggingface_hub/v2.4.0/vi/package_reference/utilities#huggingface_hub.errors.RepositoryNotFoundError) hoặc [HfHubHTTPError](/docs/huggingface_hub/v2.4.0/vi/package_reference/utilities#huggingface_hub.errors.HfHubHTTPError)

- [RepositoryNotFoundError](/docs/huggingface_hub/v2.4.0/vi/package_reference/utilities#huggingface_hub.errors.RepositoryNotFoundError) -- Nếu không tìm thấy kho (lỗi 404): repo_id/repo_type không đúng, kho là riêng tư nhưng chưa xác thực hoặc kho không tồn tại.
- [HfHubHTTPError](/docs/huggingface_hub/v2.4.0/vi/package_reference/utilities#huggingface_hub.errors.HfHubHTTPError) -- Nếu cố gắng xóa một nhánh được bảo vệ. Ví dụ: `main` không thể bị xóa.
- [HfHubHTTPError](/docs/huggingface_hub/v2.4.0/vi/package_reference/utilities#huggingface_hub.errors.HfHubHTTPError) -- Nếu cố gắng xóa một nhánh không tồn tại.

Xóa một nhánh khỏi kho trên Hub.

#### delete_bucket[[huggingface_hub.HfApi.delete_bucket]]

```python
delete_bucket(bucket_id: str, missing_ok: bool = False, token: bool | str | None = None)
```

[Nguồn](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L14157)

**Tham số:**

bucket_id (`str`) : ID của bucket (ví dụ: `"username/my-bucket"`).

missing_ok (`bool`, *tùy chọn*, mặc định là `False`) : Nếu `True`, sẽ không gây ra lỗi nếu bucket không tồn tại.

token (`bool` hoặc `str`, *tùy chọn*) : Một token truy cập người dùng hợp lệ (chuỗi). Mặc định là token được lưu cục bộ, đây là phương pháp xác thực được khuyến nghị (xem https://huggingface.co/docs/huggingface_hub/quick-start#authentication). Để tắt xác thực, truyền `False`.

**Lỗi:** `BucketNotFoundError`

- `BucketNotFoundError` -- Nếu không tìm thấy bucket và `missing_ok` được đặt thành `False` (mặc định).

Xóa một bucket khỏi Hub.

Ví dụ:
```python
>>> from huggingface_hub import delete_bucket
>>> delete_bucket(bucket_id="Wauplin/first-bucket")
>>> delete_bucket(bucket_id="Wauplin/first-bucket", missing_ok=True)
```

#### delete_collection[[huggingface_hub.HfApi.delete_collection]]

```python
delete_collection(collection_slug: str, missing_ok: bool = False, token: bool | str | None = None)
```

[Nguồn](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L10373)

**Tham số:**

collection_slug (`str`) : Slug của bộ sưu tập cần xóa. Ví dụ: `"TheBloke/recent-models-64f9a55bb3115b4f513ec026"`.

missing_ok (`bool`, *tùy chọn*) : Nếu `True`, không gây ra lỗi nếu bộ sưu tập không tồn tại.

token (`bool` hoặc `str`, *tùy chọn*) : Một token truy cập người dùng hợp lệ (chuỗi). Mặc định là token được lưu cục bộ, đây là phương pháp xác thực được khuyến nghị (xem https://huggingface.co/docs/huggingface_hub/quick-start#authentication). Để tắt xác thực, truyền `False`.

Xóa một bộ sưu tập trên Hub.

Ví dụ:

```py
>>> from huggingface_hub import delete_collection
>>> collection = delete_collection("username/useless-collection-64f9a55bb3115b4f513ec026", missing_ok=True)
```

> [!WARNING]
> Đây là một thao tác không thể hoàn tác. Một bộ sưu tập đã bị xóa không thể được khôi phục.

#### delete_collection_item[[huggingface_hub.HfApi.delete_collection_item]]

```python
delete_collection_item(collection_slug: str, item_object_id: str, missing_ok: bool = False, token: bool | str | None = None)
```

[Nguồn](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L10548)

**Tham số:**

collection_slug (`str`) : Slug của bộ sưu tập cần cập nhật. Ví dụ: `"TheBloke/recent-models-64f9a55bb3115b4f513ec026"`.

item_object_id (`str`) : ID của mục trong bộ sưu tập. Đây không phải là id của mục trên Hub (repo_id hoặc paper id). Nó phải được lấy từ một đối tượng [CollectionItem](/docs/huggingface_hub/v2.4.0/vi/package_reference/collections#huggingface_hub.CollectionItem). Ví dụ: `collection.items[0].item_object_id`.

missing_ok (`bool`, *tùy chọn*) : Nếu `True`, không gây ra lỗi nếu mục không tồn tại.

token (`bool` hoặc `str`, *tùy chọn*) : Một token truy cập người dùng hợp lệ (chuỗi). Mặc định là token được lưu cục bộ, đây là phương pháp xác thực được khuyến nghị (xem https://huggingface.co/docs/huggingface_hub/quick-start#authentication). Để tắt xác thực, truyền `False`.

Xóa một mục khỏi bộ sưu tập.

Ví dụ:

```py
>>> from huggingface_hub import get_collection, delete_collection_item

# Get collection first
>>> collection = get_collection("TheBloke/recent-models-64f9a55bb3115b4f513ec026")

# Delete item based on its ID
>>> delete_collection_item(
...     collection_slug="TheBloke/recent-models-64f9a55bb3115b4f513ec026",
...     item_object_id=collection.items[-1].item_object_id,
... )
```

#### delete_file[[huggingface_hub.HfApi.delete_file]]

```python
delete_file(path_in_repo: str, repo_id: str, token: str | bool | None = None, repo_type: str | None = None, revision: str | None = None, commit_message: str | None = None, commit_description: str | None = None, create_pr: bool | None = None, parent_commit: str | None = None)
```

[Nguồn](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L6045)

**Tham số:**

path_in_repo (`str`) : Đường dẫn tệp tương đối trong kho, ví dụ: `"checkpoints/1fec34a/weights.bin"`

repo_id (`str`) : Kho lưu trữ mà tệp sẽ bị xóa, ví dụ: `"username/custom_transformers"`

token (`bool` hoặc `str`, *tùy chọn*) : Một token truy cập người dùng hợp lệ (chuỗi). Mặc định là token được lưu cục bộ, đây là phương pháp xác thực được khuyến nghị (xem https://huggingface.co/docs/huggingface_hub/quick-start#authentication). Để tắt xác thực, truyền `False`.

repo_type (`str`, *tùy chọn*) : Đặt thành `"dataset"` hoặc `"space"` nếu tệp nằm trong một dataset hoặc space, `None` hoặc `"model"` nếu nằm trong một model. Mặc định là `None`.

revision (`str`, *tùy chọn*) : Bản sửa git để commit từ. Mặc định là đầu của nhánh `"main"`.

commit_message (`str`, *tùy chọn*) : Tóm tắt / tiêu đề / dòng đầu tiên của commit được tạo. Mặc định là `f"Delete {path_in_repo} with huggingface_hub"`.

commit_description (`str`, *tùy chọn*) : Mô tả của commit được tạo

create_pr (`boolean`, *tùy chọn*) : Có tạo Pull Request với commit đó hay không. Mặc định là `False`. Nếu `revision` không được đặt, PR sẽ được mở đối với nhánh `"main"`. Nếu `revision` được đặt và là một nhánh, PR sẽ được mở đối với nhánh này. Nếu `revision` được đặt và không phải là tên nhánh (ví dụ: một commit oid), một `RevisionNotFoundError` sẽ được trả về bởi máy chủ.

parent_commit (`str`, *tùy chọn*) : OID / SHA của commit cha, dưới dạng chuỗi hex. Các dạng viết tắt (7 ký tự đầu tiên) cũng được hỗ trợ. Nếu được chỉ định và `create_pr` là `False`, commit sẽ thất bại nếu `revision` không trỏ đến `parent_commit`. Nếu được chỉ định và `create_pr` là `True`, pull request sẽ được tạo từ `parent_commit`. Việc chỉ định `parent_commit` đảm bảo rằng repo không bị thay đổi trước khi commit các thay đổi, và đặc biệt hữu ích nếu repo được cập nhật / commit đồng thời.

Xóa một tệp trong kho đã cho.

> [!TIP]
> Gây ra các lỗi sau:
>
> - [`HTTPError`](https://requests.readthedocs.io/en/latest/api/#requests.HTTPError) nếu API HuggingFace trả về lỗi - [`ValueError`](https://docs.python.org/3/library/exceptions.html#ValueError) nếu giá trị của một số tham số không hợp lệ - [RepositoryNotFoundError](/docs/huggingface_hub/v2.4.0/vi/package_reference/utilities#huggingface_hub.errors.RepositoryNotFoundError) Nếu không tìm thấy kho cần tải xuống. Điều này có thể do kho không tồn tại, hoặc do kho được đặt ở chế độ `private` và bạn không có quyền truy cập. - [RevisionNotFoundError](/docs/huggingface_hub/v2.4.0/vi/package_reference/utilities#huggingface_hub.errors.RevisionNotFoundError) Nếu không tìm thấy phiên bản cần tải xuống. - [EntryNotFoundError](/docs/huggingface_hub/v2.4.0/vi/package_reference/utilities#huggingface_hub.errors.EntryNotFoundError) Nếu không tìm thấy tệp cần tải xuống.

#### delete_files[[huggingface_hub.HfApi.delete_files]]

```python
delete_files(repo_id: str, delete_patterns: list[str], token: bool | str | None = None, repo_type: str | None = None, revision: str | None = None, commit_message: str | None = None, commit_description: str | None = None, create_pr: bool | None = None, parent_commit: str | None = None)
```

[Nguồn](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L6135)

**Tham số:**

repo_id (`str`) : Kho lưu trữ mà thư mục sẽ bị xóa, ví dụ: `"username/custom_transformers"`

delete_patterns (`list[str]`) : Danh sách các tệp hoặc thư mục cần xóa. Mỗi chuỗi có thể là đường dẫn tệp, đường dẫn thư mục, hoặc một mẫu wildcard. Các mẫu này là Standard Wildcards (mẫu globbing) như được tài liệu hóa [tại đây](https://tldp.org/LDP/GNU-Linux-Tools-Summary/html/x11655.htm). Việc khớp mẫu dựa trên [`fnmatch`](https://docs.python.org/3/library/fnmatch.html). Lưu ý rằng `fnmatch` khớp `*` qua các ranh giới đường dẫn, khác với globbing của shell Unix truyền thống. Ví dụ: `["file.txt", "folder/", "data/*.parquet"]`

token (`bool` hoặc `str`, *tùy chọn*) : Một token truy cập người dùng hợp lệ (chuỗi). Mặc định là token được lưu cục bộ, đây là phương pháp xác thực được khuyến nghị (xem https://huggingface.co/docs/huggingface_hub/quick-start#authentication). Để tắt xác thực, truyền `False`. vào token đã lưu.

repo_type (`str`, *tùy chọn*) : Kiểu của kho cần xóa tệp. Có thể là `"model"`, `"dataset"` hoặc `"space"`. Mặc định là `"model"`.

revision (`str`, *tùy chọn*) : Bản sửa git để commit từ. Mặc định là đầu của nhánh `"main"`.

commit_message (`str`, *tùy chọn*) : Tóm tắt (dòng đầu tiên) của commit được tạo. Mặc định là `f"Delete files using huggingface_hub"`.

commit_description (`str`, *tùy chọn*) : Mô tả của commit được tạo.

create_pr (`boolean`, *tùy chọn*) : Có tạo Pull Request với commit đó hay không. Mặc định là `False`. Nếu `revision` không được đặt, PR sẽ được mở đối với nhánh `"main"`. Nếu `revision` được đặt và là một nhánh, PR sẽ được mở đối với nhánh này. Nếu `revision` được đặt và không phải là tên nhánh (ví dụ: một commit oid), một `RevisionNotFoundError` sẽ được trả về bởi máy chủ.

parent_commit (`str`, *tùy chọn*) : OID / SHA của commit cha, dưới dạng chuỗi hex. Các dạng viết tắt (7 ký tự đầu tiên) cũng được hỗ trợ. Nếu được chỉ định và `create_pr` là `False`, commit sẽ thất bại nếu `revision` không trỏ đến `parent_commit`. Nếu được chỉ định và `create_pr` là `True`, pull request sẽ được tạo từ `parent_commit`. Việc chỉ định `parent_commit` đảm bảo rằng repo không bị thay đổi trước khi commit các thay đổi, và đặc biệt hữu ích nếu repo được cập nhật / commit đồng thời.

Xóa tệp khỏi một kho trên Hub.

Nếu một đường dẫn thư mục được cung cấp, toàn bộ thư mục cùng tất cả các tệp bên trong sẽ bị xóa.

#### delete_folder[[huggingface_hub.HfApi.delete_folder]]

```python
delete_folder(path_in_repo: str, repo_id: str, token: bool | str | None = None, repo_type: str | None = None, revision: str | None = None, commit_message: str | None = None, commit_description: str | None = None, create_pr: bool | None = None, parent_commit: str | None = None)
```

[Nguồn](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L6214)

**Tham số:**

path_in_repo (`str`) : Đường dẫn thư mục tương đối trong kho, ví dụ: `"checkpoints/1fec34a"`.

repo_id (`str`) : Kho lưu trữ mà thư mục sẽ bị xóa, ví dụ: `"username/custom_transformers"`

token (`bool` hoặc `str`, *tùy chọn*) : Một token truy cập người dùng hợp lệ (chuỗi). Mặc định là token được lưu cục bộ, đây là phương pháp xác thực được khuyến nghị (xem https://huggingface.co/docs/huggingface_hub/quick-start#authentication). Để tắt xác thực, truyền `False`. vào token đã lưu.

repo_type (`str`, *tùy chọn*) : Đặt thành `"dataset"` hoặc `"space"` nếu thư mục nằm trong một dataset hoặc space, `None` hoặc `"model"` nếu nằm trong một model. Mặc định là `None`.

revision (`str`, *tùy chọn*) : Bản sửa git để commit từ. Mặc định là đầu của nhánh `"main"`.

commit_message (`str`, *tùy chọn*) : Tóm tắt / tiêu đề / dòng đầu tiên của commit được tạo. Mặc định là `f"Delete folder {path_in_repo} with huggingface_hub"`.

commit_description (`str`, *tùy chọn*) : Mô tả của commit được tạo.

create_pr (`boolean`, *tùy chọn*) : Có tạo Pull Request với commit đó hay không. Mặc định là `False`. Nếu `revision` không được đặt, PR sẽ được mở đối với nhánh `"main"`. Nếu `revision` được đặt và là một nhánh, PR sẽ được mở đối với nhánh này. Nếu `revision` được đặt và không phải là tên nhánh (ví dụ: một commit oid), một `RevisionNotFoundError` sẽ được trả về bởi máy chủ.

parent_commit (`str`, *tùy chọn*) : OID / SHA của commit cha, dưới dạng chuỗi hex. Các dạng viết tắt (7 ký tự đầu tiên) cũng được hỗ trợ. Nếu được chỉ định và `create_pr` là `False`, commit sẽ thất bại nếu `revision` không trỏ đến `parent_commit`. Nếu được chỉ định và `create_pr` là `True`, pull request sẽ được tạo từ `parent_commit`. Việc chỉ định `parent_commit` đảm bảo rằng repo không bị thay đổi trước khi commit các thay đổi, và đặc biệt hữu ích nếu repo được cập nhật / commit đồng thời.

Xóa một thư mục trong kho đã cho.

Bọc đơn giản quanh phương thức [create_commit()](/docs/huggingface_hub/v2.4.0/vi/package_reference/hf_api#huggingface_hub.HfApi.create_commit).

#### delete_inference_endpoint[[huggingface_hub.HfApi.delete_inference_endpoint]]

```python
delete_inference_endpoint(name: str, namespace: str | None = None, token: bool | str | None = None)
```

[Nguồn](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L9894)

**Tham số:**

name (`str`) : Tên của Inference Endpoint cần xóa.

namespace (`str`, *tùy chọn*) : Không gian tên chứa Inference Endpoint. Mặc định là người dùng hiện tại.

token (`bool` hoặc `str`, *tùy chọn*) : Một token truy cập người dùng hợp lệ (chuỗi). Mặc định là token được lưu cục bộ, đây là phương pháp xác thực được khuyến nghị (xem https://huggingface.co/docs/huggingface_hub/quick-start#authentication). Để tắt xác thực, truyền `False`.

Xóa một Inference Endpoint.

Thao tác này không thể đảo ngược. Nếu bạn không muốn bị tính phí cho một Inference Endpoint, tốt hơn hết là hãy tạm dừng nó bằng [pause_inference_endpoint()](/docs/huggingface_hub/v2.4.0/vi/package_reference/hf_api#huggingface_hub.HfApi.pause_inference_endpoint) hoặc thu nhỏ nó về không bằng [scale_to_zero_inference_endpoint()](/docs/huggingface_hub/v2.4.0/vi/package_reference/hf_api#huggingface_hub.HfApi.scale_to_zero_inference_endpoint).

Để tiện lợi, bạn cũng có thể xóa một Inference Endpoint bằng cách sử dụng [InferenceEndpoint.delete()](/docs/huggingface_hub/v2.4.0/vi/package_reference/inference_endpoints#huggingface_hub.InferenceEndpoint.delete).

#### delete_repo[[huggingface_hub.HfApi.delete_repo]]

```python
delete_repo(repo_id: str, token: str | bool | None = None, repo_type: str | None = None, missing_ok: bool = False)
```

[Nguồn](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L4788)

**Tham số:**

repo_id (`str`) : Một namespace (người dùng hoặc tổ chức) và tên kho, được phân tách bằng `/`.

token (`bool` hoặc `str`, *tùy chọn*) : Một token truy cập người dùng hợp lệ (chuỗi). Mặc định là token được lưu cục bộ, đây là phương pháp xác thực được khuyến nghị (xem https://huggingface.co/docs/huggingface_hub/quick-start#authentication). Để tắt xác thực, truyền `False`.

repo_type (`str`, *tùy chọn*) : Đặt thành `"dataset"` hoặc `"space"` nếu tải lên một dataset hoặc space, `None` hoặc `"model"` nếu tải lên một model.

missing_ok (`bool`, *tùy chọn*, mặc định là `False`) : Nếu `True`, không gây ra lỗi nếu kho không tồn tại.

**Lỗi:** [RepositoryNotFoundError](/docs/huggingface_hub/v2.4.0/vi/package_reference/utilities#huggingface_hub.errors.RepositoryNotFoundError)

- [RepositoryNotFoundError](/docs/huggingface_hub/v2.4.0/vi/package_reference/utilities#huggingface_hub.errors.RepositoryNotFoundError) -- Nếu không tìm thấy kho cần xóa và `missing_ok` được đặt thành False (mặc định).

Xóa một kho (repo) khỏi HuggingFace Hub. LƯU Ý: thao tác này không thể hoàn tác.

#### delete_scheduled_job[[huggingface_hub.HfApi.delete_scheduled_job]]

```python
delete_scheduled_job(scheduled_job_id: str, namespace: str | None = None, token: bool | str | None = None)
```

[Nguồn](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L13324)

**Tham số:**

scheduled_job_id (`str`) : ID của Job đã được lên lịch.

namespace (`str`, *tùy chọn*) : Không gian tên (namespace) chứa Job được lên lịch. Mặc định là không gian tên của người dùng hiện tại.

token (`bool` hoặc `str`, *tùy chọn*) : Một token truy cập người dùng hợp lệ. Nếu không được cung cấp, token được lưu cục bộ sẽ được sử dụng, đây là phương thức xác thực được khuyến nghị. Đặt thành `False` để tắt xác thực. Tham khảo: https://huggingface.co/docs/huggingface_hub/quick-start#authentication.

Xóa một Job tính toán đã lên lịch trên hạ tầng Hugging Face.

#### delete_space_secret[[huggingface_hub.HfApi.delete_space_secret]]

```python
delete_space_secret(repo_id: str, key: str, token: bool | str | None = None)
```

[Nguồn](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L8083)

**Tham số:**

repo_id (`str`) : ID của kho cần cập nhật. Ví dụ: `"bigcode/in-the-stack"`.

key (`str`) : Khóa bí mật. Ví dụ: `"GITHUB_API_KEY"`.

token (`bool` hoặc `str`, *tùy chọn*) : Một token truy cập người dùng hợp lệ (chuỗi). Mặc định là token được lưu cục bộ, đây là phương pháp xác thực được khuyến nghị (xem https://huggingface.co/docs/huggingface_hub/quick-start#authentication). Để tắt xác thực, truyền `False`.

Xóa một bí mật khỏi một Space.

Secrets cho phép thiết lập các khóa hoặc token bí mật cho một Space mà không cần hardcode chúng. Để biết thêm chi tiết, xem https://huggingface.co/docs/hub/spaces-overview#managing-secrets.

#### delete_space_variable[[huggingface_hub.HfApi.delete_space_variable]]

```python
delete_space_variable(repo_id: str, key: str, token: bool | str | None = None)
```

[Nguồn](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L8210)

**Tham số:**

repo_id (`str`) : ID của kho cần cập nhật. Ví dụ: `"bigcode/in-the-stack"`.

key (`str`) : Khóa biến. Ví dụ: `"MODEL_REPO_ID"`

token (`bool` hoặc `str`, *tùy chọn*) : Một token truy cập người dùng hợp lệ (chuỗi). Mặc định là token được lưu cục bộ, đây là phương pháp xác thực được khuyến nghị (xem https://huggingface.co/docs/huggingface_hub/quick-start#authentication). Để tắt xác thực, truyền `False`.

Xóa một biến khỏi một Space.

Biến cho phép thiết lập các biến môi trường cho một Space mà không cần hardcode chúng. Để biết thêm chi tiết, xem https://huggingface.co/docs/hub/spaces-overview#managing-secrets-and-environment-variables

#### delete_space_volumes[[huggingface_hub.HfApi.delete_space_volumes]]

```python
delete_space_volumes(repo_id: str, token: bool | str | None = None)
```

[Nguồn](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L9108)

**Tham số:**

repo_id (`str`) : ID của Space cần cập nhật. Ví dụ: `"username/my-space"`.

token (`bool` hoặc `str`, *tùy chọn*) : Một token truy cập người dùng hợp lệ (chuỗi). Mặc định là token được lưu cục bộ, đây là phương pháp xác thực được khuyến nghị (xem https://huggingface.co/docs/huggingface_hub/quick-start#authentication). Để tắt xác thực, truyền `False`.

**Lỗi:** `BadRequestError`

- `BadRequestError` -- Nếu Space không có volume nào được gắn.

Xóa tất cả các volume khỏi một Space.

Ví dụ:
```python
>>> from huggingface_hub import HfApi
>>> api = HfApi()
>>> api.delete_space_volumes("username/my-space")
```

#### delete_tag[[huggingface_hub.HfApi.delete_tag]]

```python
delete_tag(repo_id: str, tag: str, token: bool | str | None = None, repo_type: str | None = None)
```

[Nguồn](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L7169)

**Tham số:**

repo_id (`str`) : Kho lưu trữ mà một tag sẽ bị xóa. Ví dụ: `"user/my-cool-model"`.

tag (`str`) : Tên của thẻ cần xóa.

token (`bool` hoặc `str`, *tùy chọn*) : Một token truy cập người dùng hợp lệ (chuỗi). Mặc định là token được lưu cục bộ, đây là phương pháp xác thực được khuyến nghị (xem https://huggingface.co/docs/huggingface_hub/quick-start#authentication). Để tắt xác thực, truyền `False`.

repo_type (`str`, *tùy chọn*) : Đặt thành `"dataset"` hoặc `"space"` nếu gắn thẻ một dataset hoặc space, `None` hoặc `"model"` nếu gắn thẻ một model. Mặc định là `None`.

**Gây ra:** [RepositoryNotFoundError](/docs/huggingface_hub/v2.4.0/vi/package_reference/utilities#huggingface_hub.errors.RepositoryNotFoundError) hoặc [RevisionNotFoundError](/docs/huggingface_hub/v2.4.0/vi/package_reference/utilities#huggingface_hub.errors.RevisionNotFoundError)

- [RepositoryNotFoundError](/docs/huggingface_hub/v2.4.0/vi/package_reference/utilities#huggingface_hub.errors.RepositoryNotFoundError) -- Nếu không tìm thấy kho (lỗi 404): repo_id/repo_type không đúng, kho là riêng tư nhưng chưa xác thực hoặc kho không tồn tại.
- [RevisionNotFoundError](/docs/huggingface_hub/v2.4.0/vi/package_reference/utilities#huggingface_hub.errors.RevisionNotFoundError) -- Nếu không tìm thấy thẻ.

Xóa một thẻ khỏi kho trên Hub.

#### delete_webhook[[huggingface_hub.HfApi.delete_webhook]]

```python
delete_webhook(webhook_id: str, token: bool | str | None = None)
```

[Nguồn](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L11529)

**Tham số:**

webhook_id (`str`) : Định danh duy nhất của webhook cần xóa.

token (`bool` hoặc `str`, *tùy chọn*) : Một token truy cập người dùng hợp lệ (chuỗi). Mặc định là token được lưu cục bộ, đây là phương pháp xác thực được khuyến nghị (xem https://huggingface.co/docs/huggingface_hub/quick-start#authentication). Để tắt xác thực, truyền `False`.

**Trả về:** `None`

Xóa một webhook.

Ví dụ:
```python
>>> from huggingface_hub import delete_webhook
>>> delete_webhook("654bbbc16f2ec14d77f109cc")
```

#### disable_space_dev_mode[[huggingface_hub.HfApi.disable_space_dev_mode]]

```python
disable_space_dev_mode(repo_id: str, token: bool | str | None = None)
```

[Nguồn](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L8497)

**Tham số:**

repo_id (`str`) : ID của Space cần tắt chế độ dev. Ví dụ: `"Salesforce/BLIP2"`.

token (`bool` hoặc `str`, *tùy chọn*) : Một token truy cập người dùng hợp lệ (chuỗi). Mặc định là token được lưu cục bộ, đây là phương pháp xác thực được khuyến nghị (xem https://huggingface.co/docs/huggingface_hub/quick-start#authentication). Để tắt xác thực, truyền `False`.

**Trả về:** [SpaceRuntime](/docs/huggingface_hub/v2.4.0/vi/package_reference/space_runtime#huggingface_hub.SpaceRuntime)

Thông tin thời gian chạy về Space của bạn.

**Gây ra:** [RepositoryNotFoundError](/docs/huggingface_hub/v2.4.0/vi/package_reference/utilities#huggingface_hub.errors.RepositoryNotFoundError) hoặc [HfHubHTTPError](/docs/huggingface_hub/v2.4.0/vi/package_reference/utilities#huggingface_hub.errors.HfHubHTTPError) hoặc [BadRequestError](/docs/huggingface_hub/v2.4.0/vi/package_reference/utilities#huggingface_hub.errors.BadRequestError)

- [RepositoryNotFoundError](/docs/huggingface_hub/v2.4.0/vi/package_reference/utilities#huggingface_hub.errors.RepositoryNotFoundError) -- Nếu Space của bạn không được tìm thấy (lỗi 404). Khả năng cao là repo_id sai hoặc Space của bạn là riêng tư nhưng bạn chưa xác thực.
- [HfHubHTTPError](/docs/huggingface_hub/v2.4.0/vi/package_reference/utilities#huggingface_hub.errors.HfHubHTTPError) -- 403 Forbidden: chỉ chủ sở hữu của một Space mới có thể đặt chế độ dev. Nếu bạn muốn xử lý một Space mà bạn không sở hữu, hãy yêu cầu chủ sở hữu bằng cách mở một Discussion hoặc nhân bản Space đó.
- [BadRequestError](/docs/huggingface_hub/v2.4.0/vi/package_reference/utilities#huggingface_hub.errors.BadRequestError) -- Nếu Space của bạn là một static Space. Các static Space luôn ở trạng thái chạy và không bao giờ bị tính phí. Nếu bạn muốn ẩn một static Space, bạn có thể đặt nó ở chế độ private.

Tắt chế độ dev trên một Space.

Spaces Dev Mode giúp việc gỡ lỗi ứng dụng của bạn trở nên dễ dàng hơn và rút ngắn thời gian lặp lại trên Spaces bằng cách cho phép bạn khởi động lại ứng dụng mà không cần dừng container của Space. Việc bật dev mode yêu cầu gói PRO hoặc Team & Enterprise, nhưng việc tắt nó luôn được cho phép (ví dụ: sau khi đăng ký hết hạn). Xem https://huggingface.co/docs/hub/spaces-dev-mode để biết thêm chi tiết.

#### disable_webhook[[huggingface_hub.HfApi.disable_webhook]]

```python
disable_webhook(webhook_id: str, token: bool | str | None = None)
```

[Nguồn](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L11476)

**Tham số:**

webhook_id (`str`) : Định danh duy nhất của webhook cần vô hiệu hóa.

token (`bool` hoặc `str`, *tùy chọn*) : Một token truy cập người dùng hợp lệ (chuỗi). Mặc định là token được lưu cục bộ, đây là phương pháp xác thực được khuyến nghị (xem https://huggingface.co/docs/huggingface_hub/quick-start#authentication). Để tắt xác thực, truyền `False`.

**Trả về:** [WebhookInfo](/docs/huggingface_hub/v2.4.0/vi/package_reference/hf_api#huggingface_hub.WebhookInfo)

Thông tin về webhook đã bị vô hiệu hóa.

Tắt một webhook (đặt nó ở trạng thái "tắt").

Ví dụ:
```python
>>> from huggingface_hub import disable_webhook
>>> disabled_webhook = disable_webhook("654bbbc16f2ec14d77f109cc")
>>> disabled_webhook
WebhookInfo(
    id="654bbbc16f2ec14d77f109cc",
    url="https://webhook.site/a2176e82-5720-43ee-9e06-f91cb4c91548",
    jon=None,
    watched=[WebhookWatchedItem(type="user", name="julien-c"), WebhookWatchedItem(type="org", name="HuggingFaceH4")],
    domains=["repo", "discussion"],
    secret="my-secret",
    disabled=True,
)
```

#### download_bucket_files[[huggingface_hub.HfApi.download_bucket_files]]

```python
download_bucket_files(bucket_id: str, files: list[tuple[str | BucketFile, str | Path]], raise_on_missing_files: bool = False, token: str | bool | None = None)
```

[Nguồn](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L15069)

**Tham số:**

bucket_id (`str`) : ID của bucket (ví dụ: `"username/my-bucket"`).

files (`list[tuple[Union[str, BucketFile], Union[str, Path]]]`) : Các tệp cần tải xuống dưới dạng danh sách các tuple (nguồn, đích). Xem mô tả ở trên để biết chi tiết về định dạng.

raise_on_missing_files (`bool`, *optional*) : Nếu `True`, sẽ gây ra `EntryNotFoundError` khi tệp được yêu cầu không tồn tại trong bucket. Nếu `False` (mặc định), các tệp thiếu sẽ bị bỏ qua kèm theo cảnh báo.

token (`bool` hoặc `str`, *tùy chọn*) : Một token truy cập người dùng hợp lệ (chuỗi). Mặc định là token được lưu cục bộ, đây là phương pháp xác thực được khuyến nghị (xem https://huggingface.co/docs/huggingface_hub/quick-start#authentication). Để tắt xác thực, truyền `False`.

Tải tệp từ một bucket.

Files input là một danh sách các tuple `(remote file, local file)` trong đó `remote file` là đường dẫn của tệp trong bucket hoặc một đối tượng [BucketFile](/docs/huggingface_hub/v2.4.0/vi/package_reference/hf_api#huggingface_hub.BucketFile), và `local file` là đường dẫn đích trên hệ thống tệp cục bộ. Khi truyền một đối tượng [BucketFile](/docs/huggingface_hub/v2.4.0/vi/package_reference/hf_api#huggingface_hub.BucketFile) (lấy từ [list_bucket_tree()](/docs/huggingface_hub/v2.4.0/vi/package_reference/hf_api#huggingface_hub.HfApi.list_bucket_tree)), phương thức sẽ bỏ qua bước lấy metadata và tải trực tiếp các tệp xuống.

Ví dụ:
```python
>>> from huggingface_hub import download_bucket_files

>>> download_bucket_files(
...     bucket_id="username/my-bucket",
...     files=[
...         ("models/model.safetensors", "./local/model.safetensors"),
...         ("config.json", "./local/config.json"),
...     ],
... )
```

```python
>>> from huggingface_hub import download_bucket_files

>>> parquet_files = [file for file in list_bucket_tree(bucket_id="username/my-bucket") if file.path.endswith(".parquet")]
>>> download_bucket_files(
...     bucket_id="username/my-bucket",
...     files=[(file, f"./local/{file.path}") for file in parquet_files],
... )
```

#### duplicate_repo[[huggingface_hub.HfApi.duplicate_repo]]

```python
duplicate_repo(from_id: str, to_id: str | None = None, repo_type: str | None = None, private: bool | None = None, visibility: RepoVisibility_T | None = None, token: bool | str | None = None, exist_ok: bool = False, resource_group_id: str | None = None, space_hardware: SpaceHardware | None = None, space_sleep_time: int | None = None, space_secrets: list[dict[str, str]] | None = None, space_variables: list[dict[str, str]] | None = None, space_volumes: list[Volume] | None = None)
```

[Nguồn](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L8863)

**Tham số:**

from_id (`str`) : ID của kho cần nhân bản. Ví dụ: `"openai/gdpval"`.

to_id (`str`, *tùy chọn*) : ID của kho mới. Ví dụ: `"myorg/my-gdpval"`. Nếu không được cung cấp, kho mới sẽ có cùng tên với kho gốc, nhưng trong tài khoản của bạn.

repo_type (`str`, *tùy chọn*) : Đặt thành `"dataset"` hoặc `"space"` nếu nhân bản một dataset hoặc Space, `None` hoặc `"model"` nếu nhân bản một model. Mặc định là `None`.

private (`bool`, *tùy chọn*) : Xác định xem kho mới có nên là riêng tư hay không. Mặc định là cùng mức độ riêng tư với kho gốc. Không thể truyền cùng với `visibility`.

visibility (`Literal["public", "private", "protected"]`, *tùy chọn*) : Mức độ hiển thị của kho mới. Có thể là `"public"` hoặc `"private"`, hoặc `"protected"` đối với Spaces. Mặc định là cùng mức độ hiển thị với kho gốc.

token (`bool` hoặc `str`, *tùy chọn*) : Một token truy cập người dùng hợp lệ (chuỗi). Mặc định là token được lưu cục bộ, đây là phương pháp xác thực được khuyến nghị (xem https://huggingface.co/docs/huggingface_hub/quick-start#authentication). Để tắt xác thực, truyền `False`.

exist_ok (`bool`, *tùy chọn*, mặc định là `False`) : Nếu `True`, không gây ra lỗi nếu kho đã tồn tại.

resource_group_id (`str`, *tùy chọn*) : Nhóm tài nguyên để tạo kho mới. Nhóm tài nguyên chỉ khả dụng cho các tổ chức Enterprise Hub và cho phép xác định thành viên nào trong tổ chức có thể truy cập tài nguyên. ID của nhóm tài nguyên có thể tìm thấy trong URL của trang tài nguyên trên Hub (ví dụ: `"66670e5163145ca562cb1988"`). Để tìm hiểu thêm về nhóm tài nguyên, xem https://huggingface.co/docs/hub/en/security-resource-groups.

space_hardware (`SpaceHardware` hoặc `str`, *tùy chọn*) : Lựa chọn phần cứng nếu repo_type là "space". Ví dụ: `"t4-medium"`. Xem [SpaceHardware](/docs/huggingface_hub/v2.4.0/vi/package_reference/space_runtime#huggingface_hub.SpaceHardware) để biết danh sách đầy đủ.

space_sleep_time (`int`, *optional*) : Số giây không hoạt động cần chờ trước khi một Space được đưa vào trạng thái ngủ. Đặt thành `-1` nếu bạn không muốn Space của mình ngủ (hành vi mặc định cho phần cứng đã nâng cấp). Đối với phần cứng miễn phí, bạn không thể cấu hình thời gian ngủ (giá trị được cố định ở mức 48 giờ không hoạt động). Chỉ áp dụng nếu repo_type là "space". Xem https://huggingface.co/docs/hub/spaces-gpus#sleep-time để biết thêm chi tiết.

space_secrets (`list[dict[str, str]]`, *tùy chọn*) : Một danh sách các khóa bí mật cần thiết lập trong Space của bạn. Mỗi mục có dạng `{"key": ..., "value": ..., "description": ...}` trong đó description là tùy chọn. Chỉ áp dụng nếu repo_type là "space". Để biết thêm chi tiết, xem https://huggingface.co/docs/hub/spaces-overview#managing-secrets.

space_variables (`list[dict[str, str]]`, *tùy chọn*) : Một danh sách các biến môi trường công khai để thiết lập trong Space của bạn. Mỗi mục có dạng `{"key": ..., "value": ..., "description": ...}` trong đó description là tùy chọn. Chỉ áp dụng nếu repo_type là "space". Để biết thêm chi tiết, xem https://huggingface.co/docs/hub/spaces-overview#managing-secrets-and-environment-variables.

space_volumes (`list[Volume]`, *tùy chọn*) : Một danh sách các đối tượng [Volume](/docs/huggingface_hub/v2.4.0/vi/package_reference/jobs#huggingface_hub.Volume) để gắn vào Space tại thời điểm nhân bản. Mỗi volume có một `type` (`"bucket"`, `"model"`, `"dataset"` hoặc `"space"`), một `source` (ID của repo hoặc bucket), một `mount_path` (đường dẫn bên trong container), và các trường tùy chọn `revision`, `read_only` và `path`. Chỉ áp dụng nếu repo_type là "space".

**Trả về:** [DuplicatedRepoUrl](/docs/huggingface_hub/v2.4.0/vi/package_reference/hf_api#huggingface_hub.DuplicatedRepoUrl)

URL của kho vừa được tạo. Giá trị là một lớp con của [RepoUrl](/docs/huggingface_hub/v2.4.0/vi/package_reference/hf_api#huggingface_hub.RepoUrl) (và của `str`) chứa các thuộc tính như `endpoint`, `repo_type`, `repo_id` và `files_copy_pending`.

**Lỗi:** [RepositoryNotFoundError](/docs/huggingface_hub/v2.4.0/vi/package_reference/utilities#huggingface_hub.errors.RepositoryNotFoundError) hoặc `HfHubHTTPError`

- [RepositoryNotFoundError](/docs/huggingface_hub/v2.4.0/vi/package_reference/utilities#huggingface_hub.errors.RepositoryNotFoundError) -- Nếu một trong `from_id` hoặc `to_id` không thể được tìm thấy. Điều này có thể là do nó không tồn tại, hoặc do nó được đặt ở chế độ `private` và bạn không có quyền truy cập.
- `HfHubHTTPError` -- Nếu API HuggingFace trả về một lỗi

Nhân bản một kho trên Hub (mô hình, bộ dữ liệu hoặc Space).

Thao tác này thực hiện sao chép phía máy chủ, giữ nguyên toàn bộ lịch sử git và các đối tượng LFS mà không yêu cầu vòng lặp tải xuống/tải lên cục bộ.

Lịch sử git được sao chép ngay lập tức, nhưng các tệp LFS/Xet có thể vẫn đang được sao chép ở chế độ nền sau khi phương thức này trả về. Trong trường hợp đó, `files_copy_pending` có giá trị `True` trong giá trị trả về và việc tải các tệp này từ kho mới có thể thất bại cho đến khi quá trình sao chép hoàn tất.

Ví dụ:
```python
>>> from huggingface_hub import duplicate_repo

# Duplicate a model to your account
>>> repo_url = duplicate_repo("google/gemma-7b")
>>> repo_url
RepoUrl('https://huggingface.co/nateraw/gemma-7b',...)
>>> repo_url.files_copy_pending
True

# Duplicate a dataset with a custom name
>>> duplicate_repo("openai/gdpval", to_id="myorg/my-gdpval", repo_type="dataset")
RepoUrl('https://huggingface.co/datasets/myorg/my-gdpval',...)

# Duplicate a Space with custom hardware
>>> duplicate_repo("multimodalart/dreambooth-training", repo_type="space", space_hardware="t4-medium")
RepoUrl('https://huggingface.co/spaces/nateraw/dreambooth-training',...)
```

#### edit_discussion_comment[[huggingface_hub.HfApi.edit_discussion_comment]]

```python
edit_discussion_comment(repo_id: str, discussion_num: int, comment_id: str, new_content: str, token: bool | str | None = None, repo_type: str | None = None)
```

[Nguồn](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L7883)

**Tham số:**

repo_id (`str`) : Một namespace (người dùng hoặc tổ chức) và tên kho, được phân tách bằng `/`.

discussion_num (`int`) : Số thứ tự của Discussion hoặc Pull Request. Phải là một số nguyên dương.

comment_id (`str`) : ID của bình luận cần chỉnh sửa.

new_content (`str`) : Nội dung mới của bình luận. Bình luận hỗ trợ định dạng markdown.

repo_type (`str`, *tùy chọn*) : Đặt thành `"dataset"` hoặc `"space"` nếu tải lên một dataset hoặc space, `None` hoặc `"model"` nếu tải lên một model. Mặc định là `None`.

token (`bool` hoặc `str`, *tùy chọn*) : Một token truy cập người dùng hợp lệ (chuỗi). Mặc định là token được lưu cục bộ, đây là phương pháp xác thực được khuyến nghị (xem https://huggingface.co/docs/huggingface_hub/quick-start#authentication). Để tắt xác thực, truyền `False`.

**Trả về:** [DiscussionComment](/docs/huggingface_hub/v2.4.0/vi/package_reference/community#huggingface_hub.DiscussionComment)

bình luận đã chỉnh sửa

Chỉnh sửa một bình luận trên Discussion / Pull Request.

> [!TIP]
> Gây ra các lỗi sau:
>
> - [`HTTPError`](https://requests.readthedocs.io/en/latest/api/#requests.HTTPError) nếu API HuggingFace trả về lỗi - [`ValueError`](https://docs.python.org/3/library/exceptions.html#ValueError) nếu giá trị của một số tham số không hợp lệ - [RepositoryNotFoundError](/docs/huggingface_hub/v2.4.0/vi/package_reference/utilities#huggingface_hub.errors.RepositoryNotFoundError) Nếu không tìm thấy kho cần tải xuống. Điều này có thể do kho không tồn tại, hoặc do kho được đặt ở chế độ `private` và bạn không có quyền truy cập.

#### enable_space_dev_mode[[huggingface_hub.HfApi.enable_space_dev_mode]]

```python
enable_space_dev_mode(repo_id: str, token: bool | str | None = None)
```

[Nguồn](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L8458)

**Tham số:**

repo_id (`str`) : ID của Space cần bật chế độ dev. Ví dụ: `"Salesforce/BLIP2"`.

token (`bool` hoặc `str`, *tùy chọn*) : Một token truy cập người dùng hợp lệ (chuỗi). Mặc định là token được lưu cục bộ, đây là phương pháp xác thực được khuyến nghị (xem https://huggingface.co/docs/huggingface_hub/quick-start#authentication). Để tắt xác thực, truyền `False`.

**Trả về:** [SpaceRuntime](/docs/huggingface_hub/v2.4.0/vi/package_reference/space_runtime#huggingface_hub.SpaceRuntime)

Thông tin thời gian chạy về Space của bạn.

**Gây ra:** [RepositoryNotFoundError](/docs/huggingface_hub/v2.4.0/vi/package_reference/utilities#huggingface_hub.errors.RepositoryNotFoundError) hoặc [HfHubHTTPError](/docs/huggingface_hub/v2.4.0/vi/package_reference/utilities#huggingface_hub.errors.HfHubHTTPError) hoặc [BadRequestError](/docs/huggingface_hub/v2.4.0/vi/package_reference/utilities#huggingface_hub.errors.BadRequestError)

- [RepositoryNotFoundError](/docs/huggingface_hub/v2.4.0/vi/package_reference/utilities#huggingface_hub.errors.RepositoryNotFoundError) -- Nếu Space của bạn không được tìm thấy (lỗi 404). Khả năng cao là repo_id sai hoặc Space của bạn là riêng tư nhưng bạn chưa xác thực.
- [HfHubHTTPError](/docs/huggingface_hub/v2.4.0/vi/package_reference/utilities#huggingface_hub.errors.HfHubHTTPError) -- 403 Forbidden: chỉ chủ sở hữu của một Space mới có thể đặt chế độ dev. Nếu bạn muốn xử lý một Space mà bạn không sở hữu, hãy yêu cầu chủ sở hữu bằng cách mở một Discussion hoặc nhân bản Space đó.
- [BadRequestError](/docs/huggingface_hub/v2.4.0/vi/package_reference/utilities#huggingface_hub.errors.BadRequestError) -- Nếu Space của bạn là một static Space. Các static Space luôn ở trạng thái chạy và không bao giờ bị tính phí. Nếu bạn muốn ẩn một static Space, bạn có thể đặt nó ở chế độ private.

Bật chế độ dev trên một Space.

Spaces Dev Mode giúp việc gỡ lỗi ứng dụng của bạn trở nên dễ dàng hơn và rút ngắn thời gian lặp lại trên Spaces bằng cách cho phép bạn khởi động lại ứng dụng mà không cần dừng container của Space. Tính năng này có sẵn như một phần của gói PRO hoặc Team & Enterprise. Xem https://huggingface.co/docs/hub/spaces-dev-mode để biết thêm chi tiết.

#### enable_webhook[[huggingface_hub.HfApi.enable_webhook]]

```python
enable_webhook(webhook_id: str, token: bool | str | None = None)
```

[Nguồn](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L11423)

**Tham số:**

webhook_id (`str`) : Định danh duy nhất của webhook cần bật.

token (`bool` hoặc `str`, *tùy chọn*) : Một token truy cập người dùng hợp lệ (chuỗi). Mặc định là token được lưu cục bộ, đây là phương pháp xác thực được khuyến nghị (xem https://huggingface.co/docs/huggingface_hub/quick-start#authentication). Để tắt xác thực, truyền `False`.

**Trả về:** [WebhookInfo](/docs/huggingface_hub/v2.4.0/vi/package_reference/hf_api#huggingface_hub.WebhookInfo)

Thông tin về webhook được bật.

Bật webhook (khiến nó "hoạt động").

Ví dụ:
```python
>>> from huggingface_hub import enable_webhook
>>> enabled_webhook = enable_webhook("654bbbc16f2ec14d77f109cc")
>>> enabled_webhook
WebhookInfo(
    id="654bbbc16f2ec14d77f109cc",
    job=None,
    url="https://webhook.site/a2176e82-5720-43ee-9e06-f91cb4c91548",
    watched=[WebhookWatchedItem(type="user", name="julien-c"), WebhookWatchedItem(type="org", name="HuggingFaceH4")],
    domains=["repo", "discussion"],
    secret="my-secret",
    disabled=False,
)
```

#### fetch_job_logs[[huggingface_hub.HfApi.fetch_job_logs]]

```python
fetch_job_logs(job_id: str, namespace: str | None = None, follow: bool = False, tail: int | None = None, token: bool | str | None = None)
```

[Nguồn](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L12327)

**Tham số:**

job_id (`str`) : ID của Job.

namespace (`str`, *tùy chọn*) : Không gian tên nơi Job đang chạy. Mặc định là không gian tên của người dùng hiện tại.

follow (`bool`, *tuỳ chọn*) : Nếu `True`, sẽ phát trực tiếp nhật ký theo thời gian thực cho đến khi công việc hoàn tất (chặn). Nếu `False` (mặc định), chỉ lấy các nhật ký hiện có và trả về ngay lập tức (không chặn).

tail (`int`, *optional*) : Số dòng tối đa cần trả về từ nhật ký. Khi kết hợp với `follow=True`, bắt đầu từ N dòng cuối và tiếp tục phát trực tiếp các nhật ký mới. Khi `follow=False`, chỉ trả về N dòng cuối từ các nhật ký hiện có.

token (`bool` hoặc `str`, *tùy chọn*) : Một token truy cập người dùng hợp lệ. Nếu không được cung cấp, token được lưu cục bộ sẽ được sử dụng, đây là phương thức xác thực được khuyến nghị. Đặt thành `False` để tắt xác thực. Tham khảo: https://huggingface.co/docs/huggingface_hub/quick-start#authentication.

Lấy tất cả các nhật ký từ một Job tính toán trên hạ tầng của Hugging Face.

Ví dụ:

```python
>>> from huggingface_hub import fetch_job_logs, run_job
>>> job = run_job(image="python:3.12", command=["python", "-c" ,"print('Hello from HF compute!')"])
>>> for log in fetch_job_logs(job_id=job.id):
...     print(log)
Hello from HF compute!

>>> # Non-blocking: fetch only currently available logs
>>> for log in fetch_job_logs(job_id=job.id, follow=False):
...     print(log)

>>> # Stream logs starting from the last 100 lines
>>> for log in fetch_job_logs(job_id=job.id, follow=True, tail=100):
...     print(log)
```

#### fetch_job_metrics[[huggingface_hub.HfApi.fetch_job_metrics]]

```python
fetch_job_metrics(job_id: str, namespace: str | None = None, follow: bool = False, token: bool | str | None = None)
```

[Nguồn](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L12407)

**Tham số:**

job_id (`str`) : ID của Job.

namespace (`str`, *tùy chọn*) : Không gian tên nơi Job đang chạy. Mặc định là không gian tên của người dùng hiện tại.

follow (`bool`, *tuỳ chọn*) : Nếu `True`, truyền trực tiếp các chỉ số theo thời gian thực cho đến khi công việc hoàn tất (chặn). Nếu `False` (mặc định), chỉ lấy các chỉ số hiện tại và trả về (không chặn).

token (`bool` hoặc `str`, *tùy chọn*) : Một token truy cập người dùng hợp lệ. Nếu không được cung cấp, token được lưu cục bộ sẽ được sử dụng, đây là phương thức xác thực được khuyến nghị. Đặt thành `False` để tắt xác thực. Tham khảo: https://huggingface.co/docs/huggingface_hub/quick-start#authentication.

Lấy các chỉ số trực tiếp từ một Job tính toán trên hạ tầng của Hugging Face.

Ví dụ:

```python
>>> from huggingface_hub import fetch_job_metrics, run_job
>>> job = run_job(image="python:3.12", command=["python", "-c" ,"print('Hello from HF compute!')"], flavor="a10g-small")
>>> for metrics in fetch_job_metrics(job_id=job.id):
...     print(metrics)
{
    "cpu_usage_pct": 0,
    "cpu_millicores": 3500,
    "memory_used_bytes": 1306624,
    "memory_total_bytes": 15032385536,
    "rx_bps": 0,
    "tx_bps": 0,
    "gpus": {
        "882fa930": {
            "utilization": 0,
            "memory_used_bytes": 0,
            "memory_total_bytes": 22836000000
        }
    },
    "replica": "57vr7"
}

>>> # Stream metrics until the job completes
>>> for metrics in fetch_job_metrics(job_id=job.id, follow=True):
...     print(metrics)
```

#### fetch_space_logs[[huggingface_hub.HfApi.fetch_space_logs]]

```python
fetch_space_logs(repo_id: str, build: bool = False, follow: bool = False, token: bool | str | None = None)
```

[Nguồn](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L8737)

**Tham số:**

repo_id (`str`) : ID của Space. Ví dụ: `"bigcode/in-the-stack"`.

build (`bool`, *tuỳ chọn*, mặc định là `False`) : Nếu `True`, lấy nhật ký xây dựng container (hữu ích khi một Space bị kẹt ở `BUILD_ERROR`). Nếu `False` (mặc định), lấy nhật ký chạy, tức là stdout/stderr của ứng dụng đang chạy.

follow (`bool`, *tùy chọn*, mặc định là `False`) : Nếu `True`, phát trực tiếp nhật ký theo thời gian thực (chặn) cho đến khi máy chủ đóng luồng hoặc `KeyboardInterrupt` được ném ra. Nếu `False` (mặc định), chỉ lấy các nhật ký đang được đệm và trả về ngay lập tức (không chặn, giống như `docker logs`).

token (`bool` hoặc `str`, *tùy chọn*) : Một token truy cập người dùng hợp lệ. Mặc định là token được lưu cục bộ, đây là phương thức xác thực được khuyến nghị. Đặt thành `False` để tắt xác thực. Xem https://huggingface.co/docs/huggingface_hub/quick-start#authentication.

**Trả về:** `Iterable[str]`

Một trình tạo (generator) trả về các dòng nhật ký khi chúng có sẵn.

Lấy nhật ký chạy hoặc nhật ký build của một Space trên Hub.

Hữu ích để gỡ lỗi một Space đang gặp lỗi khi build hoặc bị crash khi chạy, đặc biệt là từ một script hoặc quy trình làm việc dạng agentic, nơi việc đọc log trong trình duyệt không khả thi.

Ví dụ:

```python
>>> from huggingface_hub import fetch_space_logs
>>> # Non-blocking: print currently available run logs and exit.
>>> for line in fetch_space_logs("username/my-space"):
...     print(line, end="")

>>> # Debug a build failure:
>>> for line in fetch_space_logs("username/my-space", build=True):
...     print(line, end="")

>>> # Stream run logs until the server closes the stream.
>>> for line in fetch_space_logs("username/my-space", follow=True):
...     print(line, end="")
```

#### file_exists[[huggingface_hub.HfApi.file_exists]]

```python
file_exists(repo_id: str, filename: str, repo_type: str | None = None, revision: str | None = None, token: str | bool | None = None)
```

[Nguồn](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L3768)

**Tham số:**

repo_id (`str`) : Một namespace (người dùng hoặc tổ chức) và tên kho, được phân tách bằng `/`.

filename (`str`) : Tên của tệp cần kiểm tra, ví dụ: `"config.json"`

repo_type (`str`, *tùy chọn*) : Đặt thành `"dataset"` hoặc `"space"` nếu lấy thông tin kho từ một dataset hoặc một space, `None` hoặc `"model"` nếu lấy thông tin kho từ một model. Mặc định là `None`.

revision (`str`, *tùy chọn*) : Phiên bản của kho chứa mà từ đó lấy thông tin. Mặc định là nhánh `"main"`.

token (`bool` hoặc `str`, *tùy chọn*) : Một token truy cập người dùng hợp lệ (chuỗi). Mặc định là token được lưu cục bộ, đây là phương pháp xác thực được khuyến nghị (xem https://huggingface.co/docs/huggingface_hub/quick-start#authentication). Để tắt xác thực, truyền `False`.

**Trả về:**

True nếu tệp tồn tại, False nếu không.

Kiểm tra xem một tệp có tồn tại trong một kho trên Hugging Face Hub hay không.

Ví dụ:
```py
>>> from huggingface_hub import file_exists
>>> file_exists("bigcode/starcoder", "config.json")
True
>>> file_exists("bigcode/starcoder", "not-a-file")
False
>>> file_exists("bigcode/not-a-repo", "config.json")
False
```

#### get_bucket_file_metadata[[huggingface_hub.HfApi.get_bucket_file_metadata]]

```python
get_bucket_file_metadata(bucket_id: str, remote_path: str, token: str | bool | None = None)
```

[Nguồn](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L15010)

**Tham số:**

bucket_id (`str`) : ID của bucket (ví dụ: `"username/my-bucket"`).

remote_path (`str`) : Đường dẫn của tệp trong bucket.

token (`bool` hoặc `str`, *tùy chọn*) : Một token truy cập người dùng hợp lệ (chuỗi). Mặc định là token được lưu cục bộ, đây là phương pháp xác thực được khuyến nghị (xem https://huggingface.co/docs/huggingface_hub/quick-start#authentication). Để tắt xác thực, truyền `False`.

**Trả về:** [BucketFileMetadata](/docs/huggingface_hub/v2.4.0/vi/package_reference/hf_api#huggingface_hub.BucketFileMetadata)

Tệp metadata chứa thông tin về kích thước và xet.

Lấy metadata của một tệp trong bucket.

Ví dụ:
```python
>>> from huggingface_hub import get_bucket_file_metadata
>>> metadata = get_bucket_file_metadata(
...     bucket_id="username/my-bucket",
...     remote_path="models/model.safetensors",
... )
>>> metadata.size
42000
```

#### get_bucket_paths_info[[huggingface_hub.HfApi.get_bucket_paths_info]]

```python
get_bucket_paths_info(bucket_id: str, paths: Iterable[str], token: str | bool | None = None)
```

[Nguồn](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L14356)

**Tham số:**

bucket_id (`str`) : ID của bucket (ví dụ: `"username/my-bucket"`).

paths (`Iterable[str]`) : Các đường dẫn để lấy thông tin. Nếu một đường dẫn không tồn tại, nó sẽ bị bỏ qua mà không gây ra ngoại lệ. Chỉ hỗ trợ đường dẫn tệp.

token (`bool` hoặc `str`, *tùy chọn*) : Một token truy cập người dùng hợp lệ (chuỗi). Mặc định là token được lưu cục bộ, đây là phương pháp xác thực được khuyến nghị (xem https://huggingface.co/docs/huggingface_hub/quick-start#authentication). Để tắt xác thực, truyền `False`.

**Trả về:** `Iterable[BucketFile]`

Thông tin về các đường dẫn, dưới dạng một đối tượng lặp được của các đối tượng [BucketFile](/docs/huggingface_hub/v2.4.0/vi/package_reference/hf_api#huggingface_hub.BucketFile).

Lấy thông tin về các đường dẫn của một bucket.

Các cuộc gọi được thực hiện theo các lô gồm 1000 đường dẫn. Kết quả được trả về ngay khi nhận được.

Ví dụ:
```py
>>> from huggingface_hub import get_bucket_paths_info
>>> paths_info = get_bucket_paths_info("username/my-bucket", ["file.txt", "checkpoints/model.safetensors"])
>>> for info in paths_info:
...     print(info)
BucketFile(type='file', path='file.txt', size=2379, xet_hash='96e637d9665bd35477b1908a23f2e254edfba0618dbd2d62f90a6baee7d139cf', mtime=datetime.datetime(2024, 9, 25, 15, 31, 2, 346000, tzinfo=datetime.timezone.utc))
BucketFile(type='file', path='checkpoints/model.safetensors', size=2408828, xet_hash='3ed0e9fefe788ddd61d1e26eba67057e9740a064b009256fbafadf6bb95785ca', mtime=datetime.datetime(2024, 9, 25, 15, 31, 2, 346000, tzinfo=datetime.timezone.utc))
```

#### get_collection[[huggingface_hub.HfApi.get_collection]]

```python
get_collection(collection_slug: str, token: bool | str | None = None)
```

[Nguồn](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L10152)

**Tham số:**

collection_slug (`str`) : Slug của bộ sưu tập trên Hub. Ví dụ: `"TheBloke/recent-models-64f9a55bb3115b4f513ec026"`.

token (`bool` hoặc `str`, *tùy chọn*) : Một token truy cập người dùng hợp lệ (chuỗi). Mặc định là token được lưu cục bộ, đây là phương pháp xác thực được khuyến nghị (xem https://huggingface.co/docs/huggingface_hub/quick-start#authentication). Để tắt xác thực, truyền `False`.

Lấy thông tin về một Collection trên Hub.

Trả về: [Collection](/docs/huggingface_hub/v2.4.0/vi/package_reference/collections#huggingface_hub.Collection)

Ví dụ:

```py
>>> from huggingface_hub import get_collection
>>> collection = get_collection("TheBloke/recent-models-64f9a55bb3115b4f513ec026")
>>> collection.title
'Recent models'
>>> len(collection.items)
37
>>> collection.items[0]
CollectionItem(
    item_object_id='651446103cd773a050bf64c2',
    item_id='TheBloke/U-Amethyst-20B-AWQ',
    item_type='model',
    position=88,
    note=None
)
```

#### get_dataset_leaderboard[[huggingface_hub.HfApi.get_dataset_leaderboard]]

```python
get_dataset_leaderboard(repo_id: str, base_model_only: bool | None = None, token: bool | str | None = None, timeout: float | None = None)
```

[Nguồn](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L3289)

**Tham số:**

repo_id (`str`) : Một namespace (người dùng hoặc tổ chức) và tên kho, phân tách bằng `/`. Ví dụ: `"allenai/olmOCR-bench"`.

base_model_only (`bool` hoặc `None`, *tùy chọn*) : Mặc định, bảng xếp hạng chỉ bao gồm các model không có quan hệ `base_model` được khai báo (tức là các repo gốc/canonical), khớp với chế độ xem bảng xếp hạng mặc định của Hub. Các repo được fine-tune hoặc dẫn xuất có khai báo model cha sẽ bị loại. Truyền `base_model_only=False` để tắt bộ lọc này và bao gồm mọi kết quả đã gửi, bất kể model có khai báo quan hệ base model hay không.

token (`bool` hoặc `str`, *tùy chọn*) : Một token truy cập người dùng hợp lệ. Mặc định là token được lưu cục bộ, đây là phương pháp xác thực được khuyến nghị (xem https://huggingface.co/docs/huggingface_hub/quick-start#authentication). Để tắt xác thực, truyền `False`.

timeout (`float`, *optional*) : Có nên đặt thời gian chờ (timeout) cho yêu cầu đến Hub hay không.

**Trả về:** `list[DatasetLeaderboardEntry]`

Một danh sách các đối tượng [DatasetLeaderboardEntry](/docs/huggingface_hub/v2.4.0/vi/package_reference/hf_api#huggingface_hub.DatasetLeaderboardEntry) đại diện cho các mục trên bảng xếp hạng, được sắp xếp theo thứ hạng.

Lấy bảng xếp hạng cho một bộ dữ liệu trên Hub.

Bảng xếp hạng sắp xếp các mô hình dựa trên điểm đánh giá của chúng trên bộ dữ liệu chuẩn được chỉ định. Không phải tất cả các bộ dữ liệu đều có bảng xếp hạng — chỉ những bộ dữ liệu chuẩn có kết quả đánh giá được gửi đến mới có. Điều này cung cấp góc nhìn tập trung vào bộ dữ liệu về các điểm số; để có góc nhìn tập trung vào mô hình, hãy sử dụng [model_info()](/docs/huggingface_hub/v2.4.0/vi/package_reference/hf_api#huggingface_hub.HfApi.model_info) với `expand=["evalResults"]`.

> [!TIP]
> Gây ra các lỗi sau:
>
> - [RepositoryNotFoundError](/docs/huggingface_hub/v2.4.0/vi/package_reference/utilities#huggingface_hub.errors.RepositoryNotFoundError) Nếu không tìm thấy kho lưu trữ. Điều này có thể do kho không tồn tại, hoặc do kho được đặt ở chế độ `private` và bạn không có quyền truy cập. - [HfHubHTTPError](/docs/huggingface_hub/v2.4.0/vi/package_reference/utilities#huggingface_hub.errors.HfHubHTTPError) Nếu bộ dữ liệu không có bảng xếp hạng.

Ví dụ:
```python
>>> from huggingface_hub import HfApi
>>> api = HfApi()
>>> leaderboard = api.get_dataset_leaderboard("allenai/olmOCR-bench")
>>> leaderboard[0].model_id
'datalab-to/chandra-ocr-2'
>>> leaderboard[0].rank
1

# Include fine-tuned / derivative models too
>>> full_leaderboard = api.get_dataset_leaderboard("allenai/olmOCR-bench", base_model_only=False)
```

#### get_dataset_tags[[huggingface_hub.HfApi.get_dataset_tags]]

```python
get_dataset_tags()
```

[Nguồn](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L2301)

Liệt kê tất cả các thẻ (tags) hợp lệ của bộ dữ liệu dưới dạng một đối tượng namespace lồng nhau.

#### get_discussion_details[[huggingface_hub.HfApi.get_discussion_details]]

```python
get_discussion_details(repo_id: str, discussion_num: int, repo_type: str | None = None, token: bool | str | None = None)
```

[Nguồn](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L7364)

**Tham số:**

repo_id (`str`) : Một namespace (người dùng hoặc tổ chức) và tên kho, được phân tách bằng `/`.

discussion_num (`int`) : Số thứ tự của Discussion hoặc Pull Request. Phải là một số nguyên dương.

repo_type (`str`, *tùy chọn*) : Đặt thành `"dataset"` hoặc `"space"` nếu tải lên một dataset hoặc space, `None` hoặc `"model"` nếu tải lên một model. Mặc định là `None`.

token (`bool` hoặc `str`, *tùy chọn*) : Một token truy cập người dùng hợp lệ (chuỗi). Mặc định là token được lưu cục bộ, đây là phương pháp xác thực được khuyến nghị (xem https://huggingface.co/docs/huggingface_hub/quick-start#authentication). Để tắt xác thực, truyền `False`.

Lấy chi tiết của một Discussion / Pull Request từ Hub.

Trả về: [DiscussionWithDetails](/docs/huggingface_hub/v2.4.0/vi/package_reference/community#huggingface_hub.DiscussionWithDetails)

> [!TIP]
> Gây ra các lỗi sau:
>
> - [`HTTPError`](https://requests.readthedocs.io/en/latest/api/#requests.HTTPError) nếu API HuggingFace trả về lỗi - [`ValueError`](https://docs.python.org/3/library/exceptions.html#ValueError) nếu giá trị của một số tham số không hợp lệ - [RepositoryNotFoundError](/docs/huggingface_hub/v2.4.0/vi/package_reference/utilities#huggingface_hub.errors.RepositoryNotFoundError) Nếu không tìm thấy kho cần tải xuống. Điều này có thể do kho không tồn tại, hoặc do kho được đặt ở chế độ `private` và bạn không có quyền truy cập.

#### get_full_repo_name[[huggingface_hub.HfApi.get_full_repo_name]]

```python
get_full_repo_name(model_id: str, organization: str | None = None, token: bool | str | None = None)
```

[Nguồn](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L7218)

**Tham số:**

model_id (`str`) : Tên của mô hình.

organization (`str`, *tùy chọn*) : Nếu được truyền vào, tên kho sẽ nằm trong không gian tên của tổ chức thay vì không gian tên của người dùng.

token (`bool` hoặc `str`, *tùy chọn*) : Một token truy cập người dùng hợp lệ (chuỗi). Mặc định là token được lưu cục bộ, đây là phương pháp xác thực được khuyến nghị (xem https://huggingface.co/docs/huggingface_hub/quick-start#authentication). Để tắt xác thực, truyền `False`.

**Trả về:** `str`

Tên kho trong không gian tên của người dùng ({username}/{model_id}) nếu không có tổ chức nào được truyền vào, và trong không gian tên của tổ chức ({organization}/{model_id}) trong trường hợp ngược lại.

Trả về tên kho cho một ID model và tổ chức tùy chọn.

#### get_hf_file_metadata[[huggingface_hub.HfApi.get_hf_file_metadata]]

```python
get_hf_file_metadata(url: str, token: bool | str | None = None, timeout: float | None = 10)
```

[Nguồn](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L6285)

**Tham số:**

url (`str`) : URL của tệp, ví dụ được trả về bởi [hf_hub_url()](/docs/huggingface_hub/v2.4.0/vi/package_reference/file_download#huggingface_hub.hf_hub_url).

token (`bool` hoặc `str`, *tùy chọn*) : Một token truy cập người dùng hợp lệ (chuỗi). Mặc định là token được lưu cục bộ, đây là phương pháp xác thực được khuyến nghị (xem https://huggingface.co/docs/huggingface_hub/quick-start#authentication). Để tắt xác thực, truyền `False`.

timeout (`float`, *tuỳ chọn*, mặc định là 10) : Số giây để chờ máy chủ gửi dữ liệu mô tả trước khi từ bỏ.

**Trả về:**

Một đối tượng [HfFileMetadata](/docs/huggingface_hub/v2.4.0/vi/package_reference/file_download#huggingface_hub.HfFileMetadata) chứa các thông tin mô tả như vị trí, etag, kích thước và commit_hash.

Lấy metadata của một tệp được phiên bản hóa trên Hub cho một url nhất định.

#### get_inference_endpoint[[huggingface_hub.HfApi.get_inference_endpoint]]

```python
get_inference_endpoint(name: str, namespace: str | None = None, token: bool | str | None = None)
```

[Nguồn](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L9659)

**Tham số:**

name (`str`) : Tên của Inference Endpoint cần lấy thông tin.

namespace (`str`, *tùy chọn*) : Không gian tên chứa Inference Endpoint. Mặc định là người dùng hiện tại.

token (`bool` hoặc `str`, *tùy chọn*) : Một token truy cập người dùng hợp lệ (chuỗi). Mặc định là token được lưu cục bộ, đây là phương pháp xác thực được khuyến nghị (xem https://huggingface.co/docs/huggingface_hub/quick-start#authentication). Để tắt xác thực, truyền `False`.

**Trả về:** [InferenceEndpoint](/docs/huggingface_hub/v2.4.0/vi/package_reference/inference_endpoints#huggingface_hub.InferenceEndpoint)

thông tin về Inference Endpoint được yêu cầu.

Lấy thông tin về một Inference Endpoint.

Ví dụ:
```python
>>> from huggingface_hub import HfApi
>>> api = HfApi()
>>> endpoint = api.get_inference_endpoint("my-text-to-image")
>>> endpoint
InferenceEndpoint(name='my-text-to-image', ...)

# Get status
>>> endpoint.status
'running'
>>> endpoint.url
'https://my-text-to-image.region.vendor.endpoints.huggingface.cloud'

# Run inference
>>> endpoint.client.text_to_image(...)
```

#### get_model_tags[[huggingface_hub.HfApi.get_model_tags]]

```python
get_model_tags()
```

[Nguồn](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L2292)

Liệt kê tất cả các thẻ mô hình hợp lệ dưới dạng một đối tượng namespace lồng nhau

#### get_organization_overview[[huggingface_hub.HfApi.get_organization_overview]]

```python
get_organization_overview(organization: str, token: bool | str | None = None)
```

[Nguồn](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L11747)

**Tham số:**

organization (`str`) : Tên của tổ chức cần xem tổng quan.

token (`bool` hoặc `str`, *tùy chọn*) : Một token truy cập người dùng hợp lệ (chuỗi). Mặc định là token được lưu cục bộ, đây là phương pháp xác thực được khuyến nghị (xem https://huggingface.co/docs/huggingface_hub/quick-start#authentication). Để tắt xác thực, truyền `False`.

**Trả về:** `Organization`

Một đối tượng `Organization` chứa phần giới thiệu về tổ chức.

**Lỗi:** ``HTTPError``

- [`HTTPError`](https://requests.readthedocs.io/en/latest/api/#requests.HTTPError) -- HTTP 404 Nếu tổ chức không tồn tại trên Hub.

Xem tổng quan về một tổ chức trên Hub.

#### get_paths_info[[huggingface_hub.HfApi.get_paths_info]]

```python
get_paths_info(repo_id: str, paths: list[str] | str, expand: bool = False, revision: str | None = None, repo_type: str | None = None, token: str | bool | None = None)
```

[Nguồn](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L4269)

**Tham số:**

repo_id (`str`) : Một namespace (người dùng hoặc tổ chức) và tên kho, được phân tách bằng `/`.

paths (`Union[list[str], str]`, *tùy chọn*) : Các đường dẫn để lấy thông tin. Nếu một đường dẫn không tồn tại, nó sẽ bị bỏ qua mà không gây ra ngoại lệ.

expand (`bool`, *tùy chọn*, mặc định là `False`) : Có nên lấy thêm thông tin về các đường dẫn (ví dụ: commit gần nhất và kết quả quét bảo mật của các tệp) hay không. Thao tác này tốn kém hơn cho máy chủ nên chỉ trả về 50 kết quả mỗi trang (thay vì 1000). Vì phân trang được triển khai trong `huggingface_hub`, điều này là minh bạch với bạn ngoại trừ thời gian cần thiết để nhận được kết quả.

revision (`str`, *tùy chọn*) : Phiên bản của kho chứa mà từ đó lấy thông tin. Mặc định là nhánh `"main"`.

repo_type (`str`, *tùy chọn*) : Kiểu của kho chứa mà từ đó lấy thông tin (`"model"`, `"dataset"` hoặc `"space"`. Mặc định là `"model"`.

token (`bool` hoặc `str`, *tùy chọn*) : Một token truy cập người dùng hợp lệ (chuỗi). Mặc định là token được lưu cục bộ, đây là phương pháp xác thực được khuyến nghị (xem https://huggingface.co/docs/huggingface_hub/quick-start#authentication). Để tắt xác thực, truyền `False`.

**Trả về:** `list[Union[RepoFile, RepoFolder]]`

Thông tin về các đường dẫn, dưới dạng danh sách các đối tượng [RepoFile](/docs/huggingface_hub/v2.4.0/vi/package_reference/hf_api#huggingface_hub.RepoFile) và `RepoFolder`.

**Gây ra:** [RepositoryNotFoundError](/docs/huggingface_hub/v2.4.0/vi/package_reference/utilities#huggingface_hub.errors.RepositoryNotFoundError) hoặc [RevisionNotFoundError](/docs/huggingface_hub/v2.4.0/vi/package_reference/utilities#huggingface_hub.errors.RevisionNotFoundError)

- [RepositoryNotFoundError](/docs/huggingface_hub/v2.4.0/vi/package_reference/utilities#huggingface_hub.errors.RepositoryNotFoundError) -- Nếu không tìm thấy kho (lỗi 404): repo_id/repo_type không đúng, kho là riêng tư nhưng chưa xác thực hoặc kho không tồn tại.
- [RevisionNotFoundError](/docs/huggingface_hub/v2.4.0/vi/package_reference/utilities#huggingface_hub.errors.RevisionNotFoundError) -- Nếu không tìm thấy revision (lỗi 404) trên kho.

Lấy thông tin về các đường dẫn của một kho.

Ví dụ:
```py
>>> from huggingface_hub import get_paths_info
>>> paths_info = get_paths_info("allenai/c4", ["README.md", "en"], repo_type="dataset")
>>> paths_info
[
    RepoFile(path='README.md', size=2379, blob_id='f84cb4c97182890fc1dbdeaf1a6a468fd27b4fff', lfs=None, last_commit=None, security=None),
    RepoFolder(path='en', tree_id='dc943c4c40f53d02b31ced1defa7e5f438d5862e', last_commit=None)
]
```

#### get_repo_discussions[[huggingface_hub.HfApi.get_repo_discussions]]

```python
get_repo_discussions(repo_id: str, author: str | None = None, discussion_type: constants.DiscussionTypeFilter | None = None, discussion_status: constants.DiscussionStatusFilter | None = None, repo_type: str | None = None, token: bool | str | None = None)
```

[Nguồn](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L7256)

**Tham số:**

repo_id (`str`) : Một namespace (người dùng hoặc tổ chức) và tên kho, được phân tách bằng `/`.

author (`str`, *tùy chọn*) : Truyền một giá trị để lọc theo tác giả thảo luận. `None` có nghĩa là không lọc. Mặc định là `None`.

discussion_type (`str`, *tùy chọn*) : Đặt thành `"pull_request"` để chỉ lấy các pull request, `"discussion"` để chỉ lấy các thảo luận. Đặt thành `"all"` hoặc `None` để lấy cả hai. Mặc định là `None`.

discussion_status (`str`, *tùy chọn*) : Đặt thành `"open"` (tương ứng `"closed"`) để chỉ lấy các cuộc thảo luận đang mở (tương ứng đã đóng). Đặt thành `"all"` hoặc `None` để lấy cả hai. Mặc định là `None`.

repo_type (`str`, *tùy chọn*) : Đặt thành `"dataset"` hoặc `"space"` nếu lấy từ một dataset hoặc space, `None` hoặc `"model"` nếu lấy từ một model. Mặc định là `None`.

token (`bool` hoặc `str`, *tùy chọn*) : Một token truy cập người dùng hợp lệ (chuỗi). Mặc định là token được lưu cục bộ, đây là phương pháp xác thực được khuyến nghị (xem https://huggingface.co/docs/huggingface_hub/quick-start#authentication). Để tắt xác thực, truyền `False`.

**Trả về:** `Iterator[Discussion]`

Một trình lặp các đối tượng [Discussion](/docs/huggingface_hub/v2.4.0/vi/package_reference/community#huggingface_hub.Discussion).

Lấy các Thảo luận và Yêu cầu Gộp (Pull Requests) cho kho (repo) được chỉ định.

Ví dụ:

Thu thập tất cả các cuộc thảo luận của một kho lưu trữ trong một danh sách:

```python
>>> from huggingface_hub import get_repo_discussions
>>> discussions_list = list(get_repo_discussions(repo_id="bert-base-uncased"))
```

Lặp qua các cuộc thảo luận của một kho:

```python
>>> from huggingface_hub import get_repo_discussions
>>> for discussion in get_repo_discussions(repo_id="bert-base-uncased"):
...     print(discussion.num, discussion.title)
```

#### get_safetensors_metadata[[huggingface_hub.HfApi.get_safetensors_metadata]]

```python
get_safetensors_metadata(repo_id: str, repo_type: str | None = None, revision: str | None = None, token: bool | str | None = None, timeout: float | None = 10)
```

[Nguồn](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L6669)

**Tham số:**

repo_id (`str`) : Tên người dùng hoặc tên tổ chức và tên kho, phân tách bằng `/`.

repo_type (`str`, *tùy chọn*) : Đặt thành `"dataset"` hoặc `"space"` nếu tệp nằm trong một dataset hoặc space, `None` hoặc `"model"` nếu nằm trong một model. Mặc định là `None`.

revision (`str`, *tùy chọn*) : Bản sửa git để lấy tệp từ đó. Có thể là tên nhánh, một thẻ, hoặc một hash commit. Mặc định là đầu của nhánh `"main"`.

token (`bool` hoặc `str`, *tùy chọn*) : Một token truy cập người dùng hợp lệ (chuỗi). Mặc định là token được lưu cục bộ, đây là phương pháp xác thực được khuyến nghị (xem https://huggingface.co/docs/huggingface_hub/quick-start#authentication). Để tắt xác thực, truyền `False`.

timeout (`float`, *optional*, mặc định là 10) : Số giây chờ máy chủ gửi dữ liệu trước khi từ bỏ, được truyền cho mỗi yêu cầu lấy phần đầu tệp safetensors. Đặt thành `None` để tắt thời gian chờ (không khuyến nghị, vì kết nối bị treo có thể khiến cuộc gọi treo vĩnh viễn).

**Trả về:** `SafetensorsRepoMetadata`

thông tin liên quan đến kho safetensors.

**Gây ra:** `NotASafetensorsRepoError` hoặc `SafetensorsParsingError`

- `NotASafetensorsRepoError` -- Nếu repo không phải là repo safetensors, tức là không có file `model.safetensors` hoặc `model.safetensors.index.json`.
- `SafetensorsParsingError` -- Nếu không thể phân tích đúng phần đầu của tệp safetensors.

Phân tích metadata cho một kho safetensors trên Hub.

Trước tiên, chúng ta kiểm tra xem repo có một tệp safetensors đơn lẻ hay là một repo safetensors dạng phân mảnh (sharded). Nếu là tệp safetensors đơn lẻ, chúng ta sẽ phân tích metadata từ tệp này. Nếu là repo safetensors dạng phân mảnh, chúng ta sẽ phân tích metadata từ tệp index và sau đó phân tích metadata từ từng shard.

Để phân tích metadata từ một tệp safetensors đơn lẻ, hãy sử dụng [parse_safetensors_file_metadata()](/docs/huggingface_hub/v2.4.0/vi/package_reference/hf_api#huggingface_hub.HfApi.parse_safetensors_file_metadata). Để lấy mọi header shard của một model dạng shard trên `main` trong một yêu cầu duy nhất, hãy sử dụng [get_sharded_safetensors_metadata()](/docs/huggingface_hub/v2.4.0/vi/package_reference/hf_api#huggingface_hub.HfApi.get_sharded_safetensors_metadata).

Để biết thêm chi tiết về định dạng safetensors, hãy xem https://huggingface.co/docs/safetensors/index#format.

Ví dụ:
```py
# Parse repo with single weights file
>>> metadata = get_safetensors_metadata("bigscience/bloomz-560m")
>>> metadata
SafetensorsRepoMetadata(
    metadata=None,
    sharded=False,
    weight_map={'h.0.input_layernorm.bias': 'model.safetensors', ...},
    files_metadata={'model.safetensors': SafetensorsFileMetadata(...)}
)
>>> metadata.files_metadata["model.safetensors"].metadata
{'format': 'pt'}

# Parse repo with sharded model
>>> metadata = get_safetensors_metadata("bigscience/bloom")
Parse safetensors files: 100%|██████████████████████████████████████████| 72/72 [00:12<00:00,  5.78it/s]
>>> metadata
SafetensorsRepoMetadata(metadata={'total_size': 352494542848}, sharded=True, weight_map={...}, files_metadata={...})
>>> len(metadata.files_metadata)
72  # All safetensors files have been fetched

# Parse repo with sharded model
>>> get_safetensors_metadata("runwayml/stable-diffusion-v1-5")
NotASafetensorsRepoError: 'runwayml/stable-diffusion-v1-5' is not a safetensors repo. Couldn't find 'model.safetensors.index.json' or 'model.safetensors' files.
```

#### get_sharded_safetensors_metadata[[huggingface_hub.HfApi.get_sharded_safetensors_metadata]]

```python
get_sharded_safetensors_metadata(repo_id: str, filename: str = 'model.safetensors.index.json', token: bool | str | None = None, timeout: float | None = 10)
```

[Nguồn](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L6824)

**Tham số:**

repo_id (`str`) : Tên người dùng hoặc tên tổ chức và tên kho, phân tách bằng `/`.

filename (`str`, *tùy chọn*) : Đường dẫn của tệp chỉ mục safetensors trong kho. Mặc định là `"model.safetensors.index.json"`.

token (`bool` hoặc `str`, *tùy chọn*) : Một token truy cập người dùng hợp lệ (chuỗi). Mặc định là token được lưu cục bộ, đây là phương pháp xác thực được khuyến nghị (xem https://huggingface.co/docs/huggingface_hub/quick-start#authentication). Để tắt xác thực, truyền `False`.

timeout (`float`, *optional*, mặc định là 10) : Số giây chờ máy chủ gửi dữ liệu trước khi từ bỏ. Đặt thành `None` để vô hiệu hóa thời gian chờ (không được khuyến nghị, vì một kết nối bị treo có thể khiến cuộc gọi bị treo vô thời hạn).

**Trả về:** `SafetensorsRepoMetadata`

cùng metadata với [get_safetensors_metadata()](/docs/huggingface_hub/v2.4.0/vi/package_reference/hf_api#huggingface_hub.HfApi.get_safetensors_metadata).

Lấy metadata của mọi shard của một mô hình safetensors dạng sharded trên `main` từ Hub trong một yêu cầu duy nhất, thay vì [get_safetensors_metadata()](/docs/huggingface_hub/v2.4.0/vi/package_reference/hf_api#huggingface_hub.HfApi.get_safetensors_metadata) phân tích header của từng shard. Chỉ dành cho Hugging Face Hub.

Ví dụ:
```py
>>> metadata = get_sharded_safetensors_metadata("HuggingFaceH4/zephyr-7b-beta")
>>> len(metadata.files_metadata)
8
```

#### get_space_runtime[[huggingface_hub.HfApi.get_space_runtime]]

```python
get_space_runtime(repo_id: str, token: bool | str | None = None)
```

[Nguồn](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L8239)

**Tham số:**

repo_id (`str`) : ID của kho cần cập nhật. Ví dụ: `"bigcode/in-the-stack"`.

token (`bool` hoặc `str`, *tùy chọn*) : Một token truy cập người dùng hợp lệ (chuỗi). Mặc định là token được lưu cục bộ, đây là phương pháp xác thực được khuyến nghị (xem https://huggingface.co/docs/huggingface_hub/quick-start#authentication). Để tắt xác thực, truyền `False`.

**Trả về:** [SpaceRuntime](/docs/huggingface_hub/v2.4.0/vi/package_reference/space_runtime#huggingface_hub.SpaceRuntime)

Thông tin thời gian chạy về một Space, bao gồm giai đoạn và phần cứng của Space.

Lấy thông tin thời gian chạy về một Space.

#### get_space_secrets[[huggingface_hub.HfApi.get_space_secrets]]

```python
get_space_secrets(repo_id: str, token: bool | str | None = None)
```

[Nguồn](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L8109)

**Tham số:**

repo_id (`str`) : ID của kho cần truy vấn. Ví dụ: `"bigcode/in-the-stack"`.

token (`bool` hoặc `str`, *tùy chọn*) : Một token truy cập người dùng hợp lệ (chuỗi). Mặc định là token được lưu cục bộ, đây là phương pháp xác thực được khuyến nghị (xem https://huggingface.co/docs/huggingface_hub/quick-start#authentication). Để tắt xác thực, truyền `False`.

**Trả về:** `dict[str, SpaceSecret]`

Từ điển các đối tượng `SpaceSecret` được đánh chỉ mục theo tên bí mật.

Lấy tất cả các bí mật từ một Space.

Giá trị bí mật chỉ có thể ghi và không thể đọc lại. Chỉ có khóa, mô tả và thời gian cập nhật cuối cùng được trả về.

Secrets cho phép thiết lập các khóa hoặc token bí mật cho một Space mà không cần hardcode chúng. Để biết thêm chi tiết, xem https://huggingface.co/docs/hub/spaces-overview#managing-secrets.

Ví dụ:
```python
>>> from huggingface_hub import HfApi
>>> api = HfApi()
>>> api.get_space_secrets("username/my-space")
{'HF_TOKEN': SpaceSecret(key='HF_TOKEN', description='...', updated_at=datetime.datetime(...))}
```

#### get_space_variables[[huggingface_hub.HfApi.get_space_variables]]

```python
get_space_variables(repo_id: str, token: bool | str | None = None)
```

[Nguồn](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L8146)

**Tham số:**

repo_id (`str`) : ID của kho cần truy vấn. Ví dụ: `"bigcode/in-the-stack"`.

token (`bool` hoặc `str`, *tùy chọn*) : Một token truy cập người dùng hợp lệ (chuỗi). Mặc định là token được lưu cục bộ, đây là phương pháp xác thực được khuyến nghị (xem https://huggingface.co/docs/huggingface_hub/quick-start#authentication). Để tắt xác thực, truyền `False`.

Lấy tất cả các biến từ một Space.

Biến cho phép thiết lập các biến môi trường cho một Space mà không cần hardcode chúng. Để biết thêm chi tiết, xem https://huggingface.co/docs/hub/spaces-overview#managing-secrets-and-environment-variables

#### get_user_overview[[huggingface_hub.HfApi.get_user_overview]]

```python
get_user_overview(username: str, token: bool | str | None = None)
```

[Nguồn](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L11721)

**Tham số:**

username (`str`) : Tên người dùng của người dùng cần xem tổng quan.

token (`bool` hoặc `str`, *tùy chọn*) : Một token truy cập người dùng hợp lệ (chuỗi). Mặc định là token được lưu cục bộ, đây là phương pháp xác thực được khuyến nghị (xem https://huggingface.co/docs/huggingface_hub/quick-start#authentication). Để tắt xác thực, truyền `False`.

**Trả về:** `User`

Một đối tượng [User](/docs/huggingface_hub/v2.4.0/vi/package_reference/hf_api#huggingface_hub.User) chứa thông tin tổng quan về người dùng.

**Gây ra:** `HfHubHTTPError`

- `HfHubHTTPError` -- HTTP 404 Nếu người dùng không tồn tại trên Hub.

Xem tổng quan về một người dùng trên Hub.

#### get_webhook[[huggingface_hub.HfApi.get_webhook]]

```python
get_webhook(webhook_id: str, token: bool | str | None = None)
```

[Nguồn](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L11072)

**Tham số:**

webhook_id (`str`) : Định danh duy nhất của webhook cần lấy.

token (`bool` hoặc `str`, *tùy chọn*) : Một token truy cập người dùng hợp lệ (chuỗi). Mặc định là token được lưu cục bộ, đây là phương pháp xác thực được khuyến nghị (xem https://huggingface.co/docs/huggingface_hub/quick-start#authentication). Để tắt xác thực, truyền `False`.

**Trả về:** [WebhookInfo](/docs/huggingface_hub/v2.4.0/vi/package_reference/hf_api#huggingface_hub.WebhookInfo)

Thông tin về webhook.

Lấy webhook theo id của nó.

Ví dụ:
```python
>>> from huggingface_hub import get_webhook
>>> webhook = get_webhook("654bbbc16f2ec14d77f109cc")
>>> print(webhook)
WebhookInfo(
    id="654bbbc16f2ec14d77f109cc",
    job=None,
    watched=[WebhookWatchedItem(type="user", name="julien-c"), WebhookWatchedItem(type="org", name="HuggingFaceH4")],
    url="https://webhook.site/a2176e82-5720-43ee-9e06-f91cb4c91548",
    secret="my-secret",
    domains=["repo", "discussion"],
    disabled=False,
)
```

#### get_zero_gpu_quota[[huggingface_hub.HfApi.get_zero_gpu_quota]]

```python
get_zero_gpu_quota(token: bool | str | None = None)
```

[Nguồn](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L8283)

**Tham số:**

token (`bool` hoặc `str`, *tùy chọn*) : Một token truy cập người dùng hợp lệ (chuỗi). Mặc định là token được lưu cục bộ, đây là phương pháp xác thực được khuyến nghị (xem https://huggingface.co/docs/huggingface_hub/quick-start#authentication). Token chi tiết (fine-grained) phải có quyền "Billing > Read billing usage and payment method status" và token OAuth phải có phạm vi `read-billing`.

**Trả về:** [ZeroGpuQuota](/docs/huggingface_hub/v2.4.0/vi/package_reference/space_runtime#huggingface_hub.ZeroGpuQuota)

Hạn mức ZeroGPU của người dùng đã xác thực.

Lấy hạn mức ZeroGPU của người dùng đã xác thực.

Có ích để theo dõi việc sử dụng ZeroGPU khi gọi các ZeroGPU Spaces theo chương trình (ví dụ: từ một ứng dụng, một agent hoặc một máy chủ MCP). Xem https://huggingface.co/docs/hub/spaces-zerogpu để biết thêm chi tiết.

Ví dụ:
```py
>>> from huggingface_hub import get_zero_gpu_quota
>>> quota = get_zero_gpu_quota()
>>> quota
ZeroGpuQuota(base=2400, remaining=1810, resets_at=datetime.datetime(2026, 9, 30, 9, 12, 3, tzinfo=datetime.timezone.utc), overquota_used=0)
>>> print(f"{quota.remaining / 60:.1f} minutes left")
30.2 minutes left
```

#### grant_access[[huggingface_hub.HfApi.grant_access]]

```python
grant_access(repo_id: str, user: str, repo_type: str | None = None, token: bool | str | None = None)
```

[Nguồn](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L11017)

**Tham số:**

repo_id (`str`) : id của repo cần cấp quyền truy cập.

user (`str`) : Tên người dùng của người dùng cần cấp quyền truy cập.

repo_type (`str`, *tùy chọn*) : Kiểu kho cần cấp quyền truy cập. Phải là một trong `model`, `dataset` hoặc `space`. Mặc định là `model`.

token (`bool` hoặc `str`, *tùy chọn*) : Một token truy cập người dùng hợp lệ (chuỗi). Mặc định là token được lưu cục bộ, đây là phương pháp xác thực được khuyến nghị (xem https://huggingface.co/docs/huggingface_hub/quick-start#authentication). Để tắt xác thực, truyền `False`.

**Gây ra:** `HfHubHTTPError`

- `HfHubHTTPError` -- HTTP 400 nếu kho không được bảo vệ.
- `HfHubHTTPError` -- HTTP 400 nếu người dùng đã có quyền truy cập vào kho.
- `HfHubHTTPError` -- HTTP 403 nếu bạn chỉ có quyền truy cập chỉ đọc vào kho. Điều này có thể xảy ra nếu bạn không có vai trò `write` hoặc `admin` trong tổ chức mà kho thuộc về, hoặc nếu bạn đã truyền một token `read`.
- `HfHubHTTPError` -- HTTP 404 nếu người dùng không tồn tại trên Hub.

Cấp quyền truy cập cho một người dùng đối với một kho có kiểm soát nhất định.

Việc cấp quyền truy cập không yêu cầu người dùng phải tự gửi yêu cầu truy cập. Người dùng sẽ được tự động thêm vào danh sách chấp nhận, cho phép họ tải xuống các tệp. Bạn có thể thu hồi quyền truy cập đã cấp vào bất kỳ lúc nào bằng cách sử dụng [cancel_access_request()](/docs/huggingface_hub/v2.4.0/vi/package_reference/hf_api#huggingface_hub.HfApi.cancel_access_request) hoặc [reject_access_request()](/docs/huggingface_hub/v2.4.0/vi/package_reference/hf_api#huggingface_hub.HfApi.reject_access_request).

Để biết thêm thông tin về các kho lưu trữ có kiểm soát, hãy xem https://huggingface.co/docs/hub/models-gated.

#### hf_hub_download[[huggingface_hub.HfApi.hf_hub_download]]

```python
hf_hub_download(repo_id: str, filename: str, subfolder: str | None = None, repo_type: str | None = None, revision: str | None = None, cache_dir: str | Path | None = None, local_dir: str | Path | None = None, force_download: bool = False, etag_timeout: float = 10, token: bool | str | None = None, local_files_only: bool = False, tqdm_class: type[base_tqdm] | None = None, dry_run: bool = False)
```

[Nguồn](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L6364)

**Tham số:**

repo_id (`str`) : Tên người dùng hoặc tên tổ chức và tên kho, phân tách bằng `/`.

filename (`str`) : Tên của tệp trong kho.

subfolder (`str`, *tùy chọn*) : Một giá trị tùy chọn tương ứng với một thư mục bên trong kho.

repo_type (`str`, *tùy chọn*) : Đặt thành `"dataset"` hoặc `"space"` nếu tải xuống từ một dataset hoặc space, `None` hoặc `"model"` nếu tải xuống từ một model. Mặc định là `None`.

revision (`str`, *tùy chọn*) : Một id phiên bản Git tùy chọn, có thể là tên nhánh, một tag, hoặc một commit hash.

cache_dir (`str`, `Path`, *tùy chọn*) : Đường dẫn đến thư mục nơi lưu trữ các tệp được lưu trong bộ nhớ đệm.

local_dir (`str` hoặc `Path`, *tùy chọn*) : Nếu được cung cấp, tệp đã tải xuống sẽ được đặt trong thư mục này.

force_download (`bool`, *tùy chọn*, mặc định là `False`) : Xác định xem tệp có nên được tải xuống ngay cả khi nó đã tồn tại trong bộ nhớ đệm cục bộ hay không.

etag_timeout (`float`, *tùy chọn*, mặc định là `10`) : Khi lấy ETag, số giây chờ máy chủ gửi dữ liệu trước khi từ bỏ, được truyền vào `httpx2.request`.

token (`bool` hoặc `str`, *tùy chọn*) : Một token truy cập người dùng hợp lệ (chuỗi). Mặc định là token được lưu cục bộ, đây là phương pháp xác thực được khuyến nghị (xem https://huggingface.co/docs/huggingface_hub/quick-start#authentication). Để tắt xác thực, truyền `False`.

local_files_only (`bool`, *tùy chọn*, mặc định là `False`) : Nếu `True`, tránh tải xuống tệp và trả về đường dẫn đến tệp được lưu trong bộ nhớ đệm cục bộ nếu tệp đó tồn tại.

tqdm_class (`tqdm`, *tùy chọn*) : Nếu được cung cấp, sẽ ghi đè lên hành vi mặc định của thanh tiến trình. Đối số được truyền phải kế thừa từ `tqdm.auto.tqdm` hoặc ít nhất phải mô phỏng hành vi của nó. Mặc định là thanh tiến trình tùy chỉnh của HF, có thể bị vô hiệu hóa bằng cách đặt biến môi trường `HF_HUB_DISABLE_PROGRESS_BARS`.

dry_run (`bool`, *tuỳ chọn*, mặc định là `False`) : Nếu `True`, thực hiện chạy thử mà không thực sự tải xuống tệp. Trả về một đối tượng [DryRunFileInfo](/docs/huggingface_hub/v2.4.0/vi/package_reference/hf_api#huggingface_hub.DryRunFileInfo) chứa thông tin về những gì sẽ được tải xuống.

**Trả về:** `str` hoặc [DryRunFileInfo](/docs/huggingface_hub/v2.4.0/vi/package_reference/hf_api#huggingface_hub.DryRunFileInfo)

- Nếu `dry_run=False`: Đường dẫn cục bộ của tệp hoặc, nếu mạng bị tắt, phiên bản tệp được lưu trong bộ nhớ đệm trên đĩa gần nhất.
- Nếu `dry_run=True`: Một đối tượng [DryRunFileInfo](/docs/huggingface_hub/v2.4.0/vi/package_reference/hf_api#huggingface_hub.DryRunFileInfo) chứa thông tin tải xuống.

**Gây ra:** [RepositoryNotFoundError](/docs/huggingface_hub/v2.4.0/vi/package_reference/utilities#huggingface_hub.errors.RepositoryNotFoundError) hoặc [RevisionNotFoundError](/docs/huggingface_hub/v2.4.0/vi/package_reference/utilities#huggingface_hub.errors.RevisionNotFoundError) hoặc `~utils.RemoteEntryNotFoundError` hoặc [LocalEntryNotFoundError](/docs/huggingface_hub/v2.4.0/vi/package_reference/utilities#huggingface_hub.errors.LocalEntryNotFoundError) hoặc ``EnvironmentError`` hoặc ``OSError`` hoặc ``ValueError``

- [RepositoryNotFoundError](/docs/huggingface_hub/v2.4.0/vi/package_reference/utilities#huggingface_hub.errors.RepositoryNotFoundError) -- Nếu không tìm thấy kho cần tải xuống. Điều này có thể do kho không tồn tại, hoặc do kho được đặt ở chế độ `private` và bạn không có quyền truy cập.
- [RevisionNotFoundError](/docs/huggingface_hub/v2.4.0/vi/package_reference/utilities#huggingface_hub.errors.RevisionNotFoundError) -- Nếu không tìm thấy revision cần tải xuống.
- `~utils.RemoteEntryNotFoundError` -- Nếu tệp cần tải xuống không được tìm thấy.
- [LocalEntryNotFoundError](/docs/huggingface_hub/v2.4.0/vi/package_reference/utilities#huggingface_hub.errors.LocalEntryNotFoundError) -- Nếu mạng bị vô hiệu hóa hoặc không khả dụng và tệp không được tìm thấy trong bộ nhớ đệm.
- [`EnvironmentError`](https://docs.python.org/3/library/exceptions.html#EnvironmentError) -- Nếu `token=True` nhưng không tìm thấy token.
- [`OSError`](https://docs.python.org/3/library/exceptions.html#OSError) -- Nếu không thể xác định được ETag.
- [`ValueError`](https://docs.python.org/3/library/exceptions.html#ValueError) -- Nếu giá trị của một số tham số không hợp lệ.

Tải xuống một tệp nhất định nếu tệp đó chưa có trong bộ nhớ đệm cục bộ.

Bố cục tệp cache mới trông như sau:
- Thư mục cache chứa một thư mục con cho mỗi repo_id (được đặt tên theo loại repo)
- bên trong mỗi thư mục kho:
  - refs là danh sách các cặp revision => commit_hash mới nhất được biết đến
  - blobs chứa các blob tệp thực tế (được xác định bằng git-sha hoặc sha256, tùy thuộc vào việc chúng có phải là tệp LFS hay không)
  - snapshots chứa một thư mục con cho mỗi commit, mỗi "commit" chứa tập con các tệp đã được giải quyết tại commit đó. Mỗi tên tệp là một symlink trỏ đến blob tại commit đó.

```
[  96]  .
└── [ 160]  models--julien-c--EsperBERTo-small
    ├── [ 160]  blobs
    │   ├── [321M]  403450e234d65943a7dcf7e05a771ce3c92faa84dd07db4ac20f592037a1e4bd
    │   ├── [ 398]  7cb18dc9bafbfcf74629a4b760af1b160957a83e
    │   └── [1.4K]  d7edf6bd2a681fb0175f7735299831ee1b22b812
    ├── [  96]  refs
    │   └── [  40]  main
    └── [ 128]  snapshots
        ├── [ 128]  2439f60ef33a0d46d85da5001d52aeda5b00ce9f
        │   ├── [  52]  README.md -> ../../blobs/d7edf6bd2a681fb0175f7735299831ee1b22b812
        │   └── [  76]  pytorch_model.bin -> ../../blobs/403450e234d65943a7dcf7e05a771ce3c92faa84dd07db4ac20f592037a1e4bd
        └── [ 128]  bbc77c8132af1cc5cf678da3f1ddf2de43606d48
            ├── [  52]  README.md -> ../../blobs/7cb18dc9bafbfcf74629a4b760af1b160957a83e
            └── [  76]  pytorch_model.bin -> ../../blobs/403450e234d65943a7dcf7e05a771ce3c92faa84dd07db4ac20f592037a1e4bd
```

Nếu `local_dir` được cung cấp, cấu trúc tệp từ kho sẽ được nhân bản tại vị trí này. Khi sử dụng tùy chọn này, `cache_dir` sẽ không được dùng và một thư mục `.cache/huggingface/` sẽ được tạo tại gốc của `local_dir` để lưu trữ một số metadata liên quan đến các tệp đã tải xuống. Mặc dù cơ chế này không mạnh mẽ bằng hệ thống cache chính, nó được tối ưu hóa cho việc thường xuyên kéo phiên bản mới nhất của một kho.

#### hide_discussion_comment[[huggingface_hub.HfApi.hide_discussion_comment]]

```python
hide_discussion_comment(repo_id: str, discussion_num: int, comment_id: str, token: bool | str | None = None, repo_type: str | None = None)
```

[Nguồn](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L7940)

**Tham số:**

repo_id (`str`) : Một namespace (người dùng hoặc tổ chức) và tên kho, được phân tách bằng `/`.

discussion_num (`int`) : Số thứ tự của Discussion hoặc Pull Request. Phải là một số nguyên dương.

comment_id (`str`) : ID của bình luận cần chỉnh sửa.

repo_type (`str`, *tùy chọn*) : Đặt thành `"dataset"` hoặc `"space"` nếu tải lên một dataset hoặc space, `None` hoặc `"model"` nếu tải lên một model. Mặc định là `None`.

token (`bool` hoặc `str`, *tùy chọn*) : Một token truy cập người dùng hợp lệ (chuỗi). Mặc định là token được lưu cục bộ, đây là phương pháp xác thực được khuyến nghị (xem https://huggingface.co/docs/huggingface_hub/quick-start#authentication). Để tắt xác thực, truyền `False`.

**Trả về:** [DiscussionComment](/docs/huggingface_hub/v2.4.0/vi/package_reference/community#huggingface_hub.DiscussionComment)

bình luận ẩn

Ẩn một bình luận trên Discussion / Pull Request.

> [!WARNING]
> Nội dung của các bình luận ẩn không thể được truy xuất lại. Việc ẩn một bình luận là không thể đảo ngược.

> [!TIP]
> Gây ra các lỗi sau:
>
> - [`HTTPError`](https://requests.readthedocs.io/en/latest/api/#requests.HTTPError) nếu API HuggingFace trả về lỗi - [`ValueError`](https://docs.python.org/3/library/exceptions.html#ValueError) nếu giá trị của một số tham số không hợp lệ - [RepositoryNotFoundError](/docs/huggingface_hub/v2.4.0/vi/package_reference/utilities#huggingface_hub.errors.RepositoryNotFoundError) Nếu không tìm thấy kho cần tải xuống. Điều này có thể do kho không tồn tại, hoặc do kho được đặt ở chế độ `private` và bạn không có quyền truy cập.

#### inspect_job[[huggingface_hub.HfApi.inspect_job]]

```python
inspect_job(job_id: str, namespace: str | None = None, token: bool | str | None = None)
```

[Nguồn](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L12563)

**Tham số:**

job_id (`str`) : ID của Job.

namespace (`str`, *tùy chọn*) : Không gian tên nơi Job đang chạy. Mặc định là không gian tên của người dùng hiện tại.

token (`bool` hoặc `str`, *tùy chọn*) : Một token truy cập người dùng hợp lệ. Nếu không được cung cấp, token được lưu cục bộ sẽ được sử dụng, đây là phương thức xác thực được khuyến nghị. Đặt thành `False` để tắt xác thực. Tham khảo: https://huggingface.co/docs/huggingface_hub/quick-start#authentication.

Kiểm tra một Job tính toán trên hạ tầng của Hugging Face.

Ví dụ:

```python
>>> from huggingface_hub import inspect_job, run_job
>>> job = run_job(image="python:3.12", command=["python", "-c" ,"print('Hello from HF compute!')"])
>>> inspect_job(job_id=job.id)
JobInfo(
    id='68780d00bbe36d38803f645f',
    created_at=datetime.datetime(2025, 7, 16, 20, 35, 12, 808000, tzinfo=datetime.timezone.utc),
    docker_image='python:3.12',
    space_id=None,
    command=['python', '-c', "print('Hello from HF compute!')"],
    arguments=[],
    environment={},
    secrets={},
    flavor='cpu-basic',
    status=JobStatus(stage='RUNNING', message=None)
)
```

#### inspect_scheduled_job[[huggingface_hub.HfApi.inspect_scheduled_job]]

```python
inspect_scheduled_job(scheduled_job_id: str, namespace: str | None = None, token: bool | str | None = None)
```

[Nguồn](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L13285)

**Tham số:**

scheduled_job_id (`str`) : ID của Job đã được lên lịch.

namespace (`str`, *tùy chọn*) : Không gian tên (namespace) chứa Job được lên lịch. Mặc định là không gian tên của người dùng hiện tại.

token (`bool` hoặc `str`, *tùy chọn*) : Một token truy cập người dùng hợp lệ. Nếu không được cung cấp, token được lưu cục bộ sẽ được sử dụng, đây là phương thức xác thực được khuyến nghị. Đặt thành `False` để tắt xác thực. Tham khảo: https://huggingface.co/docs/huggingface_hub/quick-start#authentication.

Kiểm tra một Job tính toán đã lên lịch trên hạ tầng Hugging Face.

Ví dụ:

```python
>>> from huggingface_hub import inspect_scheduled_job, create_scheduled_job
>>> scheduled_job = create_scheduled_job(image="python:3.12", command=["python", "-c" ,"print('Hello from HF compute!')"], schedule="@hourly")
>>> inspect_scheduled_job(scheduled_job_id=scheduled_job.id)
```

#### kernel_info[[huggingface_hub.HfApi.kernel_info]]

```python
kernel_info(repo_id: str, revision: str | None = None, timeout: float | None = None, token: bool | str | None = None)
```

[Nguồn](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L3429)

**Tham số:**

repo_id (`str`) : Một namespace (người dùng hoặc tổ chức) và tên kho, được phân tách bằng `/`.

revision (`str`, *tùy chọn*) : Phiên bản của kho kernel để lấy thông tin.

timeout (`float`, *optional*) : Có nên đặt thời gian chờ (timeout) cho yêu cầu đến Hub hay không.

token (`bool` hoặc `str`, *tùy chọn*) : Một token truy cập người dùng hợp lệ (chuỗi). Mặc định là token được lưu cục bộ, đây là phương pháp xác thực được khuyến nghị (xem https://huggingface.co/docs/huggingface_hub/quick-start#authentication). Để tắt xác thực, truyền `False`.

**Trả về:** [ModelInfo](/docs/huggingface_hub/v2.4.0/vi/package_reference/hf_api#huggingface_hub.ModelInfo)

Thông tin về kho lưu trữ kernel.

Lấy thông tin về một kernel cụ thể trên huggingface.co.

#### list_accepted_access_requests[[huggingface_hub.HfApi.list_accepted_access_requests]]

```python
list_accepted_access_requests(repo_id: str, repo_type: str | None = None, token: bool | str | None = None)
```

[Nguồn](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L10669)

**Tham số:**

repo_id (`str`) : id của repo để lấy các yêu cầu truy cập.

repo_type (`str`, *tùy chọn*) : Kiểu của kho cần lấy các yêu cầu truy cập. Phải là một trong `model`, `dataset` hoặc `space`. Mặc định là `model`.

token (`bool` hoặc `str`, *tùy chọn*) : Một token truy cập người dùng hợp lệ (chuỗi). Mặc định là token được lưu cục bộ, đây là phương pháp xác thực được khuyến nghị (xem https://huggingface.co/docs/huggingface_hub/quick-start#authentication). Để tắt xác thực, truyền `False`.

**Trả về:** `Iterable[AccessRequest]`

Một iterable gồm các đối tượng `AccessRequest`. Mỗi mục chứa các thuộc tính `username`, `request_id`, `email`, `status` và `timestamp`. Nếu kho có cổng (gated repo) có biểu mẫu tùy chỉnh, thuộc tính `fields` sẽ được điền với các câu trả lời của người dùng.

**Gây ra:** `HfHubHTTPError`

- `HfHubHTTPError` -- HTTP 400 nếu kho không được bảo vệ.
- `HfHubHTTPError` -- HTTP 403 nếu bạn chỉ có quyền truy cập chỉ đọc vào kho. Điều này có thể xảy ra nếu bạn không có vai trò `write` hoặc `admin` trong tổ chức mà kho thuộc về, hoặc nếu bạn đã truyền một token `read`.

Lấy các yêu cầu truy cập đã được chấp nhận cho một kho có kiểm soát nhất định.

Một yêu cầu được chấp nhận có nghĩa là người dùng đã yêu cầu quyền truy cập vào repo và yêu cầu đó đã được chấp thuận. Người dùng có thể tải xuống bất kỳ tệp nào của repo. Nếu chế độ phê duyệt là tự động, danh sách này mặc định phải chứa tất cả các yêu cầu. Các yêu cầu đã được chấp nhận có thể bị hủy hoặc từ chối vào bất kỳ lúc nào bằng cách sử dụng [cancel_access_request()](/docs/huggingface_hub/v2.4.0/vi/package_reference/hf_api#huggingface_hub.HfApi.cancel_access_request) và [reject_access_request()](/docs/huggingface_hub/v2.4.0/vi/package_reference/hf_api#huggingface_hub.HfApi.reject_access_request). Một yêu cầu bị hủy sẽ quay lại danh sách chờ trong khi một yêu cầu bị từ chối sẽ chuyển sang danh sách đã từ chối. Trong cả hai trường hợp, người dùng sẽ mất quyền truy cập vào repo.

Để biết thêm thông tin về các kho lưu trữ có kiểm soát, hãy xem https://huggingface.co/docs/hub/models-gated.

Ví dụ:
```py
>>> from huggingface_hub import list_accepted_access_requests

>>> requests = list(list_accepted_access_requests("meta-llama/Llama-2-7b"))
>>> len(requests)
411
>>> requests[0]
[
    AccessRequest(
        username='clem',
        request_id='655f3a1c9e6b2d4f8a7c1e05',
        fullname='Clem 🤗',
        email='***',
        timestamp=datetime.datetime(2023, 11, 23, 18, 4, 53, 828000, tzinfo=datetime.timezone.utc),
        status='accepted',
        fields=None,
    ),
    ...
]
```

#### list_bucket_tree[[huggingface_hub.HfApi.list_bucket_tree]]

```python
list_bucket_tree(bucket_id: str, prefix: str | None = None, recursive: bool | None = None, token: str | bool | None = None)
```

[Nguồn](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L14301)

**Tham số:**

bucket_id (`str`) : ID của bucket (ví dụ: `"username/my-bucket"`).

prefix (`str`, *tùy chọn*) : Lọc kết quả thành các tệp có đường dẫn bắt đầu bằng tiền tố này.

recursive (`bool`, *tuỳ chọn*) : Nếu `True`, liệt kê các tệp đệ quy. Nếu `False` (mặc định), chỉ liệt kê các tệp và thư mục ở thư mục gốc.

token (`bool` hoặc `str`, *tùy chọn*) : Một token truy cập người dùng hợp lệ (chuỗi). Mặc định là token được lưu cục bộ, đây là phương pháp xác thực được khuyến nghị (xem https://huggingface.co/docs/huggingface_hub/quick-start#authentication). Để tắt xác thực, truyền `False`.

**Trả về:** `Iterable[Union[BucketFile, BucketFolder]]`

Một iterable gồm các đối tượng [BucketFile](/docs/huggingface_hub/v2.4.0/vi/package_reference/hf_api#huggingface_hub.BucketFile) và `BucketFolder` chứa thông tin về tệp và thư mục (đường dẫn, v.v.).

Liệt kê các tệp trong một bucket.

Ví dụ:
```python
>>> from huggingface_hub import list_bucket_tree
>>> for file_info in list_bucket_tree(bucket_id="username/my-bucket"):
...     print(file_info.path)

>>> # Filter by prefix
>>> for file_info in list_bucket_tree(bucket_id="username/my-bucket", prefix="models/"):
...     print(file_info.path)
```

#### list_buckets[[huggingface_hub.HfApi.list_buckets]]

```python
list_buckets(namespace: str | None = None, search: str | None = None, token: bool | str | None = None)
```

[Nguồn](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L14108)

**Tham số:**

namespace (`str`, *tùy chọn*) : Liệt kê các bucket dưới namespace này (người dùng hoặc tổ chức). Mặc định là liệt kê các bucket của người dùng.

search (`str`, *tùy chọn*) : Chuỗi tìm kiếm để lọc tên bucket.

token (`bool` hoặc `str`, *tùy chọn*) : Một token truy cập người dùng hợp lệ (chuỗi). Mặc định là token được lưu cục bộ, đây là phương pháp xác thực được khuyến nghị (xem https://huggingface.co/docs/huggingface_hub/quick-start#authentication). Để tắt xác thực, truyền `False`.

**Trả về:** `Iterable[BucketInfo]`

Một iterable gồm các đối tượng [BucketInfo](/docs/huggingface_hub/v2.4.0/vi/package_reference/hf_api#huggingface_hub.BucketInfo).

Liệt kê các bucket trên Hub thuộc một namespace nhất định.

Ví dụ:
```python
>>> from huggingface_hub import list_buckets
>>> for bucket in list_buckets(): # lists buckets in the user's namespace
...     print(bucket)

>>> for bucket in list_buckets(namespace="huggingface"): # lists buckets in the "huggingface" organization
...     print(bucket)

>>> for bucket in list_buckets(search="my-prefix"): # filter buckets by name
...     print(bucket)
```

#### list_collections[[huggingface_hub.HfApi.list_collections]]

```python
list_collections(owner: list[str] | str | None = None, item: list[str] | str | None = None, sort: CollectionSort_T | None = None, limit: int | None = None, token: bool | str | None = None)
```

[Nguồn](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L10096)

**Tham số:**

owner (`list[str]` hoặc `str`, *tùy chọn*) : Lọc theo tên người dùng của chủ sở hữu.

item (`list[str]` hoặc `str`, *tùy chọn*) : Lọc các bộ sưu tập chứa một mục cụ thể. Ví dụ: `"models/teknium/OpenHermes-2.5-Mistral-7B"`, `"datasets/squad"` hoặc `"papers/2311.12983"`.

sort (`Literal["lastModified", "trending", "upvotes"]`, *tùy chọn*) : Sắp xếp các bộ sưu tập theo thời gian sửa đổi gần nhất, xu hướng hoặc số lượt bình chọn.

limit (`int`, *tuỳ chọn*) : Số lượng bộ sưu tập tối đa được trả về.

token (`bool` hoặc `str`, *tùy chọn*) : Một token truy cập người dùng hợp lệ (chuỗi). Mặc định là token được lưu cục bộ, đây là phương pháp xác thực được khuyến nghị (xem https://huggingface.co/docs/huggingface_hub/quick-start#authentication). Để tắt xác thực, truyền `False`.

**Trả về:** `Iterable[Collection]`

một đối tượng có thể lặp lại của các đối tượng [Collection](/docs/huggingface_hub/v2.4.0/vi/package_reference/collections#huggingface_hub.Collection).

Liệt kê các bộ sưu tập trên Huggingface Hub, dựa trên một số bộ lọc.

> [!WARNING]
> Khi liệt kê các bộ sưu tập, danh sách mục trong mỗi bộ sưu tập bị cắt ngắn tối đa 4 mục. Để lấy tất cả các mục từ một bộ sưu tập, bạn phải sử dụng [get_collection()](/docs/huggingface_hub/v2.4.0/vi/package_reference/hf_api#huggingface_hub.HfApi.get_collection).

#### list_daily_papers[[huggingface_hub.HfApi.list_daily_papers]]

```python
list_daily_papers(date: str | None = None, token: bool | str | None = None, week: str | None = None, month: str | None = None, submitter: str | None = None, sort: DailyPapersSort_T | None = None, p: int | None = None, limit: int | None = None)
```

[Nguồn](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L11978)

**Tham số:**

date (`str`, *tùy chọn*) : Ngày ở định dạng ISO (YYYY-MM-DD) để lấy các bài báo hàng ngày. Mặc định là những bài mới nhất.

token (Union[bool, str, None], *tùy chọn*) : Một token truy cập người dùng hợp lệ (chuỗi). Mặc định là token được lưu cục bộ. Để tắt xác thực, truyền `False`.

week (`str`, *tùy chọn*) : Tuần theo định dạng ISO (YYYY-Www) để lấy các bài báo hàng ngày. Ví dụ, `2025-W09`.

month (`str`, *tùy chọn*) : Tháng theo định dạng ISO (YYYY-MM) để lấy các bài báo hàng ngày. Ví dụ, `2025-02`.

submitter (`str`, *tùy chọn*) : Tên người dùng của người gửi để lọc các bài báo hàng ngày.

sort (`Literal["publishedAt", "trending"]`, *tùy chọn*) : Thứ tự sắp xếp cho các bài báo hàng ngày. Có thể là theo `publishedAt` hoặc theo `trending`. Mặc định là `"publishedAt"`

p (`int`, *tuỳ chọn*) : Số trang cho phân trang. Mặc định là 0.

limit (`int`, *tuỳ chọn*) : Giới hạn số lượng bài báo cần lấy. Mặc định là 50.

**Trả về:** `Iterable[PaperInfo]`

một iterable các đối tượng `huggingface_hub.hf_api.PaperInfo`.

Liệt kê các bài báo hàng ngày được xuất bản vào một ngày cụ thể trên Hugging Face Hub.

Ví dụ:

```python
>>> from huggingface_hub import HfApi

>>> api = HfApi()
>>> list(api.list_daily_papers(date="2025-10-29"))
```

#### list_dataset_parquet_files[[huggingface_hub.HfApi.list_dataset_parquet_files]]

```python
list_dataset_parquet_files(repo_id: str, config: str | None = None, token: bool | str | None = None)
```

[Nguồn](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L2707)

**Tham số:**

repo_id (`str`) : ID của kho dữ liệu (ví dụ: `"username/dataset-name"`).

config (`str`, *tùy chọn*) : Lọc theo tên config/subset cụ thể. Khi được cung cấp, chỉ các tệp parquet cho config đó sẽ được trả về.

token (`bool` hoặc `str`, *tùy chọn*) : Một token truy cập người dùng hợp lệ (chuỗi). Mặc định là token được lưu cục bộ, đây là phương pháp xác thực được khuyến nghị (xem https://huggingface.co/docs/huggingface_hub/quick-start#authentication). Để tắt xác thực, truyền `False`.

**Trả về:** `list[DatasetParquetEntry]`

một danh sách các đối tượng `DatasetParquetEntry` chứa config, split, url và size cho mỗi tệp parquet.

Liệt kê các tệp parquet có sẵn cho một tập dữ liệu trên Hub.

Tất cả các dataset được lưu trữ trên Hub sẽ được tự động chuyển đổi sang Parquet bởi [Dataset Viewer](https://huggingface.co/docs/dataset-viewer/parquet). Phương pháp này trả về danh sách các tệp parquet kèm theo URL, configs, splits và kích thước của chúng.

Ví dụ:
```python
>>> from huggingface_hub import list_dataset_parquet_files
>>> list_dataset_parquet_files("lhoestq/demo1")
>>> entries[0]
DatasetParquetEntry(config='default', split='train', url='https://huggingface.co/...', size=5038)
```

#### list_datasets[[huggingface_hub.HfApi.list_datasets]]

```python
list_datasets(filter: str | Iterable[str] | None = None, author: str | None = None, benchmark: Literal[True] | Literal['official'] | str | None = None, dataset_name: str | None = None, gated: bool | None = None, language_creators: str | list[str] | None = None, language: str | list[str] | None = None, multilinguality: str | list[str] | None = None, size_categories: str | list[str] | None = None, task_categories: str | list[str] | None = None, task_ids: str | list[str] | None = None, search: str | None = None, sort: DatasetSort_T | None = None, limit: int | None = None, expand: list[ExpandDatasetProperty_T] | None = None, full: bool | None = None, token: bool | str | None = None)
```

[Nguồn](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L2502)

**Tham số:**

filter (`str` hoặc `Iterable[str]`, *tùy chọn*) : Một chuỗi hoặc danh sách các chuỗi để lọc các bộ dữ liệu trên hub.

author (`str`, *tùy chọn*) : Một chuỗi nhận diện tác giả của các bộ dữ liệu được trả về.

benchmark (`True`, `"official"`, `str`, *tùy chọn*) : Lọc các bộ dữ liệu theo benchmark. Có thể là `True` hoặc `"official"` để trả về các bộ dữ liệu benchmark chính thức. Để tương thích với các phiên bản sau, cũng có thể là một chuỗi đại diện cho tên benchmark (hiện tại chỉ hỗ trợ "official").

dataset_name (`str`, *tùy chọn*) : Một chuỗi hoặc danh sách các chuỗi có thể được sử dụng để xác định các bộ dữ liệu trên Hub bằng tên của chúng, chẳng hạn như `SQAC` hoặc `wikineural`

gated (`bool`, *tuỳ chọn*) : Một giá trị boolean để lọc các bộ dữ liệu trên Hub có được kiểm soát truy cập hay không. Mặc định, tất cả các bộ dữ liệu đều được trả về. Nếu truyền `gated=True`, chỉ các bộ dữ liệu có kiểm soát truy cập được trả về. Nếu truyền `gated=False`, chỉ các bộ dữ liệu không có kiểm soát truy cập được trả về.

language_creators (`str` hoặc `List`, *tùy chọn*) : Một chuỗi hoặc danh sách các chuỗi có thể được sử dụng để xác định các bộ dữ liệu trên Hub bằng cách mô tả dữ liệu đã được tuyển chọn như thế nào, chẳng hạn như `crowdsourced` hoặc `machine_generated`.

language (`str` hoặc `List`, *tùy chọn*) : Một chuỗi hoặc danh sách các chuỗi đại diện cho một ngôn ngữ hai ký tự để lọc các bộ dữ liệu trên Hub.

multilinguality (`str` hoặc `List`, *tùy chọn*) : Một chuỗi hoặc danh sách các chuỗi đại diện cho bộ lọc dành cho các bộ dữ liệu chứa nhiều ngôn ngữ.

size_categories (`str` hoặc `List`, *tùy chọn*) : Một chuỗi hoặc danh sách các chuỗi có thể được sử dụng để xác định các bộ dữ liệu trên Hub theo kích thước của bộ dữ liệu, chẳng hạn như `100K<n<1M` hoặc `1M<n<10M`.

task_categories (`str` hoặc `List`, *tùy chọn*) : Một chuỗi hoặc danh sách các chuỗi có thể được sử dụng để xác định các bộ dữ liệu trên Hub theo nhiệm vụ được thiết kế, chẳng hạn như `audio_classification` hoặc `named_entity_recognition`.

task_ids (`str` hoặc `List`, *tùy chọn*) : Một chuỗi hoặc danh sách các chuỗi có thể được sử dụng để xác định các bộ dữ liệu trên Hub theo nhiệm vụ cụ thể như `speech_emotion_recognition` hoặc `paraphrase`.

search (`str`, *tùy chọn*) : Một chuỗi sẽ được chứa trong các bộ dữ liệu được trả về.

sort (`DatasetSort_T`, *tùy chọn*) : Khóa để sắp xếp các bộ dữ liệu kết quả. Các giá trị có thể là "created_at", "downloads", "last_modified", "likes" và "trending_score".

limit (`int`, *tuỳ chọn*) : Giới hạn số lượng bộ dữ liệu được lấy. Để tuỳ chọn này là `None` sẽ lấy tất cả các bộ dữ liệu.

expand (`list[ExpandDatasetProperty_T]`, *tùy chọn*) : Danh sách các thuộc tính cần trả về trong phản hồi. Khi được sử dụng, chỉ các thuộc tính trong danh sách sẽ được trả về. Tham số này không thể được sử dụng nếu `full` được truyền vào. Các giá trị có thể là `"author"`, `"cardData"`, `"citation"`, `"createdAt"`, `"disabled"`, `"description"`, `"downloads"`, `"downloadsAllTime"`, `"gated"`, `"lastModified"`, `"likes"`, `"mainSize"`, `"paperswithcode_id"`, `"private"`, `"siblings"`, `"sha"`, `"tags"`, `"trendingScore"`, `"usedStorage"` và `"resourceGroup"`.

full (`bool`, *tuỳ chọn*) : Có lấy toàn bộ dữ liệu của bộ dữ liệu hay không, bao gồm `last_modified`, `card_data` và các tệp. Có thể chứa thông tin hữu ích như ID PapersWithCode.

token (`bool` hoặc `str`, *tùy chọn*) : Một token truy cập người dùng hợp lệ (chuỗi). Mặc định là token được lưu cục bộ, đây là phương pháp xác thực được khuyến nghị (xem https://huggingface.co/docs/huggingface_hub/quick-start#authentication). Để tắt xác thực, truyền `False`.

**Trả về:** `Iterable[DatasetInfo]`

một iterable các đối tượng [huggingface_hub.hf_api.DatasetInfo](/docs/huggingface_hub/v2.4.0/vi/package_reference/hf_api#huggingface_hub.DatasetInfo).

Liệt kê các bộ dữ liệu được lưu trữ trên Huggingface Hub, dựa trên một số bộ lọc.

Ví dụ sử dụng với đối số `filter`:

```python
>>> from huggingface_hub import HfApi

>>> api = HfApi()

# List all datasets
>>> api.list_datasets()

# List only the text classification datasets
>>> api.list_datasets(filter="task_categories:text-classification")

# List only the datasets in russian for language modeling
>>> api.list_datasets(
...     filter=("language:ru", "task_ids:language-modeling")
... )

# List FiftyOne datasets (identified by the tag "fiftyone" in dataset card)
>>> api.list_datasets(filter="fiftyone")
```

Ví dụ sử dụng với đối số `search`:

```python
>>> from huggingface_hub import HfApi

>>> api = HfApi()

# List all datasets with "text" in their name
>>> api.list_datasets(search="text")

# List all datasets with "text" in their name made by google
>>> api.list_datasets(search="text", author="google")
```

#### list_inference_catalog[[huggingface_hub.HfApi.list_inference_catalog]]

```python
list_inference_catalog(accelerator: Literal['cpu', 'gpu', 'neuron'] | str | None = None, engine: Literal['llamacpp', 'sglang', 'tei', 'vllm'] | str | None = None, license: str | None = None, task: str | None = None, search: str | None = None, limit: int | None = None, token: bool | str | None = None)
```

[Nguồn](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L9587)

**Tham số:**

accelerator (`str`, *tùy chọn*) : Chỉ trả về các mô hình có công thức cho bộ tăng tốc này (`"cpu"`, `"gpu"` hoặc `"neuron"`).

engine (`str`, *tùy chọn*) : Chỉ trả về các mô hình có công thức cho engine suy luận này (ví dụ: `"vllm"`, `"llamacpp"`, `"tei"`, `"sglang"`).

license (`str`, *tùy chọn*) : Chỉ trả về các mô hình dưới giấy phép này (ví dụ: `"Apache 2.0"`).

task (`str`, *tùy chọn*) : Chỉ trả về các mô hình cho tác vụ này (ví dụ: `"text-generation"`).

search (`str`, *tùy chọn*) : Chỉ trả về các mô hình khớp với truy vấn tìm kiếm này.

limit (`int`, *tùy chọn*) : Số lượng tối đa các mô hình cần trả về.

token (`bool` hoặc `str`, *tùy chọn*) : Một token truy cập người dùng hợp lệ (chuỗi). Mặc định là token được lưu cục bộ, đây là phương pháp xác thực được khuyến nghị (xem https://huggingface.co/docs/huggingface_hub/quick-start#authentication).

**Trả về:** `list[InferenceCatalogModel]`

Các mô hình có sẵn trong danh mục, mỗi mô hình kèm theo các công thức đã được kiểm chứng.

Liệt kê các model có sẵn trong Hugging Face Inference Catalog.

Mục tiêu của Inference Catalog là cung cấp một danh sách các mô hình được tuyển chọn, tối ưu cho suy luận và đã được kiểm tra với các cấu hình mặc định. Xem https://endpoints.huggingface.co/catalog để biết danh sách các mô hình có sẵn trong catalog.

Sử dụng [create_inference_endpoint_from_catalog()](/docs/huggingface_hub/v2.4.0/vi/package_reference/hf_api#huggingface_hub.HfApi.create_inference_endpoint_from_catalog) để triển khai một mô hình hoặc một công thức từ danh mục.

Ví dụ:
```python
>>> from huggingface_hub import HfApi
>>> api = HfApi()
>>> catalog = api.list_inference_catalog(task="text-generation", accelerator="neuron")
>>> [(model.repo_id, [recipe.id for recipe in model.recipes]) for model in catalog]
[('meta-llama/Llama-3.1-8B-Instruct', ['sizzling-biryani-g4xsi1ac', 'artisanal-quinoa-yz9ynamx']), ...]
```

> [!WARNING]
> `list_inference_catalog` là thử nghiệm. API của nó có thể thay đổi trong tương lai. Vui lòng cung cấp phản hồi nếu bạn có bất kỳ đề xuất hoặc yêu cầu nào.

#### list_inference_endpoints[[huggingface_hub.HfApi.list_inference_endpoints]]

```python
list_inference_endpoints(namespace: str | None = None, token: bool | str | None = None)
```

[Nguồn](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L9147)

**Tham số:**

namespace (`str`, *tùy chọn*) : Không gian tên để liệt kê các endpoint. Mặc định là người dùng hiện tại. Đặt thành `"*"` để liệt kê tất cả các endpoint từ mọi không gian tên (tức là không gian tên cá nhân và tất cả các tổ chức mà người dùng thuộc về).

token (`bool` hoặc `str`, *tùy chọn*) : Một token truy cập người dùng hợp lệ (chuỗi). Mặc định là token được lưu cục bộ, đây là phương pháp xác thực được khuyến nghị (xem https://huggingface.co/docs/huggingface_hub/quick-start#authentication). Để tắt xác thực, truyền `False`.

**Trả về:** list[InferenceEndpoint](/docs/huggingface_hub/v2.4.0/vi/package_reference/inference_endpoints#huggingface_hub.InferenceEndpoint)

Danh sách tất cả các điểm cuối suy luận cho namespace được chỉ định.

Liệt kê tất cả các điểm cuối suy luận cho namespace được chỉ định.

Ví dụ:
```python
>>> from huggingface_hub import HfApi
>>> api = HfApi()
>>> api.list_inference_endpoints()
[InferenceEndpoint(name='my-endpoint', ...), ...]
```

#### list_inference_endpoints_hardware[[huggingface_hub.HfApi.list_inference_endpoints_hardware]]

```python
list_inference_endpoints_hardware(namespace: str | None = None, token: bool | str | None = None)
```

[Nguồn](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L10038)

**Tham số:**

namespace (`str`, *tùy chọn*) : Không gian tên mà bạn muốn liệt kê hạn mức phần cứng và bộ tăng tốc khả dụng. Mặc định là người dùng hiện tại.

token (`bool` hoặc `str`, *tùy chọn*) : Một token truy cập người dùng hợp lệ (chuỗi). Mặc định là token được lưu cục bộ, đây là phương pháp xác thực được khuyến nghị (xem https://huggingface.co/docs/huggingface_hub/quick-start#authentication).

**Trả về:** `list[InferenceEndpointHardware]`

Phần cứng có sẵn ở mọi nhà cung cấp và khu vực, bao gồm cả phần cứng hiện không khả dụng hoặc đã bị ngừng hỗ trợ.

Liệt kê phần cứng có sẵn để triển khai một Inference Endpoint.

Mỗi mục chứa các giá trị chính xác của `vendor`, `region`, `accelerator`, `instance_type` và `instance_size` được kỳ vọng bởi [create_inference_endpoint()](/docs/huggingface_hub/v2.4.0/vi/package_reference/hf_api#huggingface_hub.HfApi.create_inference_endpoint), cùng với giá và hạn mức accelerator của namespace.

Ví dụ:
```python
>>> from huggingface_hub import HfApi
>>> api = HfApi()
>>> hardware = api.list_inference_endpoints_hardware()
>>> [hw.id for hw in hardware if hw.accelerator == "gpu" and hw.status == "available"]
['aws-us-east-1-nvidia-l4-x1', 'aws-us-east-1-nvidia-l4-x4', ...]
```

#### list_jobs[[huggingface_hub.HfApi.list_jobs]]

```python
list_jobs(status: list[JobStage | str] | JobStage | str | None = None, labels: dict[str, str] | None = None, timeout: int | None = None, namespace: str | None = None, token: bool | str | None = None)
```

[Nguồn](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L12487)

**Tham số:**

status (`JobStage`, `str` hoặc `list`, *tùy chọn*) : Chỉ trả về các Job có trạng thái được chỉ định, ví dụ `"RUNNING"` hoặc `[JobStage.RUNNING, JobStage.SCHEDULING]`. Xem [JobStage](/docs/huggingface_hub/v2.4.0/vi/package_reference/jobs#huggingface_hub.JobStage) để biết các giá trị có thể.

labels (`dict[str, str]`, *tùy chọn*) : Chỉ trả về các Job có tất cả các nhãn `key=value` được cho, ví dụ `{"env": "prod", "team": "ml"}`.

timeout (`float`, *optional*) : Có nên đặt thời gian chờ (timeout) cho yêu cầu đến Hub hay không.

namespace (`str`, *tùy chọn*) : Không gian tên mà từ đó nó liệt kê các công việc. Mặc định là không gian tên của người dùng hiện tại.

token (`bool` hoặc `str`, *tùy chọn*) : Một token truy cập người dùng hợp lệ. Nếu không được cung cấp, token được lưu cục bộ sẽ được sử dụng, đây là phương thức xác thực được khuyến nghị. Đặt thành `False` để tắt xác thực. Tham khảo: https://huggingface.co/docs/huggingface_hub/quick-start#authentication.

**Trả về:** `Iterable[JobInfo]`

một iterable của các đối tượng [JobInfo](/docs/huggingface_hub/v2.4.0/vi/package_reference/jobs#huggingface_hub.JobInfo).

Liệt kê các Job tính toán trên hạ tầng của Hugging Face.

#### list_jobs_hardware[[huggingface_hub.HfApi.list_jobs_hardware]]

```python
list_jobs_hardware(token: bool | str | None = None)
```

[Nguồn](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L12535)

**Trả về:** `list[JobHardwareInfo]`

Danh sách các cấu hình phần cứng khả dụng.

Liệt kê các tùy chọn phần cứng khả dụng cho Jobs trên hạ tầng của Hugging Face.

Ví dụ:

```python
>>> from huggingface_hub import HfApi
>>> api = HfApi()
>>> hardware_list = api.list_jobs_hardware()
>>> hardware_list[0]
JobHardwareInfo(name='cpu-basic', pretty_name='CPU Basic', cpu='2 vCPU', ram='16 GB', ephemeral_storage='20 GB', accelerator=None, unit_cost_micro_usd=167, unit_cost_usd=0.000167, unit_label='minute')
>>> hardware_list[0].name
'cpu-basic'

# Filter GPU options
>>> gpu_hardware = [hw for hw in hardware_list if hw.accelerator is not None]
>>> gpu_hardware[0].accelerator.model
'T4'
```

#### list_lfs_files[[huggingface_hub.HfApi.list_lfs_files]]

```python
list_lfs_files(repo_id: str, repo_type: str | None = None, token: bool | str | None = None)
```

[Nguồn](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L4426)

**Tham số:**

repo_id (`str`) : Kho mà bạn đang liệt kê các tệp LFS.

repo_type (`str`, *tùy chọn*) : Kiểu của kho. Đặt thành `"dataset"` hoặc `"space"` nếu liệt kê từ một dataset hoặc space, `None` hoặc `"model"` nếu liệt kê từ một model. Mặc định là `None`.

token (`bool` hoặc `str`, *tùy chọn*) : Một token truy cập người dùng hợp lệ (chuỗi). Mặc định là token được lưu cục bộ, đây là phương pháp xác thực được khuyến nghị (xem https://huggingface.co/docs/huggingface_hub/quick-start#authentication). Để tắt xác thực, truyền `False`.

**Trả về:** `Iterable[LFSFileInfo]`

Một trình lặp các đối tượng `LFSFileInfo`.

Liệt kê tất cả các tệp LFS trong một kho trên Hub.

Điều này chủ yếu hữu ích để đếm lượng dung lượng lưu trữ mà một repo đang sử dụng và cuối cùng là dọn dẹp các tệp lớn bằng [permanently_delete_lfs_files()](/docs/huggingface_hub/v2.4.0/vi/package_reference/hf_api#huggingface_hub.HfApi.permanently_delete_lfs_files). Lưu ý rằng đây sẽ là một hành động vĩnh viễn, ảnh hưởng đến tất cả các commit tham chiếu đến các tệp đã bị xóa này và không thể hoàn tác.

Ví dụ:
```py
>>> from huggingface_hub import HfApi
>>> api = HfApi()
>>> lfs_files = api.list_lfs_files("username/my-cool-repo")

# Filter files to delete based on a combination of `filename`, `pushed_at`, `ref` or `size`.
# e.g. select only LFS files in the "checkpoints" folder
>>> lfs_files_to_delete = (lfs_file for lfs_file in lfs_files if lfs_file.filename.startswith("checkpoints/"))

# Permanently delete LFS files
>>> api.permanently_delete_lfs_files("username/my-cool-repo", lfs_files_to_delete)
```

#### list_liked_repos[[huggingface_hub.HfApi.list_liked_repos]]

```python
list_liked_repos(user: str | None = None, token: bool | str | None = None)
```

[Nguồn](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L2988)

**Tham số:**

user (`str`, *tùy chọn*) : Tên của người dùng mà bạn muốn lấy các lượt thích.

token (`bool` hoặc `str`, *tùy chọn*) : Một token truy cập người dùng hợp lệ (chuỗi). Mặc định là token được lưu cục bộ, đây là phương pháp xác thực được khuyến nghị (xem https://huggingface.co/docs/huggingface_hub/quick-start#authentication). Để tắt xác thực, truyền `False`.

**Trả về:** [UserLikes](/docs/huggingface_hub/v2.4.0/vi/package_reference/hf_api#huggingface_hub.UserLikes)

đối tượng chứa tên người dùng và 3 danh sách id kho (1 cho models, 1 cho datasets và 1 cho Spaces).

**Lỗi:** ``ValueError``

- [`ValueError`](https://docs.python.org/3/library/exceptions.html#ValueError) -- Nếu `user` không được truyền và không tìm thấy token (từ đối số hoặc từ máy).

Liệt kê tất cả các kho lưu trữ công khai được một người dùng thích trên huggingface.co.

Danh sách này là công khai nên token là tùy chọn. Nếu `user` không được truyền vào, giá trị mặc định sẽ là người dùng đang đăng nhập.

Xem thêm [unlike()](/docs/huggingface_hub/v2.4.0/vi/package_reference/hf_api#huggingface_hub.HfApi.unlike).

Ví dụ:
```python
>>> from huggingface_hub import list_liked_repos

>>> likes = list_liked_repos("julien-c")

>>> likes.user
"julien-c"

>>> likes.models
["osanseviero/streamlit_1.15", "Xhaheen/ChatGPT_HF", ...]
```

#### list_models[[huggingface_hub.HfApi.list_models]]

```python
list_models(filter: str | Iterable[str] | None = None, author: str | None = None, apps: str | list[str] | None = None, gated: bool | None = None, inference: Literal['warm'] | None = None, inference_provider: Literal['all'] | PROVIDER_T | list[PROVIDER_T] | None = None, trained_dataset: str | list[str] | None = None, search: str | None = None, pipeline_tag: str | None = None, num_parameters: str | None = None, emissions_thresholds: tuple[float, float] | None = None, sort: ModelSort_T | None = None, limit: int | None = None, expand: list[ExpandModelProperty_T] | None = None, full: bool | None = None, cardData: bool = False, fetch_config: bool = False, token: bool | str | None = None)
```

[Nguồn](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L2310)

**Tham số:**

filter (`str` hoặc `Iterable[str]`, *tùy chọn*) : Một chuỗi hoặc danh sách các chuỗi để lọc các model trên Hub. Các model có thể được lọc theo thư viện, ngôn ngữ, tác vụ, thẻ, và nhiều tiêu chí khác.

author (`str`, *tùy chọn*) : Một chuỗi nhận diện tác giả (người dùng hoặc tổ chức) của các mô hình được trả về.

apps (`str` hoặc `List`, *tùy chọn*) : Một chuỗi hoặc danh sách các chuỗi để lọc các model trên Hub hỗ trợ các ứng dụng được chỉ định. Các giá trị ví dụ bao gồm `"ollama"` hoặc `["ollama", "vllm"]`.

gated (`bool`, *tuỳ chọn*) : Một giá trị boolean để lọc các model trên Hub có bị hạn chế truy cập (gated) hay không. Mặc định, tất cả các model đều được trả về. Nếu truyền `gated=True`, chỉ các model bị hạn chế truy cập sẽ được trả về. Nếu truyền `gated=False`, chỉ các model không bị hạn chế truy cập sẽ được trả về.

inference (`Literal["warm"]`, *tùy chọn*) : Nếu là "warm", lọc các model trên Hub hiện đang được phục vụ bởi ít nhất một nhà cung cấp.

inference_provider (`Literal["all"]` hoặc `str`, *tùy chọn*) : Một chuỗi để lọc các model trên Hub được cung cấp bởi một nhà cung cấp cụ thể. Truyền `"all"` để lấy tất cả các model được cung cấp bởi ít nhất một nhà cung cấp.

trained_dataset (`str` hoặc `List`, *tùy chọn*) : Một thẻ chuỗi hoặc danh sách các thẻ chuỗi của bộ dữ liệu đã được huấn luyện cho một mô hình trên Hub.

search (`str`, *tùy chọn*) : Một chuỗi sẽ được chứa trong các id mô hình được trả về.

pipeline_tag (`str`, *tùy chọn*) : Một thẻ pipeline dạng chuỗi để lọc các model trên Hub, chẳng hạn như `summarization`.

num_parameters (`str`, *tùy chọn*) : Lọc các mô hình theo số lượng tham số. Chấp nhận cùng cú pháp khoảng giá trị như giao diện người dùng và API của Hub, ví dụ `"min:6B,max:128B"`, `"min:6B"` hoặc `"max:128B"`.

emissions_thresholds (`Tuple`, *tùy chọn*) : Một tuple gồm hai số nguyên hoặc số thực đại diện cho mức phát thải carbon tối thiểu và tối đa để lọc các mô hình kết quả, tính bằng gam.

sort (`ModelSort_T`, *tùy chọn*) : Khóa để sắp xếp các mô hình kết quả. Các giá trị có thể là "created_at", "downloads", "last_modified", "likes" và "trending_score".

limit (`int`, *tuỳ chọn*) : Giới hạn số lượng mô hình được lấy. Để tuỳ chọn này là `None` sẽ lấy tất cả các mô hình.

expand (`list[ExpandModelProperty_T]`, *optional*) : Danh sách các thuộc tính cần trả về trong phản hồi. Khi được sử dụng, chỉ các thuộc tính trong danh sách sẽ được trả về. Tham số này không thể được sử dụng nếu `full`, `cardData` hoặc `fetch_config` được truyền vào. Các giá trị có thể là `"author"`, `"cardData"`, `"config"`, `"createdAt"`, `"disabled"`, `"downloads"`, `"downloadsAllTime"`, `"evalResults"`, `"gated"`, `"gguf"`, `"inference"`, `"inferenceProviderMapping"`, `"lastModified"`, `"library_name"`, `"likes"`, `"mask_token"`, `"model-index"`, `"pipeline_tag"`, `"private"`, `"safetensors"`, `"sha"`, `"siblings"`, `"spaces"`, `"tags"`, `"transformersInfo"`, `"trendingScore"`, `"widgetData"` và `"resourceGroup"`.

full (`bool`, *tùy chọn*) : Có lấy tất cả dữ liệu của mô hình hay không, bao gồm `last_modified`, `sha`, các tệp và `tags`. Mặc định được đặt thành `True` khi sử dụng bộ lọc.

cardData (`bool`, *tùy chọn*) : Có lấy thêm metadata của model hay không. Có thể chứa thông tin hữu ích như lượng khí thải carbon, các chỉ số (metrics) và các dataset được dùng để huấn luyện.

fetch_config (`bool`, *tùy chọn*) : Có lấy cả cấu hình của mô hình hay không. Mục này không được bao gồm trong `full` do kích thước của nó.

token (`bool` hoặc `str`, *tùy chọn*) : Một token truy cập người dùng hợp lệ (chuỗi). Mặc định là token được lưu cục bộ, đây là phương pháp xác thực được khuyến nghị (xem https://huggingface.co/docs/huggingface_hub/quick-start#authentication). Để tắt xác thực, truyền `False`.

**Trả về:** `Iterable[ModelInfo]`

một iterable các đối tượng [huggingface_hub.hf_api.ModelInfo](/docs/huggingface_hub/v2.4.0/vi/package_reference/hf_api#huggingface_hub.ModelInfo).

Liệt kê các mô hình được lưu trữ trên Huggingface Hub, dựa trên một số bộ lọc.

Ví dụ:

```python
>>> from huggingface_hub import HfApi

>>> api = HfApi()

# List all models
>>> api.list_models()

# List text classification models
>>> api.list_models(filter="text-classification")

# List models from the KerasHub library
>>> api.list_models(filter="keras-hub")

# List models served by Cohere
>>> api.list_models(inference_provider="cohere")

# List models with "bert" in their name
>>> api.list_models(search="bert")

# List models with "bert" in their name and pushed by google
>>> api.list_models(search="bert", author="google")

# List models with 6B to 128B parameters
>>> api.list_models(num_parameters="min:6B,max:128B", sort="likes")
```

#### list_organization_followers[[huggingface_hub.HfApi.list_organization_followers]]

```python
list_organization_followers(organization: str, token: bool | str | None = None)
```

[Nguồn](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L11774)

**Tham số:**

organization (`str`) : Tên của tổ chức cần lấy danh sách người theo dõi.

token (`bool` hoặc `str`, *tùy chọn*) : Một token truy cập người dùng hợp lệ (chuỗi). Mặc định là token được lưu cục bộ, đây là phương pháp xác thực được khuyến nghị (xem https://huggingface.co/docs/huggingface_hub/quick-start#authentication). Để tắt xác thực, truyền `False`.

**Trả về:** `Iterable[User]`

Danh sách các đối tượng [User](/docs/huggingface_hub/v2.4.0/vi/package_reference/hf_api#huggingface_hub.User) là người theo dõi của tổ chức.

**Gây ra:** `HfHubHTTPError`

- `HfHubHTTPError` -- HTTP 404 Nếu tổ chức không tồn tại trên Hub.

Liệt kê người theo dõi của một tổ chức trên Hub.

#### list_organization_members[[huggingface_hub.HfApi.list_organization_members]]

```python
list_organization_members(organization: str, token: bool | str | None = None)
```

[Nguồn](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L11803)

**Tham số:**

organization (`str`) : Tên của tổ chức cần lấy danh sách thành viên.

token (`bool` hoặc `str`, *tùy chọn*) : Một token truy cập người dùng hợp lệ (chuỗi). Mặc định là token được lưu cục bộ, đây là phương pháp xác thực được khuyến nghị (xem https://huggingface.co/docs/huggingface_hub/quick-start#authentication). Để tắt xác thực, truyền `False`.

**Trả về:** `Iterable[User]`

Danh sách các đối tượng [User](/docs/huggingface_hub/v2.4.0/vi/package_reference/hf_api#huggingface_hub.User) với các thành viên của tổ chức.

**Gây ra:** `HfHubHTTPError`

- `HfHubHTTPError` -- HTTP 404 Nếu tổ chức không tồn tại trên Hub.

Danh sách các thành viên của một tổ chức trên Hub.

#### list_papers[[huggingface_hub.HfApi.list_papers]]

```python
list_papers(query: str | None = None, limit: int | None = None, token: bool | str | None = None)
```

[Nguồn](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L11887)

**Tham số:**

query (`str`, *tùy chọn*) : Chuỗi truy vấn tìm kiếm để tìm các bài báo. Nếu được cung cấp, sẽ trả về các bài báo khớp với truy vấn.

limit (`int`, *tùy chọn*) : Số lượng tối đa các bài báo cần trả về.

token (Union[bool, str, None], *tùy chọn*) : Một token truy cập người dùng hợp lệ (chuỗi). Mặc định là token được lưu cục bộ, đây là phương pháp xác thực được khuyến nghị (xem https://huggingface.co/docs/huggingface_hub/quick-start#authentication). Để tắt xác thực, truyền `False`.

**Trả về:** `Iterable[PaperInfo]`

một iterable các đối tượng `huggingface_hub.hf_api.PaperInfo`.

Liệt kê các bài báo hàng ngày trên Hugging Face Hub dựa trên truy vấn tìm kiếm.

Ví dụ:

```python
>>> from huggingface_hub import HfApi

>>> api = HfApi()

# List all papers with "attention" in their title
>>> api.list_papers(query="attention")
```

#### list_pending_access_requests[[huggingface_hub.HfApi.list_pending_access_requests]]

```python
list_pending_access_requests(repo_id: str, repo_type: str | None = None, token: bool | str | None = None)
```

[Nguồn](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L10604)

**Tham số:**

repo_id (`str`) : id của repo để lấy các yêu cầu truy cập.

repo_type (`str`, *tùy chọn*) : Kiểu của kho cần lấy các yêu cầu truy cập. Phải là một trong `model`, `dataset` hoặc `space`. Mặc định là `model`.

token (`bool` hoặc `str`, *tùy chọn*) : Một token truy cập người dùng hợp lệ (chuỗi). Mặc định là token được lưu cục bộ, đây là phương pháp xác thực được khuyến nghị (xem https://huggingface.co/docs/huggingface_hub/quick-start#authentication). Để tắt xác thực, truyền `False`.

**Trả về:** `Iterable[AccessRequest]`

Một iterable gồm các đối tượng `AccessRequest`. Mỗi mục chứa các thuộc tính `username`, `request_id`, `email`, `status` và `timestamp`. Nếu kho có cổng (gated repo) có biểu mẫu tùy chỉnh, thuộc tính `fields` sẽ được điền với các câu trả lời của người dùng.

**Gây ra:** `HfHubHTTPError`

- `HfHubHTTPError` -- HTTP 400 nếu kho không được bảo vệ.
- `HfHubHTTPError` -- HTTP 403 nếu bạn chỉ có quyền truy cập chỉ đọc vào kho. Điều này có thể xảy ra nếu bạn không có vai trò `write` hoặc `admin` trong tổ chức mà kho thuộc về, hoặc nếu bạn đã truyền một token `read`.

Lấy các yêu cầu truy cập đang chờ cho một kho có kiểm soát được chỉ định.

Một yêu cầu đang chờ có nghĩa là người dùng đã yêu cầu quyền truy cập vào kho nhưng yêu cầu đó chưa được xử lý. Nếu chế độ phê duyệt là tự động, danh sách này phải trống. Các yêu cầu đang chờ có thể được chấp nhận hoặc từ chối bằng [accept_access_request()](/docs/huggingface_hub/v2.4.0/vi/package_reference/hf_api#huggingface_hub.HfApi.accept_access_request) và [reject_access_request()](/docs/huggingface_hub/v2.4.0/vi/package_reference/hf_api#huggingface_hub.HfApi.reject_access_request).

Để biết thêm thông tin về các kho lưu trữ có kiểm soát, hãy xem https://huggingface.co/docs/hub/models-gated.

Ví dụ:
```py
>>> from huggingface_hub import list_pending_access_requests, accept_access_request

# List pending requests
>>> requests = list(list_pending_access_requests("meta-llama/Llama-2-7b"))
>>> len(requests)
411
>>> requests[0]
[
    AccessRequest(
        username='clem',
        request_id='655f3a1c9e6b2d4f8a7c1e05',
        fullname='Clem 🤗',
        email='***',
        timestamp=datetime.datetime(2023, 11, 23, 18, 4, 53, 828000, tzinfo=datetime.timezone.utc),
        status='pending',
        fields=None,
    ),
    ...
]

# Accept Clem's request
>>> accept_access_request("meta-llama/Llama-2-7b", "clem")
```

#### list_rejected_access_requests[[huggingface_hub.HfApi.list_rejected_access_requests]]

```python
list_rejected_access_requests(repo_id: str, repo_type: str | None = None, token: bool | str | None = None)
```

[Nguồn](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L10732)

**Tham số:**

repo_id (`str`) : id của repo để lấy các yêu cầu truy cập.

repo_type (`str`, *tùy chọn*) : Kiểu của kho cần lấy các yêu cầu truy cập. Phải là một trong `model`, `dataset` hoặc `space`. Mặc định là `model`.

token (`bool` hoặc `str`, *tùy chọn*) : Một token truy cập người dùng hợp lệ (chuỗi). Mặc định là token được lưu cục bộ, đây là phương pháp xác thực được khuyến nghị (xem https://huggingface.co/docs/huggingface_hub/quick-start#authentication). Để tắt xác thực, truyền `False`.

**Trả về:** `Iterable[AccessRequest]`

Một iterable gồm các đối tượng `AccessRequest`. Mỗi mục chứa các thuộc tính `username`, `request_id`, `email`, `status` và `timestamp`. Nếu kho có cổng (gated repo) có biểu mẫu tùy chỉnh, thuộc tính `fields` sẽ được điền với các câu trả lời của người dùng.

**Gây ra:** `HfHubHTTPError`

- `HfHubHTTPError` -- HTTP 400 nếu kho không được bảo vệ.
- `HfHubHTTPError` -- HTTP 403 nếu bạn chỉ có quyền truy cập chỉ đọc vào kho. Điều này có thể xảy ra nếu bạn không có vai trò `write` hoặc `admin` trong tổ chức mà kho thuộc về, hoặc nếu bạn đã truyền một token `read`.

Lấy các yêu cầu truy cập bị từ chối cho một kho có kiểm soát nhất định.

Yêu cầu bị từ chối có nghĩa là người dùng đã yêu cầu quyền truy cập vào repo và yêu cầu đó đã bị chủ sở hữu repo (có thể là bạn hoặc một người dùng khác trong tổ chức của bạn) từ chối một cách rõ ràng. Người dùng không thể tải xuống bất kỳ tệp nào của repo. Các yêu cầu bị từ chối có thể được chấp nhận hoặc hủy vào bất kỳ lúc nào bằng cách sử dụng [accept_access_request()](/docs/huggingface_hub/v2.4.0/vi/package_reference/hf_api#huggingface_hub.HfApi.accept_access_request) và [cancel_access_request()](/docs/huggingface_hub/v2.4.0/vi/package_reference/hf_api#huggingface_hub.HfApi.cancel_access_request). Một yêu cầu bị hủy sẽ quay lại danh sách chờ, trong khi một yêu cầu được chấp nhận sẽ chuyển sang danh sách đã chấp nhận.

Để biết thêm thông tin về các kho lưu trữ có kiểm soát, hãy xem https://huggingface.co/docs/hub/models-gated.

Ví dụ:
```py
>>> from huggingface_hub import list_rejected_access_requests

>>> requests = list(list_rejected_access_requests("meta-llama/Llama-2-7b"))
>>> len(requests)
411
>>> requests[0]
[
    AccessRequest(
        username='clem',
        request_id='655f3a1c9e6b2d4f8a7c1e05',
        fullname='Clem 🤗',
        email='***',
        timestamp=datetime.datetime(2023, 11, 23, 18, 4, 53, 828000, tzinfo=datetime.timezone.utc),
        status='rejected',
        fields=None,
    ),
    ...
]
```

#### list_repo_commits[[huggingface_hub.HfApi.list_repo_commits]]

```python
list_repo_commits(repo_id: str, repo_type: str | None = None, token: bool | str | None = None, revision: str | None = None, formatted: bool = False)
```

[Nguồn](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L4183)

**Tham số:**

repo_id (`str`) : Một namespace (người dùng hoặc tổ chức) và tên kho, được phân tách bằng `/`.

repo_type (`str`, *tùy chọn*) : Đặt thành `"dataset"` hoặc `"space"` nếu liệt kê các commit từ một dataset hoặc một Space, `None` hoặc `"model"` nếu liệt kê từ một model. Mặc định là `None`.

token (`bool` hoặc `str`, *tùy chọn*) : Một token truy cập người dùng hợp lệ (chuỗi). Mặc định là token được lưu cục bộ, đây là phương pháp xác thực được khuyến nghị (xem https://huggingface.co/docs/huggingface_hub/quick-start#authentication). Để tắt xác thực, truyền `False`.

revision (`str`, *tùy chọn*) : Bản sửa git để commit từ. Mặc định là đầu của nhánh `"main"`.

formatted (`bool`) : Xác định có trả về tiêu đề và mô tả của các commit được định dạng HTML hay không. Mặc định là False.

**Trả về:** list[[GitCommitInfo](/docs/huggingface_hub/v2.4.0/vi/package_reference/hf_api#huggingface_hub.GitCommitInfo)]

danh sách các đối tượng chứa thông tin về các commit cho một kho trên Hub.

**Gây ra:** [RepositoryNotFoundError](/docs/huggingface_hub/v2.4.0/vi/package_reference/utilities#huggingface_hub.errors.RepositoryNotFoundError) hoặc [RevisionNotFoundError](/docs/huggingface_hub/v2.4.0/vi/package_reference/utilities#huggingface_hub.errors.RevisionNotFoundError)

- [RepositoryNotFoundError](/docs/huggingface_hub/v2.4.0/vi/package_reference/utilities#huggingface_hub.errors.RepositoryNotFoundError) -- Nếu không tìm thấy kho (lỗi 404): repo_id/repo_type không đúng, kho là riêng tư nhưng chưa xác thực hoặc kho không tồn tại.
- [RevisionNotFoundError](/docs/huggingface_hub/v2.4.0/vi/package_reference/utilities#huggingface_hub.errors.RevisionNotFoundError) -- Nếu không tìm thấy revision (lỗi 404) trên kho.

Lấy danh sách các commit của một phiên bản nhất định cho một kho trên Hub.

Các commit được sắp xếp theo ngày (commit gần nhất ở đầu).

Ví dụ:
```py
>>> from huggingface_hub import HfApi
>>> api = HfApi()

# Commits are sorted by date (last commit first)
>>> initial_commit = api.list_repo_commits("gpt2")[-1]

# Initial commit is always a system commit containing the `.gitattributes` file.
>>> initial_commit
GitCommitInfo(
    commit_id='9b865efde13a30c13e0a33e536cf3e4a5a9d71d8',
    authors=['system'],
    created_at=datetime.datetime(2019, 2, 18, 10, 36, 15, tzinfo=datetime.timezone.utc),
    title='initial commit',
    message='',
    formatted_title=None,
    formatted_message=None
)

# Create an empty branch by deriving from initial commit
>>> api.create_branch("gpt2", branch="new_empty_branch", revision=initial_commit.commit_id)
```

#### list_repo_files[[huggingface_hub.HfApi.list_repo_files]]

```python
list_repo_files(repo_id: str, revision: str | None = None, repo_type: str | None = None, token: str | bool | None = None)
```

[Nguồn](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L3829)

**Tham số:**

repo_id (`str`) : Một namespace (người dùng hoặc tổ chức) và tên kho, được phân tách bằng `/`.

revision (`str`, *tùy chọn*) : Phiên bản của kho chứa mà từ đó lấy thông tin.

repo_type (`str`, *tùy chọn*) : Đặt thành `"dataset"` hoặc `"space"` nếu tải lên một dataset hoặc space, `None` hoặc `"model"` nếu tải lên một model. Mặc định là `None`.

token (`bool` hoặc `str`, *tùy chọn*) : Một token truy cập người dùng hợp lệ (chuỗi). Mặc định là token được lưu cục bộ, đây là phương pháp xác thực được khuyến nghị (xem https://huggingface.co/docs/huggingface_hub/quick-start#authentication). Để tắt xác thực, truyền `False`.

**Trả về:** `list[str]`

danh sách các tệp trong một kho lưu trữ nhất định.

Lấy danh sách các tệp trong một kho lưu trữ được chỉ định.

#### list_repo_likers[[huggingface_hub.HfApi.list_repo_likers]]

```python
list_repo_likers(repo_id: str, repo_type: str | None = None, token: bool | str | None = None)
```

[Nguồn](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L3105)

**Tham số:**

repo_id (`str`) : Kho lưu trữ cần truy xuất. Ví dụ: `"user/my-cool-model"`.

token (`bool` hoặc `str`, *tùy chọn*) : Một token truy cập người dùng hợp lệ (chuỗi). Mặc định là token được lưu cục bộ, đây là phương pháp xác thực được khuyến nghị (xem https://huggingface.co/docs/huggingface_hub/quick-start#authentication). Để tắt xác thực, truyền `False`.

repo_type (`str`, *tùy chọn*) : Đặt thành `"dataset"` hoặc `"space"` nếu tải lên một dataset hoặc space, `None` hoặc `"model"` nếu tải lên một model. Mặc định là `None`.

**Trả về:** `Iterable[User]`

một iterable các đối tượng [huggingface_hub.hf_api.User](/docs/huggingface_hub/v2.4.0/vi/package_reference/hf_api#huggingface_hub.User).

Liệt kê tất cả người dùng đã thích một kho lưu trữ (repo) cụ thể trên hugging Face Hub.

Xem thêm [list_liked_repos()](/docs/huggingface_hub/v2.4.0/vi/package_reference/hf_api#huggingface_hub.HfApi.list_liked_repos).

#### list_repo_refs[[huggingface_hub.HfApi.list_repo_refs]]

```python
list_repo_refs(repo_id: str, repo_type: str | None = None, include_pull_requests: bool = False, token: str | bool | None = None)
```

[Nguồn](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L4111)

**Tham số:**

repo_id (`str`) : Một namespace (người dùng hoặc tổ chức) và tên kho, được phân tách bằng `/`.

repo_type (`str`, *tùy chọn*) : Đặt thành `"dataset"`, `"space"` hoặc `"kernel"` nếu liệt kê refs từ một dataset, một Space hoặc một Kernel, `None` hoặc `"model"` nếu liệt kê từ một model. Mặc định là `None`.

include_pull_requests (`bool`, *tuỳ chọn*) : Có bao gồm các refs từ pull request trong danh sách hay không. Mặc định là `False`.

token (`bool` hoặc `str`, *tùy chọn*) : Một token truy cập người dùng hợp lệ (chuỗi). Mặc định là token được lưu cục bộ, đây là phương pháp xác thực được khuyến nghị (xem https://huggingface.co/docs/huggingface_hub/quick-start#authentication). Để tắt xác thực, truyền `False`.

**Trả về:** [GitRefs](/docs/huggingface_hub/v2.4.0/vi/package_reference/hf_api#huggingface_hub.GitRefs)

đối tượng chứa tất cả thông tin về các nhánh và thẻ cho một kho trên Hub.

Lấy danh sách các refs của một kho (repo) cho trước (cả tags và branches).

Ví dụ:
```py
>>> from huggingface_hub import HfApi
>>> api = HfApi()
>>> api.list_repo_refs("gpt2")
GitRefs(branches=[GitRefInfo(name='main', ref='refs/heads/main', target_commit='e7da7f221d5bf496a48136c0cd264e630fe9fcc8')], converts=[], tags=[])

>>> api.list_repo_refs("bigcode/the-stack", repo_type='dataset')
GitRefs(
    branches=[
        GitRefInfo(name='main', ref='refs/heads/main', target_commit='18edc1591d9ce72aa82f56c4431b3c969b210ae3'),
        GitRefInfo(name='v1.1.a1', ref='refs/heads/v1.1.a1', target_commit='f9826b862d1567f3822d3d25649b0d6d22ace714')
    ],
    converts=[],
    tags=[
        GitRefInfo(name='v1.0', ref='refs/tags/v1.0', target_commit='c37a8cd1e382064d8aced5e05543c5f7753834da')
    ]
)
```

#### list_repo_tree[[huggingface_hub.HfApi.list_repo_tree]]

```python
list_repo_tree(repo_id: str, path_in_repo: str | None = None, recursive: bool = False, expand: bool = False, revision: str | None = None, repo_type: str | None = None, token: str | bool | None = None)
```

[Nguồn](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L3866)

**Tham số:**

repo_id (`str`) : Một namespace (người dùng hoặc tổ chức) và tên kho, được phân tách bằng `/`.

path_in_repo (`str`, *tùy chọn*) : Đường dẫn tương đối của cây (thư mục) trong kho, ví dụ: `"checkpoints/1fec34a/results"`. Mặc định sẽ là cây (thư mục) gốc của kho.

recursive (`bool`, *tùy chọn*, mặc định là `False`) : Có nên liệt kê đệ quy các tệp và thư mục của cây hay không.

expand (`bool`, *tùy chọn*, mặc định là `False`) : Có nên lấy thêm thông tin về các tệp và thư mục của cây hay không (ví dụ: commit gần nhất và kết quả quét bảo mật của các tệp). Thao tác này tốn kém hơn cho máy chủ nên chỉ trả về 50 kết quả mỗi trang (thay vì 1000). Vì phân trang được triển khai trong `huggingface_hub`, điều này là minh bạch với bạn ngoại trừ thời gian để nhận được kết quả.

revision (`str`, *tùy chọn*) : Phiên bản của kho chứa để lấy cây. Mặc định là nhánh `"main"`.

repo_type (`str`, *tùy chọn*) : Kiểu của kho chứa mà từ đó lấy cây (`"model"`, `"dataset"`, `"space"` hoặc `"kernel"`). Mặc định là `"model"`.

token (`bool` hoặc `str`, *tùy chọn*) : Một token truy cập người dùng hợp lệ (chuỗi). Mặc định là token được lưu cục bộ, đây là phương pháp xác thực được khuyến nghị (xem https://huggingface.co/docs/huggingface_hub/quick-start#authentication). Để tắt xác thực, truyền `False`.

**Trả về:** `Iterable[Union[RepoFile, RepoFolder]]`

Thông tin về các tệp và thư mục của cây, dưới dạng một đối tượng lặp được của các đối tượng [RepoFile](/docs/huggingface_hub/v2.4.0/vi/package_reference/hf_api#huggingface_hub.RepoFile) và `RepoFolder`. Thứ tự của các tệp và thư mục không được đảm bảo.

**Gây ra:** [RepositoryNotFoundError](/docs/huggingface_hub/v2.4.0/vi/package_reference/utilities#huggingface_hub.errors.RepositoryNotFoundError) hoặc [RevisionNotFoundError](/docs/huggingface_hub/v2.4.0/vi/package_reference/utilities#huggingface_hub.errors.RevisionNotFoundError) hoặc `~utils.RemoteEntryNotFoundError`

- [RepositoryNotFoundError](/docs/huggingface_hub/v2.4.0/vi/package_reference/utilities#huggingface_hub.errors.RepositoryNotFoundError) -- Nếu không tìm thấy kho (lỗi 404): repo_id/repo_type không đúng, kho là riêng tư nhưng chưa xác thực hoặc kho không tồn tại.
- [RevisionNotFoundError](/docs/huggingface_hub/v2.4.0/vi/package_reference/utilities#huggingface_hub.errors.RevisionNotFoundError) -- Nếu không tìm thấy revision (lỗi 404) trên kho.
- `~utils.RemoteEntryNotFoundError` -- Nếu cây (thư mục) không tồn tại (lỗi 404) trên kho.

Liệt kê các tệp và thư mục trong cây của kho và lấy thông tin về chúng.

Ví dụ:

Lấy thông tin về cây của một kho.

```py
>>> from huggingface_hub import list_repo_tree
>>> repo_tree = list_repo_tree("lysandre/arxiv-nlp")
>>> repo_tree
<generator object HfApi.list_repo_tree at 0x7fa4088e1ac0>
>>> list(repo_tree)
[
    RepoFile(path='.gitattributes', size=391, blob_id='ae8c63daedbd4206d7d40126955d4e6ab1c80f8f', lfs=None, last_commit=None, security=None),
    RepoFile(path='README.md', size=391, blob_id='43bd404b159de6fba7c2f4d3264347668d43af25', lfs=None, last_commit=None, security=None),
    RepoFile(path='config.json', size=554, blob_id='2f9618c3a19b9a61add74f70bfb121335aeef666', lfs=None, last_commit=None, security=None),
    RepoFile(
        path='flax_model.msgpack', size=497764107, blob_id='8095a62ccb4d806da7666fcda07467e2d150218e',
        lfs={'size': 497764107, 'sha256': 'd88b0d6a6ff9c3f8151f9d3228f57092aaea997f09af009eefd7373a77b5abb9', 'pointer_size': 134}, last_commit=None, security=None
    ),
    RepoFile(path='merges.txt', size=456318, blob_id='226b0752cac7789c48f0cb3ec53eda48b7be36cc', lfs=None, last_commit=None, security=None),
    RepoFile(
        path='pytorch_model.bin', size=548123560, blob_id='64eaa9c526867e404b68f2c5d66fd78e27026523',
        lfs={'size': 548123560, 'sha256': '9be78edb5b928eba33aa88f431551348f7466ba9f5ef3daf1d552398722a5436', 'pointer_size': 134}, last_commit=None, security=None
    ),
    RepoFile(path='vocab.json', size=898669, blob_id='b00361fece0387ca34b4b8b8539ed830d644dbeb', lfs=None, last_commit=None, security=None)]
]
```

Lấy thêm thông tin về cây thư mục của một kho (cam kết cuối cùng và kết quả quét bảo mật của các tệp)

```py
>>> from huggingface_hub import list_repo_tree
>>> repo_tree = list_repo_tree("prompthero/openjourney-v4", expand=True)
>>> list(repo_tree)
[
    RepoFolder(
        path='feature_extractor',
        tree_id='aa536c4ea18073388b5b0bc791057a7296a00398',
        last_commit={
            'oid': '47b62b20b20e06b9de610e840282b7e6c3d51190',
            'title': 'Upload diffusers weights (#48)',
            'date': datetime.datetime(2023, 3, 21, 9, 5, 27, tzinfo=datetime.timezone.utc)
        }
    ),
    RepoFolder(
        path='safety_checker',
        tree_id='65aef9d787e5557373fdf714d6c34d4fcdd70440',
        last_commit={
            'oid': '47b62b20b20e06b9de610e840282b7e6c3d51190',
            'title': 'Upload diffusers weights (#48)',
            'date': datetime.datetime(2023, 3, 21, 9, 5, 27, tzinfo=datetime.timezone.utc)
        }
    ),
    RepoFile(
        path='model_index.json',
        size=582,
        blob_id='d3d7c1e8c3e78eeb1640b8e2041ee256e24c9ee1',
        lfs=None,
        last_commit={
            'oid': 'b195ed2d503f3eb29637050a886d77bd81d35f0e',
            'title': 'Fix deprecation warning by changing `CLIPFeatureExtractor` to `CLIPImageProcessor`. (#54)',
            'date': datetime.datetime(2023, 5, 15, 21, 41, 59, tzinfo=datetime.timezone.utc)
        },
        security={
            'safe': True,
            'av_scan': {'virusFound': False, 'virusNames': None},
            'pickle_import_scan': None
        }
    )
    ...
]
```

#### list_scheduled_jobs[[huggingface_hub.HfApi.list_scheduled_jobs]]

```python
list_scheduled_jobs(labels: dict[str, str] | None = None, timeout: int | None = None, namespace: str | None = None, token: bool | str | None = None)
```

[Nguồn](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L13231)

**Tham số:**

labels (`dict[str, str]`, *tùy chọn*) : Chỉ trả về các Job đã được lên lịch có tất cả các nhãn `key=value` được cho, ví dụ: `{"env": "prod", "team": "ml"}`.

timeout (`float`, *optional*) : Có nên đặt thời gian chờ (timeout) cho yêu cầu đến Hub hay không.

namespace (`str`, *tùy chọn*) : Không gian tên mà từ đó nó liệt kê các công việc. Mặc định là không gian tên của người dùng hiện tại.

token (`bool` hoặc `str`, *tùy chọn*) : Một token truy cập người dùng hợp lệ. Nếu không được cung cấp, token được lưu cục bộ sẽ được sử dụng, đây là phương thức xác thực được khuyến nghị. Đặt thành `False` để tắt xác thực. Tham khảo: https://huggingface.co/docs/huggingface_hub/quick-start#authentication.

**Trả về:** `list[ScheduledJobInfo]`

một danh sách các đối tượng `ScheduledJobInfo`.

Liệt kê các Job tính toán đã lên lịch trên hạ tầng Hugging Face.

#### list_space_templates[[huggingface_hub.HfApi.list_space_templates]]

```python
list_space_templates(token: str | bool | None = None)
```

[Nguồn](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L4548)

**Tham số:**

token (`bool` hoặc `str`, *tùy chọn*) : Một token truy cập người dùng hợp lệ (chuỗi). Mặc định là token được lưu cục bộ, đây là phương pháp xác thực được khuyến nghị (xem https://huggingface.co/docs/huggingface_hub/quick-start#authentication). Để tắt xác thực, truyền `False`.

**Trả về:** `list[SpaceTemplate]`

Danh sách các mẫu Space có sẵn.

Liệt kê các mẫu Space chính thức có sẵn trên Hub.

`repo_id` của một template được trả về (hoặc `name` ngắn của nó) có thể được truyền dưới dạng `space_template` cho [HfApi.create_repo()](/docs/huggingface_hub/v2.4.0/vi/package_reference/hf_api#huggingface_hub.HfApi.create_repo) để khởi tạo một Space mới từ template đó.

Ví dụ:
```py
>>> from huggingface_hub import list_space_templates
>>> templates = list_space_templates()
>>> templates[0]
SpaceTemplate(name='Streamlit', repo_id='streamlit/streamlit-template-space', sdk='docker', preferred_private=False)
```

#### list_spaces[[huggingface_hub.HfApi.list_spaces]]

```python
list_spaces(filter: str | Iterable[str] | None = None, author: str | None = None, search: str | None = None, datasets: str | Iterable[str] | None = None, models: str | Iterable[str] | None = None, linked: bool = False, sort: SpaceSort_T | None = None, limit: int | None = None, expand: list[ExpandSpaceProperty_T] | None = None, full: bool | None = None, token: bool | str | None = None)
```

[Nguồn](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L2774)

**Tham số:**

filter (`str` hoặc `Iterable`, *tùy chọn*) : Một thẻ dạng chuỗi hoặc danh sách các thẻ có thể được sử dụng để xác định Spaces trên Hub.

author (`str`, *tùy chọn*) : Một chuỗi nhận diện tác giả của các Spaces được trả về.

search (`str`, *tùy chọn*) : Một chuỗi sẽ được chứa trong các Spaces được trả về.

datasets (`str` hoặc `Iterable`, *tùy chọn*) : Có nên trả về các Spaces sử dụng một bộ dữ liệu hay không. Tên của một bộ dữ liệu cụ thể có thể được truyền dưới dạng chuỗi.

models (`str` hoặc `Iterable`, *tùy chọn*) : Có trả về các Spaces sử dụng một model hay không. Tên của một model cụ thể có thể được truyền dưới dạng chuỗi.

linked (`bool`, *tùy chọn*) : Có trả về các Spaces sử dụng mô hình hoặc bộ dữ liệu hay không.

sort (`SpaceSort_T`, *tùy chọn*) : Khóa để sắp xếp các space kết quả. Các giá trị có thể là "created_at", "last_modified", "likes" và "trending_score".

limit (`int`, *tuỳ chọn*) : Giới hạn số lượng Spaces được lấy. Để tuỳ chọn này là `None` sẽ lấy tất cả các Spaces.

expand (`list[ExpandSpaceProperty_T]`, *tuỳ chọn*) : Danh sách các thuộc tính cần trả về trong phản hồi. Khi được sử dụng, chỉ các thuộc tính trong danh sách sẽ được trả về. Tham số này không thể được sử dụng nếu `full` được truyền vào. Các giá trị có thể là `"author"`, `"cardData"`, `"datasets"`, `"disabled"`, `"lastModified"`, `"createdAt"`, `"likes"`, `"models"`, `"private"`, `"region"`, `"runtime"`, `"sdk"`, `"siblings"`, `"sha"`, `"subdomain"`, `"tags"`, `"trendingScore"`, `"usedStorage"`, và `"resourceGroup"`.

full (`bool`, *tuỳ chọn*) : Xác định có lấy toàn bộ dữ liệu Spaces hay không, bao gồm các trường `last_modified`, `siblings` và `card_data`.

token (`bool` hoặc `str`, *tùy chọn*) : Một token truy cập người dùng hợp lệ (chuỗi). Mặc định là token được lưu cục bộ, đây là phương pháp xác thực được khuyến nghị (xem https://huggingface.co/docs/huggingface_hub/quick-start#authentication). Để tắt xác thực, truyền `False`.

**Trả về:** `Iterable[SpaceInfo]`

một iterable các đối tượng [huggingface_hub.hf_api.SpaceInfo](/docs/huggingface_hub/v2.4.0/vi/package_reference/hf_api#huggingface_hub.SpaceInfo).

Liệt kê các space được lưu trữ trên Huggingface Hub, dựa trên một số bộ lọc.

#### list_spaces_hardware[[huggingface_hub.HfApi.list_spaces_hardware]]

```python
list_spaces_hardware(token: bool | str | None = None)
```

[Nguồn](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L8260)

**Trả về:** `list[JobHardwareInfo]`

Danh sách các cấu hình phần cứng khả dụng.

Liệt kê các tùy chọn phần cứng khả dụng cho Spaces.

Ví dụ:

```python
>>> from huggingface_hub import list_spaces_hardware
>>> hardware_list = list_spaces_hardware()
>>> hardware_list[0]
JobHardwareInfo(name='cpu-basic', pretty_name='CPU Basic', cpu='2 vCPU', ram='16 GB', ...)
>>> hardware_list[0].name
'cpu-basic'
```

#### list_user_followers[[huggingface_hub.HfApi.list_user_followers]]

```python
list_user_followers(username: str, token: bool | str | None = None)
```

[Nguồn](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L11831)

**Tham số:**

username (`str`) : Tên người dùng của người dùng cần lấy danh sách người theo dõi.

token (`bool` hoặc `str`, *tùy chọn*) : Một token truy cập người dùng hợp lệ (chuỗi). Mặc định là token được lưu cục bộ, đây là phương pháp xác thực được khuyến nghị (xem https://huggingface.co/docs/huggingface_hub/quick-start#authentication). Để tắt xác thực, truyền `False`.

**Trả về:** `Iterable[User]`

Danh sách các đối tượng [User](/docs/huggingface_hub/v2.4.0/vi/package_reference/hf_api#huggingface_hub.User) là người theo dõi của người dùng.

**Gây ra:** `HfHubHTTPError`

- `HfHubHTTPError` -- HTTP 404 Nếu người dùng không tồn tại trên Hub.

Lấy danh sách người theo dõi của một người dùng trên Hub.

#### list_user_following[[huggingface_hub.HfApi.list_user_following]]

```python
list_user_following(username: str, token: bool | str | None = None)
```

[Nguồn](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L11859)

**Tham số:**

username (`str`) : Tên người dùng của người dùng cần lấy danh sách người dùng mà họ đang theo dõi.

token (`bool` hoặc `str`, *tùy chọn*) : Một token truy cập người dùng hợp lệ (chuỗi). Mặc định là token được lưu cục bộ, đây là phương pháp xác thực được khuyến nghị (xem https://huggingface.co/docs/huggingface_hub/quick-start#authentication). Để tắt xác thực, truyền `False`.

**Trả về:** `Iterable[User]`

Danh sách các đối tượng [User](/docs/huggingface_hub/v2.4.0/vi/package_reference/hf_api#huggingface_hub.User) với các người dùng được người dùng đó theo dõi.

**Gây ra:** `HfHubHTTPError`

- `HfHubHTTPError` -- HTTP 404 Nếu người dùng không tồn tại trên Hub.

Lấy danh sách người dùng được theo dõi bởi một người dùng trên Hub.

#### list_user_repos[[huggingface_hub.HfApi.list_user_repos]]

```python
list_user_repos(namespace: str | None = None, token: bool | str | None = None)
```

[Nguồn](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L3065)

**Tham số:**

namespace (`str`, *tùy chọn*) : Tên tổ chức. Nếu không được cung cấp, sẽ liệt kê các kho cho người dùng đã xác thực.

token (`bool` hoặc `str`, *tùy chọn*) : Một token truy cập người dùng hợp lệ. Mặc định là token được lưu cục bộ.

**Trả về:** `Iterable[RepoStorageInfo]`

Một iterable gồm các đối tượng `RepoStorageInfo`.

Liệt kê tất cả các kho (mô hình, bộ dữ liệu, spaces, buckets) của một người dùng hoặc tổ chức kèm thông tin lưu trữ.

Sử dụng endpoint `/api/settings/repositories` cho người dùng đã xác thực hoặc `/api/organizations/{namespace}/settings/repositories` cho một tổ chức.

Ví dụ:
```python
>>> from huggingface_hub import list_user_repos

>>> repos = list(list_user_repos())
>>> repos[0]
RepoStorageInfo(id='username/my-model', type='model', ...)

>>> # List repos from an organization
>>> repos = list(list_user_repos(namespace="my-org"))
```

#### list_webhooks[[huggingface_hub.HfApi.list_webhooks]]

```python
list_webhooks(token: bool | str | None = None)
```

[Nguồn](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L11125)

**Tham số:**

token (`bool` hoặc `str`, *tùy chọn*) : Một token truy cập người dùng hợp lệ (chuỗi). Mặc định là token được lưu cục bộ, đây là phương pháp xác thực được khuyến nghị (xem https://huggingface.co/docs/huggingface_hub/quick-start#authentication). Để tắt xác thực, truyền `False`.

**Trả về:** `list[WebhookInfo]`

Danh sách các đối tượng thông tin webhook.

Liệt kê tất cả các webhook đã cấu hình.

Ví dụ:
```python
>>> from huggingface_hub import list_webhooks
>>> webhooks = list_webhooks()
>>> len(webhooks)
2
>>> webhooks[0]
WebhookInfo(
    id="654bbbc16f2ec14d77f109cc",
    watched=[WebhookWatchedItem(type="user", name="julien-c"), WebhookWatchedItem(type="org", name="HuggingFaceH4")],
    url="https://webhook.site/a2176e82-5720-43ee-9e06-f91cb4c91548",
    secret="my-secret",
    domains=["repo", "discussion"],
    disabled=False,
)
```

#### merge_pull_request[[huggingface_hub.HfApi.merge_pull_request]]

```python
merge_pull_request(repo_id: str, discussion_num: int, token: bool | str | None = None, comment: str | None = None, repo_type: str | None = None)
```

[Nguồn](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L7830)

**Tham số:**

repo_id (`str`) : Một namespace (người dùng hoặc tổ chức) và tên kho, được phân tách bằng `/`.

discussion_num (`int`) : Số thứ tự của Discussion hoặc Pull Request. Phải là một số nguyên dương.

comment (`str`, *tùy chọn*) : Một bình luận tùy chọn để đăng kèm theo việc thay đổi trạng thái.

repo_type (`str`, *tùy chọn*) : Đặt thành `"dataset"` hoặc `"space"` nếu tải lên một dataset hoặc space, `None` hoặc `"model"` nếu tải lên một model. Mặc định là `None`.

token (`bool` hoặc `str`, *tùy chọn*) : Một token truy cập người dùng hợp lệ (chuỗi). Mặc định là token được lưu cục bộ, đây là phương pháp xác thực được khuyến nghị (xem https://huggingface.co/docs/huggingface_hub/quick-start#authentication). Để tắt xác thực, truyền `False`.

**Trả về:** [DiscussionStatusChange](/docs/huggingface_hub/v2.4.0/vi/package_reference/community#huggingface_hub.DiscussionStatusChange)

sự kiện thay đổi trạng thái

Gộp một Pull Request.

> [!TIP]
> Gây ra các lỗi sau:
>
> - [`HTTPError`](https://requests.readthedocs.io/en/latest/api/#requests.HTTPError) nếu API HuggingFace trả về lỗi - [`ValueError`](https://docs.python.org/3/library/exceptions.html#ValueError) nếu giá trị của một số tham số không hợp lệ - [RepositoryNotFoundError](/docs/huggingface_hub/v2.4.0/vi/package_reference/utilities#huggingface_hub.errors.RepositoryNotFoundError) Nếu không tìm thấy kho cần tải xuống. Điều này có thể do kho không tồn tại, hoặc do kho được đặt ở chế độ `private` và bạn không có quyền truy cập.

#### model_info[[huggingface_hub.HfApi.model_info]]

```python
model_info(repo_id: str, revision: str | None = None, timeout: float | None = None, securityStatus: bool | None = None, files_metadata: bool = False, expand: list[ExpandModelProperty_T] | None = None, token: bool | str | None = None)
```

[Nguồn](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L3144)

**Tham số:**

repo_id (`str`) : Một namespace (người dùng hoặc tổ chức) và tên kho, được phân tách bằng `/`.

revision (`str`, *tùy chọn*) : Phiên bản của kho lưu trữ mô hình để lấy thông tin.

timeout (`float`, *optional*) : Có nên đặt thời gian chờ (timeout) cho yêu cầu đến Hub hay không.

securityStatus (`bool`, *tuỳ chọn*) : Có lấy trạng thái bảo mật từ kho lưu trữ mô hình hay không. Trạng thái bảo mật sẽ được trả về trong trường `security_repo_status`.

files_metadata (`bool`, *tuỳ chọn*) : Có lấy hay không lấy siêu dữ liệu cho các tệp trong kho (kích thước, siêu dữ liệu LFS, v.v.). Mặc định là `False`.

expand (`list[ExpandModelProperty_T]`, *tùy chọn*) : Danh sách các thuộc tính cần trả về trong phản hồi. Khi được sử dụng, chỉ các thuộc tính trong danh sách sẽ được trả về. Tham số này không thể được sử dụng nếu `securityStatus` hoặc `files_metadata` được truyền vào. Các giá trị có thể là `"author"`, `"baseModels"`, `"cardData"`, `"childrenModelCount"`, `"config"`, `"createdAt"`, `"disabled"`, `"downloads"`, `"downloadsAllTime"`, `"evalResults"`, `"gated"`, `"gguf"`, `"inference"`, `"inferenceProviderMapping"`, `"lastModified"`, `"library_name"`, `"likes"`, `"mask_token"`, `"model-index"`, `"pipeline_tag"`, `"private"`, `"safetensors"`, `"sha"`, `"siblings"`, `"spaces"`, `"tags"`, `"transformersInfo"`, `"trendingScore"`, `"widgetData"`, `"usedStorage"`, và `"resourceGroup"`.

token (`bool` hoặc `str`, *tùy chọn*) : Một token truy cập người dùng hợp lệ (chuỗi). Mặc định là token được lưu cục bộ, đây là phương pháp xác thực được khuyến nghị (xem https://huggingface.co/docs/huggingface_hub/quick-start#authentication). Để tắt xác thực, truyền `False`.

**Trả về:** [huggingface_hub.hf_api.ModelInfo](/docs/huggingface_hub/v2.4.0/vi/package_reference/hf_api#huggingface_hub.ModelInfo)

Thông tin kho lưu trữ mô hình.

Lấy thông tin về một mô hình cụ thể trên huggingface.co

Model có thể là private nếu bạn truyền vào một token hợp lệ hoặc đã đăng nhập.

> [!TIP]
> Gây ra các lỗi sau:
>
> - [RepositoryNotFoundError](/docs/huggingface_hub/v2.4.0/vi/package_reference/utilities#huggingface_hub.errors.RepositoryNotFoundError) Nếu không tìm thấy kho cần tải xuống. Điều này có thể do kho không tồn tại, hoặc do kho được đặt ở chế độ `private` và bạn không có quyền truy cập. - [RevisionNotFoundError](/docs/huggingface_hub/v2.4.0/vi/package_reference/utilities#huggingface_hub.errors.RevisionNotFoundError) Nếu không tìm thấy phiên bản cần tải xuống.

#### move_bucket[[huggingface_hub.HfApi.move_bucket]]

```python
move_bucket(from_id: str, to_id: str, token: bool | str | None = None)
```

[Nguồn](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L14199)

**Tham số:**

from_id (`str`) : Một namespace (người dùng hoặc tổ chức) và tên bucket được phân tách bằng `/`. Định danh bucket gốc (ví dụ: `"username/my-bucket"`).

to_id (`str`) : Một namespace (người dùng hoặc tổ chức) và tên bucket được phân tách bằng `/`. Định danh bucket cuối cùng (ví dụ `"username/new-bucket-name"` hoặc `"organization/my-bucket"`).

token (`bool` hoặc `str`, *tùy chọn*) : Một token truy cập người dùng hợp lệ (chuỗi). Mặc định là token được lưu cục bộ, đây là phương pháp xác thực được khuyến nghị (xem https://huggingface.co/docs/huggingface_hub/quick-start#authentication). Để tắt xác thực, truyền `False`.

**Lỗi:** `BucketNotFoundError`

- `BucketNotFoundError` -- Nếu không tìm thấy bucket nguồn. Điều này có thể do bucket không tồn tại, hoặc do bucket được đặt ở chế độ `private` và bạn không có quyền truy cập.

Di chuyển một bucket từ "namespace1/repo_name1" sang "namespace2/repo_name2"

Lưu ý rằng có một số hạn chế nhất định. Để biết thêm thông tin về việc di chuyển kho lưu trữ, hãy xem https://hf.co/docs/hub/repositories-settings#renaming-or-transferring-a-repo.

Ví dụ:
```python
>>> from huggingface_hub import move_bucket

>>> # Rename a bucket within the same namespace
>>> move_bucket(from_id="username/old-name", to_id="username/new-name")

>>> # Transfer a bucket to an organization
>>> move_bucket(from_id="username/my-bucket", to_id="my-org/my-bucket")
```

#### move_repo[[huggingface_hub.HfApi.move_repo]]

```python
move_repo(from_id: str, to_id: str, repo_type: str | None = None, token: str | bool | None = None)
```

[Nguồn](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L4918)

**Tham số:**

from_id (`str`) : Một namespace (người dùng hoặc tổ chức) và tên kho, được phân tách bằng `/`. Định danh kho gốc.

to_id (`str`) : Một namespace (người dùng hoặc tổ chức) và tên kho, được phân tách bằng `/`. Định danh kho cuối cùng.

repo_type (`str`, *tùy chọn*) : Đặt thành `"dataset"` hoặc `"space"` nếu tải lên một dataset hoặc space, `None` hoặc `"model"` nếu tải lên một model. Mặc định là `None`.

token (`bool` hoặc `str`, *tùy chọn*) : Một token truy cập người dùng hợp lệ (chuỗi). Mặc định là token được lưu cục bộ, đây là phương pháp xác thực được khuyến nghị (xem https://huggingface.co/docs/huggingface_hub/quick-start#authentication). Để tắt xác thực, truyền `False`.

Chuyển một kho từ namespace1/repo_name1 sang namespace2/repo_name2

Lưu ý rằng có một số hạn chế nhất định. Để biết thêm thông tin về việc di chuyển kho lưu trữ, hãy xem https://hf.co/docs/hub/repositories-settings#renaming-or-transferring-a-repo.

> [!TIP]
> Gây ra các lỗi sau:
>
> - [RepositoryNotFoundError](/docs/huggingface_hub/v2.4.0/vi/package_reference/utilities#huggingface_hub.errors.RepositoryNotFoundError) Nếu không tìm thấy kho cần tải xuống. Điều này có thể do kho không tồn tại, hoặc do kho được đặt ở chế độ `private` và bạn không có quyền truy cập.

#### paper_info[[huggingface_hub.HfApi.paper_info]]

```python
paper_info(id: str)
```

[Nguồn](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L11938)

**Tham số:**

id (`str`, **tùy chọn**) : id của bài báo trên ArXiv.

**Trả về:** `PaperInfo`

Một đối tượng `PaperInfo`.

**Gây ra:** `HfHubHTTPError`

- `HfHubHTTPError` -- HTTP 404 Nếu bài báo không tồn tại trên Hub.

Lấy thông tin về một bài báo trên Hub.

#### parse_safetensors_file_metadata[[huggingface_hub.HfApi.parse_safetensors_file_metadata]]

```python
parse_safetensors_file_metadata(repo_id: str, filename: str, repo_type: str | None = None, revision: str | None = None, token: bool | str | None = None, timeout: float | None = 10)
```

[Nguồn](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L6882)

**Tham số:**

repo_id (`str`) : Tên người dùng hoặc tên tổ chức và tên kho, phân tách bằng `/`.

filename (`str`) : Tên của tệp trong kho.

repo_type (`str`, *tùy chọn*) : Đặt thành `"dataset"` hoặc `"space"` nếu tệp nằm trong một dataset hoặc space, `None` hoặc `"model"` nếu nằm trong một model. Mặc định là `None`.

revision (`str`, *tùy chọn*) : Bản sửa git để lấy tệp từ đó. Có thể là tên nhánh, một thẻ, hoặc một hash commit. Mặc định là đầu của nhánh `"main"`.

token (`bool` hoặc `str`, *tùy chọn*) : Một token truy cập người dùng hợp lệ (chuỗi). Mặc định là token được lưu cục bộ, đây là phương pháp xác thực được khuyến nghị (xem https://huggingface.co/docs/huggingface_hub/quick-start#authentication). Để tắt xác thực, truyền `False`.

timeout (`float`, *optional*, mặc định là 10) : Số giây chờ máy chủ gửi dữ liệu trước khi từ bỏ. Đặt thành `None` để vô hiệu hóa thời gian chờ (không được khuyến nghị, vì một kết nối bị treo có thể khiến cuộc gọi bị treo vô thời hạn).

**Trả về:** `SafetensorsFileMetadata`

thông tin liên quan đến tệp safetensors.

**Gây ra:** `NotASafetensorsRepoError` hoặc `SafetensorsParsingError`

- `NotASafetensorsRepoError` -- Nếu repo không phải là repo safetensors, tức là không có file `model.safetensors` hoặc `model.safetensors.index.json`.
- `SafetensorsParsingError` -- Nếu không thể phân tích đúng phần đầu của tệp safetensors.

Phân tích metadata từ một tệp safetensors trên Hub.

Để phân tích metadata từ tất cả các tệp safetensors trong một repo cùng lúc, hãy sử dụng [get_safetensors_metadata()](/docs/huggingface_hub/v2.4.0/vi/package_reference/hf_api#huggingface_hub.HfApi.get_safetensors_metadata).

Để biết thêm chi tiết về định dạng safetensors, hãy xem https://huggingface.co/docs/safetensors/index#format.

#### pause_inference_endpoint[[huggingface_hub.HfApi.pause_inference_endpoint]]

```python
pause_inference_endpoint(name: str, namespace: str | None = None, token: bool | str | None = None)
```

[Nguồn](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L9922)

**Tham số:**

name (`str`) : Tên của Inference Endpoint cần tạm dừng.

namespace (`str`, *tùy chọn*) : Không gian tên chứa Inference Endpoint. Mặc định là người dùng hiện tại.

token (`bool` hoặc `str`, *tùy chọn*) : Một token truy cập người dùng hợp lệ (chuỗi). Mặc định là token được lưu cục bộ, đây là phương pháp xác thực được khuyến nghị (xem https://huggingface.co/docs/huggingface_hub/quick-start#authentication). Để tắt xác thực, truyền `False`.

**Trả về:** [InferenceEndpoint](/docs/huggingface_hub/v2.4.0/vi/package_reference/inference_endpoints#huggingface_hub.InferenceEndpoint)

thông tin về Inference Endpoint đang tạm dừng.

Tạm dừng một Inference Endpoint.

Inference Endpoint ở trạng thái tạm dừng sẽ không bị tính phí. Bạn có thể tiếp tục sử dụng nó bất cứ lúc nào bằng [resume_inference_endpoint()](/docs/huggingface_hub/v2.4.0/vi/package_reference/hf_api#huggingface_hub.HfApi.resume_inference_endpoint). Điều này khác với việc thu nhỏ Inference Endpoint về không bằng [scale_to_zero_inference_endpoint()](/docs/huggingface_hub/v2.4.0/vi/package_reference/hf_api#huggingface_hub.HfApi.scale_to_zero_inference_endpoint), khi đó nó sẽ tự động khởi động lại khi có yêu cầu được gửi đến.

Để tiện lợi, bạn cũng có thể tạm dừng một Inference Endpoint bằng cách sử dụng [pause_inference_endpoint()](/docs/huggingface_hub/v2.4.0/vi/package_reference/hf_api#huggingface_hub.HfApi.pause_inference_endpoint).

#### pause_space[[huggingface_hub.HfApi.pause_space]]

```python
pause_space(repo_id: str, token: bool | str | None = None)
```

[Nguồn](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L8419)

**Tham số:**

repo_id (`str`) : ID của Space cần tạm dừng. Ví dụ: `"Salesforce/BLIP2"`.

token (`bool` hoặc `str`, *tùy chọn*) : Một token truy cập người dùng hợp lệ (chuỗi). Mặc định là token được lưu cục bộ, đây là phương pháp xác thực được khuyến nghị (xem https://huggingface.co/docs/huggingface_hub/quick-start#authentication). Để tắt xác thực, truyền `False`.

**Trả về:** [SpaceRuntime](/docs/huggingface_hub/v2.4.0/vi/package_reference/space_runtime#huggingface_hub.SpaceRuntime)

Thông tin thời gian chạy về Space của bạn, bao gồm `stage=PAUSED` và phần cứng được yêu cầu.

**Gây ra:** [RepositoryNotFoundError](/docs/huggingface_hub/v2.4.0/vi/package_reference/utilities#huggingface_hub.errors.RepositoryNotFoundError) hoặc [HfHubHTTPError](/docs/huggingface_hub/v2.4.0/vi/package_reference/utilities#huggingface_hub.errors.HfHubHTTPError) hoặc [BadRequestError](/docs/huggingface_hub/v2.4.0/vi/package_reference/utilities#huggingface_hub.errors.BadRequestError)

- [RepositoryNotFoundError](/docs/huggingface_hub/v2.4.0/vi/package_reference/utilities#huggingface_hub.errors.RepositoryNotFoundError) -- Nếu Space của bạn không được tìm thấy (lỗi 404). Khả năng cao là repo_id sai hoặc Space của bạn là riêng tư nhưng bạn chưa xác thực.
- [HfHubHTTPError](/docs/huggingface_hub/v2.4.0/vi/package_reference/utilities#huggingface_hub.errors.HfHubHTTPError) -- 403 Forbidden: chỉ chủ sở hữu của một Space mới có thể tạm dừng nó. Nếu bạn muốn quản lý một Space mà bạn không sở hữu, hãy yêu cầu chủ sở hữu bằng cách mở một Discussion hoặc sao chép Space đó.
- [BadRequestError](/docs/huggingface_hub/v2.4.0/vi/package_reference/utilities#huggingface_hub.errors.BadRequestError) -- Nếu Space của bạn là một static Space. Các static Space luôn ở trạng thái chạy và không bao giờ bị tính phí. Nếu bạn muốn ẩn một static Space, bạn có thể đặt nó ở chế độ private.

Tạm dừng Space của bạn.

Space ở trạng thái tạm dừng sẽ ngừng thực thi cho đến khi chủ sở hữu khởi động lại thủ công. Điều này khác với trạng thái ngủ mà các Space miễn phí chuyển sang sau 48 giờ không hoạt động. Thời gian tạm dừng không bị tính phí vào tài khoản của bạn, bất kể phần cứng bạn đã chọn. Để khởi động lại Space của bạn, hãy sử dụng [restart_space()](/docs/huggingface_hub/v2.4.0/vi/package_reference/hf_api#huggingface_hub.HfApi.restart_space) và truy cập trang cài đặt Space của bạn.

Để biết thêm chi tiết, vui lòng truy cập [tài liệu](https://huggingface.co/docs/hub/spaces-gpus#pause).

#### permanently_delete_lfs_files[[huggingface_hub.HfApi.permanently_delete_lfs_files]]

```python
permanently_delete_lfs_files(repo_id: str, lfs_files: Iterable[LFSFileInfo], rewrite_history: bool = True, repo_type: str | None = None, token: bool | str | None = None)
```

[Nguồn](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L4480)

**Tham số:**

repo_id (`str`) : Kho mà bạn đang liệt kê các tệp LFS.

lfs_files (`Iterable[LFSFileInfo]`) : Một iterable gồm các mục `LFSFileInfo` để xóa vĩnh viễn khỏi kho. Sử dụng [list_lfs_files()](/docs/huggingface_hub/v2.4.0/vi/package_reference/hf_api#huggingface_hub.HfApi.list_lfs_files) để liệt kê tất cả các tệp LFS từ một kho.

rewrite_history (`bool`, *tuỳ chọn*, mặc định là `True`) : Có nên viết lại lịch sử kho để loại bỏ các con trỏ tệp tham chiếu đến các tệp LFS đã bị xóa (được khuyến nghị) hay không.

repo_type (`str`, *tùy chọn*) : Kiểu của kho. Đặt thành `"dataset"` hoặc `"space"` nếu liệt kê từ một dataset hoặc space, `None` hoặc `"model"` nếu liệt kê từ một model. Mặc định là `None`.

token (`bool` hoặc `str`, *tùy chọn*) : Một token truy cập người dùng hợp lệ (chuỗi). Mặc định là token được lưu cục bộ, đây là phương pháp xác thực được khuyến nghị (xem https://huggingface.co/docs/huggingface_hub/quick-start#authentication). Để tắt xác thực, truyền `False`.

Xóa vĩnh viễn các tệp LFS khỏi một kho trên Hub.

> [!WARNING]
> Đây là một thao tác vĩnh viễn sẽ ảnh hưởng đến tất cả các commit tham chiếu đến các tệp đã bị xóa và có thể làm hỏng kho lưu trữ của bạn. Đây là một thao tác không thể hoàn tác. Chỉ sử dụng khi bạn thực sự hiểu rõ những gì mình đang làm.

Ví dụ:
```py
>>> from huggingface_hub import HfApi
>>> api = HfApi()
>>> lfs_files = api.list_lfs_files("username/my-cool-repo")

# Filter files to delete based on a combination of `filename`, `pushed_at`, `ref` or `size`.
# e.g. select only LFS files in the "checkpoints" folder
>>> lfs_files_to_delete = (lfs_file for lfs_file in lfs_files if lfs_file.filename.startswith("checkpoints/"))

# Permanently delete LFS files
>>> api.permanently_delete_lfs_files("username/my-cool-repo", lfs_files_to_delete)
```

#### preupload_lfs_files[[huggingface_hub.HfApi.preupload_lfs_files]]

```python
preupload_lfs_files(repo_id: str, additions: Iterable[CommitOperationAdd], token: str | bool | None = None, repo_type: str | None = None, revision: str | None = None, create_pr: bool | None = None, num_threads: int = 5, free_memory: bool = True, gitignore_content: str | None = None)
```

[Nguồn](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L5311)

**Tham số:**

repo_id (`str`) : Kho lưu trữ mà bạn sẽ commit các tệp vào, ví dụ: `"username/custom_transformers"`.

additions (`Iterable` của [CommitOperationAdd](/docs/huggingface_hub/v2.4.0/vi/package_reference/hf_api#huggingface_hub.CommitOperationAdd)) : Danh sách các tệp cần tải lên. Cảnh báo: các đối tượng trong danh sách này sẽ bị thay đổi để bao gồm thông tin liên quan đến việc tải lên. Không tái sử dụng cùng các đối tượng cho nhiều lần commit.

token (`bool` hoặc `str`, *tùy chọn*) : Một token truy cập người dùng hợp lệ (chuỗi). Mặc định là token được lưu cục bộ, đây là phương pháp xác thực được khuyến nghị (xem https://huggingface.co/docs/huggingface_hub/quick-start#authentication). Để tắt xác thực, truyền `False`.

repo_type (`str`, *tùy chọn*) : Kiểu kho cần tải lên (ví dụ: `"model"` -mặc định-, `"dataset"`, `"space"` hoặc `"kernel"`).

revision (`str`, *tùy chọn*) : Bản sửa git để commit từ. Mặc định là đầu của nhánh `"main"`.

create_pr (`boolean`, *tùy chọn*) : Bạn có dự định tạo một Pull Request với commit đó hay không. Mặc định là `False`.

num_threads (`int`, *optional*) : Số lượng luồng đồng thời để tải tệp lên. Mặc định là 5. Đặt thành 2 có nghĩa là tối đa 2 tệp sẽ được tải lên đồng thời.

free_memory (`bool`, *tuỳ chọn*, mặc định là `True`) : Nếu `True`, thuộc tính `path_or_fileobj` của mỗi `CommitOperationAdd` sẽ được thay thế bằng một đối tượng `bytes` rỗng sau khi tải lên để tiết kiệm bộ nhớ. Đặt thành `False` nếu bạn cần tái sử dụng các đối tượng thao tác bên ngoài một cuộc gọi [create_commit()](/docs/huggingface_hub/v2.4.0/vi/package_reference/hf_api#huggingface_hub.HfApi.create_commit) tiếp theo.

gitignore_content (`str`, *tùy chọn*) : Nội dung của tệp `.gitignore` để biết tệp nào nên được bỏ qua. Thứ tự ưu tiên là trước tiên kiểm tra xem `gitignore_content` có được truyền vào không, sau đó kiểm tra xem tệp `.gitignore` có hiện diện trong danh sách các tệp cần commit hay không, và cuối cùng mặc định dùng tệp `.gitignore` đã được lưu trên Hub (nếu có).

Tải trước các tệp LFS lên S3 để chuẩn bị cho một commit trong tương lai.

Phương pháp này hữu ích nếu bạn đang tạo các tệp để tải lên theo thời gian thực và không muốn lưu trữ chúng trong bộ nhớ trước khi tải lên tất cả cùng lúc.

> [!WARNING]
> Đây là phương pháp dành cho người dùng nâng cao. Bạn không cần gọi trực tiếp phương pháp này để thực hiện một commit thông thường. Hãy dùng [create_commit()](/docs/huggingface_hub/v2.4.0/vi/package_reference/hf_api#huggingface_hub.HfApi.create_commit) trực tiếp thay vào đó.

> [!WARNING]
> Các thao tác commit sẽ bị thay đổi trong quá trình xử lý. Cụ thể, `path_or_fileobj` được đính kèm sẽ bị xóa sau khi tải lên để tiết kiệm bộ nhớ (và được thay thế bằng một đối tượng `bytes` rỗng). Không tái sử dụng các đối tượng này, ngoại trừ việc truyền chúng vào [create_commit()](/docs/huggingface_hub/v2.4.0/vi/package_reference/hf_api#huggingface_hub.HfApi.create_commit). Nếu bạn không muốn xóa nội dung đính kèm khỏi đối tượng thao tác commit, hãy truyền `free_memory=False`.

Ví dụ:
```py
>>> from huggingface_hub import CommitOperationAdd, preupload_lfs_files, create_commit, create_repo

>>> repo_id = create_repo("test_preupload").repo_id

# Generate and preupload LFS files one by one
>>> operations = [] # List of all `CommitOperationAdd` objects that will be generated
>>> for i in range(5):
...     content = ... # generate binary content
...     addition = CommitOperationAdd(path_in_repo=f"shard_{i}_of_5.bin", path_or_fileobj=content)
...     preupload_lfs_files(repo_id, additions=[addition]) # upload + free memory
...     operations.append(addition)

# Create commit
>>> create_commit(repo_id, operations=operations, commit_message="Commit all shards")
```

#### read_paper[[huggingface_hub.HfApi.read_paper]]

```python
read_paper(id: str)
```

[Nguồn](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L11958)

**Tham số:**

id (`str`) : id của bài báo trên ArXiv.

**Trả về:** `str`

Nội dung trang bài báo dưới dạng markdown.

**Gây ra:** `HfHubHTTPError`

- `HfHubHTTPError` -- HTTP 404 Nếu bài báo không tồn tại trên Hub.

Lấy nội dung markdown của một trang bài báo trên Hub.

#### reject_access_request[[huggingface_hub.HfApi.reject_access_request]]

```python
reject_access_request(repo_id: str, user: str | None = None, request_id: str | None = None, repo_type: str | None = None, rejection_reason: str | None, token: bool | str | None = None)
```

[Nguồn](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L10925)

**Tham số:**

repo_id (`str`) : id của repo để từ chối yêu cầu truy cập.

user (`str`, *tùy chọn*) : Tên người dùng của người dùng mà yêu cầu truy cập cần bị từ chối. Phải cung cấp đúng một trong `user` hoặc `request_id`.

request_id (`str`, *tùy chọn*) : id của yêu cầu truy cập cần từ chối (xem `AccessRequest`). Bắt buộc khi repo được cấu hình để không chia sẻ tên người dùng của người yêu cầu. Phải cung cấp đúng một trong `user` hoặc `request_id`.

repo_type (`str`, *tùy chọn*) : Kiểu kho cần từ chối yêu cầu truy cập. Phải là một trong `model`, `dataset` hoặc `space`. Mặc định là `model`.

rejection_reason (`str`, *tùy chọn*) : Lý do từ chối tùy chọn sẽ hiển thị cho người dùng (tối đa 200 ký tự).

token (`bool` hoặc `str`, *tùy chọn*) : Một token truy cập người dùng hợp lệ (chuỗi). Mặc định là token được lưu cục bộ, đây là phương pháp xác thực được khuyến nghị (xem https://huggingface.co/docs/huggingface_hub/quick-start#authentication). Để tắt xác thực, truyền `False`.

**Gây ra:** `HfHubHTTPError`

- `HfHubHTTPError` -- HTTP 400 nếu kho không được bảo vệ.
- `HfHubHTTPError` -- HTTP 403 nếu bạn chỉ có quyền truy cập chỉ đọc vào kho. Điều này có thể xảy ra nếu bạn không có vai trò `write` hoặc `admin` trong tổ chức mà kho thuộc về, hoặc nếu bạn đã truyền một token `read`.
- `HfHubHTTPError` -- HTTP 404 nếu người dùng không tồn tại trên Hub.
- `HfHubHTTPError` -- HTTP 404 nếu không tìm thấy yêu cầu truy cập của người dùng.
- `HfHubHTTPError` -- HTTP 404 nếu yêu cầu truy cập của người dùng đã nằm trong danh sách bị từ chối.

Từ chối yêu cầu truy cập từ một người dùng đối với một kho có kiểm soát (gated repo) cụ thể.

Yêu cầu bị từ chối sẽ được đưa vào danh sách bị từ chối. Người dùng không thể tải xuống bất kỳ tệp nào của kho. Các yêu cầu bị từ chối có thể được chấp nhận hoặc hủy vào bất kỳ lúc nào bằng [accept_access_request()](/docs/huggingface_hub/v2.4.0/vi/package_reference/hf_api#huggingface_hub.HfApi.accept_access_request) và [cancel_access_request()](/docs/huggingface_hub/v2.4.0/vi/package_reference/hf_api#huggingface_hub.HfApi.cancel_access_request). Một yêu cầu bị hủy sẽ quay lại danh sách chờ trong khi một yêu cầu được chấp nhận sẽ được đưa vào danh sách đã chấp nhận.

Để biết thêm thông tin về các kho lưu trữ có kiểm soát, hãy xem https://huggingface.co/docs/hub/models-gated.

#### rename_discussion[[huggingface_hub.HfApi.rename_discussion]]

```python
rename_discussion(repo_id: str, discussion_num: int, new_title: str, token: bool | str | None = None, repo_type: str | None = None)
```

[Nguồn](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L7689)

**Tham số:**

repo_id (`str`) : Một namespace (người dùng hoặc tổ chức) và tên kho, được phân tách bằng `/`.

discussion_num (`int`) : Số thứ tự của Discussion hoặc Pull Request. Phải là một số nguyên dương.

new_title (`str`) : Tiêu đề mới cho cuộc thảo luận

repo_type (`str`, *tùy chọn*) : Đặt thành `"dataset"` hoặc `"space"` nếu tải lên một dataset hoặc space, `None` hoặc `"model"` nếu tải lên một model. Mặc định là `None`.

token (`bool` hoặc `str`, *tùy chọn*) : Một token truy cập người dùng hợp lệ (chuỗi). Mặc định là token được lưu cục bộ, đây là phương pháp xác thực được khuyến nghị (xem https://huggingface.co/docs/huggingface_hub/quick-start#authentication). Để tắt xác thực, truyền `False`.

**Trả về:** [DiscussionTitleChange](/docs/huggingface_hub/v2.4.0/vi/package_reference/community#huggingface_hub.DiscussionTitleChange)

sự kiện thay đổi tiêu đề

Đổi tên một Thảo luận.

Ví dụ:
```python
>>> new_title = "New title, fixing a typo"
>>> HfApi().rename_discussion(
...     repo_id="username/repo_name",
...     discussion_num=34,
...     new_title=new_title
... )
# DiscussionTitleChange(id='deadbeef0000000', type='title-change', ...)

```

> [!TIP]
> Gây ra các lỗi sau:
>
> - [`HTTPError`](https://requests.readthedocs.io/en/latest/api/#requests.HTTPError) nếu API HuggingFace trả về lỗi - [`ValueError`](https://docs.python.org/3/library/exceptions.html#ValueError) nếu giá trị của một số tham số không hợp lệ - [RepositoryNotFoundError](/docs/huggingface_hub/v2.4.0/vi/package_reference/utilities#huggingface_hub.errors.RepositoryNotFoundError) Nếu không tìm thấy kho cần tải xuống. Điều này có thể do kho không tồn tại, hoặc do kho được đặt ở chế độ `private` và bạn không có quyền truy cập.

#### repo_exists[[huggingface_hub.HfApi.repo_exists]]

```python
repo_exists(repo_id: str, repo_type: str | None = None, token: str | bool | None = None)
```

[Nguồn](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L3677)

**Tham số:**

repo_id (`str`) : Một namespace (người dùng hoặc tổ chức) và tên kho, được phân tách bằng `/`.

repo_type (`str`, *tùy chọn*) : Đặt thành `"dataset"` hoặc `"space"` nếu lấy thông tin kho từ một dataset hoặc một space, `None` hoặc `"model"` nếu lấy thông tin kho từ một model. Mặc định là `None`.

token (`bool` hoặc `str`, *tùy chọn*) : Một token truy cập người dùng hợp lệ (chuỗi). Mặc định là token được lưu cục bộ, đây là phương pháp xác thực được khuyến nghị (xem https://huggingface.co/docs/huggingface_hub/quick-start#authentication). Để tắt xác thực, truyền `False`.

**Trả về:**

Đúng nếu kho lưu trữ tồn tại, Sai nếu không.

Kiểm tra xem một kho lưu trữ có tồn tại trên Hugging Face Hub hay không.

Ví dụ:
```py
>>> from huggingface_hub import repo_exists
>>> repo_exists("google/gemma-7b")
True
>>> repo_exists("google/not-a-repo")
False
```

#### repo_info[[huggingface_hub.HfApi.repo_info]]

```python
repo_info(repo_id: str, revision: str | None = None, repo_type: str | None = None, timeout: float | None = None, files_metadata: bool = False, expand: ExpandModelProperty_T | ExpandDatasetProperty_T | ExpandSpaceProperty_T | None = None, token: bool | str | None = None)
```

[Nguồn](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L3469)

**Tham số:**

repo_id (`str`) : Một namespace (người dùng hoặc tổ chức) và tên kho, được phân tách bằng `/`.

revision (`str`, *tùy chọn*) : Phiên bản của kho chứa mà từ đó lấy thông tin.

repo_type (`str`, *tùy chọn*) : Đặt thành `"dataset"` hoặc `"space"` nếu lấy thông tin kho từ một dataset hoặc một space, `None` hoặc `"model"` nếu lấy thông tin kho từ một model. Mặc định là `None`.

timeout (`float`, *optional*) : Có nên đặt thời gian chờ (timeout) cho yêu cầu đến Hub hay không.

expand (`ExpandModelProperty_T` hoặc `ExpandDatasetProperty_T` hoặc `ExpandSpaceProperty_T`, *tuỳ chọn*) : Danh sách các thuộc tính cần trả về trong phản hồi. Khi được sử dụng, chỉ các thuộc tính trong danh sách sẽ được trả về. Tham số này không thể được sử dụng nếu `files_metadata` được truyền vào. Để xem danh sách đầy đủ các thuộc tính khả dụng, hãy xem [model_info()](/docs/huggingface_hub/v2.4.0/vi/package_reference/hf_api#huggingface_hub.HfApi.model_info), [dataset_info()](/docs/huggingface_hub/v2.4.0/vi/package_reference/hf_api#huggingface_hub.HfApi.dataset_info) hoặc [space_info()](/docs/huggingface_hub/v2.4.0/vi/package_reference/hf_api#huggingface_hub.HfApi.space_info).

files_metadata (`bool`, *tuỳ chọn*) : Có lấy hay không lấy siêu dữ liệu cho các tệp trong kho (kích thước, siêu dữ liệu LFS, v.v.). Mặc định là `False`.

token (`bool` hoặc `str`, *tùy chọn*) : Một token truy cập người dùng hợp lệ (chuỗi). Mặc định là token được lưu cục bộ, đây là phương pháp xác thực được khuyến nghị (xem https://huggingface.co/docs/huggingface_hub/quick-start#authentication). Để tắt xác thực, truyền `False`.

**Trả về:** `Union[SpaceInfo, DatasetInfo, ModelInfo]`

Thông tin kho lưu trữ, dưới dạng đối tượng [huggingface_hub.hf_api.DatasetInfo](/docs/huggingface_hub/v2.4.0/vi/package_reference/hf_api#huggingface_hub.DatasetInfo), [huggingface_hub.hf_api.ModelInfo](/docs/huggingface_hub/v2.4.0/vi/package_reference/hf_api#huggingface_hub.ModelInfo) hoặc [huggingface_hub.hf_api.SpaceInfo](/docs/huggingface_hub/v2.4.0/vi/package_reference/hf_api#huggingface_hub.SpaceInfo).

Lấy đối tượng thông tin cho một kho có loại đã cho.

> [!TIP]
> Gây ra các lỗi sau:
>
> - [RepositoryNotFoundError](/docs/huggingface_hub/v2.4.0/vi/package_reference/utilities#huggingface_hub.errors.RepositoryNotFoundError) Nếu không tìm thấy kho cần tải xuống. Điều này có thể do kho không tồn tại, hoặc do kho được đặt ở chế độ `private` và bạn không có quyền truy cập. - [RevisionNotFoundError](/docs/huggingface_hub/v2.4.0/vi/package_reference/utilities#huggingface_hub.errors.RevisionNotFoundError) Nếu không tìm thấy phiên bản cần tải xuống.

#### request_space_hardware[[huggingface_hub.HfApi.request_space_hardware]]

```python
request_space_hardware(repo_id: str, hardware: SpaceHardware, token: bool | str | None = None, sleep_time: int | None = None)
```

[Nguồn](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L8323)

**Tham số:**

repo_id (`str`) : ID của kho cần cập nhật. Ví dụ: `"bigcode/in-the-stack"`.

hardware (`str` hoặc [SpaceHardware](/docs/huggingface_hub/v2.4.0/vi/package_reference/space_runtime#huggingface_hub.SpaceHardware)) : Phần cứng để chạy Space. Ví dụ: `"t4-medium"`.

token (`bool` hoặc `str`, *tùy chọn*) : Một token truy cập người dùng hợp lệ (chuỗi). Mặc định là token được lưu cục bộ, đây là phương pháp xác thực được khuyến nghị (xem https://huggingface.co/docs/huggingface_hub/quick-start#authentication). Để tắt xác thực, truyền `False`.

sleep_time (`int`, *optional*) : Số giây không hoạt động cần chờ trước khi một Space được đưa vào trạng thái ngủ. Đặt thành `-1` nếu bạn không muốn Space của mình ngủ (hành vi mặc định cho phần cứng đã nâng cấp). Đối với phần cứng miễn phí, bạn không thể cấu hình thời gian ngủ (giá trị được cố định ở mức 48 giờ không hoạt động). Xem https://huggingface.co/docs/hub/spaces-gpus#sleep-time để biết thêm chi tiết.

**Trả về:** [SpaceRuntime](/docs/huggingface_hub/v2.4.0/vi/package_reference/space_runtime#huggingface_hub.SpaceRuntime)

Thông tin thời gian chạy về một Space, bao gồm giai đoạn và phần cứng của Space.

Yêu cầu phần cứng mới cho một Space.

> [!TIP]
> Bạn cũng có thể yêu cầu phần cứng trực tiếp khi tạo kho Space! Xem [create_repo()](/docs/huggingface_hub/v2.4.0/vi/package_reference/hf_api#huggingface_hub.HfApi.create_repo) để biết thêm chi tiết.

#### rerun_job[[huggingface_hub.HfApi.rerun_job]]

```python
rerun_job(job_id: str, namespace: str | None = None, token: bool | str | None = None)
```

[Nguồn](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L12728)

**Tham số:**

job_id (`str`) : ID của Job cần chạy lại.

namespace (`str`, *tùy chọn*) : Namespace của Job. Mặc định là namespace của người dùng hiện tại.

token (`bool` hoặc `str`, *tùy chọn*) : Token truy cập của người dùng. Mặc định là token được lưu cục bộ.

**Trả về:** [JobInfo](/docs/huggingface_hub/v2.4.0/vi/package_reference/jobs#huggingface_hub.JobInfo)

Job vừa được khởi động.

Chạy một Job mới bằng cách sử dụng spec của Job hiện có, bao gồm các cài đặt thử lại và tài nguyên của nó.

#### resolve_revision[[huggingface_hub.HfApi.resolve_revision]]

```python
resolve_revision(repo_id: str, repo_type: str | None = None, revision: str | None = None, cache_dir: str | Path | None = None, local_files_only: bool = False, token: bool | str | None = None)
```

[Nguồn](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L3544)

**Tham số:**

repo_id (`str`) : Tên người dùng hoặc tên tổ chức và tên kho, phân tách bằng `/`.

repo_type (`str`, *tùy chọn*) : Đặt thành `"dataset"`, `"space"` hoặc `"kernel"` nếu kho là kho dataset, space hoặc kernel, `None` hoặc `"model"` nếu là model. Mặc định là `None`.

revision (`str`, *tùy chọn*) : Bản sửa (revision) cần phân giải. Có thể là tên nhánh, một tag, một PR ref hoặc một commit hash. Mặc định là nhánh mặc định. Nếu một [ResolvedRevision](/docs/huggingface_hub/v2.4.0/vi/package_reference/file_download#huggingface_hub.ResolvedRevision) được truyền vào, nó sẽ được trả về nguyên vẹn - trừ khi nó được phân giải đối với một repo khác, trong trường hợp đó bản sửa ban đầu được yêu cầu sẽ được phân giải lại.

cache_dir (`str`, `Path`, *tùy chọn*) : Đường dẫn đến thư mục nơi lưu trữ các tệp được lưu trong bộ nhớ đệm. Mặc định là giá trị của `HF_HUB_CACHE`.

local_files_only (`bool`, *tùy chọn*, mặc định là `False`) : Nếu `True`, chỉ giải quyết phiên bản từ bộ nhớ đệm cục bộ, không liên hệ với Hub.

token (`bool` hoặc `str`, *tùy chọn*) : Một token truy cập người dùng hợp lệ (chuỗi). Mặc định là token được lưu cục bộ, đây là phương pháp xác thực được khuyến nghị (xem https://huggingface.co/docs/huggingface_hub/quick-start#authentication). Để tắt xác thực, truyền `False`.

**Trả về:** [ResolvedRevision](/docs/huggingface_hub/v2.4.0/vi/package_reference/file_download#huggingface_hub.ResolvedRevision)

Một lớp con của `str` lưu trữ cả phiên bản được yêu cầu và mã băm của commit mà nó trỏ đến.

**Gây ra:** [RevisionResolutionError](/docs/huggingface_hub/v2.4.0/vi/package_reference/utilities#huggingface_hub.errors.RevisionResolutionError) hoặc [RevisionNotFoundError](/docs/huggingface_hub/v2.4.0/vi/package_reference/utilities#huggingface_hub.errors.RevisionNotFoundError) hoặc [RepositoryNotFoundError](/docs/huggingface_hub/v2.4.0/vi/package_reference/utilities#huggingface_hub.errors.RepositoryNotFoundError)

- [RevisionResolutionError](/docs/huggingface_hub/v2.4.0/vi/package_reference/utilities#huggingface_hub.errors.RevisionResolutionError) -- Nếu không thể xác định phiên bản: không thể kết nối với Hub và không có gì được lưu cục bộ.
- [RevisionNotFoundError](/docs/huggingface_hub/v2.4.0/vi/package_reference/utilities#huggingface_hub.errors.RevisionNotFoundError) -- Nếu revision không tồn tại trên Hub.
- [RepositoryNotFoundError](/docs/huggingface_hub/v2.4.0/vi/package_reference/utilities#huggingface_hub.errors.RepositoryNotFoundError) -- Nếu không tìm thấy kho lưu trữ. Điều này có thể do kho không tồn tại, hoặc do kho được đặt ở chế độ `private` và bạn không có quyền truy cập.

Giải quyết một phiên bản (nhánh, thẻ, tham chiếu PR) thành một băm commit.

Điều này dành cho các thư viện tải xuống và nạp nhiều thành phần của một repo riêng biệt (config, weights, tokenizer, ...). Việc giải quyết revision một lần và truyền [ResolvedRevision](/docs/huggingface_hub/v2.4.0/vi/package_reference/file_download#huggingface_hub.ResolvedRevision) được trả về cho các lần gọi tiếp theo đảm bảo rằng mọi lần gọi sau đó đều nhắm đến đúng commit, ngay cả khi repo được cập nhật trong thời gian đó. Nó cũng tiết kiệm các cuộc gọi HTTP, vì các lần tải xuống được thực hiện bằng commit hash có thể được phục vụ từ bộ nhớ đệm cục bộ mà không cần liên hệ với Hub.

Bản ánh xạ `revision` -> `commit hash` được lưu đệm trên đĩa (trong thư mục `refs/` của bộ đệm) theo cơ chế cố gắng hết sức. Nếu không thể kết nối đến Hub sau đó (chế độ ngoại tuyến, lỗi kết nối, hết thời gian chờ, Hub ngừng hoạt động, ...), giá trị được lưu đệm sẽ được sử dụng làm phương án dự phòng.

> [!TIP]
> Nếu bạn chỉ cần tải xuống một bản snapshot hoàn chỉnh của repo, một lệnh gọi duy nhất [snapshot_download()](/docs/huggingface_hub/v2.4.0/vi/package_reference/file_download#huggingface_hub.snapshot_download) là đủ và đã thực hiện đúng cách. `resolve_revision` chỉ hữu ích khi tải xuống các tệp riêng lẻ.

Ví dụ:
```py
>>> from huggingface_hub import hf_hub_download, resolve_revision
>>> revision = resolve_revision("openai-community/gpt2")
>>> revision
ResolvedRevision(initial=None, resolved='607a30d783dfa663caf39e06633721c8d4cfcd7e')

# Pass it around: every download is pinned to the same commit
>>> config = hf_hub_download("openai-community/gpt2", "config.json", revision=revision)
>>> weights = hf_hub_download("openai-community/gpt2", "model.safetensors", revision=revision)
```

#### restart_space[[huggingface_hub.HfApi.restart_space]]

```python
restart_space(repo_id: str, token: bool | str | None = None, factory_reboot: bool = False)
```

[Nguồn](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L8542)

**Tham số:**

repo_id (`str`) : ID của Space cần khởi động lại. Ví dụ: `"Salesforce/BLIP2"`.

token (`bool` hoặc `str`, *tùy chọn*) : Một token truy cập người dùng hợp lệ (chuỗi). Mặc định là token được lưu cục bộ, đây là phương pháp xác thực được khuyến nghị (xem https://huggingface.co/docs/huggingface_hub/quick-start#authentication). Để tắt xác thực, truyền `False`.

factory_reboot (`bool`, *tùy chọn*) : Nếu `True`, Space sẽ được xây dựng lại từ đầu mà không lưu trữ bộ nhớ đệm cho bất kỳ yêu cầu nào.

**Trả về:** [SpaceRuntime](/docs/huggingface_hub/v2.4.0/vi/package_reference/space_runtime#huggingface_hub.SpaceRuntime)

Thông tin thời gian chạy về Space của bạn.

**Gây ra:** [RepositoryNotFoundError](/docs/huggingface_hub/v2.4.0/vi/package_reference/utilities#huggingface_hub.errors.RepositoryNotFoundError) hoặc [HfHubHTTPError](/docs/huggingface_hub/v2.4.0/vi/package_reference/utilities#huggingface_hub.errors.HfHubHTTPError) hoặc [BadRequestError](/docs/huggingface_hub/v2.4.0/vi/package_reference/utilities#huggingface_hub.errors.BadRequestError)

- [RepositoryNotFoundError](/docs/huggingface_hub/v2.4.0/vi/package_reference/utilities#huggingface_hub.errors.RepositoryNotFoundError) -- Nếu Space của bạn không được tìm thấy (lỗi 404). Khả năng cao là repo_id sai hoặc Space của bạn là riêng tư nhưng bạn chưa xác thực.
- [HfHubHTTPError](/docs/huggingface_hub/v2.4.0/vi/package_reference/utilities#huggingface_hub.errors.HfHubHTTPError) -- 403 Forbidden: chỉ chủ sở hữu của một Space mới có thể khởi động lại nó. Nếu bạn muốn khởi động lại một Space mà bạn không sở hữu, hãy yêu cầu chủ sở hữu bằng cách mở một Discussion hoặc sao chép Space đó.
- [BadRequestError](/docs/huggingface_hub/v2.4.0/vi/package_reference/utilities#huggingface_hub.errors.BadRequestError) -- Nếu Space của bạn là một static Space. Các static Space luôn ở trạng thái chạy và không bao giờ bị tính phí. Nếu bạn muốn ẩn một static Space, bạn có thể đặt nó ở chế độ private.

Khởi động lại Space của bạn.

Đây là cách duy nhất để khởi động lại một Space bằng lập trình nếu bạn đã đặt nó ở trạng thái Tạm dừng (xem [pause_space()](/docs/huggingface_hub/v2.4.0/vi/package_reference/hf_api#huggingface_hub.HfApi.pause_space)). Bạn phải là chủ sở hữu của Space để khởi động lại nó. Nếu bạn đang sử dụng phần cứng nâng cấp, tài khoản của bạn sẽ bị tính phí ngay khi Space được khởi động lại. Bạn có thể kích hoạt việc khởi động lại bất kể trạng thái hiện tại của Space.

Để biết thêm chi tiết, vui lòng truy cập [tài liệu](https://huggingface.co/docs/hub/spaces-gpus#pause).

#### resume_inference_endpoint[[huggingface_hub.HfApi.resume_inference_endpoint]]

```python
resume_inference_endpoint(name: str, namespace: str | None = None, running_ok: bool = True, token: bool | str | None = None)
```

[Nguồn](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L9957)

**Tham số:**

name (`str`) : Tên của Inference Endpoint cần tiếp tục.

namespace (`str`, *tùy chọn*) : Không gian tên chứa Inference Endpoint. Mặc định là người dùng hiện tại.

running_ok (`bool`, *tuỳ chọn*) : Nếu `True`, phương thức sẽ không gây ra lỗi nếu Inference Endpoint đã đang chạy. Mặc định là `True`.

token (`bool` hoặc `str`, *tùy chọn*) : Một token truy cập người dùng hợp lệ (chuỗi). Mặc định là token được lưu cục bộ, đây là phương pháp xác thực được khuyến nghị (xem https://huggingface.co/docs/huggingface_hub/quick-start#authentication). Để tắt xác thực, truyền `False`.

**Trả về:** [InferenceEndpoint](/docs/huggingface_hub/v2.4.0/vi/package_reference/inference_endpoints#huggingface_hub.InferenceEndpoint)

thông tin về Inference Endpoint đã được khởi động lại.

Tiếp tục một Inference Endpoint.

Để tiện lợi, bạn cũng có thể khôi phục một Inference Endpoint bằng cách sử dụng [InferenceEndpoint.resume()](/docs/huggingface_hub/v2.4.0/vi/package_reference/inference_endpoints#huggingface_hub.InferenceEndpoint.resume).

#### resume_scheduled_job[[huggingface_hub.HfApi.resume_scheduled_job]]

```python
resume_scheduled_job(scheduled_job_id: str, namespace: str | None = None, token: bool | str | None = None)
```

[Nguồn](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L13384)

**Tham số:**

scheduled_job_id (`str`) : ID của Job đã được lên lịch.

namespace (`str`, *tùy chọn*) : Không gian tên (namespace) chứa Job được lên lịch. Mặc định là không gian tên của người dùng hiện tại.

token (`bool` hoặc `str`, *tùy chọn*) : Một token truy cập người dùng hợp lệ. Nếu không được cung cấp, token được lưu cục bộ sẽ được sử dụng, đây là phương thức xác thực được khuyến nghị. Đặt thành `False` để tắt xác thực. Tham khảo: https://huggingface.co/docs/huggingface_hub/quick-start#authentication.

Resume (hủy tạm dừng) một Job tính toán đã lên lịch trên hạ tầng Hugging Face.

#### revision_exists[[huggingface_hub.HfApi.revision_exists]]

```python
revision_exists(repo_id: str, revision: str, repo_type: str | None = None, token: str | bool | None = None)
```

[Nguồn](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L3721)

**Tham số:**

repo_id (`str`) : Một namespace (người dùng hoặc tổ chức) và tên kho, được phân tách bằng `/`.

revision (`str`) : Phiên bản của kho cần kiểm tra.

repo_type (`str`, *tùy chọn*) : Đặt thành `"dataset"` hoặc `"space"` nếu lấy thông tin kho từ một dataset hoặc một space, `None` hoặc `"model"` nếu lấy thông tin kho từ một model. Mặc định là `None`.

token (`bool` hoặc `str`, *tùy chọn*) : Một token truy cập người dùng hợp lệ (chuỗi). Mặc định là token được lưu cục bộ, đây là phương pháp xác thực được khuyến nghị (xem https://huggingface.co/docs/huggingface_hub/quick-start#authentication). Để tắt xác thực, truyền `False`.

**Trả về:**

Đúng nếu kho và bản sửa đổi tồn tại, Sai trong trường hợp ngược lại.

Kiểm tra xem một bản sửa đổi cụ thể có tồn tại trên một kho trên Hugging Face Hub hay không.

Ví dụ:
```py
>>> from huggingface_hub import revision_exists
>>> revision_exists("google/gemma-7b", "float16")
True
>>> revision_exists("google/gemma-7b", "not-a-revision")
False
```

#### run_as_future[[huggingface_hub.HfApi.run_as_future]]

```python
run_as_future(fn: Callable[..., R], *args, **kwargs)
```

[Nguồn](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L2178)

**Tham số:**

fn (`Callable`) : Phương thức cần chạy ở nền.

- ***args,** **kwargs : Các đối số mà phương thức sẽ được gọi với chúng.

**Trả về:** `Future`

một instance [Future](https://docs.python.org/3/library/concurrent.futures.html#future-objects) để lấy kết quả của tác vụ.

Chạy một phương thức ở nền và trả về một instance của Future.

Mục tiêu chính là chạy các phương thức mà không chặn luồng chính (ví dụ: đẩy dữ liệu trong quá trình huấn luyện). Các tác vụ nền được xếp hàng để duy trì thứ tự nhưng không được chạy song song. Nếu bạn cần tăng tốc các script của mình bằng cách song song hóa nhiều lời gọi tới API, bạn phải thiết lập và sử dụng riêng [ThreadPoolExecutor](https://docs.python.org/3/library/concurrent.futures.html#threadpoolexecutor) của mình.

Lưu ý: Các phương thức được sử dụng nhiều nhất như [upload_file()](/docs/huggingface_hub/v2.4.0/vi/package_reference/hf_api#huggingface_hub.HfApi.upload_file), [upload_folder()](/docs/huggingface_hub/v2.4.0/vi/package_reference/hf_api#huggingface_hub.HfApi.upload_folder) và [create_commit()](/docs/huggingface_hub/v2.4.0/vi/package_reference/hf_api#huggingface_hub.HfApi.create_commit) có đối số `run_as_future: bool` để gọi chúng trực tiếp ở chế độ nền. Điều này tương đương với việc gọi `api.run_as_future(...)` trên chúng nhưng ít rườm rà hơn.

Ví dụ:
```py
>>> from huggingface_hub import HfApi
>>> api = HfApi()
>>> future = api.run_as_future(api.whoami) # instant
>>> future.done()
False
>>> future.result() # wait until complete and return result
(...)
>>> future.done()
True
```

#### run_job[[huggingface_hub.HfApi.run_job]]

```python
run_job(image: str, command: list[str], env: dict[str, Any] | None = None, secrets: dict[str, Any] | None = None, flavor: JobHardware | str | None = None, timeout: int | float | str | None = None, attempts: int | None = None, name: str | None = None, labels: dict[str, str] | None = None, volumes: list[Volume] | None = None, expose: list[int] | None = None, expose_public: list[int] | None = None, ssh: bool = False, network_group: str | None = None, network_aliases: list[str] | None = None, resource_group_id: str | None = None, namespace: str | None = None, token: bool | str | None = None)
```

[Nguồn](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L12122)

**Tham số:**

image (`str`) : Ảnh Docker cần sử dụng. Ví dụ: `"ubuntu"`, `"python:3.12"`, `"pytorch/pytorch:2.6.0-cuda12.4-cudnn9-devel"`. Ví dụ với một ảnh từ Space: `"hf.co/spaces/lhoestq/duckdb"`.

command (`list[str]`) : Lệnh cần thực thi. Ví dụ: `["echo", "hello"]`.

env (`dict[str, Any]`, *tùy chọn*) : Định nghĩa các biến môi trường cho Job.

secrets (`dict[str, Any]`, *tùy chọn*) : Định nghĩa các biến môi trường bí mật cho Job.

flavor (`str`, *tùy chọn*) : Kiểu phần cứng. Xem `JobHardware` để biết các giá trị có thể. Mặc định là `"cpu-basic"`.

timeout (`Union[int, float, str]`, *tùy chọn*) : Thời lượng tối đa cho Job: int với s (giây, mặc định), m (phút), h (giờ) hoặc d (ngày). Ví dụ: `300` hoặc `"5m"` cho 5 phút.

attempts (`int`, *optional*) : Số lần thử tối đa, bao gồm lần chạy ban đầu. Mặc định là 1. Ví dụ, 3 sẽ thử lại một Job thất bại tối đa 2 lần.

name (`str`, *tuỳ chọn*) : Tên cho Job. Được lưu dưới dạng nhãn `name`. Không thể truyền cùng với khóa `name` trong `labels`. Tên không nhất thiết phải duy nhất. Mặc định là tên được suy ra từ image và command (kèm hậu tố hash ngắn).

labels (`dict[str, str]`, *tùy chọn*) : Nhãn để gắn cho công việc (cặp khóa-giá trị).

volumes (`list[Volume]`, *tùy chọn*) : Các Buckets hoặc Repos của Hugging Face để gắn làm volume trong container của job. Mỗi volume là một [Volume](/docs/huggingface_hub/v2.4.0/vi/package_reference/jobs#huggingface_hub.Volume) có `type` (`"bucket"`, `"model"`, `"dataset"` hoặc `"space"`), `source` (ví dụ `"username/my-bucket"`) và `mount_path` (ví dụ `"/data"`).

expose (`list[int]`, *optional*) : Các cổng container cần mở qua proxy của jobs. Mỗi cổng được liệt kê sẽ có thể truy cập trên tên miền jobs công khai (ví dụ: `https://<job_id>--8000.hf.jobs`). Việc truy cập luôn yêu cầu một HF token có quyền đọc vào namespace của job. Sử dụng `expose_public` cho truy cập không xác thực.

expose_public (`list[int]`, *optional*) : Các cổng cần phơi bày qua proxy của Jobs mà không cần xác thực. Chúng không cần được liệt kê trong `expose`.

ssh (`bool`, *tuỳ chọn*) : Nếu là True, container của job có thể truy cập qua SSH tại URL được chỉ định bởi `job.status.ssh_url` (ví dụ `ssh <job_id>@ssh.hf.jobs`, hoặc `hf jobs ssh <job_id>` từ CLI). Việc kết nối yêu cầu quyền ghi vào namespace của job và một khóa công khai SSH đã đăng ký trên Hub (https://huggingface.co/settings/keys). Mặc định là False.

network_group (`str`, *tùy chọn*) : Tên của nhóm mạng để tham gia. Các tác vụ trong cùng namespace và nhóm tài nguyên chia sẻ một nhóm sẽ được đặt cùng nhau và có thể liên lạc với nhau trên mọi cổng. Bên trong mỗi thành viên, `HF_NETWORK_GROUP_HOSTNAME` sẽ phân giải thành mọi thành viên của nhóm. Chỉ gồm chữ cái in thường, chữ số và dấu gạch ngang, tối đa 46 ký tự.

network_aliases (`list[str]`, *tùy chọn*) : Các alias mà công việc này tuyên bố trong nhóm mạng của nó. Các thành viên truy cập các công việc tuyên bố một alias tại `${HF_NETWORK_GROUP_PREFIX}<alias>`. Nhiều công việc có thể tuyên bố cùng một alias. Chỉ gồm chữ cái in thường, chữ số và dấu gạch nối, tối đa 34 ký tự, duy nhất trong công việc. Yêu cầu `network_group`.

resource_group_id (`str`, *tùy chọn*) : ID của nhóm tài nguyên để tạo Job. Được sử dụng để kiểm soát quyền truy cập vào các tài nguyên trong tổ chức và cho các tính năng gán chi phí/giới hạn chi tiêu. Nếu không được cung cấp, Job sẽ được tạo bên ngoài bất kỳ nhóm tài nguyên nào.

namespace (`str`, *tùy chọn*) : Không gian tên nơi Job sẽ được tạo. Mặc định là không gian tên của người dùng hiện tại.

token (`bool` hoặc `str`, *tùy chọn*) : Một token truy cập người dùng hợp lệ. Nếu không được cung cấp, token được lưu cục bộ sẽ được sử dụng, đây là phương thức xác thực được khuyến nghị. Đặt thành `False` để tắt xác thực. Tham khảo: https://huggingface.co/docs/huggingface_hub/quick-start#authentication.

Chạy các tác vụ tính toán trên hạ tầng của Hugging Face.

Ví dụ:

Chạy Job đầu tiên của bạn:

```python
>>> from huggingface_hub import run_job
>>> run_job(image="python:3.12", command=["python", "-c" ,"print('Hello from HF compute!')"])
```

Chạy một tác vụ GPU:

```python
>>> from huggingface_hub import run_job
>>> image = "pytorch/pytorch:2.6.0-cuda12.4-cudnn9-devel"
>>> command = ["python", "-c", "import torch; print(f'This code ran with the following GPU: {torch.cuda.get_device_name()}')"]
>>> run_job(image=image, command=command, flavor="a10g-small")
```

Chạy một Job với volumes:

```python
>>> from huggingface_hub import Volume, run_job
>>> dataset_volume = Volume(type="dataset", source="HuggingFaceFW/fineweb", mount_path="/data")
>>> output_bucket_volume = Volume(type="bucket", source="username/my-bucket", mount_path="/output")
>>> image = "duckdb/duckdb"
>>> command = ["duckdb", "-c", "COPY (SELECT * FROM '/data/**/*.parquet' LIMIT 5) TO '/output/first-rows.parquet'"]
>>> run_job(image=image, command=command, volumes=[dataset_volume, output_bucket_volume])
```

#### run_uv_job[[huggingface_hub.HfApi.run_uv_job]]

```python
run_uv_job(script: str, script_args: list[str] | None = None, dependencies: list[str] | None = None, python: str | None = None, image: str | None = None, env: dict[str, Any] | None = None, secrets: dict[str, Any] | None = None, flavor: JobHardware | str | None = None, timeout: int | float | str | None = None, attempts: int | None = None, name: str | None = None, labels: dict[str, str] | None = None, volumes: list[Volume] | None = None, expose: list[int] | None = None, expose_public: list[int] | None = None, ssh: bool = False, network_group: str | None = None, network_aliases: list[str] | None = None, resource_group_id: str | None = None, namespace: str | None = None, token: bool | str | None = None)
```

[Nguồn](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L12871)

**Tham số:**

script (`str`) : Đường dẫn hoặc URL của script UV, hoặc một lệnh.

script_args (`list[str]`, *tùy chọn*) : Các đối số để truyền cho script hoặc lệnh.

dependencies (`list[str]`, *tùy chọn*) : Các phụ thuộc cần dùng để chạy script UV.

python (`str`, *tùy chọn*) : Sử dụng một phiên bản Python cụ thể. Mặc định là 3.12.

image (`str`, *tùy chọn*, mặc định là "ghcr.io/astral-sh/uv --python3.12-bookworm"): Sử dụng hình ảnh Docker tùy chỉnh có cài đặt `uv`.

env (`dict[str, Any]`, *tùy chọn*) : Định nghĩa các biến môi trường cho Job.

secrets (`dict[str, Any]`, *tùy chọn*) : Định nghĩa các biến môi trường bí mật cho Job.

flavor (`str`, *tùy chọn*) : Kiểu phần cứng. Xem `JobHardware` để biết các giá trị có thể. Mặc định là `"cpu-basic"`.

timeout (`Union[int, float, str]`, *tùy chọn*) : Thời lượng tối đa cho Job: int với s (giây, mặc định), m (phút), h (giờ) hoặc d (ngày). Ví dụ: `300` hoặc `"5m"` cho 5 phút.

attempts (`int`, *optional*) : Số lần thử tối đa, bao gồm lần chạy ban đầu. Mặc định là 1.

name (`str`, *tuỳ chọn*) : Tên cho Job. Được lưu dưới dạng nhãn `name`. Không thể truyền cùng với khóa `name` trong `labels`. Tên không nhất thiết phải duy nhất. Mặc định là tên được suy ra từ script và các đối số của nó (kèm hậu tố hash ngắn).

labels (`dict[str, str]`, *tùy chọn*) : Nhãn để gắn cho công việc (cặp khóa-giá trị).

volumes (`list[Volume]`, *tùy chọn*) : Các Buckets hoặc Repos của Hugging Face để gắn làm volume trong container của job. Mỗi volume là một [Volume](/docs/huggingface_hub/v2.4.0/vi/package_reference/jobs#huggingface_hub.Volume) có `type` (`"bucket"`, `"model"`, `"dataset"` hoặc `"space"`), `source` (ví dụ `"username/my-bucket"`) và `mount_path` (ví dụ `"/data"`).

expose (`list[int]`, *optional*) : Các cổng container cần mở qua proxy của jobs. Mỗi cổng được liệt kê sẽ có thể truy cập trên tên miền jobs công khai (ví dụ: `https://<job_id>--8000.hf.jobs`). Việc truy cập luôn yêu cầu một HF token có quyền đọc vào namespace của job. Sử dụng `expose_public` cho truy cập không xác thực.

expose_public (`list[int]`, *optional*) : Các cổng cần phơi bày qua proxy của Jobs mà không cần xác thực. Chúng không cần được liệt kê trong `expose`.

ssh (`bool`, *tuỳ chọn*) : Nếu là True, container của job có thể truy cập qua SSH tại URL được chỉ định bởi `job.status.ssh_url` (ví dụ `ssh <job_id>@ssh.hf.jobs`, hoặc `hf jobs ssh <job_id>` từ CLI). Việc kết nối yêu cầu quyền ghi vào namespace của job và một khóa công khai SSH đã đăng ký trên Hub (https://huggingface.co/settings/keys). Mặc định là False.

network_group (`str`, *tùy chọn*) : Tên của nhóm mạng để tham gia. Các tác vụ trong cùng namespace và nhóm tài nguyên chia sẻ một nhóm sẽ được đặt cùng nhau và có thể liên lạc với nhau trên mọi cổng. Bên trong mỗi thành viên, `HF_NETWORK_GROUP_HOSTNAME` sẽ phân giải thành mọi thành viên của nhóm. Chỉ gồm chữ cái in thường, chữ số và dấu gạch ngang, tối đa 46 ký tự.

network_aliases (`list[str]`, *tùy chọn*) : Các alias mà công việc này tuyên bố trong nhóm mạng của nó. Các thành viên truy cập các công việc tuyên bố một alias tại `${HF_NETWORK_GROUP_PREFIX}<alias>`. Nhiều công việc có thể tuyên bố cùng một alias. Chỉ gồm chữ cái in thường, chữ số và dấu gạch nối, tối đa 34 ký tự, duy nhất trong công việc. Yêu cầu `network_group`.

resource_group_id (`str`, *tùy chọn*) : ID của nhóm tài nguyên để tạo Job. Được sử dụng để kiểm soát quyền truy cập vào các tài nguyên trong tổ chức và cho các tính năng gán chi phí/giới hạn chi tiêu. Nếu không được cung cấp, Job sẽ được tạo bên ngoài bất kỳ nhóm tài nguyên nào.

namespace (`str`, *tùy chọn*) : Không gian tên nơi Job sẽ được tạo. Mặc định là không gian tên của người dùng hiện tại.

token (`bool` hoặc `str`, *tùy chọn*) : Một token truy cập người dùng hợp lệ. Nếu không được cung cấp, token được lưu cục bộ sẽ được sử dụng, đây là phương thức xác thực được khuyến nghị. Đặt thành `False` để tắt xác thực. Tham khảo: https://huggingface.co/docs/huggingface_hub/quick-start#authentication.

Chạy một Job script UV trên hạ tầng của Hugging Face.

> [!WARNING]
> Khác với `hf jobs uv run`, phương pháp này bỏ qua bảng tùy chọn `[tool.hf-jobs]` mà một script UV có thể chứa trong phần header PEP 723 của nó (xem [Jobs guide](../guides/jobs#ship-the-launch-config-with-the-script)): cấu hình khởi chạy phải được truyền vào một cách tường minh tại đây.

Ví dụ:

Chạy một script từ một URL:

```python
>>> from huggingface_hub import run_uv_job
>>> script = "https://raw.githubusercontent.com/huggingface/trl/refs/heads/main/trl/scripts/sft.py"
>>> script_args = ["--model_name_or_path", "Qwen/Qwen2-0.5B", "--dataset_name", "trl-lib/Capybara", "--push_to_hub"]
>>> run_uv_job(script, script_args=script_args, dependencies=["trl"], flavor="a10g-small")
```

Chạy một script cục bộ:

```python
>>> from huggingface_hub import run_uv_job
>>> script = "my_sft.py"
>>> script_args = ["--model_name_or_path", "Qwen/Qwen2-0.5B", "--dataset_name", "trl-lib/Capybara", "--push_to_hub"]
>>> run_uv_job(script, script_args=script_args, dependencies=["trl"], flavor="a10g-small")
```

Chạy một lệnh:

```python
>>> from huggingface_hub import run_uv_job
>>> script = "lighteval"
>>> script_args= ["endpoint", "inference-providers", "model_name=openai/gpt-oss-20b,provider=auto", "lighteval|gsm8k|0|0"]
>>> run_uv_job(script, script_args=script_args, dependencies=["lighteval"], flavor="a10g-small")
```

Gắn các volume, ví dụ để lưu các checkpoint của mô hình trong quá trình huấn luyện:

```python
>>> from huggingface_hub import Volume, run_uv_job
>>> script = "my_sft.py"
>>> script_args = ["--output_dir", "/training-outputs/training-v3-final", ...]
>>> checkpoints_bucket = Volume(type="bucket", source="username/my-bucket", mount_path="/training-outputs")
>>> run_uv_job(script, script_args=script_args, volumes=[checkpoints_bucket])
```

#### scale_to_zero_inference_endpoint[[huggingface_hub.HfApi.scale_to_zero_inference_endpoint]]

```python
scale_to_zero_inference_endpoint(name: str, namespace: str | None = None, token: bool | str | None = None)
```

[Nguồn](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L10003)

**Tham số:**

name (`str`) : Tên của Inference Endpoint cần scale về zero.

namespace (`str`, *tùy chọn*) : Không gian tên chứa Inference Endpoint. Mặc định là người dùng hiện tại.

token (`bool` hoặc `str`, *tùy chọn*) : Một token truy cập người dùng hợp lệ (chuỗi). Mặc định là token được lưu cục bộ, đây là phương pháp xác thực được khuyến nghị (xem https://huggingface.co/docs/huggingface_hub/quick-start#authentication). Để tắt xác thực, truyền `False`.

**Trả về:** [InferenceEndpoint](/docs/huggingface_hub/v2.4.0/vi/package_reference/inference_endpoints#huggingface_hub.InferenceEndpoint)

thông tin về Inference Endpoint đã được scale về 0.

Thang đo điểm cuối suy luận về không.

Inference Endpoint được scale về 0 sẽ không bị tính phí. Nó sẽ được resume ở lần request tiếp theo, kèm theo độ trễ cold start. Điều này khác với việc pause Inference Endpoint bằng [pause_inference_endpoint()](/docs/huggingface_hub/v2.4.0/vi/package_reference/hf_api#huggingface_hub.HfApi.pause_inference_endpoint), khi đó sẽ cần resume thủ công bằng [resume_inference_endpoint()](/docs/huggingface_hub/v2.4.0/vi/package_reference/hf_api#huggingface_hub.HfApi.resume_inference_endpoint).

Để tiện lợi, bạn cũng có thể thu nhỏ một Inference Endpoint về không bằng cách sử dụng [InferenceEndpoint.scale_to_zero()](/docs/huggingface_hub/v2.4.0/vi/package_reference/inference_endpoints#huggingface_hub.InferenceEndpoint.scale_to_zero).

#### search_spaces[[huggingface_hub.HfApi.search_spaces]]

```python
search_spaces(query: str, filter: str | Iterable[str] | None = None, sdk: str | list[str] | None = None, include_non_running: bool = False, token: bool | str | None = None)
```

[Nguồn](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L2878)

**Tham số:**

query (`str`) : Chuỗi truy vấn tìm kiếm.

filter (`str` hoặc `Iterable[str]`, *tùy chọn*) : Một thẻ dạng chuỗi hoặc danh sách các thẻ để lọc.

sdk (`str` hoặc `list[str]`, *tùy chọn*) : Lọc theo SDK (ví dụ: `"gradio"`, `"docker"`, `"static"`).

include_non_running (`bool`, *tuỳ chọn*) : Có bao gồm các Spaces không đang chạy trong kết quả hay không. Mặc định là `False`.

token (`bool` hoặc `str`, *tùy chọn*) : Một token truy cập người dùng hợp lệ (chuỗi). Mặc định là token được lưu cục bộ, đây là phương pháp xác thực được khuyến nghị (xem https://huggingface.co/docs/huggingface_hub/quick-start#authentication). Để tắt xác thực, truyền `False`.

**Trả về:** `Iterable[SpaceSearchResult]`

một iterable gồm các đối tượng [SpaceSearchResult](/docs/huggingface_hub/v2.4.0/vi/package_reference/hf_api#huggingface_hub.SpaceSearchResult).

Tìm kiếm Spaces trên Hub bằng tìm kiếm ngữ nghĩa.

Endpoint này sử dụng tìm kiếm ngữ nghĩa (dựa trên embedding) cho các truy vấn nhiều từ và tìm kiếm toàn văn cho các truy vấn một từ.

Ví dụ:
```python
>>> from huggingface_hub import HfApi
>>> api = HfApi()
>>> results = list(api.search_spaces("generate image"))
>>> results[0].id
'mrfakename/Z-Image-Turbo'
>>> results[0].ai_category
'Image Generation'
```

#### set_space_sleep_time[[huggingface_hub.HfApi.set_space_sleep_time]]

```python
set_space_sleep_time(repo_id: str, sleep_time: int, token: bool | str | None = None)
```

[Nguồn](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L8373)

**Tham số:**

repo_id (`str`) : ID của kho cần cập nhật. Ví dụ: `"bigcode/in-the-stack"`.

sleep_time (`int`, *optional*) : Số giây không hoạt động cần chờ trước khi một Space được đưa vào trạng thái ngủ. Đặt thành `-1` nếu bạn không muốn Space của mình tạm dừng (hành vi mặc định cho phần cứng đã nâng cấp). Đối với phần cứng miễn phí, bạn không thể cấu hình thời gian ngủ (giá trị được cố định ở mức 48 giờ không hoạt động). Xem https://huggingface.co/docs/hub/spaces-gpus#sleep-time để biết thêm chi tiết.

token (`bool` hoặc `str`, *tùy chọn*) : Một token truy cập người dùng hợp lệ (chuỗi). Mặc định là token được lưu cục bộ, đây là phương pháp xác thực được khuyến nghị (xem https://huggingface.co/docs/huggingface_hub/quick-start#authentication). Để tắt xác thực, truyền `False`.

**Trả về:** [SpaceRuntime](/docs/huggingface_hub/v2.4.0/vi/package_reference/space_runtime#huggingface_hub.SpaceRuntime)

Thông tin thời gian chạy về một Space, bao gồm giai đoạn và phần cứng của Space.

Đặt thời gian ngủ tùy chỉnh cho một Space chạy trên phần cứng nâng cấp.

Space của bạn sẽ chuyển sang trạng thái ngủ sau X giây không hoạt động. Bạn không bị tính phí khi Space ở chế độ "ngủ". Khi một khách truy cập mới đến Space của bạn, nó sẽ được "thức dậy". Chỉ phần cứng nâng cấp mới có thể cấu hình thời gian ngủ. Để biết thêm về giai đoạn ngủ, vui lòng tham khảo https://huggingface.co/docs/hub/spaces-gpus#sleep-time.

> [!TIP]
> Bạn cũng có thể đặt thời gian ngủ tùy chỉnh khi yêu cầu phần cứng bằng [request_space_hardware()](/docs/huggingface_hub/v2.4.0/vi/package_reference/hf_api#huggingface_hub.HfApi.request_space_hardware).

#### set_space_volumes[[huggingface_hub.HfApi.set_space_volumes]]

```python
set_space_volumes(repo_id: str, volumes: list[Volume], token: bool | str | None = None)
```

[Nguồn](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L9057)

**Tham số:**

repo_id (`str`) : ID của Space cần cập nhật. Ví dụ: `"username/my-space"`.

volumes (`list[Volume]`) : Danh sách các đối tượng [Volume](/docs/huggingface_hub/v2.4.0/vi/package_reference/jobs#huggingface_hub.Volume) để gắn. Mỗi volume có một `type` (`"bucket"`, `"model"`, `"dataset"`, hoặc `"space"`), một `source` (ID của repo hoặc bucket), một `mount_path` (đường dẫn bên trong container), và các trường tùy chọn `revision`, `read_only`, cùng `path`.

token (`bool` hoặc `str`, *tùy chọn*) : Một token truy cập người dùng hợp lệ (chuỗi). Mặc định là token được lưu cục bộ, đây là phương pháp xác thực được khuyến nghị (xem https://huggingface.co/docs/huggingface_hub/quick-start#authentication). Để tắt xác thực, truyền `False`.

**Lỗi:** `BadRequestError`

- `BadRequestError` -- Nếu Space là một Space tĩnh (không hỗ trợ volumes trên các Space tĩnh).

Đặt các volume cho một Space.

Sets (hoặc thay thế) danh sách các volume được gắn vào Space. Mỗi volume cho phép container của Space truy cập vào một tài nguyên trên Hub (mô hình, tập dữ liệu, hoặc bucket lưu trữ).

Ví dụ:
```python
>>> from huggingface_hub import HfApi, Volume
>>> api = HfApi()
>>> api.set_space_volumes(
...     "username/my-space",
...     volumes=[
...         Volume(type="model", source="username/my-model", mount_path="/models", read_only=True),
...         Volume(type="bucket", source="username/my-bucket", mount_path="/data"),
...     ],
... )
```

#### snapshot_download[[huggingface_hub.HfApi.snapshot_download]]

```python
snapshot_download(repo_id: str, repo_type: str | None = None, revision: str | None = None, cache_dir: str | Path | None = None, local_dir: str | Path | None = None, etag_timeout: float = 10, force_download: bool = False, token: bool | str | None = None, local_files_only: bool = False, allow_patterns: list[str] | str | None = None, ignore_patterns: list[str] | str | None = None, max_workers: int = 8, tqdm_class: type[base_tqdm] | None = None, dry_run: bool = False)
```

[Nguồn](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L6546)

**Tham số:**

repo_id (`str`) : Tên người dùng hoặc tên tổ chức và tên kho, phân tách bằng `/`.

repo_type (`str`, *tùy chọn*) : Đặt thành `"dataset"` hoặc `"space"` nếu tải xuống từ một dataset hoặc space, `None` hoặc `"model"` nếu tải xuống từ một model. Mặc định là `None`.

revision (`str`, *tùy chọn*) : Một id phiên bản Git tùy chọn, có thể là tên nhánh, một tag, hoặc một commit hash.

cache_dir (`str`, `Path`, *tùy chọn*) : Đường dẫn đến thư mục nơi lưu trữ các tệp được lưu trong bộ nhớ đệm.

local_dir (`str` hoặc `Path`, *tùy chọn*) : Nếu được cung cấp, các tệp đã tải xuống sẽ được đặt trong thư mục này.

etag_timeout (`float`, *tùy chọn*, mặc định là `10`) : Khi lấy ETag, số giây chờ máy chủ gửi dữ liệu trước khi từ bỏ, được truyền vào `httpx2.request`.

force_download (`bool`, *tùy chọn*, mặc định là `False`) : Xác định xem tệp có nên được tải xuống ngay cả khi nó đã tồn tại trong bộ nhớ đệm cục bộ hay không.

token (`bool` hoặc `str`, *tùy chọn*) : Một token truy cập người dùng hợp lệ (chuỗi). Mặc định là token được lưu cục bộ, đây là phương pháp xác thực được khuyến nghị (xem https://huggingface.co/docs/huggingface_hub/quick-start#authentication). Để tắt xác thực, truyền `False`.

local_files_only (`bool`, *tùy chọn*, mặc định là `False`) : Nếu `True`, tránh tải xuống tệp và trả về đường dẫn đến tệp được lưu trong bộ nhớ đệm cục bộ nếu tệp đó tồn tại.

allow_patterns (`list[str]` hoặc `str`, *tùy chọn*) : Nếu được cung cấp, chỉ các tệp khớp với ít nhất một mẫu sẽ được tải xuống.

ignore_patterns (`list[str]` hoặc `str`, *tùy chọn*) : Nếu được cung cấp, các tệp khớp với bất kỳ mẫu nào sẽ không được tải xuống.

max_workers (`int`, *optional*) : Số lượng luồng đồng thời để tải xuống các tệp (1 luồng = 1 tệp tải xuống). Mặc định là 8.

tqdm_class (`tqdm`, *tùy chọn*) : Nếu được cung cấp, sẽ ghi đè lên hành vi mặc định của thanh tiến trình. Đối số được truyền phải kế thừa từ `tqdm.auto.tqdm` hoặc ít nhất phải mô phỏng hành vi của nó. Lưu ý rằng `tqdm_class` không được truyền cho từng thao tác tải xuống riêng lẻ. Mặc định là thanh tiến trình tùy chỉnh của HF, có thể bị vô hiệu hóa bằng cách đặt biến môi trường `HF_HUB_DISABLE_PROGRESS_BARS`.

dry_run (`bool`, *tuỳ chọn*, mặc định là `False`) : Nếu `True`, thực hiện chạy thử mà không thực sự tải xuống các tệp. Trả về một danh sách các đối tượng [DryRunFileInfo](/docs/huggingface_hub/v2.4.0/vi/package_reference/hf_api#huggingface_hub.DryRunFileInfo) chứa thông tin về những gì sẽ được tải xuống.

**Trả về:** `str` hoặc danh sách [DryRunFileInfo](/docs/huggingface_hub/v2.4.0/vi/package_reference/hf_api#huggingface_hub.DryRunFileInfo)

- Nếu `dry_run=False`: Đường dẫn thư mục của bản sao lưu kho.
- Nếu `dry_run=True`: Một danh sách các đối tượng [DryRunFileInfo](/docs/huggingface_hub/v2.4.0/vi/package_reference/hf_api#huggingface_hub.DryRunFileInfo) chứa thông tin tải xuống.

**Gây ra:** [RepositoryNotFoundError](/docs/huggingface_hub/v2.4.0/vi/package_reference/utilities#huggingface_hub.errors.RepositoryNotFoundError) hoặc [RevisionNotFoundError](/docs/huggingface_hub/v2.4.0/vi/package_reference/utilities#huggingface_hub.errors.RevisionNotFoundError) hoặc ``EnvironmentError`` hoặc ``OSError`` hoặc ``ValueError``

- [RepositoryNotFoundError](/docs/huggingface_hub/v2.4.0/vi/package_reference/utilities#huggingface_hub.errors.RepositoryNotFoundError) -- Nếu không tìm thấy kho cần tải xuống. Điều này có thể do kho không tồn tại, hoặc do kho được đặt ở chế độ `private` và bạn không có quyền truy cập.
- [RevisionNotFoundError](/docs/huggingface_hub/v2.4.0/vi/package_reference/utilities#huggingface_hub.errors.RevisionNotFoundError) -- Nếu không tìm thấy revision cần tải xuống.
- [`EnvironmentError`](https://docs.python.org/3/library/exceptions.html#EnvironmentError) -- Nếu `token=True` và không tìm thấy token.
- [`OSError`](https://docs.python.org/3/library/exceptions.html#OSError) -- nếu không thể xác định được ETag.
- [`ValueError`](https://docs.python.org/3/library/exceptions.html#ValueError) -- nếu giá trị của một số tham số không hợp lệ.

Tải xuống các tệp của kho.

Tải xuống toàn bộ snapshot các tệp của một repo tại revision được chỉ định. Điều này hữu ích khi bạn muốn tất cả các tệp từ một repo, vì bạn không biết trước mình sẽ cần những tệp nào. Tất cả các tệp được đặt lồng trong một thư mục để giữ nguyên tên tệp thực tế của chúng so với thư mục đó. Bạn cũng có thể lọc các tệp cần tải xuống bằng cách sử dụng `allow_patterns` và `ignore_patterns`.

Nếu `local_dir` được cung cấp, cấu trúc tệp từ kho sẽ được nhân bản tại vị trí này. Khi sử dụng tùy chọn này, `cache_dir` sẽ không được sử dụng và một thư mục `.cache/huggingface/` sẽ được tạo tại gốc của `local_dir` để lưu trữ một số siêu dữ liệu liên quan đến các tệp đã tải xuống. Mặc dù cơ chế này không mạnh mẽ bằng hệ thống cache chính, nó được tối ưu hóa để thường xuyên kéo phiên bản mới nhất của một kho.

Một phương án thay thế là clone kho mã nguồn, nhưng điều này yêu cầu git và git-lfs phải được cài đặt và cấu hình đúng cách. Ngoài ra, khi clone một kho mã nguồn bằng git, bạn không thể lọc các tệp cần tải xuống.

#### space_info[[huggingface_hub.HfApi.space_info]]

```python
space_info(repo_id: str, revision: str | None = None, timeout: float | None = None, files_metadata: bool = False, expand: list[ExpandSpaceProperty_T] | None = None, token: bool | str | None = None)
```

[Nguồn](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L3359)

**Tham số:**

repo_id (`str`) : Một namespace (người dùng hoặc tổ chức) và tên kho, được phân tách bằng `/`.

revision (`str`, *tùy chọn*) : Phiên bản của kho không gian mà từ đó lấy thông tin.

timeout (`float`, *optional*) : Có nên đặt thời gian chờ (timeout) cho yêu cầu đến Hub hay không.

files_metadata (`bool`, *tuỳ chọn*) : Có lấy hay không lấy siêu dữ liệu cho các tệp trong kho (kích thước, siêu dữ liệu LFS, v.v.). Mặc định là `False`.

expand (`list[ExpandSpaceProperty_T]`, *tùy chọn*) : Danh sách các thuộc tính cần trả về trong phản hồi. Khi được sử dụng, chỉ các thuộc tính trong danh sách sẽ được trả về. Tham số này không thể được sử dụng nếu `full` được truyền vào. Các giá trị có thể là `"author"`, `"cardData"`, `"createdAt"`, `"datasets"`, `"disabled"`, `"lastModified"`, `"likes"`, `"models"`, `"private"`, `"region"`, `"runtime"`, `"sdk"`, `"siblings"`, `"sha"`, `"subdomain"`, `"tags"`, `"trendingScore"`, `"usedStorage"`, và `"resourceGroup"`.

token (`bool` hoặc `str`, *tùy chọn*) : Một token truy cập người dùng hợp lệ (chuỗi). Mặc định là token được lưu cục bộ, đây là phương pháp xác thực được khuyến nghị (xem https://huggingface.co/docs/huggingface_hub/quick-start#authentication). Để tắt xác thực, truyền `False`.

**Trả về:** [SpaceInfo](/docs/huggingface_hub/v2.4.0/vi/package_reference/hf_api#huggingface_hub.SpaceInfo)

Thông tin kho lưu trữ Space.

Lấy thông tin về một Space cụ thể trên huggingface.co.

Space có thể là riêng tư nếu bạn truyền vào một token hợp lệ.

> [!TIP]
> Gây ra các lỗi sau:
>
> - [RepositoryNotFoundError](/docs/huggingface_hub/v2.4.0/vi/package_reference/utilities#huggingface_hub.errors.RepositoryNotFoundError) Nếu không tìm thấy kho cần tải xuống. Điều này có thể do kho không tồn tại, hoặc do kho được đặt ở chế độ `private` và bạn không có quyền truy cập. - [RevisionNotFoundError](/docs/huggingface_hub/v2.4.0/vi/package_reference/utilities#huggingface_hub.errors.RevisionNotFoundError) Nếu không tìm thấy phiên bản cần tải xuống.

#### super_squash_history[[huggingface_hub.HfApi.super_squash_history]]

```python
super_squash_history(repo_id: str, branch: str | None = None, commit_message: str | None = None, repo_type: str | None = None, token: str | bool | None = None)
```

[Nguồn](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L4346)

**Tham số:**

repo_id (`str`) : Một namespace (người dùng hoặc tổ chức) và tên kho, được phân tách bằng `/`.

branch (`str`, *tùy chọn*) : Nhánh cần squash. Mặc định là đầu của nhánh `"main"`.

commit_message (`str`, *tùy chọn*) : Thông báo commit cần sử dụng cho commit đã được nén (squashed).

repo_type (`str`, *tùy chọn*) : Đặt thành `"dataset"` hoặc `"space"` nếu liệt kê các commit từ một dataset hoặc một Space, `None` hoặc `"model"` nếu liệt kê từ một model. Mặc định là `None`.

token (`bool` hoặc `str`, *tùy chọn*) : Một token truy cập người dùng hợp lệ (chuỗi). Mặc định là token được lưu cục bộ, đây là phương pháp xác thực được khuyến nghị (xem https://huggingface.co/docs/huggingface_hub/quick-start#authentication). Để tắt xác thực, truyền `False`.

**Gây ra:** [RepositoryNotFoundError](/docs/huggingface_hub/v2.4.0/vi/package_reference/utilities#huggingface_hub.errors.RepositoryNotFoundError) hoặc [RevisionNotFoundError](/docs/huggingface_hub/v2.4.0/vi/package_reference/utilities#huggingface_hub.errors.RevisionNotFoundError) hoặc [BadRequestError](/docs/huggingface_hub/v2.4.0/vi/package_reference/utilities#huggingface_hub.errors.BadRequestError)

- [RepositoryNotFoundError](/docs/huggingface_hub/v2.4.0/vi/package_reference/utilities#huggingface_hub.errors.RepositoryNotFoundError) -- Nếu không tìm thấy kho (lỗi 404): repo_id/repo_type không đúng, kho là riêng tư nhưng chưa xác thực hoặc kho không tồn tại.
- [RevisionNotFoundError](/docs/huggingface_hub/v2.4.0/vi/package_reference/utilities#huggingface_hub.errors.RevisionNotFoundError) -- Nếu không tìm thấy nhánh cần squash.
- [BadRequestError](/docs/huggingface_hub/v2.4.0/vi/package_reference/utilities#huggingface_hub.errors.BadRequestError) -- Nếu tham chiếu không hợp lệ cho một nhánh. Bạn không thể nén lịch sử trên các thẻ.

Nén lịch sử commit trên một nhánh của kho trên Hub.

Việc nén lịch sử repo hữu ích khi bạn biết mình sẽ tạo hàng trăm commit và không muốn làm lộn xộn lịch sử. Việc nén commit chỉ có thể được thực hiện từ đầu của một nhánh.

> [!WARNING]
> Một khi đã được nén, lịch sử commit không thể được khôi phục. Đây là một thao tác không thể hoàn tác.

> [!WARNING]
> Một khi lịch sử của một nhánh đã được nén lại, sẽ không thể hợp nhất nó trở lại một nhánh khác vì lịch sử của chúng đã phân kỳ.

Ví dụ:
```py
>>> from huggingface_hub import HfApi
>>> api = HfApi()

# Create repo
>>> repo_id = api.create_repo("test-squash").repo_id

# Make a lot of commits.
>>> api.upload_file(repo_id=repo_id, path_in_repo="file.txt", path_or_fileobj=b"content")
>>> api.upload_file(repo_id=repo_id, path_in_repo="lfs.bin", path_or_fileobj=b"content")
>>> api.upload_file(repo_id=repo_id, path_in_repo="file.txt", path_or_fileobj=b"another_content")

# Squash history
>>> api.super_squash_history(repo_id=repo_id)
```

#### suspend_scheduled_job[[huggingface_hub.HfApi.suspend_scheduled_job]]

```python
suspend_scheduled_job(scheduled_job_id: str, namespace: str | None = None, token: bool | str | None = None)
```

[Nguồn](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L13354)

**Tham số:**

scheduled_job_id (`str`) : ID của Job đã được lên lịch.

namespace (`str`, *tùy chọn*) : Không gian tên (namespace) chứa Job được lên lịch. Mặc định là không gian tên của người dùng hiện tại.

token (`bool` hoặc `str`, *tùy chọn*) : Một token truy cập người dùng hợp lệ. Nếu không được cung cấp, token được lưu cục bộ sẽ được sử dụng, đây là phương thức xác thực được khuyến nghị. Đặt thành `False` để tắt xác thực. Tham khảo: https://huggingface.co/docs/huggingface_hub/quick-start#authentication.

Suspend (dừng) một Job tính toán đã lên lịch trên hạ tầng Hugging Face.

#### sync_bucket[[huggingface_hub.HfApi.sync_bucket]]

```python
sync_bucket(source: str | None = None, dest: str | None = None, delete: bool = False, ignore_times: bool = False, ignore_sizes: bool = False, existing: bool = False, ignore_existing: bool = False, include: list[str] | None = None, exclude: list[str] | None = None, filter_from: str | None = None, plan: str | None = None, apply: str | None = None, dry_run: bool = False, verbose: bool = False, quiet: bool = False, token: bool | str | None = None)
```

[Nguồn](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L15207)

**Tham số:**

source (*str*, *tuỳ chọn*) : Đường dẫn nguồn: thư mục cục bộ hoặc `hf://buckets/namespace/bucket_name(/prefix)`. Bắt buộc trừ khi sử dụng `apply`.

dest (*str*, *tuỳ chọn*) : Đường dẫn đích: thư mục cục bộ hoặc `hf://buckets/namespace/bucket_name(/prefix)`. Bắt buộc trừ khi sử dụng `apply`.

delete (*bool*, *optional*, mặc định là *False*) : Xóa các tệp đích không có trong nguồn.

ignore_times (*bool*, *optional*, mặc định là *False*) : Bỏ qua các tệp chỉ dựa trên kích thước, bỏ qua thời gian sửa đổi.

ignore_sizes (*bool*, *optional*, mặc định là *False*) : Bỏ qua các tệp chỉ dựa trên thời gian sửa đổi, bỏ qua kích thước.

existing (*bool*, *optional*, mặc định là *False*) : Bỏ qua việc tạo các tệp mới trên máy nhận (chỉ cập nhật các tệp hiện có).

ignore_existing (*bool*, *optional*, mặc định là *False*) : Bỏ qua việc cập nhật các tệp đã tồn tại trên máy nhận (chỉ tạo các tệp mới).

include (*list[str]*, *optional*) : Bao gồm các tệp khớp với các mẫu (theo kiểu fnmatch).

exclude (*list[str]*, *optional*) : Loại trừ các tệp khớp với các mẫu (theo kiểu fnmatch).

filter_from (*str*, *optional*) : Đường dẫn đến tệp bộ lọc chứa các quy tắc bao gồm/loại trừ.

plan (*str*, *optional*) : Lưu kế hoạch đồng bộ vào tệp JSONL này thay vì thực thi.

apply (*str*, *optional*) : Áp dụng tệp kế hoạch đã lưu trước đó. Khi được đặt, `source` và `dest` không cần thiết.

dry_run (*bool*, *optional*, mặc định là *False*) : In kế hoạch đồng bộ ra stdout dưới dạng JSONL mà không thực thi.

verbose (*bool*, *optional*, mặc định là *False*) : Hiển thị các thao tác chi tiết cho từng tệp.

quiet (*bool*, *optional*, mặc định là *False*) : Ẩn tất cả đầu ra và thanh tiến trình.

token (Union[bool, str, None], tùy chọn) : Một token truy cập người dùng hợp lệ. Nếu không được cung cấp, token được lưu cục bộ sẽ được sử dụng.

**Trả về:** [*SyncPlan*]

Kế hoạch đồng bộ đã được tính toán (hoặc tải vào).

Đồng bộ hóa các tệp giữa một thư mục cục bộ và một bucket.

Điều này tương đương với lệnh CLI `hf buckets sync`. Một trong `source` hoặc `dest` phải là đường dẫn bucket (`hf://buckets/...`) và cái còn lại phải là đường dẫn thư mục cục bộ.

Ví dụ:
```python
>>> from huggingface_hub import HfApi
>>> api = HfApi()

# Upload local directory to bucket
>>> api.sync_bucket("./data", "hf://buckets/username/my-bucket")

# Download bucket to local directory
>>> api.sync_bucket("hf://buckets/username/my-bucket", "./data")

# Sync with delete and filtering
>>> api.sync_bucket(
...     "./data",
...     "hf://buckets/username/my-bucket",
...     delete=True,
...     include=["*.safetensors"],
... )

# Dry run: preview what would be synced
>>> plan = api.sync_bucket("./data", "hf://buckets/username/my-bucket", dry_run=True)
>>> plan.summary()
&amp;lcub;'uploads': 3, 'downloads': 0, 'deletes': 0, 'skips': 1, 'total_size': 4096}

# Save plan for review, then apply
>>> api.sync_bucket("./data", "hf://buckets/username/my-bucket", plan="sync-plan.jsonl")
>>> api.sync_bucket(apply="sync-plan.jsonl")
```

#### sync_job_volume[[huggingface_hub.HfApi.sync_job_volume]]

```python
sync_job_volume(source: str | Path, mount_path: str, remote_name: str | None = None, read_only: bool = True, namespace: str | None = None, token: bool | str | None = None)
```

[Nguồn](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L13857)

**Tham số:**

source (`str` hoặc `Path`) : Đường dẫn đến một thư mục cục bộ để đồng bộ hóa.

mount_path (`str`) : Đường dẫn gắn (mount path) bên trong container của Job, ví dụ `"/inputs"`. Phải bắt đầu bằng `/`.

remote_name (`str`, *tùy chọn*) : Tên của thư mục con trong bucket để đồng bộ hóa. Mặc định là tên `{dirname}-{hash}` được suy ra từ đường dẫn nguồn và tên máy chủ của máy.

read_only (`bool`, *tùy chọn*, mặc định là `True`) : Gắn volume chỉ đọc trong Job. Truyền `False` để cho phép Job ghi ngược lại vào thư mục bucket (ví dụ để lấy các kết quả đầu ra bằng [sync_bucket()](/docs/huggingface_hub/v2.4.0/vi/package_reference/hf_api#huggingface_hub.HfApi.sync_bucket) sau đó).

namespace (`str`, *tùy chọn*) : Không gian tên sở hữu bucket `jobs-artifacts`. Mặc định là không gian tên của người dùng hiện tại. Hãy sử dụng cùng không gian tên với Job sẽ gắn (mount) volume.

token (`Union[bool, str, None]`, *tùy chọn*) : Một token truy cập người dùng hợp lệ. Nếu không được cung cấp, token được lưu cục bộ sẽ được sử dụng, đây là phương thức xác thực được khuyến nghị. Đặt thành `False` để tắt xác thực. Tham khảo: https://huggingface.co/docs/huggingface_hub/quick-start#authentication.

**Trả về:** [Volume](/docs/huggingface_hub/v2.4.0/vi/package_reference/jobs#huggingface_hub.Volume)

Dung lượng bucket được giới hạn phạm vi theo thư mục con đã đồng bộ, để truyền vào danh sách `volumes` của [run_job()](/docs/huggingface_hub/v2.4.0/vi/package_reference/hf_api#huggingface_hub.HfApi.run_job), [run_uv_job()](/docs/huggingface_hub/v2.4.0/vi/package_reference/hf_api#huggingface_hub.HfApi.run_uv_job), [create_scheduled_job()](/docs/huggingface_hub/v2.4.0/vi/package_reference/hf_api#huggingface_hub.HfApi.create_scheduled_job) hoặc [create_scheduled_uv_job()](/docs/huggingface_hub/v2.4.0/vi/package_reference/hf_api#huggingface_hub.HfApi.create_scheduled_uv_job).

Đồng bộ một thư mục cục bộ với một bucket và trả về một [Volume](/docs/huggingface_hub/v2.4.0/vi/package_reference/jobs#huggingface_hub.Volume) sẵn sàng để gắn vào một Job.

Các tệp được tải lên một thư mục con của bucket `{namespace}/jobs-artifacts` (được tạo tự động ở chế độ riêng tư; một cảnh báo sẽ được phát ra nếu bucket đã tồn tại và đang ở chế độ công khai) bằng cách sử dụng cùng logic đồng bộ hóa như [sync_bucket()](/docs/huggingface_hub/v2.4.0/vi/package_reference/hf_api#huggingface_hub.HfApi.sync_bucket): việc đồng bộ hóa lại cùng một thư mục chỉ tải lên các tệp mới hoặc đã bị sửa đổi. Mặc định, tên thư mục con được suy ra từ đường dẫn thư mục và tên máy chủ của máy, do đó các lần gọi lặp lại từ cùng một thư mục sẽ tái sử dụng cùng một thư mục từ xa. Truyền `remote_name` để sử dụng một tên cố định thay thế.

Lưu ý rằng dữ liệu được *sao chép* vào bucket, không được gắn trực tiếp: các thay đổi được thực hiện cục bộ sau khi đồng bộ sẽ không hiển thị cho Job (chạy lại `sync_job_volume` để cập nhật), và volume được gắn ở chế độ chỉ đọc theo mặc định. Để lấy dữ liệu do Job ghi vào một volume đọc-ghi, hãy đồng bộ thư mục bucket trở lại bằng [sync_bucket()](/docs/huggingface_hub/v2.4.0/vi/package_reference/hf_api#huggingface_hub.HfApi.sync_bucket). Nếu thư mục nguồn trống (ví dụ: thư mục đầu ra), một tệp `.keep` sẽ được tải lên để volume vẫn có thể được gắn.

Ví dụ:
```python
>>> from huggingface_hub import run_uv_job, sync_job_volume

# Upload ./training-data once, then run multiple jobs against it
>>> volume = sync_job_volume("./training-data", "/data")
>>> run_uv_job("train.py", script_args=["--learning-rate", "0.01"], volumes=[volume])
>>> run_uv_job("train.py", script_args=["--learning-rate", "0.05"], volumes=[volume])

# Read-write volume to retrieve outputs after the job completes
>>> volume = sync_job_volume("./outputs", "/outputs", read_only=False)
>>> job = run_uv_job("process.py", volumes=[volume])
```

#### trigger_scheduled_job[[huggingface_hub.HfApi.trigger_scheduled_job]]

```python
trigger_scheduled_job(scheduled_job_id: str, namespace: str | None = None, token: bool | str | None = None)
```

[Nguồn](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L13466)

**Tham số:**

scheduled_job_id (`str`) : ID của Job đã được lên lịch.

namespace (`str`, *tùy chọn*) : Không gian tên (namespace) chứa Job được lên lịch. Mặc định là không gian tên của người dùng hiện tại.

token (`bool` hoặc `str`, *tùy chọn*) : Một token truy cập người dùng hợp lệ. Nếu không được cung cấp, token được lưu cục bộ sẽ được sử dụng, đây là phương thức xác thực được khuyến nghị. Đặt thành `False` để tắt xác thực. Tham khảo: https://huggingface.co/docs/huggingface_hub/quick-start#authentication.

**Trả về:** [JobInfo](/docs/huggingface_hub/v2.4.0/vi/package_reference/jobs#huggingface_hub.JobInfo)

Thông tin về lần chạy được kích hoạt.

**Lỗi:** [HfHubHTTPError](/docs/huggingface_hub/v2.4.0/vi/package_reference/utilities#huggingface_hub.errors.HfHubHTTPError)

- [HfHubHTTPError](/docs/huggingface_hub/v2.4.0/vi/package_reference/utilities#huggingface_hub.errors.HfHubHTTPError) -- HTTP 409 nếu một instance khác đã đang chạy và `concurrency` bị tắt trên job được lên lịch.

Kích hoạt một Job được lên lịch để chạy ngay lập tức.

Điều này kích hoạt một lần chạy ngay lập tức của spec công việc được lên lịch. Nó **không** thay đổi lịch trình và **không** ảnh hưởng đến lần chạy được lên lịch tiếp theo. Nếu một instance đang chạy và công việc được lên lịch không cho phép chạy đồng thời, yêu cầu sẽ bị từ chối (HTTP 409).

#### khác[[huggingface_hub.HfApi.unlike]]

```python
unlike(repo_id: str, token: bool | str | None = None, repo_type: str | None = None)
```

[Nguồn](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L2937)

**Tham số:**

repo_id (`str`) : Kho lưu trữ để bỏ thích. Ví dụ: `"user/my-cool-model"`.

token (`bool` hoặc `str`, *tùy chọn*) : Một token truy cập người dùng hợp lệ (chuỗi). Mặc định là token được lưu cục bộ, đây là phương pháp xác thực được khuyến nghị (xem https://huggingface.co/docs/huggingface_hub/quick-start#authentication). Để tắt xác thực, truyền `False`.

repo_type (`str`, *tùy chọn*) : Đặt thành `"dataset"` hoặc `"space"` nếu bỏ thích một dataset hoặc space, `None` hoặc `"model"` nếu bỏ thích một model. Mặc định là `None`.

**Lỗi:** [RepositoryNotFoundError](/docs/huggingface_hub/v2.4.0/vi/package_reference/utilities#huggingface_hub.errors.RepositoryNotFoundError)

- [RepositoryNotFoundError](/docs/huggingface_hub/v2.4.0/vi/package_reference/utilities#huggingface_hub.errors.RepositoryNotFoundError) -- Nếu không tìm thấy kho (lỗi 404): repo_id/repo_type không đúng, kho là riêng tư nhưng chưa xác thực hoặc kho không tồn tại.

Khác với một kho lưu trữ cụ thể trên Hub (ví dụ: xóa khỏi danh sách yêu thích).

Để ngăn chặn việc sử dụng spam, không thể `like` một kho lưu trữ từ một script.

Xem thêm [list_liked_repos()](/docs/huggingface_hub/v2.4.0/vi/package_reference/hf_api#huggingface_hub.HfApi.list_liked_repos).

Ví dụ:
```python
>>> from huggingface_hub import list_liked_repos, unlike
>>> "gpt2" in list_liked_repos().models # we assume you have already liked gpt2
True
>>> unlike("gpt2")
>>> "gpt2" in list_liked_repos().models
False
```

#### update_bucket_settings[[huggingface_hub.HfApi.update_bucket_settings]]

```python
update_bucket_settings(bucket_id: str, private: bool, token: bool | str | None = None)
```

[Nguồn](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L14256)

**Tham số:**

bucket_id (`str`) : ID của bucket (ví dụ: `"username/my-bucket"`).

private (`bool`) : Xác định xem có làm cho bucket riêng tư hay không.

token (`bool` hoặc `str`, *tùy chọn*) : Một token truy cập người dùng hợp lệ (chuỗi). Mặc định là token được lưu cục bộ, đây là phương pháp xác thực được khuyến nghị (xem https://huggingface.co/docs/huggingface_hub/quick-start#authentication). Để tắt xác thực, truyền `False`.

**Lỗi:** `BucketNotFoundError` hoặc ``or``

- `BucketNotFoundError` -- Nếu không tìm thấy bucket. Điều này có thể là do bucket không tồn tại,
- ``or`` -- because it is set to `private` and you do not have access.

Cập nhật cài đặt của một bucket trên Hub.

Hiện tại, cài đặt duy nhất được hỗ trợ là mức độ hiển thị của bucket.

Ví dụ:
```python
>>> from huggingface_hub import update_bucket_settings

>>> # Make a bucket public
>>> update_bucket_settings(bucket_id="Wauplin/first-bucket", private=False)

>>> # Make it private again
>>> update_bucket_settings(bucket_id="Wauplin/first-bucket", private=True)
```

#### update_collection_item[[huggingface_hub.HfApi.update_collection_item]]

```python
update_collection_item(collection_slug: str, item_object_id: str, note: str | None = None, position: int | None = None, token: bool | str | None = None)
```

[Nguồn](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L10495)

**Tham số:**

collection_slug (`str`) : Slug của bộ sưu tập cần cập nhật. Ví dụ: `"TheBloke/recent-models-64f9a55bb3115b4f513ec026"`.

item_object_id (`str`) : ID của mục trong bộ sưu tập. Đây không phải là id của mục trên Hub (repo_id hoặc paper id). Nó phải được lấy từ một đối tượng [CollectionItem](/docs/huggingface_hub/v2.4.0/vi/package_reference/collections#huggingface_hub.CollectionItem). Ví dụ: `collection.items[0].item_object_id`.

note (`str`, *tùy chọn*) : Ghi chú đính kèm cho mục trong bộ sưu tập. Kích thước tối đa của một ghi chú là 500 ký tự.

position (`int`, *tuỳ chọn*) : Vị trí mới của mục trong bộ sưu tập.

token (`bool` hoặc `str`, *tùy chọn*) : Một token truy cập người dùng hợp lệ (chuỗi). Mặc định là token được lưu cục bộ, đây là phương pháp xác thực được khuyến nghị (xem https://huggingface.co/docs/huggingface_hub/quick-start#authentication). Để tắt xác thực, truyền `False`.

Cập nhật một mục trong bộ sưu tập.

Ví dụ:

```py
>>> from huggingface_hub import get_collection, update_collection_item

# Get collection first
>>> collection = get_collection("TheBloke/recent-models-64f9a55bb3115b4f513ec026")

# Update item based on its ID (add note + update position)
>>> update_collection_item(
...     collection_slug="TheBloke/recent-models-64f9a55bb3115b4f513ec026",
...     item_object_id=collection.items[-1].item_object_id,
...     note="Newly updated model!",
...     position=0,
... )
```

#### update_collection_metadata[[huggingface_hub.HfApi.update_collection_metadata]]

```python
update_collection_metadata(collection_slug: str, title: str | None = None, description: str | None = None, position: int | None = None, private: bool | None = None, theme: str | None = None, token: bool | str | None = None)
```

[Nguồn](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L10265)

**Tham số:**

collection_slug (`str`) : Slug của bộ sưu tập cần cập nhật. Ví dụ: `"TheBloke/recent-models-64f9a55bb3115b4f513ec026"`.

title (`str`) : Tiêu đề của bộ sưu tập cần cập nhật.

description (`str`, *tùy chọn*) : Mô tả của bộ sưu tập cần cập nhật. Kích thước tối đa cho một mô tả là 150 ký tự.

position (`int`, *tuỳ chọn*) : Vị trí mới của bộ sưu tập trong danh sách các bộ sưu tập của người dùng.

private (`bool`, *tùy chọn*) : Xác định xem bộ sưu tập có nên được đặt ở chế độ riêng tư hay không.

theme (`str`, *tùy chọn*) : Chủ đề của bộ sưu tập trên Hub.

token (`bool` hoặc `str`, *tùy chọn*) : Một token truy cập người dùng hợp lệ (chuỗi). Mặc định là token được lưu cục bộ, đây là phương pháp xác thực được khuyến nghị (xem https://huggingface.co/docs/huggingface_hub/quick-start#authentication). Để tắt xác thực, truyền `False`.

Cập nhật metadata của một collection trên Hub.

Tất cả các đối số đều là tùy chọn. Chỉ các metadata được cung cấp sẽ được cập nhật.

Trả về: [Collection](/docs/huggingface_hub/v2.4.0/vi/package_reference/collections#huggingface_hub.Collection)

Ví dụ:

```py
>>> from huggingface_hub import update_collection_metadata
>>> collection = update_collection_metadata(
...     collection_slug="username/iccv-2023-64f9a55bb3115b4f513ec026",
...     title="ICCV Oct. 2023",
...     description="Portfolio of models, datasets, papers and demos I presented at ICCV Oct. 2023",
...     private=False,
...     theme="pink",
... )
>>> collection.slug
"username/iccv-oct-2023-64f9a55bb3115b4f513ec026"
# ^collection slug got updated but not the trailing ID
```

#### update_collection_resource_group[[huggingface_hub.HfApi.update_collection_resource_group]]

```python
update_collection_resource_group(collection_slug: str, resource_group_id: str | None, token: bool | str | None = None)
```

[Nguồn](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L10333)

**Tham số:**

collection_slug (`str`) : Slug của bộ sưu tập cần cập nhật. Ví dụ: `"TheBloke/recent-models-64f9a55bb3115b4f513ec026"`.

resource_group_id (`str` hoặc `None`) : Nhóm tài nguyên để gán cho bộ sưu tập, dưới dạng chuỗi thập lục phân 24 ký tự. Nếu là `None`, bộ sưu tập sẽ được gỡ khỏi mọi nhóm tài nguyên.

token (`bool` hoặc `str`, *tùy chọn*) : Một token truy cập người dùng hợp lệ (chuỗi). Mặc định là token được lưu cục bộ, đây là phương pháp xác thực được khuyến nghị (xem https://huggingface.co/docs/huggingface_hub/quick-start#authentication). Để tắt xác thực, truyền `False`.

Gán một bộ sưu tập cho nhóm tài nguyên, hoặc gỡ bỏ nó khỏi mọi nhóm tài nguyên.

Chỉ có hiệu lực với các bộ sưu tập thuộc sở hữu của tổ chức.

Ví dụ:

```py
>>> from huggingface_hub import update_collection_resource_group
>>> update_collection_resource_group(
...     collection_slug="my-org/iccv-2023-64f9a55bb3115b4f513ec026",
...     resource_group_id="66980ecfc1e12a49c8f0e42d",
... )
```

#### update_inference_endpoint[[huggingface_hub.HfApi.update_inference_endpoint]]

```python
update_inference_endpoint(name: str, accelerator: str | None = None, instance_size: str | None = None, instance_type: str | None = None, min_replica: int | None = None, max_replica: int | None = None, scale_to_zero_timeout: int | None = None, scaling_metric: InferenceEndpointScalingMetric | None = None, scaling_threshold: float | None = None, repository: str | None = None, framework: str | None = None, revision: str | None = None, task: str | None = None, custom_image: dict | None = None, container_command: list[str] | None = None, container_args: list[str] | None = None, tensor_parallel_size: int | None = None, data_parallel_size: int | None = None, env: dict[str, str] | None = None, secrets: dict[str, str] | None = None, domain: str | None = None, path: str | None = None, cache_http_responses: bool | None = None, tags: list[str] | None = None, namespace: str | None = None, token: bool | str | None = None)
```

[Nguồn](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L9706)

**Tham số:**

name (`str`) : Tên của Inference Endpoint cần cập nhật.

accelerator (`str`, *tùy chọn*) : Bộ tăng tốc phần cứng sẽ được sử dụng cho suy luận (ví dụ: `"cpu"`).

instance_size (`str`, *tùy chọn*) : Kích thước hoặc kiểu của instance sẽ được sử dụng để lưu trữ mô hình (ví dụ: `"x4"`).

instance_type (`str`, *tùy chọn*) : Kiểu instance trên cloud mà Inference Endpoint sẽ được triển khai (ví dụ: `"intel-icl"`).

min_replica (`int`, *tuỳ chọn*) : Số lượng tối thiểu các bản sao (instance) cần giữ cho đang chạy đối với Inference Endpoint.

max_replica (`int`, *tuỳ chọn*) : Số lượng bản sao (thực thể) tối đa để mở rộng cho Inference Endpoint.

scale_to_zero_timeout (`int`, *tuỳ chọn*) : Thời lượng tính bằng phút trước khi một endpoint không hoạt động bị thu về mức không.

scaling_metric (`str` hoặc `InferenceEndpointScalingMetric `, *tuỳ chọn*) : Tham chiếu chỉ số để mở rộng. Là "pendingRequests" hoặc "hardwareUsage" khi được cung cấp. Mặc định là None.

scaling_threshold (`float`, *optional*) : Ngưỡng của chỉ số đo lường tỷ lệ dùng để kích hoạt việc tăng tỷ lệ. Bị bỏ qua khi không cung cấp chỉ số đo lường tỷ lệ. Mặc định là None.

repository (`str`, *tùy chọn*) : Tên của kho mô hình liên quan đến Inference Endpoint (ví dụ: `"gpt2"`).

framework (`str`, *tùy chọn*) : Khung học máy được sử dụng cho mô hình (ví dụ: `"custom"`).

revision (`str`, *tùy chọn*) : Phiên bản mô hình cụ thể để triển khai trên Inference Endpoint (ví dụ: `"6c0e6080953db56375760c0471a8c5f2929baf11"`).

task (`str`, *tùy chọn*) : Nhiệm vụ để triển khai mô hình (ví dụ: `"text-classification"`).

custom_image (`dict`, *tùy chọn*) : Ảnh container để chạy. Có thể là một dict có khóa theo biến thể ảnh (ví dụ `{"vLLM": {"url": "vllm/vllm-openai:v0.23.0", "port": 8000}}`, cũng như `sGLang`, `tgi`, `tei`, `llamacpp`, `hfServe`, ...), được chuyển tiếp nguyên vẹn, hoặc một dict phẳng mô tả một container tùy chỉnh (ví dụ `{"url": ..., "port": ...}`), được gửi dưới dạng `{"custom": ...}`.

container_command (`list[str]`, *tùy chọn*) : Ghi đè lệnh entrypoint của container (tương ứng với `model.command` trong API payload). Hoạt động với cả các hình ảnh engine được quản lý (ví dụ: vLLM, SGLang) và các hình ảnh tùy chỉnh.

container_args (`list[str]`, *tùy chọn*) : Các đối số được thêm vào entrypoint của container (tương ứng với `model.args` trong API payload). Hoạt động với cả các image engine được quản lý (ví dụ: vLLM, SGLang) và các image tùy chỉnh.

tensor_parallel_size (`int`, *optional*) : Số lượng bộ tăng tốc để chia nhỏ một bản sao mô hình duy nhất (ảnh vLLM và SGLang). Được ghi trong cấu hình ảnh engine. API yêu cầu `model.image` như một tổng thể, do đó khi `custom_image` không được cung cấp, ảnh hiện đang được cấu hình trên endpoint sẽ được lấy về và cập nhật tại chỗ.

data_parallel_size (`int`, *tuỳ chọn*) : Số lượng bản sao mô hình cần chạy, mỗi bộ tăng tốc một bản (ảnh vLLM). Cách xử lý giống như `tensor_parallel_size`.

env (`dict[str, str]`, *tùy chọn*) : Các biến môi trường không bí mật để tiêm vào môi trường của container

secrets (`dict[str, str]`, *tùy chọn*) : Các giá trị bí mật để tiêm vào môi trường của container.

domain (`str`, *tùy chọn*) : Miền tùy chỉnh cho triển khai Inference Endpoint, nếu được cấu hình, inference endpoint sẽ khả dụng tại miền này (ví dụ: `"my-new-domain.cool-website.woof"`).

path (`str`, *tùy chọn*) : Đường dẫn tùy chỉnh đến mô hình đã triển khai, phải bắt đầu bằng `/` (ví dụ: `"/models/google-bert/bert-base-uncased"`).

cache_http_responses (`bool`, *tùy chọn*) : Có nên lưu bộ nhớ đệm các phản hồi HTTP từ Inference Endpoint hay không.

tags (`list[str]`, *tùy chọn*) : Một danh sách các thẻ để liên kết với Inference Endpoint.

namespace (`str`, *tùy chọn*) : Không gian tên mà Inference Endpoint sẽ được cập nhật. Mặc định là không gian tên của người dùng hiện tại.

token (`bool` hoặc `str`, *tùy chọn*) : Một token truy cập người dùng hợp lệ (chuỗi). Mặc định là token được lưu cục bộ, đây là phương pháp xác thực được khuyến nghị (xem https://huggingface.co/docs/huggingface_hub/quick-start#authentication). Để tắt xác thực, truyền `False`.

**Trả về:** [InferenceEndpoint](/docs/huggingface_hub/v2.4.0/vi/package_reference/inference_endpoints#huggingface_hub.InferenceEndpoint)

thông tin về Inference Endpoint đã được cập nhật.

Cập nhật một Inference Endpoint.

Phương pháp này cho phép cập nhật cấu hình tính toán, mô hình đã triển khai, tuyến đường, hoặc bất kỳ sự kết hợp nào. Tất cả các đối số đều là tùy chọn nhưng ít nhất một đối số phải được cung cấp.

Để tiện lợi, bạn cũng có thể cập nhật một Inference Endpoint bằng cách sử dụng [InferenceEndpoint.update()](/docs/huggingface_hub/v2.4.0/vi/package_reference/inference_endpoints#huggingface_hub.InferenceEndpoint.update).

#### update_job_expose[[huggingface_hub.HfApi.update_job_expose]]

```python
update_job_expose(job_id: str, expose: list[int] | None = None, expose_public: list[int] | None = None, namespace: str | None = None, token: bool | str | None = None)
```

[Nguồn](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L12787)

**Tham số:**

job_id (`str`) : ID của Job đang chạy.

expose (`list[int]`, *tùy chọn*) : Các cổng cần phơi bày thông qua Jobs proxy. Việc truy cập yêu cầu một HF token có quyền đọc trong namespace của Job.

expose_public (`list[int]`, *optional*) : Các cổng cần phơi bày qua proxy của Jobs mà không cần xác thực. Chúng không cần được liệt kê trong `expose`.

namespace (`str`, *tùy chọn*) : Namespace của Job. Mặc định là namespace của người dùng hiện tại.

token (`bool` hoặc `str`, *tùy chọn*) : Token truy cập của người dùng. Mặc định là token được lưu cục bộ.

**Trả về:** [JobInfo](/docs/huggingface_hub/v2.4.0/vi/package_reference/jobs#huggingface_hub.JobInfo)

Công việc đã được cập nhật.

Thay đổi các cổng được phơi bày của một Job đang chạy mà không cần chạy lại nó.

`expose` và `expose_public` cùng nhau tạo thành cấu hình cổng hoàn chỉnh: các cổng không có trong danh sách nào sẽ bị đóng. Không truyền tham số nào để đóng tất cả các cổng đã mở.

#### update_job_labels[[huggingface_hub.HfApi.update_job_labels]]

```python
update_job_labels(job_id: str, labels: dict[str, str], namespace: str | None = None, token: bool | str | None = None)
```

[Nguồn](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L12828)

**Tham số:**

job_id (`str`) : ID của Job.

labels (`dict[str, str]`) : Nhãn mới để đặt cho tác vụ. Thay thế tất cả các nhãn hiện có. Cả khóa và giá trị đều phải tối đa 100 ký tự và chỉ chứa ký tự chữ số, dấu gạch ngang và dấu gạch dưới.

namespace (`str`, *tùy chọn*) : Không gian tên nơi Job đang chạy. Mặc định là không gian tên của người dùng hiện tại.

token (`bool` hoặc `str`, *tùy chọn*) : Một token truy cập người dùng hợp lệ. Nếu không được cung cấp, token được lưu cục bộ sẽ được sử dụng, đây là phương thức xác thực được khuyến nghị. Đặt thành `False` để tắt xác thực. Tham khảo: https://huggingface.co/docs/huggingface_hub/quick-start#authentication.

**Trả về:** [JobInfo](/docs/huggingface_hub/v2.4.0/vi/package_reference/jobs#huggingface_hub.JobInfo)

Thông tin Job đã được cập nhật.

Cập nhật nhãn của một Job hiện có.

Thay thế tất cả các nhãn do người dùng cung cấp hiện có bằng các nhãn mới.

#### update_repo_settings[[huggingface_hub.HfApi.update_repo_settings]]

```python
update_repo_settings(repo_id: str, gated: Literal['auto', 'manual', False] | None = None, private: bool | None = None, visibility: RepoVisibility_T | None = None, token: str | bool | None = None, repo_type: str | None = None)
```

[Nguồn](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L4838)

**Tham số:**

repo_id (`str`) : Một namespace (người dùng hoặc tổ chức) và tên kho, được phân tách bằng /.

gated (`Literal["auto", "manual", False]`, *tùy chọn*) : Trạng thái kiểm soát truy cập (gated) của kho lưu trữ. Nếu đặt thành `None` (mặc định), cài đặt `gated` của kho lưu trữ sẽ không được cập nhật. * "auto": Kho lưu trữ được kiểm soát truy cập, và các yêu cầu truy cập sẽ được tự động phê duyệt hoặc từ chối dựa trên các tiêu chí được định nghĩa trước. * "manual": Kho lưu trữ được kiểm soát truy cập, và các yêu cầu truy cập cần được phê duyệt thủ công. * False : Kho lưu trữ không được kiểm soát truy cập, và bất kỳ ai cũng có thể truy cập.

private (`bool`, *tùy chọn*) : Xác định xem kho có nên là riêng tư hay không. Không thể truyền cùng với `visibility`.

visibility (`Literal["public", "private", "protected"]`, *tùy chọn*) : Tính khả kiến của kho. Có thể là `"public"` hoặc `"private"`, hoặc `"protected"` đối với Spaces.

token (`Union[str, bool, None]`, *tùy chọn*) : Một token truy cập người dùng hợp lệ (chuỗi). Mặc định là token được lưu cục bộ, đây là phương pháp xác thực được khuyến nghị (xem https://huggingface.co/docs/huggingface_hub/quick-start#authentication). Để tắt xác thực, truyền False.

repo_type (`str`, *tùy chọn*) : Kiểu của kho cần cập nhật cài đặt (`"model"`, `"dataset"` hoặc `"space"`). Mặc định là `"model"`.

**Gây ra:** ``ValueError`` hoặc [HfHubHTTPError](/docs/huggingface_hub/v2.4.0/vi/package_reference/utilities#huggingface_hub.errors.HfHubHTTPError) hoặc [RepositoryNotFoundError](/docs/huggingface_hub/v2.4.0/vi/package_reference/utilities#huggingface_hub.errors.RepositoryNotFoundError)

- [`ValueError`](https://docs.python.org/3/library/exceptions.html#ValueError) -- Nếu gated không phải là "auto", "manual" hoặc False.
- [`ValueError`](https://docs.python.org/3/library/exceptions.html#ValueError) -- Nếu repo_type không phải là một trong các giá trị trong constants.REPO_TYPES.
- [HfHubHTTPError](/docs/huggingface_hub/v2.4.0/vi/package_reference/utilities#huggingface_hub.errors.HfHubHTTPError) -- Nếu yêu cầu đến API của Hugging Face Hub thất bại.
- [RepositoryNotFoundError](/docs/huggingface_hub/v2.4.0/vi/package_reference/utilities#huggingface_hub.errors.RepositoryNotFoundError) -- Nếu không tìm thấy kho cần tải xuống. Điều này có thể do kho không tồn tại, hoặc do kho được đặt ở chế độ `private` và bạn không có quyền truy cập.

Cập nhật cài đặt của một kho lưu trữ, bao gồm quyền truy cập có kiểm soát và mức độ hiển thị.

Để cung cấp nhiều quyền kiểm soát hơn về cách các kho được sử dụng, Hub cho phép tác giả kho bật yêu cầu truy cập cho kho của họ, đồng thời thay đổi mức độ hiển thị của kho.

#### update_scheduled_job_labels[[huggingface_hub.HfApi.update_scheduled_job_labels]]

```python
update_scheduled_job_labels(scheduled_job_id: str, labels: dict[str, str], namespace: str | None = None, token: bool | str | None = None)
```

[Nguồn](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L13508)

**Tham số:**

scheduled_job_id (`str`) : ID của Job đã được lên lịch.

labels (`dict[str, str]`) : Nhãn mới để đặt cho công việc đã lên lịch. Thay thế tất cả các nhãn hiện có. Cả khóa và giá trị đều phải tối đa 100 ký tự và chỉ chứa ký tự chữ số, dấu gạch ngang và dấu gạch dưới.

namespace (`str`, *tùy chọn*) : Không gian tên (namespace) chứa Job được lên lịch. Mặc định là không gian tên của người dùng hiện tại.

token (`bool` hoặc `str`, *tùy chọn*) : Một token truy cập người dùng hợp lệ. Nếu không được cung cấp, token được lưu cục bộ sẽ được sử dụng, đây là phương thức xác thực được khuyến nghị. Đặt thành `False` để tắt xác thực. Tham khảo: https://huggingface.co/docs/huggingface_hub/quick-start#authentication.

**Trả về:** `ScheduledJobInfo`

Thông tin về Job được lên lịch đã cập nhật.

Cập nhật nhãn của một Job được lên lịch hiện có.

Thay thế tất cả các nhãn do người dùng cung cấp hiện có bằng các nhãn mới.

#### update_scheduled_job_schedule[[huggingface_hub.HfApi.update_scheduled_job_schedule]]

```python
update_scheduled_job_schedule(scheduled_job_id: str, schedule: str, namespace: str | None = None, token: bool | str | None = None)
```

[Nguồn](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L13414)

**Tham số:**

scheduled_job_id (`str`) : ID của Job đã được lên lịch.

schedule (`str`) : Một trong các giá trị "@annually", "@yearly", "@monthly", "@weekly", "@daily", "@hourly", hoặc một biểu thức lịch CRON (ví dụ: '0 9 * * 1' cho 9 giờ sáng mỗi thứ Hai).

namespace (`str`, *tùy chọn*) : Không gian tên (namespace) chứa Job được lên lịch. Mặc định là không gian tên của người dùng hiện tại.

token (`bool` hoặc `str`, *tùy chọn*) : Một token truy cập người dùng hợp lệ. Nếu không được cung cấp, token được lưu cục bộ sẽ được sử dụng, đây là phương thức xác thực được khuyến nghị. Đặt thành `False` để tắt xác thực. Tham khảo: https://huggingface.co/docs/huggingface_hub/quick-start#authentication.

**Trả về:** `ScheduledJobInfo`

Thông tin về Job được lên lịch đã cập nhật.

Thay đổi thời điểm chạy của một Job đã lên lịch có sẵn.

Chỉ lịch được cập nhật: spec của Job, các nhãn và trạng thái suspended được giữ nguyên. Để chạy Job được lên lịch một lần ngay bây giờ mà không thay đổi lịch của nó, hãy dùng [trigger_scheduled_job()](/docs/huggingface_hub/v2.4.0/vi/package_reference/hf_api#huggingface_hub.HfApi.trigger_scheduled_job) thay vào đó.

Ví dụ:

```python
>>> from huggingface_hub import update_scheduled_job_schedule
>>> scheduled_job = update_scheduled_job_schedule(scheduled_job_id="6abb8dc9c617607c354d45f4", schedule="@daily")
>>> scheduled_job.schedule
'@daily'
```

#### update_webhook[[huggingface_hub.HfApi.update_webhook]]

```python
update_webhook(webhook_id: str, url: str | None = None, job_id: str | None = None, watched: list[dict | WebhookWatchedItem] | None = None, domains: list[constants.WEBHOOK_DOMAIN_T] | None = None, secret: str | None = None, secrets: dict[str, str] | None = None, token: bool | str | None = None)
```

[Nguồn](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L11319)

**Tham số:**

webhook_id (`str`) : Định danh duy nhất của webhook cần được cập nhật.

url (`str`, tùy chọn) : URL mà payload sẽ được gửi đến.

job_id (`str`, tùy chọn) : ID của Job nguồn để kích hoạt bằng webhook payload. Bắt buộc khi thiết lập `secrets`.

watched (`list[WebhookWatchedItem]`, optional) : Danh sách các mục cần theo dõi. Các mục này có thể là người dùng, tổ chức, mô hình, bộ dữ liệu hoặc không gian. Xem [WebhookWatchedItem](/docs/huggingface_hub/v2.4.0/vi/package_reference/hf_api#huggingface_hub.WebhookWatchedItem) để biết thêm chi tiết. Các mục được theo dõi cũng có thể được cung cấp dưới dạng từ điển thông thường.

domains (`list[Literal["repo", "discussion"]]`, optional) : Các miền cần theo dõi. Có thể bao gồm "repo", "discussion", hoặc cả hai.

secret (`str`, tùy chọn) : Một bí mật để ký cho payload, cung cấp một lớp bảo mật bổ sung.

secrets (`dict[str, str]`, optional) : Các biến môi trường bí mật cho Job được kích hoạt bởi webhook. Các khóa được liệt kê sẽ thay thế giá trị đã lưu, chuỗi rỗng sẽ xóa bí mật đó, và các khóa bị bỏ qua sẽ giữ nguyên giá trị đã lưu. Yêu cầu `job_id`.

token (`bool` hoặc `str`, *tùy chọn*) : Một token truy cập người dùng hợp lệ (chuỗi). Mặc định là token được lưu cục bộ, đây là phương pháp xác thực được khuyến nghị (xem https://huggingface.co/docs/huggingface_hub/quick-start#authentication). Để tắt xác thực, truyền `False`.

**Trả về:** [WebhookInfo](/docs/huggingface_hub/v2.4.0/vi/package_reference/hf_api#huggingface_hub.WebhookInfo)

Thông tin về webhook đã được cập nhật.

Cập nhật webhook hiện có.

Ví dụ:
```python
>>> from huggingface_hub import update_webhook
>>> updated_payload = update_webhook(
...     webhook_id="654bbbc16f2ec14d77f109cc",
...     url="https://new.webhook.site/a2176e82-5720-43ee-9e06-f91cb4c91548",
...     watched=[{"type": "user", "name": "julien-c"}, {"type": "org", "name": "HuggingFaceH4"}],
...     domains=["repo"],
...     secret="my-secret",
... )
>>> print(updated_payload)
WebhookInfo(
    id="654bbbc16f2ec14d77f109cc",
    job=None,
    url="https://new.webhook.site/a2176e82-5720-43ee-9e06-f91cb4c91548",
    watched=[WebhookWatchedItem(type="user", name="julien-c"), WebhookWatchedItem(type="org", name="HuggingFaceH4")],
    domains=["repo"],
    secret="my-secret",
    disabled=False,
```

#### upload_attachment[[huggingface_hub.HfApi.upload_attachment]]

```python
upload_attachment(path: str | Path, token: bool | str | None = None)
```

[Nguồn](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L8000)

**Tham số:**

path (`str` hoặc `Path`) : Đường dẫn đến tệp cần tải lên. Các định dạng được hỗ trợ là PNG, JPEG, GIF, WebP, MP4, MOV, WebM, MP3 và WAV. Tệp phải nhỏ hơn 10MB (50MB đối với video).

token (`bool` hoặc `str`, *tùy chọn*) : Một token truy cập người dùng hợp lệ (chuỗi). Mặc định là token được lưu cục bộ, đây là phương pháp xác thực được khuyến nghị (xem https://huggingface.co/docs/huggingface_hub/quick-start#authentication). Token cần có quyền `discussion.write`. Để tải lên ẩn danh, hãy truyền `False`.

**Trả về:** `str`

đường dẫn URL của tệp đã tải lên.

**Lỗi:** ``ValueError``

- [`ValueError`](https://docs.python.org/3/library/exceptions.html#ValueError) -- Nếu định dạng tệp không được hỗ trợ.

Tải lên Hub một tệp hình ảnh, video hoặc âm thanh và trả về URL của nó.

Đây là những gì trình soạn thảo web của Hub thực hiện khi bạn kéo một tệp vào hộp bình luận của Discussion hoặc Pull Request. Nhúng URL được trả về vào mô tả hoặc bình luận: `![alt text](url)` cho hình ảnh, URL trần cho video và `<audio controls src="url"></audio>` cho tệp âm thanh.

Ví dụ:
```python
>>> from huggingface_hub import HfApi
>>> api = HfApi()
>>> url = api.upload_attachment("screenshot.png")
>>> api.create_discussion("username/my-model", title="Rendering bug", description=f"![screenshot]({url})")
```

#### upload_file[[huggingface_hub.HfApi.upload_file]]

```python
upload_file(path_or_fileobj: str | Path | bytes | BinaryIO, path_in_repo: str, repo_id: str, token: str | bool | None = None, repo_type: str | None = None, revision: str | None = None, commit_message: str | None = None, commit_description: str | None = None, create_pr: bool | None = None, parent_commit: str | None = None, run_as_future: bool = False, _hot_reload: bool | None = None)
```

[Nguồn](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L5621)

**Tham số:**

path_or_fileobj (`str`, `Path`, `bytes`, hoặc `IO`) : Đường dẫn đến tệp trên máy cục bộ hoặc luồng dữ liệu nhị phân / fileobj / buffer.

path_in_repo (`str`) : Đường dẫn tệp tương đối trong kho, ví dụ: `"checkpoints/1fec34a/weights.bin"`

repo_id (`str`) : Kho lưu trữ mà tệp sẽ được tải lên, ví dụ: `"username/custom_transformers"`

token (`bool` hoặc `str`, *tùy chọn*) : Một token truy cập người dùng hợp lệ (chuỗi). Mặc định là token được lưu cục bộ, đây là phương pháp xác thực được khuyến nghị (xem https://huggingface.co/docs/huggingface_hub/quick-start#authentication). Để tắt xác thực, truyền `False`.

repo_type (`str`, *tùy chọn*) : Đặt thành `"dataset"`, `"space"` hoặc `"kernel"` nếu tải lên kho dataset, space hoặc kernel, `None` hoặc `"model"` nếu tải lên model. Mặc định là `None`.

revision (`str`, *tùy chọn*) : Bản sửa git để commit từ. Mặc định là đầu của nhánh `"main"`.

commit_message (`str`, *tùy chọn*) : Tóm tắt / tiêu đề / dòng đầu tiên của commit được tạo

commit_description (`str`, *tùy chọn*) : Mô tả của commit được tạo

create_pr (`boolean`, *tùy chọn*) : Có tạo Pull Request với commit đó hay không. Mặc định là `False`. Nếu `revision` không được đặt, PR sẽ được mở đối với nhánh `"main"`. Nếu `revision` được đặt và là một nhánh, PR sẽ được mở đối với nhánh này. Nếu `revision` được đặt và không phải là tên nhánh (ví dụ: một commit oid), một `RevisionNotFoundError` sẽ được trả về bởi máy chủ.

parent_commit (`str`, *tùy chọn*) : OID / SHA của commit cha, dưới dạng chuỗi hex. Các dạng viết tắt (7 ký tự đầu tiên) cũng được hỗ trợ. Nếu được chỉ định và `create_pr` là `False`, commit sẽ thất bại nếu `revision` không trỏ đến `parent_commit`. Nếu được chỉ định và `create_pr` là `True`, pull request sẽ được tạo từ `parent_commit`. Việc chỉ định `parent_commit` đảm bảo rằng repo không bị thay đổi trước khi commit các thay đổi, và đặc biệt hữu ích nếu repo được cập nhật / commit đồng thời.

run_as_future (`bool`, *tuỳ chọn*) : Có chạy phương thức này ở nền hay không. Các tác vụ nền được chạy tuần tự mà không chặn luồng chính. Truyền `run_as_future=True` sẽ trả về một đối tượng [Future](https://docs.python.org/3/library/concurrent.futures.html#future-objects). Mặc định là `False`.

**Trả về:** [CommitInfo](/docs/huggingface_hub/v2.4.0/vi/package_reference/hf_api#huggingface_hub.CommitInfo) hoặc `Future`

Thư mục [CommitInfo](/docs/huggingface_hub/v2.4.0/vi/package_reference/hf_api#huggingface_hub.CommitInfo) chứa thông tin về commit mới được tạo (commit hash, commit url, pr url, commit message,...). Nếu `run_as_future=True` được truyền vào, sẽ trả về một đối tượng Future sẽ chứa kết quả khi được thực thi.

Tải lên một tệp cục bộ (tối đa 50 GB) vào kho đã cho. Việc tải lên được thực hiện thông qua yêu cầu HTTP post và không yêu cầu cài đặt git hoặc git-lfs.

> [!TIP]
> Gây ra các lỗi sau:
>
> - [`HTTPError`](https://requests.readthedocs.io/en/latest/api/#requests.HTTPError) nếu API HuggingFace trả về lỗi - [`ValueError`](https://docs.python.org/3/library/exceptions.html#ValueError) nếu giá trị của một số tham số không hợp lệ - [RepositoryNotFoundError](/docs/huggingface_hub/v2.4.0/vi/package_reference/utilities#huggingface_hub.errors.RepositoryNotFoundError) Nếu không tìm thấy kho cần tải xuống. Điều này có thể do kho không tồn tại, hoặc do kho được đặt ở chế độ `private` và bạn không có quyền truy cập. - [RevisionNotFoundError](/docs/huggingface_hub/v2.4.0/vi/package_reference/utilities#huggingface_hub.errors.RevisionNotFoundError) Nếu không tìm thấy phiên bản cần tải xuống.

> [!WARNING]
> `upload_file` giả định rằng repo đã tồn tại trên Hub. Nếu bạn gặp lỗi Client 404, hãy đảm bảo rằng bạn đã xác thực, token của bạn có các quyền cần thiết, và `repo_id` cùng `repo_type` được đặt đúng. Nếu repo chưa tồn tại, hãy tạo nó trước bằng [create_repo()](/docs/huggingface_hub/v2.4.0/vi/package_reference/hf_api#huggingface_hub.HfApi.create_repo).

Ví dụ:

```python
>>> from huggingface_hub import upload_file

>>> with open("./local/filepath", "rb") as fobj:
...     upload_file(
...         path_or_fileobj=fileobj,
...         path_in_repo="remote/file/path.h5",
...         repo_id="username/my-dataset",
...         repo_type="dataset",
...         token="my_token",
...     )

>>> upload_file(
...     path_or_fileobj=".\\local\\file\\path",
...     path_in_repo="remote/file/path.h5",
...     repo_id="username/my-model",
...     token="my_token",
... )

>>> upload_file(
...     path_or_fileobj=".\\local\\file\\path",
...     path_in_repo="remote/file/path.h5",
...     repo_id="username/my-model",
...     token="my_token",
...     create_pr=True,
... )
```

#### upload_folder[[huggingface_hub.HfApi.upload_folder]]

```python
upload_folder(repo_id: str, folder_path: str | Path, path_in_repo: str | None = None, commit_message: str | None = None, commit_description: str | None = None, token: str | bool | None = None, repo_type: str | None = None, revision: str | None = None, create_pr: bool | None = None, parent_commit: str | None = None, allow_patterns: list[str] | str | None = None, ignore_patterns: list[str] | str | None = None, delete_patterns: list[str] | str | None = None, run_as_future: bool = False)
```

[Nguồn](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L5808)

**Tham số:**

repo_id (`str`) : Kho lưu trữ mà tệp sẽ được tải lên, ví dụ: `"username/custom_transformers"`

folder_path (`str` hoặc `Path`) : Đường dẫn đến thư mục cần tải lên trên hệ thống tệp cục bộ

path_in_repo (`str`, *tùy chọn*) : Đường dẫn tương đối của thư mục trong kho, ví dụ: `"checkpoints/1fec34a/results"`. Mặc định sẽ là thư mục gốc của kho.

token (`bool` hoặc `str`, *tùy chọn*) : Một token truy cập người dùng hợp lệ (chuỗi). Mặc định là token được lưu cục bộ, đây là phương pháp xác thực được khuyến nghị (xem https://huggingface.co/docs/huggingface_hub/quick-start#authentication). Để tắt xác thực, truyền `False`.

repo_type (`str`, *tùy chọn*) : Đặt thành `"dataset"`, `"space"` hoặc `"kernel"` nếu tải lên kho dataset, space hoặc kernel, `None` hoặc `"model"` nếu tải lên model. Mặc định là `None`.

revision (`str`, *tùy chọn*) : Bản sửa git để commit từ. Mặc định là đầu của nhánh `"main"`.

commit_message (`str`, *tùy chọn*) : Tóm tắt / tiêu đề / dòng đầu tiên của commit được tạo. Mặc định là: `f"Upload {path_in_repo} with huggingface_hub"`

commit_description (`str` *tùy chọn*) : Mô tả của commit được tạo

create_pr (`boolean`, *tùy chọn*) : Có tạo Pull Request với commit đó hay không. Mặc định là `False`. PR luôn được mở đối với nhánh mặc định: việc đặt cả `create_pr=True` và `revision` sẽ gây ra `ValueError`. Lưu ý rằng mỗi lần gọi với `create_pr=True` sẽ mở một pull request mới: để tiếp tục một lần tải lên bị gián đoạn vào PR hiện có, hãy chạy lại với `revision="refs/pr/N"` thay vì vậy.

parent_commit (`str`, *tùy chọn*) : OID / SHA của commit cha, dưới dạng chuỗi hex. Các dạng viết tắt (7 ký tự đầu tiên) cũng được hỗ trợ. Nếu được chỉ định và `create_pr` là `False`, commit sẽ thất bại nếu `revision` không trỏ đến `parent_commit`. Việc chỉ định `parent_commit` đảm bảo rằng repo không bị thay đổi trước khi commit các thay đổi, và đặc biệt hữu ích nếu repo được cập nhật / commit đồng thời. Nếu quá trình tải lên được chia thành nhiều commit (các thư mục lớn), `parent_commit` chỉ áp dụng cho commit đầu tiên.

allow_patterns (`list[str]` hoặc `str`, *tùy chọn*) : Nếu được cung cấp, chỉ các tệp khớp với ít nhất một mẫu sẽ được tải lên.

ignore_patterns (`list[str]` hoặc `str`, *tùy chọn*) : Nếu được cung cấp, các tệp khớp với bất kỳ mẫu nào sẽ không được tải lên.

delete_patterns (`list[str]` hoặc `str`, *tùy chọn*) : Nếu được cung cấp, các tệp từ xa khớp với bất kỳ mẫu nào sẽ bị xóa khỏi kho khi cam kết các tệp mới. Điều này hữu ích nếu bạn không biết tệp nào đã được tải lên. Lưu ý: để tránh sai lệch, tệp `.gitattributes` sẽ không bị xóa ngay cả khi nó khớp với mẫu.

run_as_future (`bool`, *tuỳ chọn*) : Có chạy phương thức này ở nền hay không. Các tác vụ nền được chạy tuần tự mà không chặn luồng chính. Truyền `run_as_future=True` sẽ trả về một đối tượng [Future](https://docs.python.org/3/library/concurrent.futures.html#future-objects). Mặc định là `False`.

**Trả về:** [CommitInfo](/docs/huggingface_hub/v2.4.0/vi/package_reference/hf_api#huggingface_hub.CommitInfo) hoặc `Future`

Thư mục [CommitInfo](/docs/huggingface_hub/v2.4.0/vi/package_reference/hf_api#huggingface_hub.CommitInfo) chứa thông tin về commit mới được tạo (commit hash, commit url, pr url, commit message,...). Nếu `run_as_future=True` được truyền vào, sẽ trả về một đối tượng Future sẽ chứa kết quả khi được thực thi.

Tải lên một thư mục cục bộ lên kho đã cho. Việc tải lên được thực hiện thông qua các yêu cầu HTTP và không yêu cầu cài đặt git hoặc git-lfs.

Cấu trúc của thư mục sẽ được giữ nguyên. Các tệp có cùng tên đã có trong kho sẽ bị ghi đè. Các tệp khác sẽ không bị thay đổi.

Sử dụng các đối số `allow_patterns` và `ignore_patterns` để chỉ định các tệp cần tải lên. Các tham số này chấp nhận một mẫu duy nhất hoặc một danh sách các mẫu. Các mẫu là Standard Wildcards (mẫu globbing) như được tài liệu hóa [tại đây](https://tldp.org/LDP/GNU-Linux-Tools-Summary/html/x11655.htm). Nếu cả `allow_patterns` và `ignore_patterns` đều được cung cấp, cả hai ràng buộc đều được áp dụng. Mặc định, tất cả các tệp từ thư mục sẽ được tải lên.

Sử dụng đối số `delete_patterns` để chỉ định các tệp từ xa mà bạn muốn xóa. Kiểu đầu vào giống như của `allow_patterns` (xem bên trên). Nếu `path_in_repo` cũng được cung cấp, các mẫu sẽ được khớp với các đường dẫn tương đối so với thư mục này. Ví dụ, `upload_folder(..., path_in_repo="experiment", delete_patterns="logs/*")` sẽ xóa bất kỳ tệp từ xa nào dưới `./experiment/logs/`. Lưu ý rằng tệp `.gitattributes` sẽ không bị xóa ngay cả khi nó khớp với các mẫu.

Bất kỳ thư mục `.git/` nào có mặt trong bất kỳ thư mục con nào sẽ bị bỏ qua. Tuy nhiên, vui lòng lưu ý rằng tệp `.gitignore` không được tính đến.

Khi `hf_xet` được cài đặt (mặc định), các tệp được tải lên thông qua một pipeline dạng stream: quá trình tải lên bắt đầu trong khi thư mục vẫn đang được kiểm tra đối chiếu với Hub, các tệp được băm trong khi đang được chia nhỏ để tải lên (chỉ đọc một lần), và các thư mục lớn được tự động cam kết thành nhiều lô để không vượt quá giới hạn của máy chủ (các cam kết tiếp theo sẽ có hậu tố ` (part N)` trong thông điệp cam kết). Nếu quá trình tải lên bị gián đoạn, chạy lại cùng một lệnh sẽ tiếp tục quá trình đó: các tệp đã cam kết sẽ bị bỏ qua và dữ liệu đã tải lên sẽ được khử trùng lặp. Khi `hf_xet` không được cài đặt, hệ thống sẽ chuyển sang tạo một cam kết duy nhất bằng [create_commit()](/docs/huggingface_hub/v2.4.0/vi/package_reference/hf_api#huggingface_hub.HfApi.create_commit).

> [!TIP]
> Gây ra các lỗi sau:
>
> - [`HTTPError`](https://requests.readthedocs.io/en/latest/api/#requests.HTTPError) nếu API HuggingFace trả về lỗi - [`ValueError`](https://docs.python.org/3/library/exceptions.html#ValueError) nếu giá trị của một số tham số không hợp lệ

> [!WARNING]
> `upload_folder` giả định rằng repo đã tồn tại trên Hub. Nếu bạn gặp lỗi Client 404, hãy đảm bảo rằng bạn đã xác thực, token của bạn có các quyền cần thiết, và `repo_id` cùng `repo_type` được đặt đúng. Nếu repo chưa tồn tại, hãy tạo nó trước bằng [create_repo()](/docs/huggingface_hub/v2.4.0/vi/package_reference/hf_api#huggingface_hub.HfApi.create_repo).

Ví dụ:

```python
# Upload checkpoints folder except the log files
>>> upload_folder(
...     folder_path="local/checkpoints",
...     path_in_repo="remote/experiment/checkpoints",
...     repo_id="username/my-dataset",
...     repo_type="datasets",
...     token="my_token",
...     ignore_patterns="**/logs/*.txt",
... )

# Upload checkpoints folder including logs while deleting existing logs from the repo
# Useful if you don't know exactly which log files have already being pushed
>>> upload_folder(
...     folder_path="local/checkpoints",
...     path_in_repo="remote/experiment/checkpoints",
...     repo_id="username/my-dataset",
...     repo_type="datasets",
...     token="my_token",
...     delete_patterns="**/logs/*.txt",
... )

# Upload checkpoints folder while creating a PR
>>> upload_folder(
...     folder_path="local/checkpoints",
...     path_in_repo="remote/experiment/checkpoints",
...     repo_id="username/my-dataset",
...     repo_type="datasets",
...     token="my_token",
...     create_pr=True,
... )
```

#### verify_repo_checksums[[huggingface_hub.HfApi.verify_repo_checksums]]

```python
verify_repo_checksums(repo_id: str, repo_type: str | None = None, revision: str | None = None, local_dir: str | Path | None = None, cache_dir: str | Path | None = None, token: str | bool | None = None)
```

[Nguồn](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L4035)

**Tham số:**

repo_id (`str`) : Một namespace (người dùng hoặc tổ chức) và tên kho, được phân tách bằng `/`.

repo_type (`str`, *tùy chọn*) : Kiểu của kho chứa mà từ đó lấy cây (`"model"`, `"dataset"` hoặc `"space"`. Mặc định là `"model"`.

revision (`str`, *tùy chọn*) : Phiên bản của kho chứa để lấy cây. Mặc định là nhánh `"main"`.

local_dir (`str` hoặc `Path`, *tùy chọn*) : Thư mục cục bộ cần xác minh.

cache_dir (`str` hoặc `Path`, *tùy chọn*) : Thư mục cache cần kiểm tra.

token (Union[bool, str, None], optional) : Một token truy cập người dùng hợp lệ (chuỗi). Mặc định là token được lưu cục bộ, đây là phương pháp xác thực được khuyến nghị (xem https://huggingface.co/docs/huggingface_hub/quick-start#authentication). Để tắt xác thực, truyền `False`.

**Trả về:** `FolderVerification`

kết quả có cấu trúc chứa các chi tiết xác minh.

**Gây ra:** [RepositoryNotFoundError](/docs/huggingface_hub/v2.4.0/vi/package_reference/utilities#huggingface_hub.errors.RepositoryNotFoundError) hoặc [RevisionNotFoundError](/docs/huggingface_hub/v2.4.0/vi/package_reference/utilities#huggingface_hub.errors.RevisionNotFoundError)

- [RepositoryNotFoundError](/docs/huggingface_hub/v2.4.0/vi/package_reference/utilities#huggingface_hub.errors.RepositoryNotFoundError) -- Nếu không tìm thấy kho (lỗi 404): repo_id/repo_type không đúng, kho là riêng tư nhưng chưa xác thực hoặc kho không tồn tại.
- [RevisionNotFoundError](/docs/huggingface_hub/v2.4.0/vi/package_reference/utilities#huggingface_hub.errors.RevisionNotFoundError) -- Nếu không tìm thấy revision (lỗi 404) trên kho.

Xác minh các tệp cục bộ của một kho với các mã kiểm tra trên Hub.

#### wait_for_job[[huggingface_hub.HfApi.wait_for_job]]

```python
wait_for_job(job_id: str | list[str], timeout: float | None = None, poll_interval: float = 1.0, stages: list[JobStage] | None = None, namespace: str | None = None, token: bool | str | None = None)
```

[Nguồn](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L12638)

**Tham số:**

job_id (`str` hoặc `list[str]`) : ID của Job, hoặc danh sách các ID Job cần chờ. Nếu truyền vào một danh sách, một danh sách [JobInfo](/docs/huggingface_hub/v2.4.0/vi/package_reference/jobs#huggingface_hub.JobInfo) sẽ được trả về (theo cùng thứ tự).

timeout (`float`, *optional*) : Thời gian tối đa để chờ Job hoàn thành, tính bằng giây. Nếu là `None`, sẽ chờ vô thời hạn.

poll_interval (`float`, *optional*) : Thời gian chờ giữa mỗi lần kiểm tra trạng thái, tính bằng giây. Mặc định là 1s.

stages (`list[JobStage]`, *tùy chọn*) : Các giai đoạn cần chờ. Mặc định là các giai đoạn cuối (`"COMPLETED"`, `"CANCELED"`, `"ERROR"`, `"DELETED"`). Truyền ví dụ `[JobStage.RUNNING]` để chờ Job bắt đầu chạy. Các giai đoạn cuối luôn dừng việc chờ bất kể giá trị này.

namespace (`str`, *tùy chọn*) : Không gian tên nơi Job đang chạy. Mặc định là không gian tên của người dùng hiện tại.

token (`bool` hoặc `str`, *tùy chọn*) : Một token truy cập người dùng hợp lệ. Nếu không được cung cấp, token được lưu cục bộ sẽ được sử dụng, đây là phương thức xác thực được khuyến nghị. Đặt thành `False` để tắt xác thực. Tham khảo: https://huggingface.co/docs/huggingface_hub/quick-start#authentication.

**Trả về:** [JobInfo](/docs/huggingface_hub/v2.4.0/vi/package_reference/jobs#huggingface_hub.JobInfo) hoặc `list[JobInfo]`

thông tin Job cuối cùng.

**Lỗi:** ``TimeoutError``

- ``TimeoutError`` -- Nếu ít nhất một Job không đạt được một trong các giai đoạn đích sau `timeout` giây.

Chờ cho đến khi một hoặc nhiều Job tính toán trên hạ tầng Hugging Face đạt đến một giai đoạn nhất định.

Trạng thái của mỗi Job được kiểm tra (bằng [inspect_job()](/docs/huggingface_hub/v2.4.0/vi/package_reference/hf_api#huggingface_hub.HfApi.inspect_job)) mỗi `poll_interval` giây cho đến khi giai đoạn của nó nằm trong `stages` (mặc định là các giai đoạn kết thúc: `"COMPLETED"`, `"CANCELED"`, `"ERROR"` hoặc `"DELETED"`). Đối tượng [JobInfo](/docs/huggingface_hub/v2.4.0/vi/package_reference/jobs#huggingface_hub.JobInfo) cuối cùng sẽ được trả về trong mọi trường hợp: một Job thất bại hoặc bị hủy sẽ **không** gây ra ngoại lệ — hãy kiểm tra `job.status.stage` để xử lý kết quả.

Các giai đoạn cuối luôn dừng việc chờ, ngay cả khi không được liệt kê trong `stages`. Điều này tránh việc chờ vô hạn cho một giai đoạn mà Job sẽ không bao giờ đạt tới (ví dụ: chờ `"RUNNING"` trên một Job bị lỗi trong quá trình lập lịch).

Ví dụ:

```python
>>> from huggingface_hub import run_job, wait_for_job
>>> job = run_job(image="python:3.12", command=["python", "-c", "print('Hello from HF compute!')"])
>>> wait_for_job(job_id=job.id).status.stage
'COMPLETED'
```

#### wait_for_space[[huggingface_hub.HfApi.wait_for_space]]

```python
wait_for_space(repo_id: str, timeout: float | None = None, poll_interval: float = 1.0, token: bool | str | None = None)
```

[Nguồn](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L8803)

**Tham số:**

repo_id (`str`) : ID của Space cần chờ. Ví dụ: `"username/my-space"`.

timeout (`float`, *optional*) : Thời gian tối đa để chờ, tính bằng giây. Nếu là `None`, sẽ chờ vô thời hạn.

poll_interval (`float`, *tuỳ chọn*) : Số giây giữa các lần kiểm tra trạng thái. Mặc định là 1 giây.

token (`bool` hoặc `str`, *tùy chọn*) : Một token truy cập người dùng hợp lệ. Mặc định là token được lưu cục bộ, đây là phương thức xác thực được khuyến nghị. Đặt thành `False` để tắt xác thực. Xem https://huggingface.co/docs/huggingface_hub/quick-start#authentication.

**Trả về:** [SpaceRuntime](/docs/huggingface_hub/v2.4.0/vi/package_reference/space_runtime#huggingface_hub.SpaceRuntime)

Thông tin thời gian chạy cuối cùng khi Space đạt đến giai đoạn cuối.

**Lỗi:** ``TimeoutError``

- ``TimeoutError`` -- Nếu Space chưa đạt đến giai đoạn kết thúc sau `timeout` giây.

Chờ cho đến khi một Space đạt đến giai đoạn cuối (không phải đang xây dựng/khởi động).

Các cuộc thăm dò [get_space_runtime()](/docs/huggingface_hub/v2.4.0/vi/package_reference/hf_api#huggingface_hub.HfApi.get_space_runtime) mỗi `poll_interval` giây cho đến khi giai đoạn của Space không còn ở trạng thái trung gian (`BUILDING`, `RUNNING_BUILDING`, `APP_STARTING`, `RUNNING_APP_STARTING`). Trả về [SpaceRuntime](/docs/huggingface_hub/v2.4.0/vi/package_reference/space_runtime#huggingface_hub.SpaceRuntime) cuối cùng trong mọi trường hợp — kiểm tra `runtime.stage` để xử lý kết quả (ví dụ: `RUNNING` so với `BUILD_ERROR`).

Ví dụ:

```python
>>> from huggingface_hub import restart_space, wait_for_space
>>> restart_space("username/my-space")
>>> runtime = wait_for_space("username/my-space")
>>> runtime.stage
'RUNNING'
```

#### whoami[[huggingface_hub.HfApi.whoami]]

```python
whoami(token: bool | str | None = None, cache: bool = False)
```

[Nguồn](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L2218)

**Tham số:**

token (`bool` hoặc `str`, *tùy chọn*) : Một token truy cập người dùng hợp lệ (chuỗi). Mặc định là token được lưu cục bộ, đây là phương pháp xác thực được khuyến nghị (xem https://huggingface.co/docs/huggingface_hub/quick-start#authentication). Để tắt xác thực, truyền `False`.

cache (`bool`, *tuỳ chọn*) : Có nên lưu kết quả của lệnh gọi `whoami` cho các lần gọi tiếp theo hay không. Nếu xảy ra lỗi trong lần gọi đầu tiên, kết quả sẽ không được lưu. Mặc định là `False`.

Gọi HF API để biết "whoami".

Nếu truyền `cache=True`, kết quả sẽ được lưu vào bộ nhớ đệm cho các lần gọi tiếp theo trong suốt thời gian tiến trình Python đang chạy. Điều này hữu ích nếu bạn dự định gọi `whoami` nhiều lần vì endpoint này bị giới hạn tần suất gọi (rate-limited) nghiêm ngặt vì lý do bảo mật.

## API Dataclasses

### AccessRequest[[huggingface_hub.hf_api.AccessRequest]]

#### huggingface_hub.hf_api.AccessRequest[[huggingface_hub.hf_api.AccessRequest]]

```python
huggingface_hub.hf_api.AccessRequest(username: str | None, request_id: str, fullname: str | None, email: str | None, timestamp: datetime, status: Literal['pending', 'accepted', 'rejected'], fields: dict[str, Any] | None = None)
```

[Nguồn](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L445)

**Tham số:**

username (`str`, *tùy chọn*) : Tên người dùng của người đã yêu cầu quyền truy cập. `None` nếu kho được cấu hình để không chia sẻ tên người dùng của người yêu cầu. Trong trường hợp đó, hãy sử dụng `request_id` để chấp nhận, từ chối hoặc hủy yêu cầu.

request_id (`str`) : Id của yêu cầu truy cập. Luôn được đặt, ngay cả khi tên người dùng không được chia sẻ.

fullname (`str`, *tùy chọn*) : Tên đầy đủ của người dùng đã yêu cầu quyền truy cập. `None` nếu kho được cấu hình để không chia sẻ tên người dùng của những người yêu cầu.

email (`str`, *tùy chọn*) : Email của người dùng đã yêu cầu quyền truy cập. `None` nếu người dùng được cấp quyền truy cập thủ công hoặc nếu kho được cấu hình để không chia sẻ email của người yêu cầu.

timestamp (`datetime`) : Thời gian của yêu cầu.

status (`Literal["pending", "accepted", "rejected"]`) : Trạng thái của yêu cầu. Có thể là một trong `["pending", "accepted", "rejected"]`.

fields (`dict[str, Any]`, *tùy chọn*) : Các trường bổ sung do người dùng điền vào biểu mẫu gate.

Cấu trúc dữ liệu chứa thông tin về một yêu cầu truy cập của người dùng.

### BucketFile[[huggingface_hub.BucketFile]]

#### huggingface_hub.BucketFile[[huggingface_hub.BucketFile]]

```python
huggingface_hub.BucketFile(**kwargs)
```

[Nguồn](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/_buckets.py#L197)

Chứa thông tin về một tệp trong một bucket trên Hub. Đối tượng này được trả về bởi [list_bucket_tree()](/docs/huggingface_hub/v2.4.0/vi/package_reference/hf_api#huggingface_hub.HfApi.list_bucket_tree).

Tương tự như [RepoFile](/docs/huggingface_hub/v2.4.0/vi/package_reference/hf_api#huggingface_hub.RepoFile) nhưng dành cho các tệp trong các bucket.

### BucketFileMetadata[[huggingface_hub.BucketFileMetadata]]

#### huggingface_hub.BucketFileMetadata[[huggingface_hub.BucketFileMetadata]]

```python
huggingface_hub.BucketFileMetadata(size: int, xet_file_data: XetFileData)
```

[Nguồn](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/_buckets.py#L140)

**Tham số:**

size (`int`) : Kích thước của tệp tính bằng byte.

xet_file_data (`XetFileData`) : Thông tin Xet cho tệp (hash và đường dẫn làm mới).

Cấu trúc dữ liệu chứa thông tin về một tệp trong bucket.

Được trả về bởi [get_bucket_file_metadata()](/docs/huggingface_hub/v2.4.0/vi/package_reference/hf_api#huggingface_hub.HfApi.get_bucket_file_metadata).

### BucketInfo[[huggingface_hub.BucketInfo]]

#### huggingface_hub.BucketInfo[[huggingface_hub.BucketInfo]]

```python
huggingface_hub.BucketInfo(**kwargs)
```

[Nguồn](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/_buckets.py#L65)

**Tham số:**

id (`str`) : ID của bucket.

private (`bool`) : Bucket có phải là riêng tư không.

created_at (`datetime`) : Ngày tạo bucket trên Hub.

size (`int`) : Kích thước của bucket tính bằng byte.

total_files (`int`) : Tổng số tệp trong bucket.

Chứa thông tin về một bucket trên Hub. Đối tượng này được trả về bởi [bucket_info()](/docs/huggingface_hub/v2.4.0/vi/package_reference/hf_api#huggingface_hub.HfApi.bucket_info) và [list_buckets()](/docs/huggingface_hub/v2.4.0/vi/package_reference/hf_api#huggingface_hub.HfApi.list_buckets).

### BucketUrl[[huggingface_hub.BucketUrl]]

#### huggingface_hub.BucketUrl[[huggingface_hub.BucketUrl]]

```python
huggingface_hub.BucketUrl(url: str, endpoint: str = '')
```

[Nguồn](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/_buckets.py#L157)

**Tham số:**

url (`str`) : Giá trị chuỗi của url bucket.

endpoint (`str`, *tùy chọn*) : Điểm cuối của Hub. Mặc định là .

Mô tả một URL bucket trên Hub.

`BucketUrl` được trả về bởi [create_bucket()](/docs/huggingface_hub/v2.4.0/vi/package_reference/hf_api#huggingface_hub.HfApi.create_bucket). Khi khởi tạo, URL được phân tích để điền vào các thuộc tính:
- endpoint (`str`)
- namespace (`str`)
- bucket_id (`str`)
- url (`str`)
- uri (`HfUri`)

### DatasetLeaderboardEntry[[huggingface_hub.DatasetLeaderboardEntry]]

#### huggingface_hub.DatasetLeaderboardEntry[[huggingface_hub.DatasetLeaderboardEntry]]

```python
huggingface_hub.DatasetLeaderboardEntry(**kwargs)
```

[Nguồn](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L1948)

**Tham số:**

rank (`int`) : Hạng của mô hình trên bảng xếp hạng (bắt đầu từ 1).

model_id (`str`) : ID của mô hình (ví dụ: `"meta-llama/Llama-3-8b"`).

value (`float`) : Giá trị điểm đánh giá.

filename (`str`) : Tên của tệp kết quả chứa dữ liệu đánh giá.

verified (`bool`) : Kết quả đã được xác minh hay chưa.

source (`dict[str, Any]`, *tùy chọn*) : Thông tin về nguồn của kết quả đánh giá. Chứa các khóa như `"url"`, `"name"` và `"isExternal"`. Không phải mục nào cũng có nguồn.

author (`User` hoặc `Organization`) : Tác giả của mô hình, được phân tích dựa trên trường `"type"` trong phản hồi API.

pull_request (`int`, *optional*) : Số pull request liên quan đến mục trên bảng xếp hạng, nếu có.

notes (`str`, *tùy chọn*) : Ghi chú liên quan đến mục trên bảng xếp hạng, nếu có.

Chứa thông tin về một mục duy nhất trong bảng xếp hạng bộ dữ liệu trên Hub.

Bảng xếp hạng sắp xếp các mô hình dựa trên điểm đánh giá của chúng trên một bộ dữ liệu chuẩn (benchmark) nhất định. Đối tượng này được trả về bởi [get_dataset_leaderboard()](/docs/huggingface_hub/v2.4.0/vi/package_reference/hf_api#huggingface_hub.HfApi.get_dataset_leaderboard). Để lấy kết quả đánh giá cho một mô hình cụ thể trên các benchmark, hãy xem `ModelInfo.eval_results` (thông qua [model_info()](/docs/huggingface_hub/v2.4.0/vi/package_reference/hf_api#huggingface_hub.HfApi.model_info) với `expand=["evalResults"]`) và [EvalResultEntry](/docs/huggingface_hub/v2.4.0/vi/package_reference/hf_api#huggingface_hub.EvalResultEntry).

### EvalResultEntry[[huggingface_hub.EvalResultEntry]]

#### huggingface_hub.EvalResultEntry[[huggingface_hub.EvalResultEntry]]

```python
huggingface_hub.EvalResultEntry(dataset_id: str, task_id: str, value: typing.Any, dataset_revision: str | None = None, verify_token: str | None = None, date: str | None = None, source_url: str | None = None, source_name: str | None = None, source_user: str | None = None, source_org: str | None = None, notes: str | None = None)
```

[Nguồn](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/_eval_results.py#L17)

**Tham số:**

dataset_id (`str`) : ID của bộ dữ liệu benchmark từ Hub. Ví dụ: "cais/hle", "Idavidrein/gpqa".

task_id (`str`) : Định danh tác vụ trong bộ chuẩn. Ví dụ: "gpqa_diamond".

value (`Any`) : Giá trị của chỉ số. Ví dụ: 20.90.

dataset_revision (`str`, *tùy chọn*) : Git SHA của bộ dữ liệu benchmark.

verify_token (`str`, *tùy chọn*) : Một chữ ký có thể được sử dụng để chứng minh rằng việc đánh giá có thể kiểm toán và tái lập được một cách chắc chắn.

date (`str`, *tùy chọn*) : Thời điểm đánh giá được thực hiện (datetime ISO-8601). Mặc định là thời điểm commit git.

source_url (`str`, *tùy chọn*) : Liên kết đến nguồn đánh giá (ví dụ: https://huggingface.co/spaces/SaylorTwift/smollm3-mmlu-pro). Bắt buộc nếu `source_name`, `source_user`, hoặc `source_org` được cung cấp.

source_name (`str`, *tùy chọn*) : Tên hiển thị cho nguồn. Ví dụ: "Eval Logs".

source_user (`str`, *tùy chọn*) : tên người dùng HF để ghi nhận. Ví dụ: "celinah".

source_org (`str`, *tùy chọn*) : Tên tổ chức HF để ghi nhận. Ví dụ: "cais".

notes (`str`, *tùy chọn*) : Chi tiết về cấu hình đánh giá. Ví dụ: "tools", "no-tools", "chain-of-thought".

Mục kết quả đánh giá cho định dạng `.eval_results/*.yaml`.

Đại diện cho các điểm đánh giá được lưu trữ trong các kho mô hình, tự động hiển thị trên trang mô hình và bảng xếp hạng của bộ dữ liệu chuẩn.

Đối với định dạng `model-index` cũ trong `README.md`, hãy sử dụng [EvalResult](/docs/huggingface_hub/v2.4.0/vi/package_reference/cards#huggingface_hub.EvalResult) thay thế.

Xem https://huggingface.co/docs/hub/eval-results để biết thêm chi tiết.

Ví dụ:
```python
>>> from huggingface_hub import EvalResultEntry
>>> # Minimal example with required fields only
>>> result = EvalResultEntry(
...     dataset_id="Idavidrein/gpqa",
...     task_id="gpqa_diamond",
...     value=0.412,
... )
>>> # Full example with all fields
>>> result = EvalResultEntry(
...     dataset_id="cais/hle",
...     task_id="default",
...     value=20.90,
...     dataset_revision="5503434ddd753f426f4b38109466949a1217c2bb",
...     verify_token="eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
...     date="2025-01-15T10:30:00Z",
...     source_url="https://huggingface.co/datasets/cais/hle",
...     source_name="CAIS HLE",
...     source_org="cais",
...     notes="no-tools",
... )

```

### SyncOperation[[huggingface_hub.SyncOperation]]

#### huggingface_hub.SyncOperation[[huggingface_hub.SyncOperation]]

```python
huggingface_hub.SyncOperation(action: typing.Literal['upload', 'download', 'delete', 'skip'], path: str, size: int | None = None, reason: str = '', local_mtime: str | None = None, remote_mtime: str | None = None, bucket_file: huggingface_hub._buckets.BucketFile | None = None)
```

[Nguồn](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/_buckets.py#L289)

Đại diện cho một thao tác đồng bộ hóa cần thực hiện.

### SyncPlan[[huggingface_hub.SyncPlan]]

#### huggingface_hub.SyncPlan[[huggingface_hub.SyncPlan]]

```python
huggingface_hub.SyncPlan(source: str, dest: str, timestamp: str, operations: list = <factory>)
```

[Nguồn](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/_buckets.py#L302)

Đại diện cho một kế hoạch đồng bộ hoàn chỉnh.

### CommitInfo[[huggingface_hub.CommitInfo]]

#### huggingface_hub.CommitInfo[[huggingface_hub.CommitInfo]]

```python
huggingface_hub.CommitInfo(commit_url: str, *args, **kwargs)
```

[Nguồn](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L362)

**Tham số:**

commit_url (`str`) : Địa chỉ URL để tìm commit.

commit_message (`str`) : Tóm tắt (dòng đầu tiên) của commit đã được tạo.

commit_description (`str`) : Mô tả của commit đã được tạo. Có thể để trống.

oid (`str`) : Hash id của commit. Ví dụ: `"91c54ad1727ee830252e457677f467be0bfd8a57"`.

pr_url (`str`, *tùy chọn*) : URL của PR đã được tạo, nếu có. Được điền khi `create_pr=True` được truyền vào.

pr_revision (`str`, *tùy chọn*) : Phiên bản của PR đã được tạo, nếu có. Được điền khi `create_pr=True` được truyền vào. Ví dụ: `"refs/pr/1"`.

pr_num (`int`, *optional*) : Số của cuộc thảo luận PR đã được tạo, nếu có. Được điền khi `create_pr=True` được truyền vào. Có thể được truyền dưới dạng `discussion_num` trong [get_discussion_details()](/docs/huggingface_hub/v2.4.0/vi/package_reference/hf_api#huggingface_hub.HfApi.get_discussion_details). Ví dụ: `1`.

repo_url (`RepoUrl`) : URL của kho chứa commit có thông tin như repo_id, repo_type, v.v.

Cấu trúc dữ liệu chứa thông tin về một commit mới được tạo.

Được trả về bởi bất kỳ phương thức nào tạo commit trên Hub: [create_commit()](/docs/huggingface_hub/v2.4.0/vi/package_reference/hf_api#huggingface_hub.HfApi.create_commit), [upload_file()](/docs/huggingface_hub/v2.4.0/vi/package_reference/hf_api#huggingface_hub.HfApi.upload_file), [upload_folder()](/docs/huggingface_hub/v2.4.0/vi/package_reference/hf_api#huggingface_hub.HfApi.upload_folder), [delete_file()](/docs/huggingface_hub/v2.4.0/vi/package_reference/hf_api#huggingface_hub.HfApi.delete_file), [delete_folder()](/docs/huggingface_hub/v2.4.0/vi/package_reference/hf_api#huggingface_hub.HfApi.delete_folder). Nó kế thừa từ `str` để đảm bảo tương thích ngược, nhưng việc sử dụng các phương thức đặc thù của `str` đã bị ngừng hỗ trợ.

### DatasetInfo[[huggingface_hub.DatasetInfo]]

#### huggingface_hub.DatasetInfo[[huggingface_hub.DatasetInfo]]

```python
huggingface_hub.DatasetInfo(**kwargs)
```

[Nguồn](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L1013)

**Tham số:**

id (`str`) : ID của bộ dữ liệu.

author (`str`) : Tác giả của bộ dữ liệu.

card_data (`DatasetCardData`, *tùy chọn*) : Metadata của Dataset Card dưới dạng đối tượng [huggingface_hub.repocard_data.DatasetCardData](/docs/huggingface_hub/v2.4.0/vi/package_reference/cards#huggingface_hub.DatasetCardData).

citation (`str`, *tùy chọn*) : Thông tin trích dẫn cho bộ dữ liệu.

created_at (`datetime`, *tùy chọn*) : Ngày tạo kho trên Hub. Lưu ý rằng giá trị thấp nhất là `2022-03-02T23:29:04.000Z`, tương ứng với ngày chúng tôi bắt đầu lưu trữ ngày tạo.

description (`str`, *tùy chọn*) : Mô tả của bộ dữ liệu.

disabled (`bool`, *tùy chọn*) : Kho có bị vô hiệu hóa hay không.

downloads (`int`) : Số lượt tải xuống của bộ dữ liệu trong 30 ngày qua.

downloads_all_time (`int`) : Tổng số lượt tải xuống của bộ dữ liệu kể từ khi được tạo.

gated (`Literal["auto", "manual", False]`, *tùy chọn*) : Kho có được bảo vệ hay không. Nếu có, việc phê duyệt là thủ công hay tự động.

last_modified (`datetime`, *tùy chọn*) : Ngày của lần commit cuối cùng vào kho.

likes (`int`) : Số lượt thích của bộ dữ liệu.

main_size (`int`, *tuỳ chọn*) : Kích thước tính bằng byte của nhánh chính của bộ dữ liệu.

paperswithcode_id (`str`, *tùy chọn*) : ID của bộ dữ liệu trên Papers with code.

private (`bool`) : Kho có phải là kho riêng tư không.

resource_group (`dict`, *tùy chọn*) : Thông tin nhóm tài nguyên cho bộ dữ liệu.

sha (`str`) : SHA của kho tại phiên bản cụ thể này.

siblings (`list[RepoSibling]`) : Danh sách các đối tượng [huggingface_hub.hf_api.RepoSibling](/docs/huggingface_hub/v2.4.0/vi/package_reference/hf_api#huggingface_hub.hf_api.RepoSibling) cấu thành nên bộ dữ liệu.

tags (`list[str]`) : Danh sách các thẻ của bộ dữ liệu.

trending_score (`int`, *tuỳ chọn*) : Điểm xu hướng của bộ dữ liệu.

used_storage (`int`, *tuỳ chọn*) : Kích thước của bộ dữ liệu trên Hub, tính bằng byte.

Chứa thông tin về một bộ dữ liệu trên Hub. Đối tượng này được trả về bởi [dataset_info()](/docs/huggingface_hub/v2.4.0/vi/package_reference/hf_api#huggingface_hub.HfApi.dataset_info) và [list_datasets()](/docs/huggingface_hub/v2.4.0/vi/package_reference/hf_api#huggingface_hub.HfApi.list_datasets).

> [!TIP]
> Hầu hết các thuộc tính của lớp này là tùy chọn. Điều này là do dữ liệu được trả về bởi Hub phụ thuộc vào truy vấn được thực hiện. Nhìn chung, truy vấn càng cụ thể thì càng nhiều thông tin được trả về. Ngược lại, khi liệt kê các bộ dữ liệu bằng [list_datasets()](/docs/huggingface_hub/v2.4.0/vi/package_reference/hf_api#huggingface_hub.HfApi.list_datasets), chỉ một tập con các thuộc tính được trả về.

### DryRunFileInfo[[huggingface_hub.DryRunFileInfo]]

#### huggingface_hub.DryRunFileInfo[[huggingface_hub.DryRunFileInfo]]

```python
huggingface_hub.DryRunFileInfo(commit_hash: str, file_size: int | None, filename: str, local_path: str, is_cached: bool, will_download: bool)
```

[Nguồn](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/file_download.py#L182)

**Tham số:**

commit_hash (`str`) : commit_hash liên quan đến tệp.

file_size (`int`, *tuỳ chọn*) : Kích thước của tệp, nếu đã biết. Đối với tệp LFS, chứa kích thước của tệp LFS thực tế, không phải con trỏ.

filename (`str`) : Tên của tệp trong kho.

is_cached (`bool`) : Cho biết tệp đã được lưu trong bộ nhớ đệm cục bộ hay chưa.

will_download (`bool`) : Cho biết tệp có sẽ được tải xuống hay không nếu `hf_hub_download` được gọi với `dry_run=False`. Trên thực tế, will_download sẽ là `True` nếu tệp không được lưu trong bộ nhớ đệm hoặc nếu `force_download=True`.

Thông tin được trả về khi thực hiện chạy thử (dry run) việc tải xuống tệp.

Được trả về bởi [hf_hub_download()](/docs/huggingface_hub/v2.4.0/vi/package_reference/file_download#huggingface_hub.hf_hub_download) khi `dry_run=True`.

### DuplicatedRepoUrl[[huggingface_hub.DuplicatedRepoUrl]]

#### huggingface_hub.DuplicatedRepoUrl[[huggingface_hub.DuplicatedRepoUrl]]

```python
huggingface_hub.DuplicatedRepoUrl(url: Any, endpoint: str | None = None)
```

[Nguồn](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L594)

**Tham số:**

files_copy_pending (`bool`) : `True` nếu các tệp LFS/Xet của kho mới vẫn đang được sao chép ở nền. Cho đến khi quá trình sao chép hoàn tất, việc tải xuống các tệp này có thể thất bại.

[RepoUrl](/docs/huggingface_hub/v2.4.0/vi/package_reference/hf_api#huggingface_hub.RepoUrl) được trả về bởi [duplicate_repo()](/docs/huggingface_hub/v2.4.0/vi/package_reference/hf_api#huggingface_hub.HfApi.duplicate_repo).

### GitRefInfo[[huggingface_hub.GitRefInfo]]

#### huggingface_hub.GitRefInfo[[huggingface_hub.GitRefInfo]]

```python
huggingface_hub.GitRefInfo(name: str, ref: str, target_commit: str)
```

[Nguồn](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L1444)

**Tham số:**

name (`str`) : Tên của tham chiếu (ví dụ: tên tag hoặc tên nhánh).

ref (`str`) : Tham chiếu git đầy đủ trên Hub (ví dụ `"refs/heads/main"` hoặc `"refs/tags/v1.0"`).

target_commit (`str`) : OID của commit đích cho ref (ví dụ: `"e7da7f221d5bf496a48136c0cd264e630fe9fcc8"`)

Chứa thông tin về một tham chiếu git cho một kho trên Hub.

### GitCommitInfo[[huggingface_hub.GitCommitInfo]]

#### huggingface_hub.GitCommitInfo[[huggingface_hub.GitCommitInfo]]

```python
huggingface_hub.GitCommitInfo(commit_id: str, authors: list[str], created_at: datetime, title: str, message: str, formatted_title: str | None, formatted_message: str | None)
```

[Nguồn](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L1489)

**Tham số:**

commit_id (`str`) : OID của commit (ví dụ: `"e7da7f221d5bf496a48136c0cd264e630fe9fcc8"`)

authors (`list[str]`) : Danh sách tác giả của commit.

created_at (`datetime`) : Thời điểm tạo commit.

title (`str`) : Tiêu đề của commit. Đây là giá trị văn bản tự do do các tác giả nhập vào.

message (`str`) : Mô tả của commit. Đây là giá trị văn bản tự do do các tác giả nhập vào.

formatted_title (`str`) : Tiêu đề của commit được định dạng dưới dạng HTML. Chỉ được trả về nếu `formatted=True` được đặt.

formatted_message (`str`) : Mô tả của commit được định dạng dưới dạng HTML. Chỉ được trả về nếu `formatted=True` được đặt.

Chứa thông tin về một commit git cho một kho trên Hub. Xem [list_repo_commits()](/docs/huggingface_hub/v2.4.0/vi/package_reference/hf_api#huggingface_hub.HfApi.list_repo_commits) để biết thêm chi tiết.

### GitRefs[[huggingface_hub.GitRefs]]

#### huggingface_hub.GitRefs[[huggingface_hub.GitRefs]]

```python
huggingface_hub.GitRefs(branches: list[GitRefInfo], converts: list[GitRefInfo], tags: list[GitRefInfo], pull_requests: list[GitRefInfo] | None = None)
```

[Nguồn](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L1463)

**Tham số:**

branches (`list[GitRefInfo]`) : Một danh sách [GitRefInfo](/docs/huggingface_hub/v2.4.0/vi/package_reference/hf_api#huggingface_hub.GitRefInfo) chứa thông tin về các nhánh trong kho.

converts (`list[GitRefInfo]`) : Một danh sách [GitRefInfo](/docs/huggingface_hub/v2.4.0/vi/package_reference/hf_api#huggingface_hub.GitRefInfo) chứa thông tin về các ref "convert" trong repo. Convert là các ref được sử dụng (nội bộ) để đẩy dữ liệu đã tiền xử lý trong các repo Dataset.

tags (`list[GitRefInfo]`) : Một danh sách [GitRefInfo](/docs/huggingface_hub/v2.4.0/vi/package_reference/hf_api#huggingface_hub.GitRefInfo) chứa thông tin về các tag trong kho.

pull_requests (`list[GitRefInfo]`, *tùy chọn*) : Một danh sách [GitRefInfo](/docs/huggingface_hub/v2.4.0/vi/package_reference/hf_api#huggingface_hub.GitRefInfo) chứa thông tin về các pull request trên repo. Chỉ được trả về nếu `include_prs=True` được đặt.

Chứa thông tin về tất cả các tham chiếu git cho một kho trên Hub.

Object được trả về bởi [list_repo_refs()](/docs/huggingface_hub/v2.4.0/vi/package_reference/hf_api#huggingface_hub.HfApi.list_repo_refs).

### InferenceProviderMapping[[huggingface_hub.hf_api.InferenceProviderMapping]]

#### huggingface_hub.hf_api.InferenceProviderMapping[[huggingface_hub.hf_api.InferenceProviderMapping]]

```python
huggingface_hub.hf_api.InferenceProviderMapping(**kwargs)
```

[Nguồn](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L773)

### KernelInfo[[huggingface_hub.KernelInfo]]

#### huggingface_hub.KernelInfo[[huggingface_hub.KernelInfo]]

```python
huggingface_hub.KernelInfo(**kwargs)
```

[Nguồn](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L1285)

**Tham số:**

id (`str`) : ID của kho kernel.

author (`str`, *tùy chọn*) : Tác giả của kho kernel.

downloads (`int`, *tuỳ chọn*) : Số lượt tải xuống kho kernel trong 30 ngày qua.

gated (`Literal["auto", "manual", False]`, *tùy chọn*) : Kho có được bảo vệ hay không. Nếu có, việc phê duyệt là thủ công hay tự động.

last_modified (`datetime`, *tùy chọn*) : Ngày của lần commit cuối cùng vào kho.

likes (`int`, *tuỳ chọn*) : Số lượt thích của kho kernel.

private (`bool`, *tùy chọn*) : Kho có phải là riêng tư không.

sha (`str`, *tùy chọn*) : SHA của kho tại phiên bản cụ thể này.

Chứa thông tin về một kho kernel trên Hub. Đối tượng này được trả về bởi [kernel_info()](/docs/huggingface_hub/v2.4.0/vi/package_reference/hf_api#huggingface_hub.HfApi.kernel_info).

### LFSFileInfo[[huggingface_hub.hf_api.LFSFileInfo]]

#### huggingface_hub.hf_api.LFSFileInfo[[huggingface_hub.hf_api.LFSFileInfo]]

```python
huggingface_hub.hf_api.LFSFileInfo(**kwargs)
```

[Nguồn](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L1887)

**Tham số:**

file_oid (`str`) : ID đối tượng SHA-256 của tệp. Đây là định danh cần truyền khi xóa vĩnh viễn tệp.

filename (`str`) : Tên tệp khả dụng cho đối tượng LFS. Xem ghi chú ở trên để biết thêm thông tin.

oid (`str`) : OID của đối tượng LFS.

pushed_at (`datetime`) : Ngày đối tượng LFS được đẩy lên kho.

ref (`str`, *tùy chọn*) : Tham chiếu nơi đối tượng LFS đã được đẩy lên (nếu có).

size (`int`) : Kích thước của đối tượng LFS.

Chứa thông tin về một tệp được lưu trữ dưới dạng LFS trên một kho trên Hub.

Được sử dụng trong ngữ cảnh liệt kê và xóa vĩnh viễn các tệp LFS khỏi kho để giải phóng dung lượng. Xem [list_lfs_files()](/docs/huggingface_hub/v2.4.0/vi/package_reference/hf_api#huggingface_hub.HfApi.list_lfs_files) và [permanently_delete_lfs_files()](/docs/huggingface_hub/v2.4.0/vi/package_reference/hf_api#huggingface_hub.HfApi.permanently_delete_lfs_files) để biết thêm chi tiết.

Các tệp Git LFS được theo dõi bằng các ID đối tượng SHA-256 thay vì đường dẫn tệp, nhằm tối ưu hiệu suất. Cách tiếp cận này là cần thiết vì một đối tượng duy nhất có thể được tham chiếu bởi nhiều đường dẫn khác nhau qua các commit khác nhau, khiến việc tìm kiếm và giải quyết các kết nối này trở nên không thực tế. Xem [tài liệu của chúng tôi](https://huggingface.co/docs/hub/storage-limits#advanced-track-lfs-file-references) để tìm hiểu cách biết tệp nào liên kết với mỗi SHA.

Ví dụ:
```py
>>> from huggingface_hub import HfApi
>>> api = HfApi()
>>> lfs_files = api.list_lfs_files("username/my-cool-repo")

# Filter files to delete based on a combination of `filename`, `pushed_at`, `ref` or `size`.
# e.g. select only LFS files in the "checkpoints" folder
>>> lfs_files_to_delete = (lfs_file for lfs_file in lfs_files if lfs_file.filename.startswith("checkpoints/"))

# Permanently delete LFS files
>>> api.permanently_delete_lfs_files("username/my-cool-repo", lfs_files_to_delete)
```

### ModelInfo[[huggingface_hub.ModelInfo]]

#### huggingface_hub.ModelInfo[[huggingface_hub.ModelInfo]]

```python
huggingface_hub.ModelInfo(**kwargs)
```

[Nguồn](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L798)

**Tham số:**

id (`str`) : ID của model.

author (`str`, *tùy chọn*) : Tác giả của mô hình.

base_models (`list[str]`, *tùy chọn*) : Danh sách các mô hình cơ sở mà mô hình này được phát triển từ đó.

card_data (`ModelCardData`, *tùy chọn*) : Metadata của Model Card dưới dạng đối tượng [huggingface_hub.repocard_data.ModelCardData](/docs/huggingface_hub/v2.4.0/vi/package_reference/cards#huggingface_hub.ModelCardData).

children_model_count (`int`, *tuỳ chọn*) : Số lượng mô hình con được suy ra từ mô hình này.

config (`dict`, *tùy chọn*) : Cấu hình mô hình.

created_at (`datetime`, *tùy chọn*) : Ngày tạo kho trên Hub. Lưu ý rằng giá trị thấp nhất là `2022-03-02T23:29:04.000Z`, tương ứng với ngày chúng tôi bắt đầu lưu trữ ngày tạo.

disabled (`bool`, *tùy chọn*) : Kho có bị vô hiệu hóa hay không.

downloads (`int`) : Số lượt tải xuống của mô hình trong 30 ngày qua.

downloads_all_time (`int`) : Tổng số lượt tải xuống của mô hình kể từ khi được tạo.

eval_results (`list[EvalResultEntry]`, *tùy chọn*) : Kết quả đánh giá của mô hình.

gated (`Literal["auto", "manual", False]`, *tùy chọn*) : Kho có được bảo vệ hay không. Nếu có, việc phê duyệt là thủ công hay tự động.

gguf (`dict`, *tùy chọn*) : Thông tin GGUF của mô hình.

inference (`Literal["warm"]`, *tùy chọn*) : Trạng thái của mô hình trên các nhà cung cấp suy luận. Ấm nếu mô hình được phục vụ bởi ít nhất một nhà cung cấp.

inference_provider_mapping (`list[InferenceProviderMapping]`, *tùy chọn*) : Một danh sách các `InferenceProviderMapping` được sắp xếp theo thứ tự provider của người dùng.

last_modified (`datetime`, *tùy chọn*) : Ngày của lần commit cuối cùng vào kho.

library_name (`str`, *tùy chọn*) : Thư viện liên quan đến mô hình.

likes (`int`) : Số lượt thích của mô hình.

mask_token (`str`, *tùy chọn*) : Token mặt nạ được mô hình sử dụng.

model_index (`dict`, *tùy chọn*) : Chỉ mục mô hình để đánh giá.

pipeline_tag (`str`, *tùy chọn*) : Thẻ pipeline liên quan đến mô hình.

private (`bool`) : Kho có phải là kho riêng tư không.

resource_group (`dict`, *tùy chọn*) : Thông tin nhóm tài nguyên cho mô hình.

safetensors (`SafeTensorsInfo`, *tùy chọn*) : Thông tin safetensors của mô hình.

security_repo_status (`dict`, *tùy chọn*) : Trạng thái quét bảo mật của mô hình.

sha (`str`, *tùy chọn*) : SHA của kho tại phiên bản cụ thể này.

siblings (`list[RepoSibling]`) : Danh sách các đối tượng [huggingface_hub.hf_api.RepoSibling](/docs/huggingface_hub/v2.4.0/vi/package_reference/hf_api#huggingface_hub.hf_api.RepoSibling) cấu thành nên mô hình.

spaces (`list[str]`, *tùy chọn*) : Danh sách các không gian sử dụng mô hình.

tags (`list[str]`) : Danh sách các thẻ của mô hình. So với `card_data.tags`, chứa các thẻ bổ sung được tính toán bởi Hub (ví dụ: các thư viện được hỗ trợ, arXiv của mô hình).

transformers_info (`TransformersInfo`, *tùy chọn*) : Thông tin cụ thể của Transformers (auto class, processor, v.v.) liên quan đến mô hình.

trending_score (`int`, *tuỳ chọn*) : Điểm xu hướng của mô hình.

used_storage (`int`, *tuỳ chọn*) : Kích thước của mô hình trên Hub tính bằng byte.

widget_data (`Any`, *tùy chọn*) : Dữ liệu Widget liên quan đến mô hình.

Chứa thông tin về một mô hình trên Hub. Đối tượng này được trả về bởi [model_info()](/docs/huggingface_hub/v2.4.0/vi/package_reference/hf_api#huggingface_hub.HfApi.model_info) và [list_models()](/docs/huggingface_hub/v2.4.0/vi/package_reference/hf_api#huggingface_hub.HfApi.list_models).

> [!TIP]
> Hầu hết các thuộc tính của lớp này là tùy chọn. Điều này là do dữ liệu được trả về bởi Hub phụ thuộc vào truy vấn được thực hiện. Nhìn chung, truy vấn càng cụ thể thì càng nhiều thông tin được trả về. Ngược lại, khi liệt kê các mô hình bằng [list_models()](/docs/huggingface_hub/v2.4.0/vi/package_reference/hf_api#huggingface_hub.HfApi.list_models), chỉ một tập con các thuộc tính được trả về.

### RepoSibling[[huggingface_hub.hf_api.RepoSibling]]

#### huggingface_hub.hf_api.RepoSibling[[huggingface_hub.hf_api.RepoSibling]]

```python
huggingface_hub.hf_api.RepoSibling(rfilename: str, size: int | None = None, blob_id: str | None = None, lfs: BlobLfsInfo | None = None)
```

[Nguồn](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L648)

**Tham số:**

rfilename (str) : tên tệp, tương đối so với gốc của kho.

size (`int`, *optional*) : Kích thước tệp, tính bằng byte. Thuộc tính này được định nghĩa khi đối số `files_metadata` của [repo_info()](/docs/huggingface_hub/v2.4.0/vi/package_reference/hf_api#huggingface_hub.HfApi.repo_info) được đặt thành `True`. Ngược lại, giá trị là `None`.

blob_id (`str`, *tùy chọn*) : OID git của tệp. Thuộc tính này được định nghĩa khi đối số `files_metadata` của [repo_info()](/docs/huggingface_hub/v2.4.0/vi/package_reference/hf_api#huggingface_hub.HfApi.repo_info) được đặt thành `True`. Ngược lại, nó là `None`.

lfs (`BlobLfsInfo`, *tuỳ chọn*) : Metadata LFS của tệp. Thuộc tính này được định nghĩa khi đối số `files_metadata` của [repo_info()](/docs/huggingface_hub/v2.4.0/vi/package_reference/hf_api#huggingface_hub.HfApi.repo_info) được đặt thành `True` và tệp được lưu trữ bằng Git LFS. Ngược lại, giá trị là `None`.

Chứa thông tin cơ bản về một tệp trong kho trên Hub.

> [!TIP]
> Tất cả các thuộc tính của lớp này đều là tùy chọn ngoại trừ `rfilename`. Điều này là do chỉ tên tệp được trả về khi liệt kê các kho trên Hub (với [list_models()](/docs/huggingface_hub/v2.4.0/vi/package_reference/hf_api#huggingface_hub.HfApi.list_models), [list_datasets()](/docs/huggingface_hub/v2.4.0/vi/package_reference/hf_api#huggingface_hub.HfApi.list_datasets) hoặc [list_spaces()](/docs/huggingface_hub/v2.4.0/vi/package_reference/hf_api#huggingface_hub.HfApi.list_spaces)). Nếu bạn cần thêm thông tin như kích thước tệp, blob id hoặc chi tiết lfs, bạn phải yêu cầu chúng cụ thể từ từng kho một (sử dụng [model_info()](/docs/huggingface_hub/v2.4.0/vi/package_reference/hf_api#huggingface_hub.HfApi.model_info), [dataset_info()](/docs/huggingface_hub/v2.4.0/vi/package_reference/hf_api#huggingface_hub.HfApi.dataset_info) hoặc [space_info()](/docs/huggingface_hub/v2.4.0/vi/package_reference/hf_api#huggingface_hub.HfApi.space_info)) vì việc này đặt thêm các ràng buộc lên máy chủ backend để truy xuất chúng.

### RepoFile[[huggingface_hub.RepoFile]]

#### huggingface_hub.RepoFile[[huggingface_hub.RepoFile]]

```python
huggingface_hub.RepoFile(**kwargs)
```

[Nguồn](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L680)

**Tham số:**

path (str) : đường dẫn tệp tương đối so với gốc kho.

size (`int`) : Kích thước tệp, tính bằng byte.

blob_id (`str`) : OID git của tệp.

lfs (`BlobLfsInfo`, *tùy chọn*) : Metadata LFS của tệp.

xet_hash (`str`, *tùy chọn*) : Hash Xet của tệp.

last_commit (`LastCommitInfo`, *tùy chọn*) : Metadata của lần commit cuối cùng của tệp. Chỉ được định nghĩa nếu [list_repo_tree()](/docs/huggingface_hub/v2.4.0/vi/package_reference/hf_api#huggingface_hub.HfApi.list_repo_tree) và [get_paths_info()](/docs/huggingface_hub/v2.4.0/vi/package_reference/hf_api#huggingface_hub.HfApi.get_paths_info) được gọi với `expand=True`.

security (`BlobSecurityInfo`, *tùy chọn*) : Metadata của bản quét bảo mật cho tệp. Chỉ được định nghĩa nếu [list_repo_tree()](/docs/huggingface_hub/v2.4.0/vi/package_reference/hf_api#huggingface_hub.HfApi.list_repo_tree) và [get_paths_info()](/docs/huggingface_hub/v2.4.0/vi/package_reference/hf_api#huggingface_hub.HfApi.get_paths_info) được gọi với `expand=True`.

Chứa thông tin về một tệp trên Hub.

### RepoUrl[[huggingface_hub.RepoUrl]]

#### huggingface_hub.RepoUrl[[huggingface_hub.RepoUrl]]

```python
huggingface_hub.RepoUrl(url: Any, endpoint: str | None = None)
```

[Nguồn](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L527)

**Tham số:**

url (`Any`) : Chuỗi giá trị của url kho.

endpoint (`str`, *tùy chọn*) : Điểm cuối của Hub. Mặc định là .

**Gây ra:** `HfUriError`

- `HfUriError` -- Nếu URL không thể được phân tích (ví dụ: kho một đoạn chính tắc, hoặc `repo_type` không xác định).

Lớp con của `str` mô tả một URL kho trên Hub.

`RepoUrl` được trả về bởi `HfApi.create_repo`. Nó kế thừa từ `str` để đảm bảo tương thích ngược. Khi khởi tạo, URL được phân tích để điền vào các thuộc tính:
- endpoint (`str`)
- namespace (`str`)
- repo_name (`str`)
- repo_id (`str`)
- repo_type (`Literal["model", "dataset", "space"]`)
- url (`str`)

Ví dụ:
```py
>>> RepoUrl('https://huggingface.co/openai-community/gpt2')
RepoUrl('https://huggingface.co/openai-community/gpt2', endpoint='https://huggingface.co', repo_type='model', repo_id='openai-community/gpt2')

>>> RepoUrl('https://hub-ci.huggingface.co/datasets/dummy_user/dummy_dataset', endpoint='https://hub-ci.huggingface.co')
RepoUrl('https://hub-ci.huggingface.co/datasets/dummy_user/dummy_dataset', endpoint='https://hub-ci.huggingface.co', repo_type='dataset', repo_id='dummy_user/dummy_dataset')

>>> RepoUrl('hf://datasets/my-user/my-dataset')
RepoUrl('hf://datasets/my-user/my-dataset', endpoint='https://huggingface.co', repo_type='dataset', repo_id='user/dataset')

>>> HfApi.create_repo("dummy_model")
RepoUrl('https://huggingface.co/Wauplin/dummy_model', endpoint='https://huggingface.co', repo_type='model', repo_id='Wauplin/dummy_model')
```

### SafetensorsRepoMetadata[[huggingface_hub.utils.SafetensorsRepoMetadata]]

#### huggingface_hub.utils.SafetensorsRepoMetadata[[huggingface_hub.utils.SafetensorsRepoMetadata]]

```python
huggingface_hub.utils.SafetensorsRepoMetadata(metadata: dict | None, sharded: bool, weight_map: dict, files_metadata: dict)
```

[Nguồn](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/utils/_safetensors.py#L74)

**Tham số:**

metadata (`dict`, *tùy chọn*) : Metadata chứa trong tệp 'model.safetensors.index.json', nếu tệp này tồn tại. Chỉ được điền cho các model dạng sharded.

sharded (`bool`) : Cho biết kho có chứa mô hình phân mảnh hay không.

weight_map (`dict[str, str]`) : Bản đồ của tất cả các trọng số. Các khóa là tên tensor và các giá trị là tên tệp của các tệp chứa các tensor.

files_metadata (`dict[str, SafetensorsFileMetadata]`) : Bản đồ chứa metadata của tất cả các tệp. Các khóa là tên tệp và các giá trị là metadata của tệp tương ứng, dưới dạng đối tượng `SafetensorsFileMetadata`.

parameter_count (`dict[str, int]`) : Bản đồ số lượng tham số theo từng kiểu dữ liệu. Các khóa là kiểu dữ liệu và các giá trị là số lượng tham số của kiểu dữ liệu đó.

Metadata cho một kho Safetensors.

Một repo được coi là repo Safetensors nếu nó chứa tệp trọng số 'model.safetensors' (mô hình không chia sẻ) hoặc tệp chỉ mục 'model.safetensors.index.json' (mô hình phân mảnh) ở thư mục gốc.

Lớp này được trả về bởi [get_safetensors_metadata()](/docs/huggingface_hub/v2.4.0/vi/package_reference/hf_api#huggingface_hub.HfApi.get_safetensors_metadata).

Để biết thêm chi tiết về định dạng safetensors, hãy xem https://huggingface.co/docs/safetensors/index#format.

### SafetensorsFileMetadata[[huggingface_hub.utils.SafetensorsFileMetadata]]

#### huggingface_hub.utils.SafetensorsFileMetadata[[huggingface_hub.utils.SafetensorsFileMetadata]]

```python
huggingface_hub.utils.SafetensorsFileMetadata(metadata: dict, tensors: dict)
```

[Nguồn](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/utils/_safetensors.py#L44)

**Tham số:**

metadata (`dict`) : Metadata có trong tệp.

tensors (`dict[str, TensorInfo]`) : Bản đồ của tất cả các tensor. Các khóa là tên tensor và các giá trị là thông tin về tensor tương ứng, dưới dạng đối tượng `TensorInfo`.

parameter_count (`dict[str, int]`) : Bản đồ số lượng tham số theo từng kiểu dữ liệu. Các khóa là kiểu dữ liệu và các giá trị là số lượng tham số của kiểu dữ liệu đó.

Metadata cho tệp Safetensors được lưu trữ trên Hub.

Lớp này được trả về bởi [parse_safetensors_file_metadata()](/docs/huggingface_hub/v2.4.0/vi/package_reference/hf_api#huggingface_hub.HfApi.parse_safetensors_file_metadata).

Để biết thêm chi tiết về định dạng safetensors, hãy xem https://huggingface.co/docs/safetensors/index#format.

### SpaceInfo[[huggingface_hub.SpaceInfo]]

#### huggingface_hub.SpaceInfo[[huggingface_hub.SpaceInfo]]

```python
huggingface_hub.SpaceInfo(**kwargs)
```

[Nguồn](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L1147)

**Tham số:**

id (`str`) : ID của Space.

author (`str`, *tùy chọn*) : Tác giả của Space.

card_data (`SpaceCardData`, *tùy chọn*) : Metadata của Space Card dưới dạng đối tượng [huggingface_hub.repocard_data.SpaceCardData](/docs/huggingface_hub/v2.4.0/vi/package_reference/cards#huggingface_hub.SpaceCardData).

created_at (`datetime`, *tùy chọn*) : Ngày tạo kho trên Hub. Lưu ý rằng giá trị thấp nhất là `2022-03-02T23:29:04.000Z`, tương ứng với ngày chúng tôi bắt đầu lưu trữ ngày tạo.

datasets (`list[str]`, *tùy chọn*) : Danh sách các bộ dữ liệu được Space sử dụng.

disabled (`bool`, *tùy chọn*) : Cho biết Space có bị vô hiệu hóa hay không.

gated (`Literal["auto", "manual", False]`, *tùy chọn*) : Kho có được bảo vệ hay không. Nếu có, việc phê duyệt là thủ công hay tự động.

host (`str`, *tùy chọn*) : URL máy chủ của Space.

last_modified (`datetime`, *tùy chọn*) : Ngày của lần commit cuối cùng vào kho.

likes (`int`) : Số lượt thích của Space.

models (`list[str]`, *tùy chọn*) : Danh sách các mô hình được sử dụng bởi Space.

private (`bool`) : Kho có phải là kho riêng tư không.

region (`Literal["us", "eu"]`, *tùy chọn*) : Vùng cloud nơi Space được lưu trữ.

resource_group (`dict`, *tùy chọn*) : Thông tin nhóm tài nguyên cho Space.

runtime (`SpaceRuntime`, *tùy chọn*) : Thông tin về runtime của Space dưới dạng đối tượng [huggingface_hub.hf_api.SpaceRuntime](/docs/huggingface_hub/v2.4.0/vi/package_reference/space_runtime#huggingface_hub.SpaceRuntime).

sdk (`str`, *tùy chọn*) : SDK được sử dụng bởi Space.

sha (`str`, *tùy chọn*) : SHA của kho tại phiên bản cụ thể này.

siblings (`list[RepoSibling]`) : Danh sách các đối tượng [huggingface_hub.hf_api.RepoSibling](/docs/huggingface_hub/v2.4.0/vi/package_reference/hf_api#huggingface_hub.hf_api.RepoSibling) cấu thành nên Space.

subdomain (`str`, *tùy chọn*) : Subdomain của Space.

tags (`list[str]`) : Danh sách các thẻ của Space.

trending_score (`int`, *tuỳ chọn*) : Điểm xu hướng của Space.

used_storage (`int`, *tuỳ chọn*) : Kích thước tính bằng byte của Space trên Hub.

Chứa thông tin về một Space trên Hub. Đối tượng này được trả về bởi [space_info()](/docs/huggingface_hub/v2.4.0/vi/package_reference/hf_api#huggingface_hub.HfApi.space_info) và [list_spaces()](/docs/huggingface_hub/v2.4.0/vi/package_reference/hf_api#huggingface_hub.HfApi.list_spaces).

> [!TIP]
> Hầu hết các thuộc tính của lớp này là tùy chọn. Điều này là do dữ liệu được trả về bởi Hub phụ thuộc vào truy vấn được thực hiện. Nhìn chung, truy vấn càng cụ thể thì càng nhiều thông tin được trả về. Ngược lại, khi liệt kê các space bằng [list_spaces()](/docs/huggingface_hub/v2.4.0/vi/package_reference/hf_api#huggingface_hub.HfApi.list_spaces), chỉ một tập con các thuộc tính được trả về.

### SpaceSearchResult[[huggingface_hub.SpaceSearchResult]]

#### huggingface_hub.SpaceSearchResult[[huggingface_hub.SpaceSearchResult]]

```python
huggingface_hub.SpaceSearchResult(data: dict)
```

[Nguồn](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/_space_api.py#L309)

**Tham số:**

id (`str`) : ID của Space (ví dụ: `"username/repo-name"`).

author (`str`) : Tác giả của Space.

title (`str`) : Tiêu đề hiển thị của Space.

emoji (`str` hoặc `None`) : Biểu tượng emoji của Space.

sdk (`str` hoặc `None`) : SDK được sử dụng bởi Space (ví dụ: `"gradio"`, `"docker"`, `"static"`).

likes (`int`) : Số lượt thích.

private (`bool`) : Cho biết Space có phải là riêng tư hay không.

tags (`list[str]` hoặc `None`) : Danh sách các thẻ.

runtime ([SpaceRuntime](/docs/huggingface_hub/v2.4.0/vi/package_reference/space_runtime#huggingface_hub.SpaceRuntime) hoặc `None`) : Thông tin về môi trường chạy (giai đoạn, phần cứng, v.v.).

ai_short_description (`str` hoặc `None`) : Mô tả ngắn do AI tạo ra.

ai_category (`str` hoặc `None`) : Danh mục do AI tạo ra (ví dụ: `"Image Generation"`).

semantic_relevancy_score (`float` hoặc `None`) : Điểm liên quan ngữ nghĩa (0-1) so với truy vấn tìm kiếm.

trending_score (`int` hoặc `None`) : Điểm xu hướng.

Một kết quả duy nhất từ API tìm kiếm ngữ nghĩa của Spaces.

Được trả về bởi [HfApi.search_spaces()](/docs/huggingface_hub/v2.4.0/vi/package_reference/hf_api#huggingface_hub.HfApi.search_spaces).

### TensorInfo[[huggingface_hub.utils.TensorInfo]]

#### huggingface_hub.utils.TensorInfo[[huggingface_hub.utils.TensorInfo]]

```python
huggingface_hub.utils.TensorInfo(dtype: typing.Literal['F64', 'F32', 'F16', 'BF16', 'I64', 'I32', 'I16', 'I8', 'U8', 'U3', 'BOOL'], shape: list, data_offsets: tuple)
```

[Nguồn](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/utils/_safetensors.py#L14)

**Tham số:**

dtype (`str`) : Kiểu dữ liệu của tensor ("F64", "F32", "F16", "BF16", "I64", "I32", "I16", "I8", "U8", "U3", "BOOL").

shape (`list[int]`) : Hình dạng của tensor.

data_offsets (`tuple[int, int]`) : Các offset của dữ liệu trong tệp dưới dạng tuple `[BEGIN, END]`.

parameter_count (`int`) : Số lượng tham số trong tensor.

Thông tin về một tensor.

Để biết thêm chi tiết về định dạng safetensors, hãy xem https://huggingface.co/docs/safetensors/index#format.

### Người dùng[[huggingface_hub.User]]

#### huggingface_hub.User[[huggingface_hub.User]]

```python
huggingface_hub.User(**kwargs)
```

[Nguồn](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L1658)

**Tham số:**

username (`str`) : Tên của người dùng trên Hub (độc nhất).

fullname (`str`) : Họ và tên đầy đủ của người dùng.

avatar_url (`str`) : URL của ảnh đại diện của người dùng.

details (`str`, *tùy chọn*) : Chi tiết của người dùng.

is_following (`bool`, *tùy chọn*) : Người dùng đã xác thực có đang theo dõi người dùng này hay không.

is_pro (`bool`, *tùy chọn*) : Người dùng có phải là người dùng pro hay không.

num_models (`int`, *tuỳ chọn*) : Số lượng mô hình do người dùng tạo ra.

num_datasets (`int`, *tùy chọn*) : Số lượng bộ dữ liệu do người dùng tạo.

num_spaces (`int`, *tuỳ chọn*) : Số lượng không gian do người dùng tạo ra.

num_discussions (`int`, *tuỳ chọn*) : Số lượng cuộc thảo luận do người dùng khởi tạo.

num_papers (`int`, *tuỳ chọn*) : Số lượng bài báo do người dùng viết.

num_upvotes (`int`, *tuỳ chọn*) : Số lượt bình chọn tích cực mà người dùng nhận được.

num_likes (`int`, *tuỳ chọn*) : Số lượt thích do người dùng đưa ra.

num_following (`int`, *tuỳ chọn*) : Số lượng người dùng mà người dùng này đang theo dõi.

num_followers (`int`, *tuỳ chọn*) : Số người dùng đang theo dõi người dùng này.

orgs (danh sách `Organization`) : Danh sách các tổ chức mà người dùng là thành viên.

Chứa thông tin về một người dùng trên Hub.

### UserLikes[[huggingface_hub.UserLikes]]

#### huggingface_hub.UserLikes[[huggingface_hub.UserLikes]]

```python
huggingface_hub.UserLikes(user: str, total: int, datasets: list[str], kernels: list[str], models: list[str], spaces: list[str])
```

[Nguồn](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L1522)

**Tham số:**

user (`str`) : Tên của người dùng mà chúng ta đã lấy các lượt thích.

total (`int`) : Tổng số lượt thích.

datasets (`list[str]`) : Danh sách các bộ dữ liệu được người dùng thích (dưới dạng repo_ids).

kernels (`list[str]`) : Danh sách các kernel được người dùng thích (dưới dạng repo_ids).

models (`list[str]`) : Danh sách các model mà người dùng đã thích (dưới dạng repo_ids).

spaces (`list[str]`) : Danh sách các không gian được người dùng thích (dưới dạng repo_ids).

Chứa thông tin về các mục người dùng thích trên Hub.

### WebhookInfo[[huggingface_hub.WebhookInfo]]

#### huggingface_hub.WebhookInfo[[huggingface_hub.WebhookInfo]]

```python
huggingface_hub.WebhookInfo(id: str, url: str | None, job: JobSpec | None, watched: list[WebhookWatchedItem], domains: list[constants.WEBHOOK_DOMAIN_T], secret: str | None, disabled: bool)
```

[Nguồn](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L496)

**Tham số:**

id (`str`) : ID của webhook.

url (`str`, *tùy chọn*) : URL của webhook.

job (`JobSpec`, *tùy chọn*) : Thông số kỹ thuật của Job cần kích hoạt.

watched (`list[WebhookWatchedItem]`) : Danh sách các mục được webhook theo dõi, xem [WebhookWatchedItem](/docs/huggingface_hub/v2.4.0/vi/package_reference/hf_api#huggingface_hub.WebhookWatchedItem).

domains (`list[WEBHOOK_DOMAIN_T]`) : Danh sách các miền mà webhook đang theo dõi. Có thể là một trong `["repo", "discussion"]`.

secret (`str`, *tùy chọn*) : Mật mã của webhook.

disabled (`bool`) : Webhook có bị vô hiệu hóa hay không.

Cấu trúc dữ liệu chứa thông tin về một webhook.

Một trong `url` hoặc `job` được chỉ định, nhưng không phải cả hai.

### WebhookWatchedItem[[huggingface_hub.WebhookWatchedItem]]

#### huggingface_hub.WebhookWatchedItem[[huggingface_hub.WebhookWatchedItem]]

```python
huggingface_hub.WebhookWatchedItem(type: Literal['bucket', 'dataset', 'model', 'org', 'space', 'user'], name: str)
```

[Nguồn](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L480)

**Tham số:**

type (`Literal["bucket", "dataset", "model", "org", "space", "user"]`) : Loại mục cần theo dõi. Có thể là một trong `["bucket", "dataset", "model", "org", "space", "user"]`.

name (`str`) : Tên của mục cần theo dõi. Có thể là tên người dùng, tên tổ chức, tên model, tên dataset, tên space hoặc tên bucket.

Cấu trúc dữ liệu chứa thông tin về các mục được theo dõi bởi một webhook.

## CommitOperation[[huggingface_hub.CommitOperationAdd]]

Dưới đây là các giá trị được hỗ trợ cho `CommitOperation()`:

#### huggingface_hub.CommitOperationAdd[[huggingface_hub.CommitOperationAdd]]

```python
huggingface_hub.CommitOperationAdd(path_in_repo: str, path_or_fileobj: str | pathlib.Path | bytes | typing.BinaryIO)
```

[Nguồn](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/_commit_api.py#L141)

**Tham số:**

path_in_repo (`str`) : Đường dẫn tệp tương đối trong kho, ví dụ: `"checkpoints/1fec34a/weights.bin"`

path_or_fileobj (`str`, `Path`, `bytes`, hoặc `BinaryIO`) : Một trong các lựa chọn sau: - đường dẫn đến tệp cục bộ (dưới dạng `str` hoặc `pathlib.Path`) để tải lên - bộ đệm byte (`bytes`) chứa nội dung của tệp cần tải lên - một "đối tượng tệp" (lớp con của `io.BufferedIOBase`), thường được tạo bằng `open(path, "rb")`. Đối tượng này phải hỗ trợ các phương thức `seek()` và `tell()`.

**Lỗi:** ``ValueError``

- [`ValueError`](https://docs.python.org/3/library/exceptions.html#ValueError) -- Nếu `path_or_fileobj` không phải là một trong `str`, `Path`, `bytes` hoặc `io.BufferedIOBase`.
- [`ValueError`](https://docs.python.org/3/library/exceptions.html#ValueError) -- Nếu `path_or_fileobj` là `str` hoặc `Path` nhưng không phải là đường dẫn đến một tệp hiện có.
- [`ValueError`](https://docs.python.org/3/library/exceptions.html#ValueError) -- Nếu `path_or_fileobj` là một `io.BufferedIOBase` nhưng không hỗ trợ cả `seek()` và `tell()`.

Cấu trúc dữ liệu chứa thông tin cần thiết để tải lên tệp lên một kho trên Hub.

#### as_file[[huggingface_hub.CommitOperationAdd.as_file]]

```python
as_file(with_tqdm: bool = False)
```

[Nguồn](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/_commit_api.py#L223)

**Tham số:**

with_tqdm (`bool`, *tùy chọn*, mặc định là `False`) : Nếu là True, việc lặp qua đối tượng tệp sẽ hiển thị thanh tiến trình. Chỉ hoạt động nếu đối tượng dạng tệp là đường dẫn đến một tệp. Không hỗ trợ bytes thuần và buffer.

Một trình quản lý ngữ cảnh (context manager) trả về một đối tượng giống tệp (file-like object) cho phép đọc dữ liệu cơ bản phía sau `path_or_fileobj`.

Ví dụ:

```python
>>> operation = CommitOperationAdd(
...        path_in_repo="remote/dir/weights.h5",
...        path_or_fileobj="./local/weights.h5",
... )
CommitOperationAdd(path_in_repo='remote/dir/weights.h5', path_or_fileobj='./local/weights.h5')

>>> with operation.as_file() as file:
...     content = file.read()

>>> with operation.as_file(with_tqdm=True) as file:
...     while True:
...         data = file.read(1024)
...         if not data:
...              break
config.json: 100%|█████████████████████████| 8.19k/8.19k [00:02<00:00, 3.72kB/s]

>>> with operation.as_file(with_tqdm=True) as file:
...     httpx2.put(..., data=file)
config.json: 100%|█████████████████████████| 8.19k/8.19k [00:02<00:00, 3.72kB/s]
```

#### b64content[[huggingface_hub.CommitOperationAdd.b64content]]

```python
b64content()
```

[Nguồn](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/_commit_api.py#L275)

Nội dung được mã hóa base64 của `path_or_fileobj`

Trả về: `bytes`

#### huggingface_hub.CommitOperationDelete[[huggingface_hub.CommitOperationDelete]]

```python
huggingface_hub.CommitOperationDelete(path_in_repo: str, is_folder: typing.Union[bool, typing.Literal['auto']] = 'auto')
```

[Nguồn](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/_commit_api.py#L56)

**Tham số:**

path_in_repo (`str`) : Đường dẫn tệp tương đối trong repo, ví dụ: `"checkpoints/1fec34a/weights.bin"` cho một tệp hoặc `"checkpoints/1fec34a/"` cho một thư mục.

is_folder (`bool` hoặc `Literal["auto"]`, *tùy chọn*) : Xác định xem Thao tác Xóa có áp dụng cho thư mục hay không. Nếu là "auto", loại đường dẫn (tệp hoặc thư mục) sẽ được suy đoán tự động bằng cách kiểm tra xem đường dẫn có kết thúc bằng "/" (thư mục) hay không (tệp). Để đặt loại đường dẫn một cách rõ ràng, bạn có thể đặt `is_folder=True` hoặc `is_folder=False`.

Cấu trúc dữ liệu chứa thông tin cần thiết để xóa một tệp hoặc một thư mục khỏi kho trên Hub.

#### huggingface_hub.CommitOperationCopy[[huggingface_hub.CommitOperationCopy]]

```python
huggingface_hub.CommitOperationCopy(src_path_in_repo: str, path_in_repo: str, src_revision: str | None = None, src_repo_id: str | None = None, src_repo_type: str | None = None, _src_oid: str | None = None, _dest_oid: str | None = None, _is_duplicated: bool = False)
```

[Nguồn](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/_commit_api.py#L87)

**Tham số:**

src_path_in_repo (`str`) : Đường dẫn tệp tương đối trong kho của tệp cần sao chép, ví dụ `"checkpoints/1fec34a/weights.bin"`.

path_in_repo (`str`) : Đường dẫn tệp tương đối trong kho để sao chép tệp, ví dụ `"checkpoints/1fec34a/weights_copy.bin"`.

src_revision (`str`, *tùy chọn*) : Bản sửa git của tệp cần sao chép. Có thể là bất kỳ bản sửa git hợp lệ nào. Mặc định là bản sửa của commit đích.

src_repo_id (`str`, *tùy chọn*) : Kho nguồn để sao chép (ví dụ: `"username/source-model"`). Mặc định là kho đích (sao chép nội bộ kho).

src_repo_type (`str`, *tùy chọn*) : Kiểu của kho lưu trữ nguồn (`"model"`, `"dataset"` hoặc `"space"`). Bắt buộc khi `src_repo_id` được đặt.

Cấu trúc dữ liệu chứa thông tin cần thiết để sao chép một tệp trong kho trên Hub.

Cả tệp LFS và tệp thông thường đều được hỗ trợ. Tệp LFS được sao chép phía máy chủ trong khi tệp thông thường được tải xuống và tải lên lại như một phần của commit.

Bản sao giữa các kho được hỗ trợ bằng cách đặt `src_repo_id` và `src_repo_type`. Đối với bản sao LFS giữa các kho, các đối tượng LFS sẽ được nhân bản sang kho đích trước khi tạo commit. Thao tác này được xử lý tự động bởi [create_commit()](/docs/huggingface_hub/v2.4.0/vi/package_reference/hf_api#huggingface_hub.HfApi.create_commit). Lưu ý rằng bản sao giữa các kho chỉ hoạt động trong cùng một [storage region](https://huggingface.co/docs/hub/storage-regions); việc sao chép giữa các khu vực khác nhau không được hỗ trợ.

Lưu ý: bạn có thể kết hợp [CommitOperationCopy](/docs/huggingface_hub/v2.4.0/vi/package_reference/hf_api#huggingface_hub.CommitOperationCopy) và [CommitOperationDelete](/docs/huggingface_hub/v2.4.0/vi/package_reference/hf_api#huggingface_hub.CommitOperationDelete) để đổi tên một tệp LFS trên Hub.

## CommitScheduler[[huggingface_hub.CommitScheduler]]

#### huggingface_hub.CommitScheduler[[huggingface_hub.CommitScheduler]]

```python
huggingface_hub.CommitScheduler(repo_id: str, folder_path: str | pathlib.Path, every: int | float = 5, path_in_repo: str | None = None, repo_type: str | None = None, revision: str | None = None, private: bool | None = None, token: str | None = None, allow_patterns: list[str] | str | None = None, ignore_patterns: list[str] | str | None = None, squash_history: bool = False, hf_api: typing.Optional[ForwardRef('HfApi')] = None)
```

[Nguồn](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/_commit_scheduler.py#L30)

**Tham số:**

repo_id (`str`) : id của repo để commit.

folder_path (`str` hoặc `Path`) : Đường dẫn đến thư mục cục bộ để tải lên định kỳ.

every (`int` hoặc `float`, *tùy chọn*) : Số phút giữa mỗi lần commit. Mặc định là 5 phút.

path_in_repo (`str`, *tùy chọn*) : Đường dẫn tương đối của thư mục trong kho, ví dụ: `"checkpoints/"`. Mặc định là thư mục gốc của kho.

repo_type (`str`, *tùy chọn*) : Kiểu của kho cần commit. Mặc định là `model`.

revision (`str`, *tùy chọn*) : Phiên bản của kho cần commit. Mặc định là `main`.

private (`bool`, *tuỳ chọn*) : Có nên đặt kho thành riêng tư hay không. Nếu là `None` (mặc định), kho sẽ là công khai trừ khi mặc định của tổ chức là riêng tư. Giá trị này bị bỏ qua nếu kho đã tồn tại.

token (`str`, *tùy chọn*) : Token được sử dụng để cam kết vào kho. Mặc định là token đã được lưu trên máy.

allow_patterns (`list[str]` hoặc `str`, *tùy chọn*) : Nếu được cung cấp, chỉ các tệp khớp với ít nhất một mẫu sẽ được tải lên.

ignore_patterns (`list[str]` hoặc `str`, *tùy chọn*) : Nếu được cung cấp, các tệp khớp với bất kỳ mẫu nào sẽ không được tải lên.

squash_history (`bool`, *tuỳ chọn*) : Có nên nén lịch sử của kho sau mỗi lần commit hay không. Mặc định là `False`. Việc nén các commit hữu ích để tránh hiệu năng giảm khi kho trở nên quá lớn.

hf_api (`HfApi`, *tùy chọn*) : Khách hàng [HfApi](/docs/huggingface_hub/v2.4.0/vi/package_reference/hf_api#huggingface_hub.HfApi) được sử dụng để cam kết (commit) lên Hub. Có thể được thiết lập với các cài đặt tùy chỉnh (user agent, token,...).

Trình lập lịch để tải lên Hub một thư mục cục bộ theo các khoảng thời gian đều đặn (ví dụ: đẩy lên hub mỗi 5 phút).

Cách được khuyến nghị để sử dụng scheduler là dùng nó như một context manager. Điều này đảm bảo rằng scheduler được dừng đúng cách và commit cuối cùng được kích hoạt khi script kết thúc. Scheduler cũng có thể được dừng thủ công bằng phương thức `stop`. Xem [hướng dẫn upload](https://huggingface.co/docs/huggingface_hub/guides/upload#scheduled-uploads) để tìm hiểu thêm về cách sử dụng nó.

Ví dụ:
```py
>>> from pathlib import Path
>>> from huggingface_hub import CommitScheduler

# Scheduler uploads every 10 minutes
>>> csv_path = Path("watched_folder/data.csv")
>>> CommitScheduler(repo_id="test_scheduler", repo_type="dataset", folder_path=csv_path.parent, every=10)

>>> with csv_path.open("a") as f:
...     f.write("first line")

# Some time later (...)
>>> with csv_path.open("a") as f:
...     f.write("second line")
```

Ví dụ sử dụng trình quản lý ngữ cảnh:
```py
>>> from pathlib import Path
>>> from huggingface_hub import CommitScheduler

>>> with CommitScheduler(repo_id="test_scheduler", repo_type="dataset", folder_path="watched_folder", every=10) as scheduler:
...     csv_path = Path("watched_folder/data.csv")
...     with csv_path.open("a") as f:
...         f.write("first line")
...     (...)
...     with csv_path.open("a") as f:
...         f.write("second line")

# Scheduler is now stopped and last commit have been triggered
```

#### push_to_hub[[huggingface_hub.CommitScheduler.push_to_hub]]

```python
push_to_hub()
```

[Nguồn](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/_commit_scheduler.py#L204)

Đẩy thư mục lên Hub và trả về thông tin commit.

> [!WARNING]
> Phương thức này không được thiết kế để gọi trực tiếp. Nó được chạy ở nền bởi trình lập lịch, tuân theo cơ chế hàng đợi để tránh các lần commit đồng thời. Việc gọi trực tiếp phương thức này có thể dẫn đến các vấn đề về đồng thời.

Hành vi mặc định của `push_to_hub` là giả định một thư mục chỉ thêm (append-only). Phương thức này liệt kê tất cả các tệp trong thư mục và chỉ tải lên các tệp đã bị thay đổi. Nếu không tìm thấy thay đổi nào, phương thức sẽ trả về mà không thực hiện bất kỳ cam kết (commit) nào. Nếu bạn muốn thay đổi hành vi này, bạn có thể kế thừa từ [CommitScheduler](/docs/huggingface_hub/v2.4.0/vi/package_reference/hf_api#huggingface_hub.CommitScheduler) và ghi đè phương thức này. Điều này có thể hữu ích, chẳng hạn như để nén dữ liệu thành một tệp duy nhất trước khi cam kết. Để biết thêm chi tiết và ví dụ, hãy xem [hướng dẫn tích hợp](https://huggingface.co/docs/huggingface_hub/main/en/guides/upload#scheduled-uploads) của chúng tôi.

#### stop[[huggingface_hub.CommitScheduler.stop]]

```python
stop()
```

[Nguồn](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/_commit_scheduler.py#L157)

Dừng trình lập lịch.

Trình lập lịch đã dừng không thể khởi động lại. Chủ yếu dùng cho mục đích kiểm thử.

#### trigger[[huggingface_hub.CommitScheduler.trigger]]

```python
trigger()
```

[Nguồn](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/_commit_scheduler.py#L181)

Kích hoạt `push_to_hub` và trả về một future.

Phương thức này được gọi tự động mỗi `every` phút. Bạn cũng có thể gọi thủ công để kích hoạt một commit ngay lập tức, mà không cần chờ đến lần commit được lên lịch tiếp theo.