Hub Python Library documentation
Mengelola runtime Space Anda
Mengelola runtime Space Anda
Periksa halaman dokumentasi HfApi untuk referensi metode mengelola Space Anda di Hub.
- Ambil runtime saat ini: get_space_runtime()
- Ambil log build atau run: fetch_space_logs()
- Kelola rahasia: add_space_secret() dan delete_space_secret()
- Kelola perangkat keras: request_space_hardware()
- Kelola status: pause_space(), restart_space(), set_space_sleep_time()
- Tunggu hingga Space siap: wait_for_space()
- Periksa kuota ZeroGPU Anda: get_zero_gpu_quota()
Struktur data
SpaceRuntime
kelas huggingface_hub.SpaceRuntime
< source >( data: dict )
Parameter
- stage (
str) — Tahap saat ini dari space. Contoh: RUNNING. - hardware (
stratauNone) — Hardware saat ini dari space. Contoh: “cpu-basic”. Bisa menjadiNonejika Space sedangBUILDINGuntuk pertama kalinya. - requested_hardware (
stratauNone) — Hardware yang diminta. Dapat berbeda darihardware, terutama jika permintaan baru saja dibuat. Contoh: “t4-medium”. Dapat berupaNonejika belum ada hardware yang diminta. - sleep_time (
intatauNone) — Jumlah detik Space akan tetap aktif setelah permintaan terakhir. Secara default (jika nilainyaNone), Space tidak akan pernah masuk mode tidur jika berjalan di perangkat keras yang sudah ditingkatkan, sedangkan di perangkat keras gratis ‘cpu-basic’, Space akan masuk mode tidur setelah 48 jam. Untuk detail lebih lanjut, lihat https://huggingface.co/docs/hub/spaces-gpus#sleep-time. - volumes (
list[Volume]atauNone) — Daftar volume yang dipasang di Space. Setiap volume adalah objek Volume yang menjelaskan jenisnya, sumber, jalur pemasangan, dan pengaturan opsional.Nonejika tidak ada volume yang terpasang. - raw (
dict) — Respons mentah dari server. Berisi informasi lebih lanjut tentang runtime Space seperti jumlah replika, jumlah cpu, ukuran memori,…
Berisi informasi tentang runtime saat ini dari sebuah Space.
SpaceHardware
kelas huggingface_hub.SpaceHardware
< source >( valuenames = Nonemodule = Nonequalname = Nonetype = Nonestart = 1 )
Daftar perangkat keras yang tersedia untuk menjalankan Space Anda di Hub.
Diambil dari https://github.com/huggingface-internal/moon-landing/blob/main/server/repo_types/SpaceHardwareFlavor.ts (url privat).
SpaceStage
kelas huggingface_hub.SpaceStage
< source >( valuenames = Nonemodule = Nonequalname = Nonetype = Nonestart = 1 )
Enumerasi kemungkinan tahap sebuah Space di Hub.
Diambil dari https://github.com/huggingface/moon-landing/blob/main/server/repo_types/SpaceInfo.ts#L61 (url privat).
SpaceStorage
kelas huggingface_hub.SpaceStorage
< source >( valuenames = Nonemodule = Nonequalname = Nonetype = Nonestart = 1 )
Enumerasi penyimpanan persisten yang tersedia untuk Space Anda di Hub.
Diambil dari https://github.com/huggingface/moon-landing/blob/main/server/repo_types/SpaceHardwareFlavor.ts#L24 (url privat).
SpaceVariable
kelas huggingface_hub.SpaceVariable
< source >( key: strvalues: dict )
Parameter
- key (
str) — Kunci variabel. Contoh:"MODEL_REPO_ID" - value (
str) — Nilai variabel. Contoh:"the_model_repo_id". - description (
stratau None) — Deskripsi variabel. Contoh:"Model Repo ID of the implemented model". - updatedAt (
datetimeatau None) — datetime dari pembaruan terakhir variabel (jika variabel telah diperbarui setidaknya sekali).
Berisi informasi tentang variabel saat ini dari sebuah Space.
SpaceTemplate
kelas huggingface_hub.SpaceTemplate
< source >( data: dict )
Parameter
- name (
str) — Nama template yang mudah dibaca manusia (mis."JupyterLab","chatbot"). - repo_id (
str) — Repo id dari template Space (mis."SpacesExamples/jupyterlab"). - sdk (
str) — SDK yang digunakan untuk membangun template (misalnya"gradio","docker","static"). - preferred_private (
bool) — Apakah Spaces yang dibuat dari template ini disarankan untuk bersifat privat.
Berisi informasi tentang template Space yang tersedia di Hub.
Dikembalikan oleh HfApi.list_space_templates(). repo_id dapat diteruskan sebagai space_template ke HfApi.create_repo() untuk membuat Space baru dari template tersebut.
ZeroGpuQuota
kelas huggingface_hub.ZeroGpuQuota
< source >( data: dict )
Parameter
- base (
float) — Total kuota, dalam detik-GPU. - remaining (
float) — Kuota tersisa, dalam detik-GPU. - resets_at (
datetimeatauNone) — Tanggal saat kuota akan direset.Nonejika kuota belum digunakan. - overquota_used (
floatatauNone) — Detik-GPU overquota (berbayar) yang dikonsumsi setelah kuota dasar habis. Pengguna PRO, Team, dan Enterprise dapat membeli kredit untuk melampaui kuota dasar di https://huggingface.co/settings/billing?add-credits=true.
Berisi informasi tentang kuota ZeroGPU dari pengguna yang terautentikasi.
Kuota ZeroGPU dikonsumsi setiap kali Anda menggunakan Space ZeroGPU (dari UI atau melalui API-nya) dan direset secara berkala. Lihat https://huggingface.co/docs/hub/spaces-zerogpu untuk detail lebih lanjut.
Dikembalikan oleh HfApi.get_zero_gpu_quota().