1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
|
<!--⚠️ Note that this file is in Markdown but contains specific syntax for our doc-builder (similar to MDX) that may not be
rendered properly in your Markdown viewer.
-->
# HfApi Client[[hfapi-client]]
아래는 허깅 페이스 Hub의 API를 위한 파이썬 래퍼인 `HfApi` 클래스에 대한 문서입니다.
`HfApi`의 모든 메서드는 패키지의 루트에서 직접 접근할 수 있습니다. 두 접근 방식은 아래에서 자세히 설명합니다.
루트 메서드를 사용하는 것이 더 간단하지만 [`HfApi`] 클래스를 사용하면 더 유연하게 사용할 수 있습니다.
특히 모든 HTTP 호출에서 재사용할 토큰을 전달할 수 있습니다.
이 방식은 토큰이 머신에 유지되지 않기 때문에 `huggingface-cli login` 또는 [`login`]를 사용하는 방식과는 다르며,
다른 엔드포인트를 제공하거나 사용자정의 에이전트를 구성할 수도 있습니다.
```python
from huggingface_hub import HfApi, list_models
# 루트 메서드를 사용하세요.
models = list_models()
# 또는 HfApi client를 구성하세요.
hf_api = HfApi(
endpoint="https://huggingface.co", # 비공개 Hub 엔드포인트를 지정할 수 있습니다.
token="hf_xxx", # 토큰은 머신에 유지되지 않습니다.
)
models = hf_api.list_models()
```
## HfApi[[huggingface_hub.HfApi]]
[[autodoc]] HfApi
## API Dataclasses[[api-dataclasses]]
### AccessRequest[[huggingface_hub.hf_api.AccessRequest]]
[[autodoc]] huggingface_hub.hf_api.AccessRequest
### CommitInfo[[huggingface_hub.CommitInfo]]
[[autodoc]] huggingface_hub.hf_api.CommitInfo
### DatasetInfo[[huggingface_hub.hf_api.DatasetInfo]]
[[autodoc]] huggingface_hub.hf_api.DatasetInfo
### GitRefInfo[[huggingface_hub.GitRefInfo]]
[[autodoc]] huggingface_hub.hf_api.GitRefInfo
### GitCommitInfo[[huggingface_hub.GitCommitInfo]]
[[autodoc]] huggingface_hub.hf_api.GitCommitInfo
### GitRefs[[huggingface_hub.GitRefs]]
[[autodoc]] huggingface_hub.hf_api.GitRefs
### ModelInfo[[huggingface_hub.hf_api.ModelInfo]]
[[autodoc]] huggingface_hub.hf_api.ModelInfo
### RepoSibling[[huggingface_hub.hf_api.RepoSibling]]
[[autodoc]] huggingface_hub.hf_api.RepoSibling
### RepoFile[[huggingface_hub.hf_api.RepoFile]]
[[autodoc]] huggingface_hub.hf_api.RepoFile
### RepoUrl[[huggingface_hub.RepoUrl]]
[[autodoc]] huggingface_hub.hf_api.RepoUrl
### SafetensorsRepoMetadata[[huggingface_hub.utils.SafetensorsRepoMetadata]]
[[autodoc]] huggingface_hub.utils.SafetensorsRepoMetadata
### SafetensorsFileMetadata[[huggingface_hub.utils.SafetensorsFileMetadata]]
[[autodoc]] huggingface_hub.utils.SafetensorsFileMetadata
### SpaceInfo[[huggingface_hub.hf_api.SpaceInfo]]
[[autodoc]] huggingface_hub.hf_api.SpaceInfo
### TensorInfo[[huggingface_hub.utils.TensorInfo]]
[[autodoc]] huggingface_hub.utils.TensorInfo
### User[[huggingface_hub.User]]
[[autodoc]] huggingface_hub.hf_api.User
### UserLikes[[huggingface_hub.UserLikes]]
[[autodoc]] huggingface_hub.hf_api.UserLikes
## CommitOperation[[huggingface_hub.CommitOperationAdd]]
[`CommitOperation`]에 지원되는 값은 다음과 같습니다:
[[autodoc]] CommitOperationAdd
[[autodoc]] CommitOperationDelete
[[autodoc]] CommitOperationCopy
## CommitScheduler[[huggingface_hub.CommitScheduler]]
[[autodoc]] CommitScheduler
|
