Hub documentation
Trang mô hình trước khi phát hành
Trang mô hình trước khi phát hành
Tính năng này dành cho các tổ chức có gói Enterprise trở lên — hoặc liên hệ với chúng tôi.
Trang mô hình tiền phát hành cho phép tổ chức của bạn công bố một mô hình sắp ra mắt trong khi nó vẫn còn ở trạng thái riêng tư. Thay vì trang 404, khách truy cập sẽ thấy một trang công bố chuyên dụng với bộ đếm ngược trực tiếp đến ngày phát hành và nút Thích và Thông báo khi phát hành, để họ có thể nhận được thông báo qua email ngay khi mô hình của bạn được ra mắt. Khi bạn công khai mô hình, nó được coi là đã phát hành và trang công bố sẽ được thay thế bằng thẻ mô hình.
Điều kiện đủ
- Tổ chức của bạn phải được đăng ký gói Enterprise hoặc cao hơn.
- Kho mô hình phải nằm trong không gian tên của tổ chức (ví dụ:
my-org/my-upcoming-model). Các kho do người dùng sở hữu không đủ điều kiện. - Kho mô hình phải là riêng tư. Việc công khai mô hình sẽ phát hành nó (xem bên dưới).
Công bố mô hình của bạn
Để chuyển trang của một mô hình riêng tư thành trang phát hành trước, hãy thêm trường release_date vào phần metadata của thẻ mô hình (phần YAML ở đầu tệp README.md của kho):
---
release_date: 2026-07-27
description: "A short tagline shown on the pre-release page"
---Trường release_date chấp nhận một ngày ở định dạng YAML, hoặc một mốc thời gian ISO 8601 được đặt trong dấu nháy nếu bạn muốn nhắm đến một thời điểm cụ thể:
release_date: "2026-07-27T15:00:00Z"Các giá trị không hợp lệ sẽ bị trình xác thực metadata từ chối và bỏ qua. Ngày không nhất thiết phải là ngày trong tương lai: với ngày trong quá khứ, trang sẽ hiển thị “Coming very soon” thay vì bộ đếm ngược. Ngày được hiển thị theo múi giờ UTC.
Một số trường metadata tùy chọn cho phép bạn tùy chỉnh trang pre-release:
| Trường | Hiệu ứng |
|---|---|
description | Câu slogan chính của trang trước khi phát hành, đồng thời được dùng làm mô tả meta của trang. |
pretty_name | Tên dễ đọc hiển thị thay cho tên kho trong tiêu đề hero. |
approximate_eta | Đặt thành true nếu release_date chỉ là ước tính: ngày đó sẽ được gắn nhãn Current ETA. |
thumbnail | URL của hình ảnh chia sẻ mạng xã hội tùy chỉnh, thay thế cho hình ảnh được tạo tự động. |
---
release_date: 2026-07-27
approximate_eta: true
pretty_name: "My Upcoming Model"
description: "A short tagline shown on the pre-release page"
---Một vài điều cần biết thêm:
- Phần thân markdown của thẻ mô hình của bạn (mọi thứ bên dưới metadata YAML) là những gì khách truy cập đọc trên trang pre-release — hãy sử dụng phần này để mô tả những gì sắp ra mắt, hiển thị các teaser, liên kết đến một bài báo, v.v.
- Bạn không cần tải lên bất kỳ trọng số nào ngay bây giờ: kho chỉ cần
README.mdtrong suốt thời gian công bố. Hãy tải lên các tệp mô hình khi bạn sẵn sàng. - Sau khi bạn chỉnh sửa metadata của model card, trang pre-release có thể mất vài phút để bật hoặc tắt.
Những gì khách truy cập nhìn thấy
Trong khi model đang ở trạng thái private và release_date đã được thiết lập (và tổ chức của bạn đủ điều kiện), khách truy cập sẽ thấy trang pre-release thay vì trang 404:
- Một hero có nhãn Sắp phát hành, tên mô hình, khẩu hiệu của bạn và đếm ngược trực tiếp đến ngày phát hành. Màu sắc của hero được suy ra từ avatar của tổ chức bạn.
- Nút Thích và Thông báo khi phát hành: khi nhấp vào, nút này sẽ đánh dấu thích kho và đăng ký cho người dùng nhận thông báo qua email về bản phát hành. Người dùng cần đăng nhập, và việc bỏ thích mô hình sẽ hủy đăng ký.
- Nội dung thẻ mô hình.
- Thanh bên hiển thị số lượt thích (dưới dạng người dùng đang chờ phát hành) kèm theo những người thích gần nhất, ngày phát hành dự kiến và các mô hình mới nhất của tổ chức bạn.
- Ảnh thu nhỏ dùng riêng cho chia sẻ mạng xã hội, sử dụng cùng màu sắc với phần hero.

