# Chuyển sang huggingface_hub v2.0

`huggingface_hub` v2.0 thay thế phụ thuộc HTTP bằng [`httpx2`](https://httpx2.pydantic.dev/) và loại bỏ các API 1.x đã bị ngừng hỗ trợ. Các client HTTP và ngoại lệ giờ đây được lấy từ một gói riêng biệt.

Để hỗ trợ cả `huggingface_hub` v1.x (bắt đầu từ v1.30.0) và v2.x, hãy import module HTTP từ `huggingface_hub.utils`:

```python
from huggingface_hub.utils import get_session, httpx

try:
    response = get_session().get("https://huggingface.co/api/models/gpt2")
    response.raise_for_status()
except httpx.HTTPError:
    ...
```

Sử dụng cùng lệnh import này khi tạo các client tùy chỉnh cho [set_client_factory()](/docs/huggingface_hub/v2.4.0/vi/package_reference/utilities#huggingface_hub.set_client_factory) hoặc [set_async_client_factory()](/docs/huggingface_hub/v2.4.0/vi/package_reference/utilities#huggingface_hub.set_async_client_factory). Các client và ngoại lệ từ gói HTTP cũ là khác biệt so với những thứ trong `httpx2` và không thể thay thế cho nhau.

`httpx2` sử dụng kho lưu trữ chứng chỉ tin cậy của hệ điều hành theo mặc định. Các gói CA tùy chỉnh được cấu hình bằng `SSL_CERT_FILE` hoặc `SSL_CERT_DIR` vẫn được hỗ trợ. Cấu hình ghi log nên nhắm đến `httpx2` và `httpcore2` thay vì các tên logger cũ. Xem [hướng dẫn di chuyển upstream](https://httpx2.pydantic.dev/migration/) để biết thêm chi tiết.

Extra `oauth` hiện yêu cầu `authlib>=1.8.0` để hỗ trợ `httpx2`.

## Đã xóa các API không còn được hỗ trợ

- Sử dụng `upload_folder` thay vì `upload_large_folder` hoặc `HfApi.upload_large_folder`.
- Sử dụng `duplicate_repo`, `set_space_volumes` và `delete_space_volumes` thay vì `duplicate_space`, `request_space_storage` và `delete_space_storage`.
- Sử dụng `parse_hf_uri` thay vì `repo_type_and_id_from_hf_id`, và `list_models(search=...)` thay vì `model_name=...`.
- Sử dụng `space_volumes` thay vì `space_storage` trong `create_repo` và `duplicate_repo`.
- Sử dụng `InferenceEndpointType.AUTHENTICATED` hoặc `type="authenticated"` thay vì `PROTECTED` hoặc `type="protected"`.
- Sử dụng `text_generation(stop=...)` thay vì `stop_sequences=...`, và truyền một chuỗi token hoặc `None` cho `InferenceClient` thay vì một giá trị boolean.
- Sử dụng `hf` thay vì `huggingface-cli`; `hf repo` và `hf repo-files delete` được thay thế bằng `hf repos` và `hf repos delete-files`.
- Sử dụng `hf upload` thay vì `hf upload-large-folder`; sử dụng `--volume` thay vì `--storage` cho việc tạo và nhân bản kho, và `--status` hoặc `--label` thay vì `hf jobs ps --filter`.
- Tùy chọn `--claude` đã bị hủy bỏ trong `hf skills add` và `hf skills update` đã được gỡ bỏ. Các Skills sẽ được cài đặt tự động cho Claude Code.

Để có thêm ngữ cảnh, hãy xem dự án [`httpx2`](https://github.com/pydantic/httpx2), tài liệu [`httpx2`](https://pydantic.dev/docs/httpx2/), [hướng dẫn chuyển đổi từ `httpx` sang `httpx2`](https://httpx2.pydantic.dev/migration/) của upstream, và kế hoạch chuyển đổi [`huggingface_hub`](https://github.com/huggingface/huggingface_hub/issues/4802).