Space 런타임 관리
Hub에서 Space를 관리하는 메서드에 대한 참조는 HfApi 문서 페이지를 확인하세요.
- 현재 런타임 가져오기: get_space_runtime()
- 빌드 또는 실행 로그 가져오기: fetch_space_logs()
- 비밀 정보 관리: add_space_secret() 및 delete_space_secret()
- 하드웨어 관리: request_space_hardware()
- 상태 관리: pause_space(), restart_space(), set_space_sleep_time()
- Space가 준비될 때까지 대기: wait_for_space()
- ZeroGPU 할당량을 확인하세요: get_zero_gpu_quota()
데이터 구조
SpaceRuntime
class huggingface_hub.SpaceRuntime
< source >( data: dict )
매개변수
- stage (
str) — 현재 space의 단계입니다. 예: RUNNING. - hardware (
str또는None) — Space의 현재 하드웨어입니다. 예: “cpu-basic”. Space가 처음BUILDING상태일 경우None일 수 있습니다. - requested_hardware (
str또는None) — 요청된 하드웨어입니다. 요청이 방금 이루어진 경우hardware와 다를 수 있습니다. 예: “t4-medium”. 아직 하드웨어가 요청되지 않은 경우None일 수 있습니다. - sleep_time (
int또는None) — 마지막 요청 이후 Space가 유지되는 초 수입니다. 기본값(값이None인 경우)으로, 업그레이드된 하드웨어에서 실행 중이라면 Space는 절대 수면 상태로 전환되지 않으며, 무료 ‘cpu-basic’ 하드웨어에서는 48시간 후 수면 상태로 전환됩니다. 자세한 내용은 https://huggingface.co/docs/hub/spaces-gpus#sleep-time을 참조하세요. - volumes (
list[Volume]또는None) — Space에 마운트된 볼륨 목록입니다. 각 볼륨은 유형, 소스, 마운트 경로 및 선택적 설정을 설명하는 Volume 객체입니다. 볼륨이 연결되어 있지 않으면None입니다. - raw (
dict) — 서버에서 반환된 원시 응답입니다. Space 런타임에 대한 추가 정보(예: 리플리카 수, CPU 수, 메모리 크기 등)를 포함합니다.
Space의 현재 런타임에 대한 정보를 포함합니다.
SpaceHardware
class huggingface_hub.SpaceHardware
< source >( valuenames = Nonemodule = Nonequalname = Nonetype = Nonestart = 1 )
Hub에서 Space를 실행할 수 있는 하드웨어 목록
https://github.com/huggingface-internal/moon-landing/blob/main/server/repo_types/SpaceHardwareFlavor.ts(비공개 URL)에서 가져왔습니다.
SpaceStage
class huggingface_hub.SpaceStage
< source >( valuenames = Nonemodule = Nonequalname = Nonetype = Nonestart = 1 )
Hub의 Space에서 가능한 단계의 열거형입니다.
https://github.com/huggingface/moon-landing/blob/main/server/repo_types/SpaceInfo.ts#L61 (private url)에서 가져왔습니다.
SpaceStorage
class huggingface_hub.SpaceStorage
< source >( valuenames = Nonemodule = Nonequalname = Nonetype = Nonestart = 1 )
Hub의 Space에서 사용할 수 있는 영속적 스토리지의 목록
Taken from https://github.com/huggingface/moon-landing/blob/main/server/repo_types/SpaceHardwareFlavor.ts#L24 (private url).
SpaceVariable
class huggingface_hub.SpaceVariable
< source >( key: strvalues: dict )
Space의 현재 변수에 대한 정보를 포함합니다.
SpaceTemplate
class huggingface_hub.SpaceTemplate
< source >( data: dict )
Hub에서 사용할 수 있는 Space 템플릿에 대한 정보를 포함합니다.
HfApi.list_space_templates()에서 반환됩니다. repo_id를 HfApi.create_repo()의 space_template으로 전달하여 해당 템플릿에서 새로운 Space를 생성할 수 있습니다.
ZeroGpuQuota
class huggingface_hub.ZeroGpuQuota
< source >( data: dict )
매개변수
- base (
float) — GPU-초 단위의 총 할당량입니다. - remaining (
float) — GPU-초 단위로 남은 할당량입니다. - resets_at (
datetime또는None) — 할당이 리셋되는 날짜입니다. 할당이 아직 사용되지 않은 경우None입니다. - overquota_used (
float또는None) — 기본 할당량이 소진된 후 소비된 과금 대상 GPU-초입니다. PRO, Team 및 Enterprise 사용자는 https://huggingface.co/settings/billing?add-credits=true에서 크레딧을 구매하여 기본 할당량을 초과할 수 있습니다.
인증된 사용자의 ZeroGPU 할당량에 대한 정보를 포함합니다.
ZeroGPU Space를 사용할 때마다(UI 또는 해당 API를 통해) ZeroGPU 할당량이 소모되며, 주기적으로 초기화됩니다. 자세한 내용은 https://huggingface.co/docs/hub/spaces-zerogpu를 참조하세요.
HfApi.get_zero_gpu_quota()에서 반환됩니다.