Trang pre-release hiển thị nội dung model card của bạn — mọi thứ bạn viết trong phần thân của
README.mdđều công khai khi thông báo đang được đăng, bao gồm cả các hình ảnh và video được tham chiếu. Phần còn lại của repository vẫn ở chế độ riêng tư: các tệp, thảo luận và quyền truy cập API vẫn bị giới hạn cho thành viên, và model không được liệt kê công khai.
Khi đếm ngược về zero, trang hiển thị “Sắp ra mắt” — trang trước khi phát hành sẽ được giữ nguyên cho đến khi bạn công khai mô hình.
Những gì thành viên nhìn thấy
Mọi người có quyền đọc kho lưu trữ vẫn tiếp tục xem trang mô hình thông thường, vì vậy nhóm của bạn có thể tiếp tục quản lý tệp và cài đặt trong khi thông báo đang được hiển thị:
- Một banner trên trang mô hình cho biết mô hình đang ở giai đoạn pre-release. Nhấp vào Xem trước trang — hoặc thêm
?previewvào URL của mô hình — để kiểm tra những gì khách truy cập nhìn thấy. - Trong danh sách mô hình, mô hình được hiển thị kèm huy hiệu Pre-release.

Thông báo cho người đăng ký của bạn khi phát hành
Khi bạn sẵn sàng phát hành:
- Đẩy các tệp mô hình lên kho lưu trữ.
- Đặt mô hình thành công khai. Thao tác này sẽ phát hành mô hình: trang pre-release sẽ trở thành trang mô hình thông thường — không cần xóa trường
release_date. - Thành viên repo có quyền ghi sẽ thấy một banner ghi “N users are waiting to be notified about this release”, kèm nút Send release notifications.
- Nhấp vào Gửi thông báo phát hành để gửi email cho từng người đăng ký rằng model của bạn hiện đã có trên Hugging Face.

Thông báo sẽ không được gửi tự động khi mô hình trở thành công khai: bạn tự chọn thời điểm gửi. Một số điều cần biết:
- Người đăng ký là những người đã thích mô hình khi nó đang ở giai đoạn trước khi phát hành, do đó số lượng hiển thị trên banner có thể thấp hơn tổng số lượt thích.
- Mỗi người đăng ký sẽ nhận được email tối đa một lần, và banner sẽ biến mất sau khi các thông báo được gửi đi.
- Thông báo tuân thủ thiết lập thông báo của từng người dùng (“Một bản phát hành bạn đã đăng ký đã có sẵn”).
Những điều cần lưu ý
- Trang vẫn tồn tại sau ngày dự kiến: việc đến ngày phát hành không tự động gỡ trang pre-release; hãy công khai mô hình để phát hành và chuyển lại về trang mô hình thông thường.
- Việc công khai mô hình chính là bước phát hành: thông báo phát hành chỉ có thể được gửi đi sau khi mô hình đã được công khai.
- Việc xóa
release_datetrong khi model vẫn ở trạng thái private sẽ gỡ trang pre-release xuống: khách truy cập sẽ lại thấy trang 404, giống như với bất kỳ model private nào. - Đặt lại model về trạng thái riêng tư (trong khi
release_datevẫn được đặt) sẽ bật lại trang pre-release.