Hub Python Library documentation
Quản lý thời gian chạy Space của bạn
Quản lý thời gian chạy Space của bạn
Xem trang tài liệu HfApi để tham khảo các phương thức quản lý Space của bạn trên Hub.
- Lấy runtime hiện tại: get_space_runtime()
- Lấy nhật ký build hoặc chạy: fetch_space_logs()
- Quản lý thông tin bí mật: add_space_secret() và delete_space_secret()
- Quản lý phần cứng: request_space_hardware()
- Quản lý trạng thái: pause_space(), restart_space(), set_space_sleep_time()
- Chờ cho đến khi Space sẵn sàng: wait_for_space()
- Kiểm tra hạn mức ZeroGPU của bạn: get_zero_gpu_quota()
Cấu trúc dữ liệu
SpaceRuntime
lớp huggingface_hub.SpaceRuntime
< source >( data: dict )
Tham số
- stage (
str) — Giai đoạn hiện tại của space. Ví dụ: RUNNING. - hardware (
strhoặcNone) — Phần cứng hiện tại của space. Ví dụ: “cpu-basic”. Có thể làNonenếu Space đang ở trạng tháiBUILDINGlần đầu tiên. - requested_hardware (
strhoặcNone) — Phần cứng được yêu cầu. Có thể khác vớihardware, đặc biệt nếu yêu cầu vừa được thực hiện. Ví dụ: “t4-medium”. Có thể làNonenếu chưa có phần cứng nào được yêu cầu. - sleep_time (
intorNone) — Số giây Space sẽ được giữ hoạt động sau yêu cầu cuối cùng. Mặc định (nếu giá trị làNone), Space sẽ không bao giờ ngủ nếu đang chạy trên phần cứng nâng cấp, trong khi nó sẽ ngủ sau 48 giờ trên phần cứng ‘cpu-basic’ miễn phí. Để biết thêm chi tiết, xem https://huggingface.co/docs/hub/spaces-gpus#sleep-time. - volumes (
list[Volume]hoặcNone) — Danh sách các volume được gắn trong Space. Mỗi volume là một đối tượng Volume mô tả loại, nguồn, đường dẫn gắn và các cài đặt tùy chọn.Nonenếu không có volume nào được gắn. - raw (
dict) — Phản hồi thô từ máy chủ. Chứa thêm thông tin về thời gian chạy của Space như số lượng bản sao, số lượng cpu, kích thước bộ nhớ,…
Chứa thông tin về thời gian chạy hiện tại của một Space.
SpaceHardware
lớp huggingface_hub.SpaceHardware
< source >( valuenames = Nonemodule = Nonequalname = Nonetype = Nonestart = 1 )
Danh sách các phần cứng có sẵn để chạy Space của bạn trên Hub.
Trích từ https://github.com/huggingface-internal/moon-landing/blob/main/server/repo_types/SpaceHardwareFlavor.ts (đường dẫn riêng tư).
SpaceStage
lớp huggingface_hub.SpaceStage
< source >( valuenames = Nonemodule = Nonequalname = Nonetype = Nonestart = 1 )
Danh sách các giai đoạn có thể có của một Space trên Hub.
Trích từ https://github.com/huggingface/moon-landing/blob/main/server/repo_types/SpaceInfo.ts#L61 (url riêng).
SpaceStorage
lớp huggingface_hub.SpaceStorage
< source >( valuenames = Nonemodule = Nonequalname = Nonetype = Nonestart = 1 )
Danh sách các loại lưu trữ bền vững có sẵn cho Space của bạn trên Hub.
Trích từ https://github.com/huggingface/moon-landing/blob/main/server/repo_types/SpaceHardwareFlavor.ts#L24 (đường dẫn riêng tư).
SpaceVariable
lớp huggingface_hub.SpaceVariable
< source >( key: strvalues: dict )
Tham số
- key (
str) — Khóa biến. Ví dụ:"MODEL_REPO_ID" - value (
str) — Giá trị của biến. Ví dụ:"the_model_repo_id". - description (
strhoặc None) — Mô tả của biến. Ví dụ:"Model Repo ID of the implemented model". - updatedAt (
datetimehoặc None) — datetime của lần cập nhật cuối cùng của biến (nếu biến đã được cập nhật ít nhất một lần).
Chứa thông tin về các biến hiện tại của một Space.
SpaceTemplate
lớp huggingface_hub.SpaceTemplate
< source >( data: dict )
Tham số
- name (
str) — Tên thân thiện với người dùng của template (ví dụ:"JupyterLab","chatbot"). - repo_id (
str) — Repo id của Space mẫu (ví dụ:"SpacesExamples/jupyterlab"). - sdk (
str) — SDK mà template được xây dựng bằng (ví dụ:"gradio","docker","static"). - preferred_private (
bool) — Xác định xem các Spaces được tạo từ mẫu này có được khuyến nghị là riêng tư hay không.
Chứa thông tin về một mẫu Space có sẵn trên Hub.
Được trả về bởi HfApi.list_space_templates(). Tham số repo_id có thể được truyền dưới dạng space_template cho HfApi.create_repo() để khởi tạo một Space mới từ mẫu đó.
ZeroGpuQuota
lớp huggingface_hub.ZeroGpuQuota
< source >( data: dict )
Tham số
- base (
float) — Tổng hạn mức, tính bằng giây GPU. - remaining (
float) — Hạn mức còn lại, tính bằng giây GPU. - resets_at (
datetimehoặcNone) — Thời điểm hạn mức sẽ được đặt lại.Nonenếu hạn mức chưa được sử dụng. - overquota_used (
floathoặcNone) — Số giây GPU vượt hạn mức (có tính phí) đã tiêu thụ sau khi hạn mức cơ bản bị cạn kiệt. Người dùng PRO, Team và Enterprise có thể mua thêm tín dụng để vượt quá hạn mức cơ bản tại https://huggingface.co/settings/billing?add-credits=true.
Chứa thông tin về hạn mức ZeroGPU của người dùng đã xác thực.
Hạn mức ZeroGPU sẽ bị tiêu thụ mỗi khi bạn sử dụng một Space ZeroGPU (từ giao diện người dùng hoặc thông qua API của nó) và được đặt lại theo định kỳ. Xem https://huggingface.co/docs/hub/spaces-zerogpu để biết thêm chi tiết.
Được trả về bởi HfApi.get_zero_gpu_quota().