# HfApi İstemcisi Aşağıda, Hugging Face Hub API'si için bir Python sarmalayıcısı olarak hizmet veren `HfApi` sınıfının belgeleri yer almaktadır. `HfApi` sınıfındaki tüm yöntemler, paketin kökünden de doğrudan erişilebilir. Her iki yaklaşım da aşağıda ayrıntılı olarak açıklanmıştır. Kök yöntemi kullanmak daha doğrudan bir yol olmakla birlikte [HfApi](/docs/huggingface_hub/v2.4.0/tr/package_reference/hf_api#huggingface_hub.HfApi) sınıfı size daha fazla esneklik sunar. Özellikle, tüm HTTP çağrılarında yeniden kullanılacak bir token iletebilirsiniz. Bu, tokenın makinede kalıcı olarak saklanmaması nedeniyle `hf auth login` veya [login()](/docs/huggingface_hub/v2.4.0/tr/package_reference/authentication#huggingface_hub.login) komutlarından farklıdır. Ayrıca farklı bir uç nokta (endpoint) belirtmek veya özel bir kullanıcı-ajanı (user-agent) yapılandırmak da mümkündür. ```python from huggingface_hub import HfApi, list_models # Use root method models = list_models() # Or configure a HfApi client hf_api = HfApi( endpoint="https://huggingface.co", # Can be a Private Hub endpoint. token="hf_xxx", # Token is not persisted on the machine. ) models = hf_api.list_models() ``` ## HfApi[[huggingface_hub.HfApi]] #### huggingface_hub.HfApi[[huggingface_hub.HfApi]] ```python huggingface_hub.HfApi(endpoint: str | None = None, token: str | bool | None = None, library_name: str | None = None, library_version: str | None = None, user_agent: dict | str | None = None, headers: dict[str, str] | None = None) ``` [Kaynak](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L2127) **Parametreler:** endpoint (`str`, *isteğe bağlı*) : Hub'un uç noktası. Varsayılan olarak . token (`bool` veya `str`, *isteğe bağlı*) : Geçerli bir kullanıcı erişim belirteci (dize). Varsayılan olarak, kimlik doğrulama için önerilen yöntem olan yerel olarak kaydedilmiş belirteç kullanılır (bkz. https://huggingface.co/docs/huggingface_hub/quick-start#authentication). Kimlik doğrulamayı devre dışı bırakmak için `False` geçirin. library_name (`str`, *isteğe bağlı*) : HTTP isteğini yapan kütüphanenin adı. user-agent başlığına eklenecektir. Örnek: `"transformers"`. library_version (`str`, *isteğe bağlı*) : HTTP isteğini yapan kütüphanenin sürümü. user-agent başlığına eklenecektir. Örnek: `"4.24.0"`. user_agent (`str`, `dict`, *isteğe bağlı*) : Sözlük veya tek bir dize biçimindeki kullanıcı ajanı bilgisi. Yüklenmiş paketlere dair bilgilerle tamamlanacaktır. headers (`dict`, *isteğe bağlı*) : Her istekle birlikte gönderilecek ek başlıklar. Örnek: `{"X-My-Header": "value"}`. Burada geçirilen başlıklar, varsayılan başlıklara göre önceliklidir. HTTP üzerinden Hugging Face Hub ile etkileşime girmek için istemci. İstemci, Hub'a yapılan tüm isteklerde kullanılan bazı yüksek düzey ayarlarla (HF uç noktası, kimlik doğrulama, kullanıcı ajanları...) başlatılır. `HfApi` istemcisinin kullanılması tercih edilir ancak zorunlu değildir; çünkü tüm genel yöntemleri `huggingface_hub`'ün kökünde doğrudan erişilebilir durumdadır. #### accept_access_request[[huggingface_hub.HfApi.accept_access_request]] ```python accept_access_request(repo_id: str, user: str | None = None, request_id: str | None = None, repo_type: str | None = None, token: bool | str | None = None) ``` [Kaynak](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L10873) **Parametreler:** repo_id (`str`) : Erişim isteğinin kabul edileceği repozituarın kimliği. user (`str`, *isteğe bağlı*) : Erişim isteğinin kabul edileceği kullanıcının kullanıcı adı. `user` veya `request_id` parametrelerinden tam olarak biri sağlanmalıdır. request_id (`str`, *isteğe bağlı*) : Kabul edilecek erişim isteğinin kimliği (bkz. `AccessRequest`). Depo, istek sahiplerinin kullanıcı adlarını paylaşmayacak şekilde yapılandırıldığında zorunludur. `user` veya `request_id` parametrelerinden tam olarak biri sağlanmalıdır. repo_type (`str`, *isteğe bağlı*) : Erişim isteğinin kabul edileceği repoyu türü. `model`, `dataset` veya `space` değerlerinden biri olmalıdır. Varsayılan değer `model`'dir. token (`bool` veya `str`, *isteğe bağlı*) : Geçerli bir kullanıcı erişim belirteci (dize). Varsayılan olarak, kimlik doğrulama için önerilen yöntem olan yerel olarak kaydedilmiş belirteç kullanılır (bkz. https://huggingface.co/docs/huggingface_hub/quick-start#authentication). Kimlik doğrulamayı devre dışı bırakmak için `False` geçirin. **Yükselen:** `HfHubHTTPError` - `HfHubHTTPError` -- Depo gated değilse HTTP 400. - `HfHubHTTPError` -- Depoya yalnızca salt okunur erişiminiz varsa HTTP 403. Deponun ait olduğu organizasyonda `write` veya `admin` rolünüz yoksa ya da bir `read` belirteci geçirdiyseniz bu durumla karşılaşabilirsiniz. - `HfHubHTTPError` -- Kullanıcı Hub'da yoksa HTTP 404. - `HfHubHTTPError` -- Kullanıcı erişim isteği bulunamazsa HTTP 404. - `HfHubHTTPError` -- Kullanıcı erişim isteği zaten kabul edilenler listesindeyse HTTP 404. Belirli bir gated repo için bir kullanıcının erişim isteğini kabul edin. İstek kabul edildikten sonra, kullanıcı depodaki herhangi bir dosyayı indirebilir ve topluluk sekmesine erişebilir. Onay modu otomatikse, istekleri manuel olarak kabul etmenize gerek yoktur. Kabul edilmiş bir istek, [cancel_access_request()](/docs/huggingface_hub/v2.4.0/tr/package_reference/hf_api#huggingface_hub.HfApi.cancel_access_request) ve [reject_access_request()](/docs/huggingface_hub/v2.4.0/tr/package_reference/hf_api#huggingface_hub.HfApi.reject_access_request) kullanılarak herhangi bir zamanda iptal edilebilir veya reddedilebilir. Kapalı depolar hakkında daha fazla bilgi için https://huggingface.co/docs/hub/models-gated adresine bakın. #### add_collection_item[[huggingface_hub.HfApi.add_collection_item]] ```python add_collection_item(collection_slug: str, item_id: str, item_type: CollectionItemType_T, note: str | None = None, exists_ok: bool = False, token: bool | str | None = None) ``` [Kaynak](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L10411) **Parametreler:** collection_slug (`str`) : Güncellenecek koleksiyonun slug'ı. Örnek: `"TheBloke/recent-models-64f9a55bb3115b4f513ec026"`. item_id (`str`) : Koleksiyona eklenecek öğenin kimliği. Depolar/uzaylar/veri kümeleri için repo_id, makaleler için makale kimliği, başka bir koleksiyonun slug'ı (ör. `"moonshotai/kimi-k2"`) veya bir varil kimliği (ör. `"namespace/bucket-name"`) kullanın. item_type (`str`) : Eklenecek öğenin türü. `"model"`, `"dataset"`, `"space"`, `"paper"`, `"collection"` veya `"bucket"` değerlerinden biri olabilir. note (`str`, *isteğe bağlı*) : Koleksiyondaki öğeye eklemek için bir not. Bir notun maksimum boyutu 500 karakterdir. exists_ok (`bool`, *isteğe bağlı*) : `True` ise, öğe zaten varsa hata yükseltilmez. token (`bool` veya `str`, *isteğe bağlı*) : Geçerli bir kullanıcı erişim belirteci (dize). Varsayılan olarak, kimlik doğrulama için önerilen yöntem olan yerel olarak kaydedilmiş belirteç kullanılır (bkz. https://huggingface.co/docs/huggingface_hub/quick-start#authentication). Kimlik doğrulamayı devre dışı bırakmak için `False` geçirin. **Yükselen:** `HfHubHTTPError` - `HfHubHTTPError` -- Depoya yalnızca salt okunur erişiminiz varsa HTTP 403. Deponun ait olduğu organizasyonda `write` veya `admin` rolünüz yoksa ya da bir `read` belirteci geçirdiyseniz bu durumla karşılaşabilirsiniz. - `HfHubHTTPError` -- Koleksiyona eklemeye çalıştığınız öğe Hub'da yoksa HTTP 404. - `HfHubHTTPError` -- Koleksiyona eklemeye çalıştığınız öğe zaten koleksiyonda varsa (ve exists_ok=False) HTTP 409 Hub'daki bir koleksiyona öğe ekleyin. Dönüş: [Collection](/docs/huggingface_hub/v2.4.0/tr/package_reference/collections#huggingface_hub.Collection) Örnek: ```py >>> from huggingface_hub import add_collection_item >>> collection = add_collection_item( ... collection_slug="davanstrien/climate-64f99dc2a5067f6b65531bab", ... item_id="pierre-loic/climate-news-articles", ... item_type="dataset" ... ) >>> collection.items[-1].item_id "pierre-loic/climate-news-articles" # ^item got added to the collection on last position # Add item with a note >>> add_collection_item( ... collection_slug="davanstrien/climate-64f99dc2a5067f6b65531bab", ... item_id="datasets/climate_fever", ... item_type="dataset", ... note="This dataset adopts the FEVER methodology that consists of 1,535 real-world claims regarding climate-change collected on the internet." ... ) (...) ``` #### add_space_secret[[huggingface_hub.HfApi.add_space_secret]] ```python add_space_secret(repo_id: str, key: str, value: str, description: str | None = None, token: bool | str | None = None) ``` [Kaynak](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L8043) **Parametreler:** repo_id (`str`) : Güncellenecek repozituarın kimliği. Örnek: `"bigcode/in-the-stack"`. key (`str`) : Gizli anahtar. Örnek: `"GITHUB_API_KEY"` value (`str`) : Gizli değer. Örnek: `"your_github_api_key"`. description (`str`, *optional*) : Secret description. Example: `"Github API key to access the Github API"`. token (`bool` veya `str`, *isteğe bağlı*) : Geçerli bir kullanıcı erişim belirteci (dize). Varsayılan olarak, kimlik doğrulama için önerilen yöntem olan yerel olarak kaydedilmiş belirteç kullanılır (bkz. https://huggingface.co/docs/huggingface_hub/quick-start#authentication). Kimlik doğrulamayı devre dışı bırakmak için `False` geçirin. Bir Space'te gizli bir değeri ekler veya günceller. Secrets, bir Space'e gizli anahtarlar veya jetonları bunları kodun içine gömmeden ayarlamayı sağlar. Daha fazla ayrıntı için https://huggingface.co/docs/hub/spaces-overview#managing-secrets adresine bakın. #### add_space_variable[[huggingface_hub.HfApi.add_space_variable]] ```python add_space_variable(repo_id: str, key: str, value: str, description: str | None = None, token: bool | str | None = None) ``` [Kaynak](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L8169) **Parametreler:** repo_id (`str`) : Güncellenecek repozituarın kimliği. Örnek: `"bigcode/in-the-stack"`. key (`str`) : Değişken anahtarı. Örnek: `"MODEL_REPO_ID"` value (`str`) : Değişken değeri. Örnek: `"the_model_repo_id"`. description (`str`) : Değişkenin açıklaması. Örnek: `"Model Repo ID of the implemented model"`. token (`bool` veya `str`, *isteğe bağlı*) : Geçerli bir kullanıcı erişim belirteci (dize). Varsayılan olarak, kimlik doğrulama için önerilen yöntem olan yerel olarak kaydedilmiş belirteç kullanılır (bkz. https://huggingface.co/docs/huggingface_hub/quick-start#authentication). Kimlik doğrulamayı devre dışı bırakmak için `False` geçirin. Bir Space'te değişken ekler veya günceller. Değişkenler, bir Space'e ortam değişkenlerini sabit kodlamadan ayarlamayı sağlar. Daha fazla ayrıntı için bkz. https://huggingface.co/docs/hub/spaces-overview#managing-secrets-and-environment-variables #### auth_check[[huggingface_hub.HfApi.auth_check]] ```python auth_check(repo_id: str, repo_type: str | None = None, token: bool | str | None = None, write: bool = False) ``` [Kaynak](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L12047) **Parametreler:** repo_id (`str`) : Erişimin kontrol edileceği depo. Biçim `"user/repo_name"` olmalıdır. Örnek: `"user/my-cool-model"`. repo_type (`str`, *isteğe bağlı*) : Deponun türü. `"model"`, `"dataset"` veya `"space"` değerlerinden biri olmalıdır. Belirtilmezse varsayılan değer `"model"`'dir. token (`Union[bool, str, None]`, *isteğe bağlı*) : Geçerli bir kullanıcı erişim belirteci. Sağlanmazsa, önerilen kimlik doğrulama yöntemi olan yerel olarak kaydedilmiş belirteç kullanılır. Kimlik doğrulamayı devre dışı bırakmak için `False` olarak ayarlayın. Aşağıdaki bağlantıya bakın: https://huggingface.co/docs/huggingface_hub/quick-start#authentication. write (`bool`, *isteğe bağlı*) : `True` ise, kullanıcının depoda içerik yazma iznine sahip olup olmadığını kontrol eder. `False` (varsayılan) ise, yalnızca okuma erişimini kontrol eder. **Yükseltir:** [RepositoryNotFoundError](/docs/huggingface_hub/v2.4.0/tr/package_reference/utilities#huggingface_hub.errors.RepositoryNotFoundError) veya [GatedRepoError](/docs/huggingface_hub/v2.4.0/tr/package_reference/utilities#huggingface_hub.errors.GatedRepoError) - [RepositoryNotFoundError](/docs/huggingface_hub/v2.4.0/tr/package_reference/utilities#huggingface_hub.errors.RepositoryNotFoundError) -- Depo mevcut değilse, özel ise veya kullanıcının erişim yetkisi yoksa yükseltilir. Bu durum, `repo_id` veya `repo_type` hatalıysa ya da depo özel olup kullanıcı kimlik doğrulaması yapmamışsa oluşabilir. - [GatedRepoError](/docs/huggingface_hub/v2.4.0/tr/package_reference/utilities#huggingface_hub.errors.GatedRepoError) -- Depo mevcut ancak kapalı (gated) ve kullanıcının erişim yetkisi yoksa yükseltilir. Sağlanan kullanıcı belirtecinin Hugging Face Hub'daki belirli bir depoya erişim yetkisi olup olmadığını kontrol edin. Bu yöntem, sağlanan jetonla kimliği doğrulanmış kullanıcının belirtilen depoya erişim yetkisine sahip olup olmadığını doğrular. Depo bulunamazsa veya kullanıcının erişim için gerekli izinleri yoksa, yöntem uygun bir istisna fırlatır. Örnek: Kullanıcının bir depoya erişimi olup olmadığını kontrol edin: ```python >>> from huggingface_hub import auth_check >>> from huggingface_hub.utils import GatedRepoError, RepositoryNotFoundError try: auth_check("user/my-cool-model") except GatedRepoError: # Handle gated repository error print("You do not have permission to access this gated repository.") except RepositoryNotFoundError: # Handle repository not found error print("The repository was not found or you do not have access.") ``` Bu örnekte: - Kullanıcının erişim yetkisi varsa, yöntem başarıyla tamamlanır. - Depo kapalıysa veya mevcut değilse, uygun istisnalar oluşturulur ve bu da kullanıcıya buna göre ele almak için. #### batch_bucket_files[[huggingface_hub.HfApi.batch_bucket_files]] ```python batch_bucket_files(bucket_id: str, add: list[tuple[str | Path | bytes, str]] | None = None, copy: list[tuple[str, str, str, str]] | None = None, delete: list[str] | None = None, token: str | bool | None = None) ``` [Kaynak](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L14729) **Parametreler:** bucket_id (`str`) : Kovanın kimliği (ör. `"username/my-bucket"`). add (`list` of `tuple`, *isteğe bağlı*) : Yüklenecek dosyalar. Her öğe, `source`'un yerel bir dosyanın yolu (`str` veya `Path`) veya ham `bytes` içeriği, `destination`'un ise kovadaki yol olduğu bir `(source, destination)` demetidir. copy (`list` of `tuple`, *opsiyonel*) : xet hash ile kopyalanacak dosyalar. Her öğe şu şekilde bir `(source_repo_type, source_repo_id, xet_hash, destination)` tuple'idir: - `source_repo_type`, kaynak depoyun türüdür: `"model"`, `"dataset"`, `"space"` veya `"bucket"`. - `source_repo_id`, kaynak depo veya bucket'ın kimliğidir (ör. `"username/my-model"`). - `xet_hash`, kopyalanacak dosyanın xet hash'idir. - `destination`, bucket içindeki hedef yoldur. Bu, sunucu tarafında gerçekleştirilen bir işlemdir — veri indirilmez veya yeniden yüklenmez. delete (`list` of `str`, *opsiyonel*) : Bucket'ten silinecek dosyaların yolları. token (`bool` veya `str`, *isteğe bağlı*) : Geçerli bir kullanıcı erişim belirteci (dize). Varsayılan olarak, kimlik doğrulama için önerilen yöntem olan yerel olarak kaydedilmiş belirteç kullanılır (bkz. https://huggingface.co/docs/huggingface_hub/quick-start#authentication). Kimlik doğrulamayı devre dışı bırakmak için `False` geçirin. **Yükselen:** `BucketBatchError` - `BucketBatchError` -- Sunucu, bazı işlemlerin başarısız olduğunu bildirirse. Hata, her işlem gönderildikten sonra bir kez yükseltilir, bu nedenle toplu işlemin diğer işlemleri uygulanmıştır. Bir kovadaki dosyaları ekleyin, kopyalayın ve/veya silin. Bu işlem işlem dışıdır (non-transactional). Süreç sırasında bir hata oluşursa, bazı dosyalar yüklenmiş, kopyalanmış veya silinmiş olabilirken diğerleri bu işlemlerden etkilenmemiş olabilir. Örnek: ```python >>> from huggingface_hub import batch_bucket_files # Upload files >>> batch_bucket_files( ... "username/my-bucket", ... add=[ ... ("./model.safetensors", "models/model.safetensors"), ... (b'{{"key": "value"}}', "config.json"), ... ], ... ) # Copy xet files from another bucket or repo (server-side, no data transfer) >>> batch_bucket_files( ... "username/my-bucket", ... copy=[ ... ("bucket", "username/source-bucket", "", "models/model.safetensors"), ... ("model", "username/my-model", "", "models/config.safetensors"), ... ], ... ) # Delete files >>> batch_bucket_files("username/my-bucket", delete=["old-model.bin"]) # Upload and delete in one batch >>> batch_bucket_files( ... "username/my-bucket", ... add=[("./new.txt", "new.txt")], ... delete=["old.txt"], ... ) ``` #### bucket_info[[huggingface_hub.HfApi.bucket_info]] ```python bucket_info(bucket_id: str, token: bool | str | None = None) ``` [Kaynak](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L14058) **Parametreler:** bucket_id (`str`) : Kovanın kimliği (ör. `"username/my-bucket"`). token (`bool` veya `str`, *isteğe bağlı*) : Geçerli bir kullanıcı erişim belirteci (dize). Varsayılan olarak, kimlik doğrulama için önerilen yöntem olan yerel olarak kaydedilmiş belirteç kullanılır (bkz. https://huggingface.co/docs/huggingface_hub/quick-start#authentication). Kimlik doğrulamayı devre dışı bırakmak için `False` geçirin. **Dönüş:** [BucketInfo](/docs/huggingface_hub/v2.4.0/tr/package_reference/hf_api#huggingface_hub.BucketInfo) Kova bilgisi. **Yükselen:** `BucketNotFoundError` veya ``or`` - `BucketNotFoundError` -- Bucket bulunamadığında. Bunun nedeni, bucket'ın var olmaması olabilir, - ``or`` -- çünkü `private` olarak ayarlanmış ve erişiminiz yok. Hub'da belirli bir bucket hakkında bilgi alın. Örnek: ```python >>> from huggingface_hub import bucket_info >>> info = bucket_info(bucket_id="Wauplin/first-bucket") >>> info.id 'Wauplin/first-bucket' >>> info.private False >>> info.created_at datetime.datetime(2026, 2, 6, 17, 37, 57, tzinfo=datetime.timezone.utc) >>> info.size 551879671 >>> info.total_files 12 ``` #### cancel_access_request[[huggingface_hub.HfApi.cancel_access_request]] ```python cancel_access_request(repo_id: str, user: str | None = None, request_id: str | None = None, repo_type: str | None = None, token: bool | str | None = None) ``` [Kaynak](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L10823) **Parametreler:** repo_id (`str`) : Erişim isteğinin iptal edileceği repozituarın kimliği. user (`str`, *isteğe bağlı*) : Erişim isteğinin iptal edileceği kullanıcının kullanıcı adı. `user` veya `request_id` parametrelerinden tam olarak biri sağlanmalıdır. request_id (`str`, *isteğe bağlı*) : İptal edilecek erişim isteğinin kimliği (bkz. `AccessRequest`). Depo, istek sahiplerinin kullanıcı adlarını paylaşmayacak şekilde yapılandırıldığında zorunludur. `user` veya `request_id` parametrelerinden tam olarak biri sağlanmalıdır. repo_type (`str`, *isteğe bağlı*) : Erişim isteğinin iptal edileceği repoyun türü. `model`, `dataset` veya `space` değerlerinden biri olmalıdır. Varsayılan değer `model`'dir. token (`bool` veya `str`, *isteğe bağlı*) : Geçerli bir kullanıcı erişim belirteci (dize). Varsayılan olarak, kimlik doğrulama için önerilen yöntem olan yerel olarak kaydedilmiş belirteç kullanılır (bkz. https://huggingface.co/docs/huggingface_hub/quick-start#authentication). Kimlik doğrulamayı devre dışı bırakmak için `False` geçirin. **Yükselen:** `HfHubHTTPError` - `HfHubHTTPError` -- Depo gated değilse HTTP 400. - `HfHubHTTPError` -- Depoya yalnızca salt okunur erişiminiz varsa HTTP 403. Deponun ait olduğu organizasyonda `write` veya `admin` rolünüz yoksa ya da bir `read` belirteci geçirdiyseniz bu durumla karşılaşabilirsiniz. - `HfHubHTTPError` -- Kullanıcı Hub'da yoksa HTTP 404. - `HfHubHTTPError` -- Kullanıcı erişim isteği bulunamazsa HTTP 404. - `HfHubHTTPError` -- Kullanıcı erişim isteği zaten bekleyenler listesindeyse HTTP 404. Belirli bir gated repo için bir kullanıcının erişim isteğini iptal edin. İptal edilen bir istek bekleyenler listesine geri döner ve kullanıcı repoya erişimini kaybeder. Kapalı depolar hakkında daha fazla bilgi için https://huggingface.co/docs/hub/models-gated adresine bakın. #### cancel_job[[huggingface_hub.HfApi.cancel_job]] ```python cancel_job(job_id: str, namespace: str | None = None, token: bool | str | None = None) ``` [Kaynak](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L12757) **Parametreler:** job_id (`str`) : İşin kimliği. namespace (`str`, *isteğe bağlı*) : Job'un çalıştığı ad alanı. Varsayılan olarak mevcut kullanıcının ad alanıdır. token (`bool` veya `str`, *isteğe bağlı*) : Geçerli bir kullanıcı erişim belirteci. Sağlanmazsa, önerilen kimlik doğrulama yöntemi olan yerel olarak kaydedilmiş belirteç kullanılır. Kimlik doğrulamayı devre dışı bırakmak için `False` olarak ayarlayın. Aşağıdaki bağlantıya bakın: https://huggingface.co/docs/huggingface_hub/quick-start#authentication. Hugging Face altyapısında bir hesaplama İşini iptal edin. #### change_discussion_status[[huggingface_hub.HfApi.change_discussion_status]] ```python change_discussion_status(repo_id: str, discussion_num: int, new_status: Literal['open', 'closed'], token: bool | str | None = None, comment: str | None = None, repo_type: str | None = None) ``` [Kaynak](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L7756) **Parametreler:** repo_id (`str`) : `/` ile ayrılmış bir ad alanı (kullanıcı veya kuruluş) ve bir depo adı. discussion_num (`int`) : Tartışma veya Pull Request'in numarası. Kesinlikle pozitif bir tam sayı olmalıdır. new_status (`str`) : Tartışmanın yeni durumu, `"open"` veya `"closed"`. comment (`str`, *isteğe bağlı*) : Durum değişikliğiyle birlikte gönderilecek isteğe bağlı bir yorum. repo_type (`str`, *isteğe bağlı*) : Bir veri setine veya uzaya yükleniyorsa `"dataset"` veya `"space"` olarak, bir modele yükleniyorsa `None` veya `"model"` olarak ayarlayın. Varsayılan değer `None`'dir. token (`bool` veya `str`, *isteğe bağlı*) : Geçerli bir kullanıcı erişim belirteci (dize). Varsayılan olarak, kimlik doğrulama için önerilen yöntem olan yerel olarak kaydedilmiş belirteç kullanılır (bkz. https://huggingface.co/docs/huggingface_hub/quick-start#authentication). Kimlik doğrulamayı devre dışı bırakmak için `False` geçirin. **Dönüş:** [DiscussionStatusChange](/docs/huggingface_hub/v2.4.0/tr/package_reference/community#huggingface_hub.DiscussionStatusChange) durum değişikliği olayı Bir Tartışma veya Pull Request'i kapatır veya yeniden açar. Örnekler: ```python >>> HfApi().change_discussion_status( ... repo_id="username/repo_name", ... discussion_num=34, ... new_status="closed" ... ) # DiscussionStatusChange(id='deadbeef0000000', type='status-change', ...) ``` > [!TIP] > Aşağıdaki hataları oluşturur: > > - [`HTTPError`](https://requests.readthedocs.io/en/latest/api/#requests.HTTPError) HuggingFace API bir hata döndürürse - [`ValueError`](https://docs.python.org/3/library/exceptions.html#ValueError) bir parametre değeri geçersizse - [RepositoryNotFoundError](/docs/huggingface_hub/v2.4.0/tr/package_reference/utilities#huggingface_hub.errors.RepositoryNotFoundError) İndirme yapılacak deposu bulunamazsa. Bunun nedeni, deponun var olmaması veya `private` olarak ayarlanmış olması ve erişiminizin bulunmaması olabilir. #### comment_discussion[[huggingface_hub.HfApi.comment_discussion]] ```python comment_discussion(repo_id: str, discussion_num: int, comment: str, token: bool | str | None = None, repo_type: str | None = None) ``` [Kaynak](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L7613) **Parametreler:** repo_id (`str`) : `/` ile ayrılmış bir ad alanı (kullanıcı veya kuruluş) ve bir depo adı. discussion_num (`int`) : Tartışma veya Pull Request'in numarası. Kesinlikle pozitif bir tam sayı olmalıdır. comment (`str`) : Oluşturulacak yorumun içeriği. Yorumlar markdown biçimlendirmesini destekler. repo_type (`str`, *isteğe bağlı*) : Bir veri setine veya uzaya yükleniyorsa `"dataset"` veya `"space"` olarak, bir modele yükleniyorsa `None` veya `"model"` olarak ayarlayın. Varsayılan değer `None`'dir. token (`bool` veya `str`, *isteğe bağlı*) : Geçerli bir kullanıcı erişim belirteci (dize). Varsayılan olarak, kimlik doğrulama için önerilen yöntem olan yerel olarak kaydedilmiş belirteç kullanılır (bkz. https://huggingface.co/docs/huggingface_hub/quick-start#authentication). Kimlik doğrulamayı devre dışı bırakmak için `False` geçirin. **Dönüş:** [DiscussionComment](/docs/huggingface_hub/v2.4.0/tr/package_reference/community#huggingface_hub.DiscussionComment) yeni oluşturulan yorum Belirtilen Tartışma üzerinde yeni bir yorum oluşturur. Örnekler: ```python >>> comment = """ ... Hello @otheruser! ... ... # This is a title ... ... **This is bold**, *this is italic* and ~this is strikethrough~ ... And [this](http://url) is a link ... """ >>> HfApi().comment_discussion( ... repo_id="username/repo_name", ... discussion_num=34, ... comment=comment ... ) # DiscussionComment(id='deadbeef0000000', type='comment', ...) ``` > [!TIP] > Aşağıdaki hataları oluşturur: > > - [`HTTPError`](https://requests.readthedocs.io/en/latest/api/#requests.HTTPError) HuggingFace API bir hata döndürürse - [`ValueError`](https://docs.python.org/3/library/exceptions.html#ValueError) bir parametre değeri geçersizse - [RepositoryNotFoundError](/docs/huggingface_hub/v2.4.0/tr/package_reference/utilities#huggingface_hub.errors.RepositoryNotFoundError) İndirme yapılacak deposu bulunamazsa. Bunun nedeni, deponun var olmaması veya `private` olarak ayarlanmış olması ve erişiminizin bulunmaması olabilir. #### copy_files[[huggingface_hub.HfApi.copy_files]] ```python copy_files(source: str, destination: str, token: str | bool | None = None) ``` [Kaynak](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L14410) **Parametreler:** source (`str`) : `hf://` URI olarak kaynak konumu. Bir bucket yolu (ör. `"hf://buckets/my-bucket/path/to/file"`) veya bir repo yolu (ör. `"hf://username/my-model/weights.bin"`, `"hf://datasets/username/my-dataset/data/"`) olabilir. destination (`str`) : Bir kovaya (ör. `"hf://buckets/my-bucket/target/path"`) veya bir repoya (ör. `"hf://username/my-model/target/path"`) işaret eden `hf://` URI'si olarak hedef konum. token (`bool` veya `str`, *isteğe bağlı*) : Geçerli bir kullanıcı erişim belirteci (dize). Varsayılan olarak, kimlik doğrulama için önerilen yöntem olan yerel olarak kaydedilmiş belirteç kullanılır (bkz. https://huggingface.co/docs/huggingface_hub/quick-start#authentication). Kimlik doğrulamayı devre dışı bırakmak için `False` geçirin. **Yükselen:** ``ValueError`` - [`ValueError`](https://docs.python.org/3/library/exceptions.html#ValueError) -- Kaynak/hedef URI'leri geçersizse veya bir bucket'tan bir repo'ya kopyalama yapılıyorsa. Hub üzerindeki konumlar arasında dosyaları kopyalayın. Bir bucket'tan veya bir repodan (model, veri seti, space) bir bucket'a veya başka bir repoya dosya kopyalayın. Hem bireysel dosyalar hem de tüm klasörler desteklenir. Klasörleri kopyalarken, kaynak yolunun sonundaki `/` rsync tarzı bir semantiği kullanır: kaynak klasörün kendisini iç içe geçirmeden, *içeriğini* hedefe kopyalar. Sonda `/` yoksa, kaynak klasör hedefin içine iç içe yerleştirilir (tıpkı `cp -r` gibi). Bir depodan bir kovaya kopyalama sırasında, `.gitattributes` dosyaları git'e özgü meta veriler olduğu ve kovak bağlamında ilgili olmadığı için otomatik olarak hariç tutulur. Depodan depoya kopyalamalar, arka planda [CommitOperationCopy](/docs/huggingface_hub/v2.4.0/tr/package_reference/hf_api#huggingface_hub.CommitOperationCopy) kullanır ve hedef depoda bir commit oluşturur. Kova (bucket)dan depoya kopyalamalar desteklenmez. > [!WARNING] > Sunucu tarafı kopyalar yalnızca aynı [depolama bölgesi](https://huggingface.co/docs/hub/storage-regions) içinde çalışır. Örnek: ```python >>> from huggingface_hub import copy_files # Copy a single file between buckets >>> copy_files("hf://buckets/my-bucket/data.bin", "hf://buckets/other-bucket/data.bin") # Copy a folder into another bucket (nests: backup/models/...) >>> copy_files("hf://buckets/my-bucket/models", "hf://buckets/other-bucket/backup/") # Copy folder contents (trailing /): files go directly into backup/ >>> copy_files("hf://buckets/my-bucket/models/", "hf://buckets/other-bucket/backup/") # Copy a file from a model repo to a bucket >>> copy_files("hf://username/my-model/model.safetensors", "hf://buckets/my-bucket/") # Copy an entire dataset to a bucket >>> copy_files("hf://datasets/username/my-dataset/", "hf://buckets/my-bucket/datasets/") # Copy files between repositories >>> copy_files("hf://username/source-model/", "hf://username/dest-model/") # Copy a file from one repo to another >>> copy_files("hf://username/source-model/config.json", "hf://username/dest-model/config.json") ``` #### create_branch[[huggingface_hub.HfApi.create_branch]] ```python create_branch(repo_id: str, branch: str, revision: str | None = None, token: bool | str | None = None, repo_type: str | None = None, exist_ok: bool = False) ``` [Kaynak](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L6963) **Parametreler:** repo_id (`str`) : Dalın oluşturulacağı depo. Örnek: `"user/my-cool-model"`. branch (`str`) : Oluşturulacak dalın adı. revision (`str`, *isteğe bağlı*) : Dalın oluşturulacağı git revizyonu. Bir dal adı veya bir commit'in OID/SHA'sı olarak, onaltılık bir dize olabilir. Varsayılan olarak `"main"` dalının başıdır. token (`bool` veya `str`, *isteğe bağlı*) : Geçerli bir kullanıcı erişim belirteci (dize). Varsayılan olarak, kimlik doğrulama için önerilen yöntem olan yerel olarak kaydedilmiş belirteç kullanılır (bkz. https://huggingface.co/docs/huggingface_hub/quick-start#authentication). Kimlik doğrulamayı devre dışı bırakmak için `False` geçirin. repo_type (`str`, *isteğe bağlı*) : Bir veri seti veya uzay üzerinde dal oluşturuyorsanız `"dataset"` veya `"space"` olarak, bir modele etiket atıyorsanız `None` veya `"model"` olarak ayarlayın. Varsayılan değer `None`'dir. exist_ok (`bool`, *isteğe bağlı*, varsayılan `False`) : `True` ise, dal zaten varsa hata yükseltilmez. **Yükseltir:** [RepositoryNotFoundError](/docs/huggingface_hub/v2.4.0/tr/package_reference/utilities#huggingface_hub.errors.RepositoryNotFoundError) veya [BadRequestError](/docs/huggingface_hub/v2.4.0/tr/package_reference/utilities#huggingface_hub.errors.BadRequestError) veya [HfHubHTTPError](/docs/huggingface_hub/v2.4.0/tr/package_reference/utilities#huggingface_hub.errors.HfHubHTTPError) - [RepositoryNotFoundError](/docs/huggingface_hub/v2.4.0/tr/package_reference/utilities#huggingface_hub.errors.RepositoryNotFoundError) -- Depo bulunamadıysa (hata 404): repo_id/repo_type yanlış, özel ama kimlik doğrulaması yapılmamış veya depo mevcut değil. - [BadRequestError](/docs/huggingface_hub/v2.4.0/tr/package_reference/utilities#huggingface_hub.errors.BadRequestError) -- Geçersiz bir branch referansı verilirse. Ör: `refs/pr/5` veya 'refs/foo/bar'. - [HfHubHTTPError](/docs/huggingface_hub/v2.4.0/tr/package_reference/utilities#huggingface_hub.errors.HfHubHTTPError) -- Dal zaten depoda mevcutsa (hata 409) ve `exist_ok` `False` olarak ayarlanmışsa. Hub'daki bir depo için, belirtilen revizyondan (varsayılan olarak `main`) başlayarak yeni bir dal oluşturun. İhtiyacınıza uygun bir revizyon bulmak için [list_repo_refs()](/docs/huggingface_hub/v2.4.0/tr/package_reference/hf_api#huggingface_hub.HfApi.list_repo_refs) veya [list_repo_commits()](/docs/huggingface_hub/v2.4.0/tr/package_reference/hf_api#huggingface_hub.HfApi.list_repo_commits) kullanabilirsiniz. #### create_bucket[[huggingface_hub.HfApi.create_bucket]] ```python create_bucket(bucket_id: str, private: bool | None = None, visibility: Literal['public', 'private'] | None = None, resource_group_id: str | None = None, region: REPO_REGIONS | None = None, exist_ok: bool = False, token: bool | str | None = None) ``` [Kaynak](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L13950) **Parametreler:** bucket_id (`str`) : Bir `/` ile ayrılmış bir ad alanı (kullanıcı veya kuruluş) ve bir varlık adı. Ad alanı belirtilmezse, varlık mevcut kullanıcının ad alanında oluşturulur. private (`bool`, *isteğe bağlı*) : Kovanın özel yapılıp yapılmayacağını belirtir. `None` (varsayılan) ise, organizasyonun varsayılanı özel olmadıkça kovan herkese açık olur. `visibility` parametresiyle birlikte geçirilemez. visibility (`Literal["public", "private"]`, *isteğe bağlı*) : Kovanın görünürlüğü. `"public"` veya `"private"` olabilir. `None` (varsayılan) ise, organizasyonun varsayılanı özel olmadıkça kovan herkese açık olacaktır. resource_group_id (`str`, *isteğe bağlı*) : Kovanın oluşturulacağı kaynak grubu. Kaynak grupları yalnızca Enterprise Hub kuruluşları için kullanılabilir ve kuruluşun hangi üyelerinin kaynağa erişebileceğini tanımlamaya olanak tanır. Bir kaynak grubunun kimliği, Hub'daki kaynağın sayfasındaki URL'de bulunabilir (ör. `"66670e5163145ca562cb1988"`). Kaynak grupları hakkında daha fazla bilgi için https://huggingface.co/docs/hub/en/security-resource-groups adresine bakın. region (`Literal["us", "eu"]`, *isteğe bağlı*) : Kovanın oluşturulacağı bulut bölgesi. `"us"` veya `"eu"` değerlerinden biri olabilir. Belirtilmezse, kovan varsayılan bölgede oluşturulur. Team planı veya üstü gerektirir. exist_ok (`bool`, *isteğe bağlı*, varsayılan `False`) : `True` ise, varlık (bucket) zaten mevcut olsa bile hata yükseltilmez. token (`bool` veya `str`, *isteğe bağlı*) : Geçerli bir kullanıcı erişim belirteci (dize). Varsayılan olarak, kimlik doğrulama için önerilen yöntem olan yerel olarak kaydedilmiş belirteç kullanılır (bkz. https://huggingface.co/docs/huggingface_hub/quick-start#authentication). Kimlik doğrulamayı devre dışı bırakmak için `False` geçirin. **Dönüş:** [BucketUrl](/docs/huggingface_hub/v2.4.0/tr/package_reference/hf_api#huggingface_hub.BucketUrl) `endpoint`, `namespace` ve `bucket_id` gibi öznitelikleri içeren, yeni oluşturulan bucket'ın URL'si. Hub'da bir varlık oluşturun. Örnek: ```python >>> from huggingface_hub import create_bucket >>> url = create_bucket(bucket_id="my-bucket") >>> url.bucket_id 'user/my-bucket' >>> url.url 'https://huggingface.co/buckets/user/my-bucket' >>> url.uri.to_uri() 'hf://buckets/user/my-bucket' >>> create_bucket(bucket_id="my-bucket", private=True, exist_ok=True) BucketUrl(...) >>> create_bucket(bucket_id="my-bucket", region="us") BucketUrl(...) ``` #### create_collection[[huggingface_hub.HfApi.create_collection]] ```python create_collection(title: str, namespace: str | None = None, description: str | None = None, private: bool = False, resource_group_id: str | None = None, exists_ok: bool = False, token: bool | str | None = None) ``` [Kaynak](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L10191) **Parametreler:** title (`str`) : Oluşturulacak koleksiyonun başlığı. Örnek: `"Recent models"`. namespace (`str`, *isteğe bağlı*) : Oluşturulacak koleksiyonun ad alanı (kullanıcı adı veya kuruluş). Varsayılan olarak sahip adı kullanılır. description (`str`, *isteğe bağlı*) : Oluşturulacak koleksiyonun açıklaması. Bir açıklamanın maksimum boyutu 150 karakterdir. private (`bool`, *isteğe bağlı*) : Koleksiyonun özel olup olmayacağı. Varsayılan olarak `False` (yani herkese açık koleksiyon). resource_group_id (`str`, *isteğe bağlı*) : Koleksiyonu, sahip olduğu organizasyonun bir kaynak grubuna atayın. Yalnızca organizasyona ait koleksiyonlar için geçerlidir. Kaynak grubu kimliği, 24 karakterli onaltılık bir dizidir. exists_ok (`bool`, *isteğe bağlı*) : `True` ise, koleksiyon zaten varsa hata fırlatılmaz. token (`bool` veya `str`, *isteğe bağlı*) : Geçerli bir kullanıcı erişim belirteci (dize). Varsayılan olarak, kimlik doğrulama için önerilen yöntem olan yerel olarak kaydedilmiş belirteç kullanılır (bkz. https://huggingface.co/docs/huggingface_hub/quick-start#authentication). Kimlik doğrulamayı devre dışı bırakmak için `False` geçirin. Hub'da yeni bir Collection oluşturun. Dönüş: [Collection](/docs/huggingface_hub/v2.4.0/tr/package_reference/collections#huggingface_hub.Collection) Örnek: ```py >>> from huggingface_hub import create_collection >>> collection = create_collection( ... title="ICCV 2023", ... description="Portfolio of models, papers and demos I presented at ICCV 2023", ... ) >>> collection.slug "username/iccv-2023-64f9a55bb3115b4f513ec026" ``` #### create_commit[[huggingface_hub.HfApi.create_commit]] ```python create_commit(repo_id: str, operations: Iterable[CommitOperation], commit_message: str, commit_description: str | None = None, token: str | bool | None = None, repo_type: str | None = None, revision: str | None = None, create_pr: bool | None = None, num_threads: int = 5, parent_commit: str | None = None, run_as_future: bool = False, _hot_reload: bool | None = None) ``` [Kaynak](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L5016) **Parametreler:** repo_id (`str`) : Commit'in oluşturulacağı depo, örneğin: `"username/custom_transformers"` operations (`Iterable` of `~hf_api.CommitOperation`) : Commit'e dahil edilecek işlemlerin bir iterable'ı, şunlardan biri: - Dosya yüklemek için `~hf_api.CommitOperationAdd` - Dosya silmek için `~hf_api.CommitOperationDelete` - Dosya kopyalamak için `~hf_api.CommitOperationCopy` İşlem nesneleri, yüklemeyle ilgili bilgileri içerecek şekilde değiştirilecektir. Aynı nesneleri birden fazla commit için yeniden kullanmayın. commit_message (`str`) : Oluşturulacak commit'in özeti (ilk satır). commit_description (`str`, *isteğe bağlı*) : Oluşturulacak commit'in açıklaması token (`bool` veya `str`, *isteğe bağlı*) : Geçerli bir kullanıcı erişim belirteci (dize). Varsayılan olarak, kimlik doğrulama için önerilen yöntem olan yerel olarak kaydedilmiş belirteç kullanılır (bkz. https://huggingface.co/docs/huggingface_hub/quick-start#authentication). Kimlik doğrulamayı devre dışı bırakmak için `False` geçirin. repo_type (`str`, *isteğe bağlı*) : Bir veri seti, space veya kernel deposuna yükleniyorsa `"dataset"`, `"space"` veya `"kernel"` olarak ayarlayın; bir modele yükleniyorsa `None` veya `"model"` olarak ayarlayın. Varsayılan değer `None`'dir. revision (`str`, *isteğe bağlı*) : Commit'in alınacağı git revizyonu. Varsayılan olarak `"main"` dalının başıdır. create_pr (`boolean`, *isteğe bağlı*) : Bu commit ile bir Pull Request oluşturulup oluşturulmayacağı. Varsayılan olarak `False`. `revision` ayarlanmadıysa, PR `"main"` dalına karşı açılır. `revision` ayarlandıysa ve bir dal ise, PR bu dala karşı açılır. `revision` ayarlandıysa ve bir dal adı değilse (örneğin: bir commit oid), sunucu tarafından `RevisionNotFoundError` döndürülür. num_threads (`int`, *isteğe bağlı*) : Dosyaları yüklemek için eşzamanlı iş parçacığı sayısı. Varsayılan değer 5'tir. 2 olarak ayarlanması, en fazla 2 dosyanın eşzamanlı yükleneceği anlamına gelir. parent_commit (`str`, *isteğe bağlı*) : Ebeveyn commit'in OID / SHA'sı, onaltılık bir dize olarak. Kısaltmalar (ilk 7 karakter) de desteklenir. Belirtilirse ve `create_pr` `False` ise, `revision` `parent_commit`'e işaret etmiyorsa commit başarısız olur. Belirtilirse ve `create_pr` `True` ise, pull request `parent_commit`'ten oluşturulur. `parent_commit`'in belirtilmesi, değişiklikler commit edilmeden önce repoyun değişmediğinden emin olunmasını sağlar ve repo eşzamanlı olarak güncelleniyor / commit ediliyorsa özellikle faydalı olabilir. run_as_future (`bool`, *isteğe bağlı*) : Bu yöntemin arka planda çalıştırılıp çalıştırılmayacağını belirtir. Arka plan işleri, ana iş parçacığını bloklamadan sıralı olarak çalıştırılır. `run_as_future=True` geçirilirse bir [Future](https://docs.python.org/3/library/concurrent.futures.html#future-objects) nesnesi döndürülür. Varsayılan değer `False`'tir. **Dönüş:** [CommitInfo](/docs/huggingface_hub/v2.4.0/tr/package_reference/hf_api#huggingface_hub.CommitInfo) veya `Future` Yeni oluşturulan commit hakkında bilgi içeren [CommitInfo](/docs/huggingface_hub/v2.4.0/tr/package_reference/hf_api#huggingface_hub.CommitInfo) örneği (commit hash, commit url, pr url, commit message,...). `run_as_future=True` geçirilirse, çalıştırıldığında sonucu içerecek bir Future nesnesi döndürülür. **Yükselen:** ``ValueError`` veya [RepositoryNotFoundError](/docs/huggingface_hub/v2.4.0/tr/package_reference/utilities#huggingface_hub.errors.RepositoryNotFoundError) - [`ValueError`](https://docs.python.org/3/library/exceptions.html#ValueError) -- Commit mesajı boşsa. - [`ValueError`](https://docs.python.org/3/library/exceptions.html#ValueError) -- Ebeveyn commit geçerli bir commit OID'si değilse. - [`ValueError`](https://docs.python.org/3/library/exceptions.html#ValueError) -- Geçersiz bir metadata bölümüne sahip bir README.md dosyası commit edilirse. Bu durumda, herhangi bir dosya yüklenmeye çalışılmadan önce commit erken aşamada başarısız olur. - [`ValueError`](https://docs.python.org/3/library/exceptions.html#ValueError) -- `create_pr` `True` ise ve revision ne `None` ne de `"main"` ise. - [RepositoryNotFoundError](/docs/huggingface_hub/v2.4.0/tr/package_reference/utilities#huggingface_hub.errors.RepositoryNotFoundError) -- Depo bulunamadıysa (hata 404): repo_id/repo_type yanlış, özel ama kimlik doğrulaması yapılmamış veya depo mevcut değil. Verilen depoda bir commit oluşturur; gerektiği gibi dosyaları siler ve yükler. > [!WARNING] > `CommitOperation` giriş listesi, commit işlemi sırasında değiştirilecektir. Aynı nesneleri birden fazla commit için yeniden kullanmayın. > [!WARNING] > `create_commit`, Hub'da zaten var olan bir repoyu varsayar. 404 istemci hatası alırsanız, kimlik doğrulamanızın yapıldığından, token'ınızın gerekli izinlere sahip olduğundan ve `repo_id` ile `repo_type` değerlerinin doğru ayarlandığından emin olun. Repo yoksa, önce [create_repo()](/docs/huggingface_hub/v2.4.0/tr/package_reference/hf_api#huggingface_hub.HfApi.create_repo) kullanarak oluşturun. > [!WARNING] > `create_commit`, 25 bin LFS dosyası ve normal dosyalar için 1 GB yük ile sınırlıdır. #### create_discussion[[huggingface_hub.HfApi.create_discussion]] ```python create_discussion(repo_id: str, title: str, token: bool | str | None = None, description: str | None = None, repo_type: str | None = None, pull_request: bool = False) ``` [Kaynak](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L7440) **Parametreler:** repo_id (`str`) : `/` ile ayrılmış bir ad alanı (kullanıcı veya kuruluş) ve bir depo adı. title (`str`) : Tartışmanın başlığı. En fazla 200 karakter uzunluğunda olabilir ve en az 3 karakter uzunluğunda olmalıdır. Baştaki ve sonda boşluklar kaldırılır. token (`bool` veya `str`, *isteğe bağlı*) : Geçerli bir kullanıcı erişim belirteci (dize). Varsayılan olarak, kimlik doğrulama için önerilen yöntem olan yerel olarak kaydedilmiş belirteç kullanılır (bkz. https://huggingface.co/docs/huggingface_hub/quick-start#authentication). Kimlik doğrulamayı devre dışı bırakmak için `False` geçirin. description (`str`, *isteğe bağlı*) : Pull Request için isteğe bağlı bir açıklama. Varsayılan olarak `"Discussion opened with the huggingface_hub Python library"` pull_request (`bool`, *isteğe bağlı*) : Bir Pull Request veya tartışma oluşturulup oluşturulmayacağını belirtir. `True` ise bir Pull Request oluşturur. `False` ise bir tartışma oluşturur. Varsayılan değer `False`'tür. repo_type (`str`, *isteğe bağlı*) : Bir veri setine veya uzaya yükleniyorsa `"dataset"` veya `"space"` olarak, bir modele yükleniyorsa `None` veya `"model"` olarak ayarlayın. Varsayılan değer `None`'dir. Bir Tartışma veya Pull Request oluşturur. Programatik olarak oluşturulan Pull Request'ler `"draft"` durumunda olacaktır. Değişikliklerle bir Pull Request oluşturmak, [HfApi.create_commit()](/docs/huggingface_hub/v2.4.0/tr/package_reference/hf_api#huggingface_hub.HfApi.create_commit) ile tek seferde yapılabilir. Dönüş: [DiscussionWithDetails](/docs/huggingface_hub/v2.4.0/tr/package_reference/community#huggingface_hub.DiscussionWithDetails) > [!TIP] > Aşağıdaki hataları oluşturur: > > - [`HTTPError`](https://requests.readthedocs.io/en/latest/api/#requests.HTTPError) HuggingFace API bir hata döndürürse - [`ValueError`](https://docs.python.org/3/library/exceptions.html#ValueError) bir parametre değeri geçersizse - [RepositoryNotFoundError](/docs/huggingface_hub/v2.4.0/tr/package_reference/utilities#huggingface_hub.errors.RepositoryNotFoundError) İndirme yapılacak deposu bulunamazsa. Bunun nedeni, deponun var olmaması veya `private` olarak ayarlanmış olması ve erişiminizin bulunmaması olabilir. #### create_inference_endpoint[[huggingface_hub.HfApi.create_inference_endpoint]] ```python create_inference_endpoint(name: str, repository: str, framework: str, accelerator: str, instance_size: str, instance_type: str, region: str, vendor: str, account_id: str | None = None, private_link_account_id: str | None = None, private_link_region: str | None = None, min_replica: int = 1, max_replica: int = 1, scaling_metric: InferenceEndpointScalingMetric | None = None, scaling_threshold: float | None = None, scale_to_zero_timeout: int | None = None, revision: str | None = None, task: str | None = None, custom_image: dict | None = None, container_registry_username: str | None = None, container_registry_password: str | None = None, container_command: list[str] | None = None, container_args: list[str] | None = None, env: dict[str, str] | None = None, secrets: dict[str, str] | None = None, type: InferenceEndpointType | str = , domain: str | None = None, path: str | None = None, cache_http_responses: bool | None = None, tags: list[str] | None = None, namespace: str | None = None, token: bool | str | None = None) ``` [Kaynak](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L9205) **Parametreler:** name (`str`) : Yeni Inference Endpoint için benzersiz ad. repository (`str`) : Inference Endpoint ile ilişkili model deposunun adı (ör. `"gpt2"`). framework (`str`) : Model için kullanılan makine öğrenimi çerçevesi (ör. `"custom"`). accelerator (`str`) : Çıkarım için kullanılacak donanım hızlandırıcısı (ör. `"cpu"`). instance_size (`str`) : Modeli barındırmak için kullanılacak örneğin boyutu veya türü (ör. `"x4"`). instance_type (`str`) : Inference Endpoint'in dağıtılacağı bulut örneği türü (ör. `"intel-icl"`). region (`str`) : Inference Endpoint'ın oluşturulacağı bulut bölgesi (ör. `"us-east-1"`). vendor (`str`) : Inference Endpoint'in barındırılacağı bulut sağlayıcısı veya tedarikçi (ör. `"aws"`). account_id (`str`, *isteğe bağlı*) : Durduruldu ve yok sayılır. AWS PrivateLink'i yapılandırmak için `private_link_account_id` ve `private_link_region` kullanın. private_link_account_id (`str`, *isteğe bağlı*) : AWS PrivateLink üzerinden Inference Endpoint'e erişmesine izin verilen AWS hesap kimliği. `private_link_region` gerektirir. private_link_region (`str`, *isteğe bağlı*) : PrivateLink giriş noktasının AWS bölgesi (`"us-east-1"` veya `"eu-west-1"`), `private_link_account_id`'nin VPC uç noktasının bağlanacağı bölge. Hesaplama `region`'ı ve `vendor`'undan bağımsızdır. min_replica (`int`, *isteğe bağlı*) : Inference Endpoint için çalışır durumda tutulacak en az replika (örnek) sayısı. Sıfıra ölçeklemeyi etkinleştirmek için bu değeri 0 olarak ayarlayın ve `scale_to_zero_timeout` değerini buna göre düzenleyin. Varsayılan değer 1'dir. max_replica (`int`, *isteğe bağlı*) : Inference Endpoint için ölçeklenecek maksimum replika (örnek) sayısı. Varsayılan değer 1'dir. scaling_metric (`str` veya `InferenceEndpointScalingMetric `, *isteğe bağlı*) : Ölçeklendirme için metrik referansı. Verildiğinde "pendingRequests" veya "hardwareUsage" olmalıdır. Varsayılan değeri None'dır (anlamı: metriği HF Endpoints hizmetinin belirlemesine izin ver). scaling_threshold (`float`, *isteğe bağlı*) : Ölçek büyütme tetiklemek için kullanılan ölçekleme metriği eşiği. Ölçekleme metriği sağlanmadığında yok sayılır. Varsayılan değeri None'dır (anlamı: eşiği HF Endpoints hizmetinin belirlemesine izin ver). scale_to_zero_timeout (`int`, *isteğe bağlı*) : Pasif bir uç noktanın sıfıra ölçeklenmeden önce geçen dakika süresi; None olarak ayarlanırsa ve `min_replica` 0 değilse sıfıra ölçekleme yapılmaz. Varsayılan değeri None'dır. revision (`str`, *isteğe bağlı*) : Inference Endpoint üzerinde dağıtılacak belirli model revizyonu (ör. `"6c0e6080953db56375760c0471a8c5f2929baf11"`). task (`str`, *isteğe bağlı*) : Modelin dağıtılacağı görev (ör. `"text-classification"`). custom_image (`dict`, *isteğe bağlı*) : Çalıştırılacak konteyner görüntüsü. Anahtarları görüntü varyantı olan bir sözlük (ör. `{"vLLM": {"url": "vllm/vllm-openai:v0.23.0", "port": 8000}}`, ayrıca `sGLang`, `tgi`, `tei`, `llamacpp`, `hfServe`, ...), olduğu gibi iletilir; ya da özel bir konteyneri tanımlayan düz bir sözlük (ör. `{"url": ..., "port": ...}`), `{"custom": ...}` olarak gönderilir (örnekleri bkz.). Varsayılan olarak Hugging Face tarafından yönetilen görüntü kullanılır. container_registry_username (`str`, *isteğe bağlı*) : Özel bir konteyner görüntüsünü barındıran kayıt defteriyle kimlik doğrulama için kullanılan kullanıcı adı. container_registry_password (`str`, *isteğe bağlı*) : Özel bir konteyner görüntüsünü barındıran kayıt defteriyle kimlik doğrulama için kullanılan şifre. `container_registry_username` parametresini gerektirir. Sağlanmadığında API yükünden (payload) çıkarılır. container_command (`list[str]`, *isteğe bağlı*) : Konteyner giriş noktası komutunu geçersiz kılar (API yükünde `model.command` alanına eşlenir). Hem yönetilen motor görüntüleriyle (ör. vLLM, SGLang) hem de özel görüntülerle çalışır. container_args (`list[str]`, *isteğe bağlı*) : Konteyner giriş noktasına eklenen argümanlar (API yükünde `model.args`'a eşlenir). Hem yönetilen motor görüntüleriyle (ör. vLLM, SGLang) hem de özel görüntülerle çalışır. env (`dict[str, str]`, *isteğe bağlı*) : Konteyner ortamına enjekte edilecek gizli olmayan ortam değişkenleri. secrets (`dict[str, str]`, *isteğe bağlı*) : Konteyner ortamına enjekte edilecek gizli değerler. type ([`InferenceEndpointType]`, *isteğe bağlı*) : Inference Endpoint'ın türü; varsayılan olarak `"authenticated"`, `"public"` veya `"private"` olabilir. domain (`str`, *isteğe bağlı*) : Inference Endpoint dağıtımı için özel alan adı, yapılandırılmışsa inference endpoint bu alan adında kullanılabilir olacak (ör. `"my-new-domain.cool-website.woof"`). path (`str`, *isteğe bağlı*) : Dağıtılan modelin özel yolu, `/` ile başlamalıdır (ör. `"/models/google-bert/bert-base-uncased"`). cache_http_responses (`bool`, *isteğe bağlı*) : Inference Endpoint'ten gelen HTTP yanıtlarının önbelleğe alınıp alınmayacağını belirtir. Varsayılan olarak `False`'tır. tags (`list[str]`, *isteğe bağlı*) : Inference Endpoint ile ilişkilendirilecek etiketlerin listesi. namespace (`str`, *isteğe bağlı*) : Inference Endpoint'in oluşturulacağı ad alanı. Varsayılan olarak mevcut kullanıcının ad alanıdır. token (`bool` veya `str`, *isteğe bağlı*) : Geçerli bir kullanıcı erişim belirteci (dize). Varsayılan olarak, kimlik doğrulama için önerilen yöntem olan yerel olarak kaydedilmiş belirteç kullanılır (bkz. https://huggingface.co/docs/huggingface_hub/quick-start#authentication). Kimlik doğrulamayı devre dışı bırakmak için `False` geçirin. **Dönüş:** [InferenceEndpoint](/docs/huggingface_hub/v2.4.0/tr/package_reference/inference_endpoints#huggingface_hub.InferenceEndpoint) güncellenmiş Inference Endpoint hakkında bilgi. Yeni bir Inference Endpoint oluşturun. `accelerator`, `instance_size`, `instance_type`, `region` ve `vendor` değerleri birbirine bağlıdır; geçerli kombinasyonları listelemek için [list_inference_endpoints_hardware()](/docs/huggingface_hub/v2.4.0/tr/package_reference/hf_api#huggingface_hub.HfApi.list_inference_endpoints_hardware) kullanın. Örnek: ```python >>> from huggingface_hub import HfApi >>> api = HfApi() >>> endpoint = api.create_inference_endpoint( ... "my-endpoint-name", ... repository="gpt2", ... framework="pytorch", ... task="text-generation", ... accelerator="cpu", ... vendor="aws", ... region="us-east-1", ... type="authenticated", ... instance_size="x2", ... instance_type="intel-icl", ... ) >>> endpoint InferenceEndpoint(name='my-endpoint-name', status="pending",...) # Run inference on the endpoint >>> endpoint.client.text_generation(...) "..." ``` ```python # Start an Inference Endpoint running Zephyr-7b-beta on TGI >>> from huggingface_hub import HfApi >>> api = HfApi() >>> endpoint = api.create_inference_endpoint( ... "aws-zephyr-7b-beta-0486", ... repository="HuggingFaceH4/zephyr-7b-beta", ... framework="pytorch", ... task="text-generation", ... accelerator="gpu", ... vendor="aws", ... region="us-east-1", ... type="authenticated", ... instance_size="x1", ... instance_type="nvidia-a10g", ... env={ ... "MAX_BATCH_PREFILL_TOKENS": "2048", ... "MAX_INPUT_LENGTH": "1024", ... "MAX_TOTAL_TOKENS": "1512", ... "MODEL_ID": "/repository" ... }, ... custom_image={ ... "healthRoute": "/health", ... "url": "ghcr.io/huggingface/text-generation-inference:1.1.0", ... }, ... secrets={"MY_SECRET_KEY": "secret_value"}, ... tags=["dev", "text-generation"], ... ) ``` ```python # Start an Inference Endpoint running ProsusAI/finbert while scaling to zero in 15 minutes >>> from huggingface_hub import HfApi >>> api = HfApi() >>> endpoint = api.create_inference_endpoint( ... "finbert-classifier", ... repository="ProsusAI/finbert", ... framework="pytorch", ... task="text-classification", ... min_replica=0, ... scale_to_zero_timeout=15, ... accelerator="cpu", ... vendor="aws", ... region="us-east-1", ... type="authenticated", ... instance_size="x2", ... instance_type="intel-icl", ... ) >>> endpoint.wait(timeout=300) # Run inference on the endpoint >>> endpoint.client.text_generation(...) TextClassificationOutputElement(label='positive', score=0.8983615040779114) ``` #### create_inference_endpoint_from_catalog[[huggingface_hub.HfApi.create_inference_endpoint_from_catalog]] ```python create_inference_endpoint_from_catalog(repo_id: str | None = None, recipe_id: str | None = None, name: str | None = None, accelerator: Literal['cpu', 'gpu', 'neuron'] | str | None = None, gguf_file: str | None = None, token: bool | str | None = None, namespace: str | None = None) ``` [Kaynak](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L9502) **Parametreler:** repo_id (`str`, *isteğe bağlı*) : Bir Inference Endpoint olarak dağıtılacak katalogdaki modelin kimliği. `recipe_id` ile karşılıklı olarak dışlayıcıdır. recipe_id (`str`, *isteğe bağlı*) : Dağıtılacak katalog tarifinin kimliği (bkz. [InferenceCatalogRecipe](/docs/huggingface_hub/v2.4.0/tr/package_reference/inference_endpoints#huggingface_hub.InferenceCatalogRecipe)). `repo_id` ile karşılıklı olarak dışlayıcıdır. name (`str`, *isteğe bağlı*) : Yeni Inference Endpoint için benzersiz ad. Sağlanmazsa rastgele bir ad oluşturulur. accelerator (`str`, *isteğe bağlı*) : Çıkarım için kullanılacak donanım hızlandırıcısı. Olası değerler arasında `"cpu"`, `"gpu"` ve `"neuron"` bulunur. Belirtilmezse, sunucu model için uygun bir varsayılanı kullanır. Yalnızca `repo_id` ile geçerlidir. gguf_file (`str`, *isteğe bağlı*) : Her kuantizasyon için bir tarife olan modeller için dağıtılacak GGUF dosyası (ör. `"Qwen2.5-Coder-32B-Instruct-Q4_K_M.gguf"`). Yalnızca `repo_id` ile geçerlidir. token (`bool` veya `str`, *isteğe bağlı*) : Geçerli bir kullanıcı erişim belirteci (dize). Varsayılan olarak, kimlik doğrulama için önerilen yöntem olan yerel olarak kaydedilmiş belirteç kullanılır (bkz. https://huggingface.co/docs/huggingface_hub/quick-start#authentication). namespace (`str`, *isteğe bağlı*) : Inference Endpoint'in oluşturulacağı ad alanı. Varsayılan olarak mevcut kullanıcının ad alanıdır. **Dönüş:** [InferenceEndpoint](/docs/huggingface_hub/v2.4.0/tr/package_reference/inference_endpoints#huggingface_hub.InferenceEndpoint) yeni Inference Endpoint hakkında bilgi. Hugging Face Inference Catalog'dan yeni bir Inference Endpoint oluşturun. Inference Catalog'un amacı, çıkarım için optimize edilmiş ve varsayılan yapılandırmaları test edilmiş modellerin küratörlü bir listesini sağlamaktır. Katalogdaki mevcut modellerin listesini https://endpoints.huggingface.co/catalog adresinde görüntüleyebilirsiniz. Her katalog modeli, *recipe* (tarif) aracılığıyla dağıtılır: bu model için test edilmiş bir donanım ve motor kombinasyonu. Bir modelin varsayılan recipe'ini dağıtmak için `repo_id` parametresini, isteğe bağlı olarak `accelerator` ve `gguf_file` ile daraltarak, ya da [list_inference_catalog()](/docs/huggingface_hub/v2.4.0/tr/package_reference/hf_api#huggingface_hub.HfApi.list_inference_catalog) tarafından listelenen tam bir recipe'yi dağıtmak için `recipe_id` parametresini iletin. > [!WARNING] > `create_inference_endpoint_from_catalog` deneyseldir. API'si gelecekte değişiklik gösterebilir. Öneri veya talepleriniz varsa lütfen geri bildirimde bulunun. #### create_pull_request[[huggingface_hub.HfApi.create_pull_request]] ```python create_pull_request(repo_id: str, title: str, token: bool | str | None = None, description: str | None = None, repo_type: str | None = None) ``` [Kaynak](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L7529) **Parametreler:** repo_id (`str`) : `/` ile ayrılmış bir ad alanı (kullanıcı veya kuruluş) ve bir depo adı. title (`str`) : Tartışmanın başlığı. En fazla 200 karakter uzunluğunda olabilir ve en az 3 karakter uzunluğunda olmalıdır. Baştaki ve sonda boşluklar kaldırılır. token (`bool` veya `str`, *isteğe bağlı*) : Geçerli bir kullanıcı erişim belirteci (dize). Varsayılan olarak, kimlik doğrulama için önerilen yöntem olan yerel olarak kaydedilmiş belirteç kullanılır (bkz. https://huggingface.co/docs/huggingface_hub/quick-start#authentication). Kimlik doğrulamayı devre dışı bırakmak için `False` geçirin. description (`str`, *isteğe bağlı*) : Pull Request için isteğe bağlı bir açıklama. Varsayılan olarak `"Discussion opened with the huggingface_hub Python library"` repo_type (`str`, *isteğe bağlı*) : Bir veri setine veya uzaya yükleniyorsa `"dataset"` veya `"space"` olarak, bir modele yükleniyorsa `None` veya `"model"` olarak ayarlayın. Varsayılan değer `None`'dir. Bir Pull Request oluşturur. Programatik olarak oluşturulan Pull Request'ler `"draft"` durumundadır. Değişikliklerle bir Pull Request oluşturmak, [HfApi.create_commit()](/docs/huggingface_hub/v2.4.0/tr/package_reference/hf_api#huggingface_hub.HfApi.create_commit) ile tek seferde de yapılabilir; Bu, [HfApi.create_discussion()](/docs/huggingface_hub/v2.4.0/tr/package_reference/hf_api#huggingface_hub.HfApi.create_discussion) etrafında bir sarmalayıcıdır. Dönüş: [DiscussionWithDetails](/docs/huggingface_hub/v2.4.0/tr/package_reference/community#huggingface_hub.DiscussionWithDetails) > [!TIP] > Aşağıdaki hataları oluşturur: > > - [`HTTPError`](https://requests.readthedocs.io/en/latest/api/#requests.HTTPError) HuggingFace API bir hata döndürürse - [`ValueError`](https://docs.python.org/3/library/exceptions.html#ValueError) bir parametre değeri geçersizse - [RepositoryNotFoundError](/docs/huggingface_hub/v2.4.0/tr/package_reference/utilities#huggingface_hub.errors.RepositoryNotFoundError) İndirme yapılacak deposu bulunamazsa. Bunun nedeni, deponun var olmaması veya `private` olarak ayarlanmış olması ve erişiminizin bulunmaması olabilir. #### create_repo[[huggingface_hub.HfApi.create_repo]] ```python create_repo(repo_id: str, token: str | bool | None = None, private: bool | None = None, visibility: RepoVisibility_T | None = None, repo_type: str | None = None, exist_ok: bool = False, resource_group_id: str | None = None, region: REPO_REGIONS | None = None, space_sdk: str | None = None, space_hardware: SpaceHardware | None = None, space_sleep_time: int | None = None, space_secrets: list[dict[str, str]] | None = None, space_variables: list[dict[str, str]] | None = None, space_volumes: list[Volume] | None = None, space_template: str | None = None) ``` [Kaynak](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L4576) **Parametreler:** repo_id (`str`) : `/` ile ayrılmış bir ad alanı (kullanıcı veya kuruluş) ve bir depo adı. token (`bool` veya `str`, *isteğe bağlı*) : Geçerli bir kullanıcı erişim belirteci (dize). Varsayılan olarak, kimlik doğrulama için önerilen yöntem olan yerel olarak kaydedilmiş belirteç kullanılır (bkz. https://huggingface.co/docs/huggingface_hub/quick-start#authentication). Kimlik doğrulamayı devre dışı bırakmak için `False` geçirin. private (`bool`, *isteğe bağlı*) : Depoyu özel yapılıp yapılmayacağını belirtir. `None` (varsayılan) ise, organizasyonun varsayılanı özel değilse depo herkese açık olur. Depo zaten mevcutsa bu değer yok sayılır. `visibility` parametresiyle birlikte geçirilemez. visibility (`Literal["public", "private", "protected"]`, *isteğe bağlı*) : Deponun görünürlüğü. `"public"` veya `"private"` olabilir, Spaces için `"protected"` olabilir. `None` (varsayılan) ise, organizasyonun varsayılanı özel olmadıkça depo herkese açık olur. Depo zaten mevcutsa bu değer yok sayılır. repo_type (`str`, *isteğe bağlı*) : Bir veri setine veya uzaya yükleniyorsa `"dataset"` veya `"space"` olarak, bir modele yükleniyorsa `None` veya `"model"` olarak ayarlayın. Varsayılan değer `None`'dir. exist_ok (`bool`, *isteğe bağlı*, varsayılan `False`) : `True` ise, depo zaten varsa hata yükseltilmez. resource_group_id (`str`, *isteğe bağlı*) : Deponun oluşturulacağı kaynak grubu. Kaynak grupları yalnızca Enterprise Hub kuruluşları için kullanılabilir ve kuruluşun hangi üyelerinin kaynağa erişebileceğini tanımlamaya olanak tanır. Bir kaynak grubunun kimliği, Hub'daki kaynağın sayfasındaki URL'de bulunabilir (ör. `"66670e5163145ca562cb1988"`). Kaynak grupları hakkında daha fazla bilgi için https://huggingface.co/docs/hub/en/security-resource-groups adresine bakın. region (`Literal["us", "eu"]`, *isteğe bağlı*) : Deponun oluşturulacağı bulut bölgesi. `"us"` veya `"eu"` değerlerinden biri olabilir. Belirtilmezse depo, varsayılan bölgede oluşturulur. Team planı veya üstü bir plan gerektirir. space_sdk (`str`, *isteğe bağlı*) : repo_type "space" ise kullanılacak SDK seçimi. "streamlit", "gradio", "docker" veya "static" olabilir. `"static"` Spaces herkes için ücretsizdir. Diğer SDK'lar hesaplama üzerinde çalışır: ücretsiz `cpu-basic` donanımında abonelik gerektirirler (kullanıcılar için PRO, kuruluşlar için Team veya Enterprise), ücretli donanımda ise yalnızca faturalama (bir ödeme yöntemi ve önceden yüklenmiş krediler) yeterlidir. space_hardware (`SpaceHardware` veya `str`, *isteğe bağlı*) : repo_type "space" ise donanım seçimi. Tam liste için [SpaceHardware](/docs/huggingface_hub/v2.4.0/tr/package_reference/space_runtime#huggingface_hub.SpaceHardware) bölümüne bakın. space_sleep_time (`int`, *isteğe bağlı*) : Bir Space'in uyku moduna alınmadan önce beklenmesi gereken boşta kalma süresi (saniye cinsinden). Space'inizin uyumasını istemiyorsanız `-1` olarak ayarlayın (yükseltilmiş donanımlar için varsayılan davranış). Ücretsiz donanımlarda uyku süresi yapılandırılamaz (değer 48 saat boşta kalma olarak sabittir). Daha fazla ayrıntı için https://huggingface.co/docs/hub/spaces-gpus#sleep-time adresine bakın. space_secrets (`list[dict[str, str]]`, *isteğe bağlı*) : Space'inizde ayarlanacak gizli anahtarların listesi. Her öğe `{"key": ..., "value": ..., "description": ...}` biçimindedir ve description isteğe bağlıdır. Daha fazla ayrıntı için bkz. https://huggingface.co/docs/hub/spaces-overview#managing-secrets. space_variables (`list[dict[str, str]]`, *isteğe bağlı*) : Space'inizde ayarlanacak herkese açık ortam değişkenlerinin listesi. Her öğe `{"key": ..., "value": ..., "description": ...}` biçimindedir ve description isteğe bağlıdır. Daha fazla ayrıntı için bkz. https://huggingface.co/docs/hub/spaces-overview#managing-secrets-and-environment-variables. space_volumes (`list[Volume]`, *isteğe bağlı*) : Space oluşturulurken bağlanacak [Volume](/docs/huggingface_hub/v2.4.0/tr/package_reference/jobs#huggingface_hub.Volume) nesnelerinin listesi. Her hacmin bir `type` (`"bucket"`, `"model"`, `"dataset"` veya `"space"`), bir `source` (repo veya bucket kimliği), bir `mount_path` (konteyner içindeki yol) ve isteğe bağlı `revision`, `read_only` ile `path` alanları vardır. Yalnızca repo_type "space" ise geçerlidir. space_template (`str`, *isteğe bağlı*) : Yeni Space'i resmi bir şablonla başlatır. Şablon depo kimliği (ör. `"SpacesExamples/jupyterlab"`) veya kısa adı (ör. `"JupyterLab"`) olabilir. Kullanılabilir şablonları listelemek için [HfApi.list_space_templates()](/docs/huggingface_hub/v2.4.0/tr/package_reference/hf_api#huggingface_hub.HfApi.list_space_templates) kullanın. Yalnızca repo_type "space" ise geçerlidir. Şablonun özel olarak önerilmesi ve görünürlük açıkça ayarlanmamışsa, Space özel olarak oluşturulur. **Dönüş:** [RepoUrl](/docs/huggingface_hub/v2.4.0/tr/package_reference/hf_api#huggingface_hub.RepoUrl) Yeni oluşturulan depoya ait URL. Değer, `endpoint`, `repo_type` ve `repo_id` gibi öznitelikleri içeren `str`'nin bir alt sınıfıdır. HuggingFace Hub üzerinde boş bir depo oluşturun. #### create_scheduled_job[[huggingface_hub.HfApi.create_scheduled_job]] ```python create_scheduled_job(image: str, command: list[str], schedule: str, suspend: bool | None = None, concurrency: bool | None = None, env: dict[str, Any] | None = None, secrets: dict[str, Any] | None = None, flavor: JobHardware | str | None = None, timeout: int | float | str | None = None, attempts: int | None = None, name: str | None = None, labels: dict[str, str] | None = None, volumes: list[Volume] | None = None, expose: list[int] | None = None, expose_public: list[int] | None = None, resource_group_id: str | None = None, namespace: str | None = None, token: bool | str | None = None) ``` [Kaynak](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L13072) **Parametreler:** image (`str`) : Kullanılacak Docker görüntüsü. Örnekler: `"ubuntu"`, `"python:3.12"`, `"pytorch/pytorch:2.6.0-cuda12.4-cudnn9-devel"`. Bir Space'ten görüntü örneği: `"hf.co/spaces/lhoestq/duckdb"`. command (`list[str]`) : Çalıştırılacak komut. Örnek: `["echo", "hello"]`. schedule (`str`) : "@annually", "@yearly", "@monthly", "@weekly", "@daily", "@hourly" değerlerinden biri veya bir CRON zamanlama ifadesi (ör. her Pazartesi saat 9:00 için '0 9 * * 1'). suspend (`bool`, *isteğe bağlı*) : True ise, planlanan Job askıya alınır (durdurulur). Varsayılan olarak False'dur. concurrency (`bool`, *isteğe bağlı*) : True ise, bu Job'un birden fazla örneği eşzamanlı olarak çalıştırılabilir. Varsayılan değeri False'dur. env (`dict[str, Any]`, *isteğe bağlı*) : Job için ortam değişkenlerini tanımlar. secrets (`dict[str, Any]`, *isteğe bağlı*) : Job için gizli ortam değişkenlerini tanımlar. flavor (`str`, *isteğe bağlı*) : Donanım için tür. Olası değerler için `JobHardware`'a bakın. Varsayılan değer `"cpu-basic"`'tir. timeout (`Union[int, float, str]`, *isteğe bağlı*) : İşin (Job) maksimum süresi: int ile s (saniye, varsayılan), m (dakika), h (saat) veya d (gün). Örnek: 5 dakika için `300` veya `"5m"`. attempts (`int`, *isteğe bağlı*) : Her çalıştırma için, ilk deneme dahil olmak üzere maksimum deneme sayısı. Varsayılan değer 1'dir. name (`str`, *isteğe bağlı*) : Planlanan Job için bir ad. `name` etiketi olarak saklanır. `labels` içindeki `name` anahtarıyla birlikte geçirilemez. Adların benzersiz olması gerekmez. Varsayılan olarak, görüntüden ve komuttan türetilen bir ad (kısa bir hash sonekiyle) kullanılır. labels (`dict[str, str]`, *isteğe bağlı*) : İşe eklenecek etiketler (anahtar-değer çiftleri). volumes (`list[Volume]`, *isteğe bağlı*) : İş konteynerinde hacim olarak bağlanacak Hugging Face Buckets veya Repos. Her hacim, `type` (`"bucket"`, `"model"`, `"dataset"` veya `"space"`), `source` (ör. `"username/my-bucket"`) ve `mount_path` (ör. `"/data"`) içeren bir [Volume](/docs/huggingface_hub/v2.4.0/tr/package_reference/jobs#huggingface_hub.Volume)'dir. expose (`list[int]`, *isteğe bağlı*) : İşler vekili (jobs proxy) üzerinden açılacak konteyner portları. Listelenen her port, herkese açık işler alan adında erişilebilir durumda olur (ör. `https://--8000.hf.jobs`). Erişim için her zaman, işin ad alanına (namespace) okuma erişimi olan bir HF jetonu (token) gerekir. Kimlik doğrulamasız erişim için `expose_public` kullanın. expose_public (`list[int]`, *isteğe bağlı*) : Kimlik doğrulama olmadan Jobs proxy üzerinden açılacak portlar. Bunların `expose` içinde listelenmesine gerek yoktur. resource_group_id (`str`, *isteğe bağlı*) : Zamanlanmış Job'ın oluşturulacağı kaynak grubunun kimliği. Bir organizasyon içindeki kaynaklara erişimi kontrol etmek ve maliyet atama/harcama limiti özellikleri için kullanılır. Sağlanmazsa, zamanlanmış Job herhangi bir kaynak grubunun dışında oluşturulur. namespace (`str`, *isteğe bağlı*) : Job'ün oluşturulacağı ad alanı. Varsayılan olarak mevcut kullanıcının ad alanıdır. token (`bool` veya `str`, *isteğe bağlı*) : Geçerli bir kullanıcı erişim belirteci. Sağlanmazsa, önerilen kimlik doğrulama yöntemi olan yerel olarak kaydedilmiş belirteç kullanılır. Kimlik doğrulamayı devre dışı bırakmak için `False` olarak ayarlayın. Aşağıdaki bağlantıya bakın: https://huggingface.co/docs/huggingface_hub/quick-start#authentication. Hugging Face altyapısında zamanlanmış hesaplama İşleri oluşturun. Örnek: İlk zamanlanmış Job'unuzu oluşturun: ```python >>> from huggingface_hub import create_scheduled_job >>> create_scheduled_job(image="python:3.12", command=["python", "-c" ,"print('Hello from HF compute!')"], schedule="@hourly") ``` Bir CRON zamanlama ifadesi kullanın: ```python >>> from huggingface_hub import create_scheduled_job >>> create_scheduled_job(image="python:3.12", command=["python", "-c" ,"print('this runs every 5min')"], schedule="*/5 * * * *") ``` Zamanlanmış bir GPU İşlemi oluşturun: ```python >>> from huggingface_hub import create_scheduled_job >>> image = "pytorch/pytorch:2.6.0-cuda12.4-cudnn9-devel" >>> command = ["python", "-c", "import torch; print(f'This code ran with the following GPU: {torch.cuda.get_device_name()}')"] >>> create_scheduled_job(image=image, command=command, flavor="a10g-small", schedule="@hourly") ``` #### create_scheduled_uv_job[[huggingface_hub.HfApi.create_scheduled_uv_job]] ```python create_scheduled_uv_job(script: str, script_args: list[str] | None = None, schedule: str, suspend: bool | None = None, concurrency: bool | None = None, dependencies: list[str] | None = None, python: str | None = None, image: str | None = None, env: dict[str, Any] | None = None, secrets: dict[str, Any] | None = None, flavor: JobHardware | str | None = None, timeout: int | float | str | None = None, attempts: int | None = None, name: str | None = None, labels: dict[str, str] | None = None, volumes: list[Volume] | None = None, expose: list[int] | None = None, expose_public: list[int] | None = None, resource_group_id: str | None = None, namespace: str | None = None, token: bool | str | None = None) ``` [Kaynak](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L13551) **Parametreler:** script (`str`) : UV betiğinin yolu veya URL'si, ya da bir komut. script_args (`list[str]`, *isteğe bağlı*) : Betiğe veya komuta iletilecek argümanlar. schedule (`str`) : "@annually", "@yearly", "@monthly", "@weekly", "@daily", "@hourly" değerlerinden biri veya bir CRON zamanlama ifadesi (ör. her Pazartesi saat 9:00 için '0 9 * * 1'). suspend (`bool`, *isteğe bağlı*) : True ise, planlanan Job askıya alınır (durdurulur). Varsayılan olarak False'dur. concurrency (`bool`, *isteğe bağlı*) : True ise, bu Job'un birden fazla örneği eşzamanlı olarak çalıştırılabilir. Varsayılan değeri False'dur. dependencies (`list[str]`, *isteğe bağlı*) : UV betiğini çalıştırmak için kullanılacak bağımlılıklar. python (`str`, *isteğe bağlı*) : Belirli bir Python sürümü kullanın. Varsayılan 3.12'dir. image (`str`, *isteğe bağlı*, varsayılan "ghcr.io/astral-sh/uv --python3.12-bookworm"): `uv` yüklü özel bir Docker görüntüsü kullanın. env (`dict[str, Any]`, *isteğe bağlı*) : Job için ortam değişkenlerini tanımlar. secrets (`dict[str, Any]`, *isteğe bağlı*) : Job için gizli ortam değişkenlerini tanımlar. flavor (`str`, *isteğe bağlı*) : Donanım için tür. Olası değerler için `JobHardware`'a bakın. Varsayılan değer `"cpu-basic"`'tir. timeout (`Union[int, float, str]`, *isteğe bağlı*) : İşin (Job) maksimum süresi: int ile s (saniye, varsayılan), m (dakika), h (saat) veya d (gün). Örnek: 5 dakika için `300` veya `"5m"`. attempts (`int`, *isteğe bağlı*) : Her çalıştırma için, ilk deneme dahil olmak üzere maksimum deneme sayısı. Varsayılan değer 1'dir. name (`str`, *isteğe bağlı*) : Planlanan Job için bir ad. `name` etiketi olarak saklanır. `labels` içindeki `name` anahtarıyla birlikte geçirilemez. Adların benzersiz olması gerekmez. Varsayılan olarak, betikten ve argümanlarından türetilen bir ad (kısa bir hash sonekiyle) kullanılır. labels (`dict[str, str]`, *isteğe bağlı*) : İşe eklenecek etiketler (anahtar-değer çiftleri). volumes (`list[Volume]`, *isteğe bağlı*) : İş konteynerinde hacim olarak bağlanacak Hugging Face Buckets veya Repos. Her hacim, `type` (`"bucket"`, `"model"`, `"dataset"` veya `"space"`), `source` (ör. `"username/my-bucket"`) ve `mount_path` (ör. `"/data"`) içeren bir [Volume](/docs/huggingface_hub/v2.4.0/tr/package_reference/jobs#huggingface_hub.Volume)'dir. expose (`list[int]`, *isteğe bağlı*) : İşler vekili (jobs proxy) üzerinden açılacak konteyner portları. Listelenen her port, herkese açık işler alan adında erişilebilir durumda olur (ör. `https://--8000.hf.jobs`). Erişim için her zaman, işin ad alanına (namespace) okuma erişimi olan bir HF jetonu (token) gerekir. Kimlik doğrulamasız erişim için `expose_public` kullanın. expose_public (`list[int]`, *isteğe bağlı*) : Kimlik doğrulama olmadan Jobs proxy üzerinden açılacak portlar. Bunların `expose` içinde listelenmesine gerek yoktur. resource_group_id (`str`, *isteğe bağlı*) : Zamanlanmış Job'ın oluşturulacağı kaynak grubunun kimliği. Bir organizasyon içindeki kaynaklara erişimi kontrol etmek ve maliyet atama/harcama limiti özellikleri için kullanılır. Sağlanmazsa, zamanlanmış Job herhangi bir kaynak grubunun dışında oluşturulur. namespace (`str`, *isteğe bağlı*) : Job'ün oluşturulacağı ad alanı. Varsayılan olarak mevcut kullanıcının ad alanıdır. token (`bool` veya `str`, *isteğe bağlı*) : Geçerli bir kullanıcı erişim belirteci. Sağlanmazsa, önerilen kimlik doğrulama yöntemi olan yerel olarak kaydedilmiş belirteç kullanılır. Kimlik doğrulamayı devre dışı bırakmak için `False` olarak ayarlayın. Aşağıdaki bağlantıya bakın: https://huggingface.co/docs/huggingface_hub/quick-start#authentication. Hugging Face altyapısında bir UV script Job çalıştırın. > [!WARNING] > `hf jobs uv run`'un aksine, bu yöntem, bir UV betiğinin PEP 723 başlığında taşıyabileceği isteğe bağlı `[tool.hf-jobs]` tablosunu görmezden gelir ([Jobs kılavuzu](../guides/jobs#ship-the-launch-config-with-the-script) bkz.): başlatma yapılandırmasının burada açıkça iletilmesi gerekir. Örnek: Bir URL'den betik zamanla: ```python >>> from huggingface_hub import create_scheduled_uv_job >>> script = "https://raw.githubusercontent.com/huggingface/trl/refs/heads/main/trl/scripts/sft.py" >>> script_args = ["--model_name_or_path", "Qwen/Qwen2-0.5B", "--dataset_name", "trl-lib/Capybara", "--push_to_hub"] >>> create_scheduled_uv_job(script, script_args=script_args, dependencies=["trl"], flavor="a10g-small", schedule="@weekly") ``` Yerel bir betik zamanla: ```python >>> from huggingface_hub import create_scheduled_uv_job >>> script = "my_sft.py" >>> script_args = ["--model_name_or_path", "Qwen/Qwen2-0.5B", "--dataset_name", "trl-lib/Capybara", "--push_to_hub"] >>> create_scheduled_uv_job(script, script_args=script_args, dependencies=["trl"], flavor="a10g-small", schedule="@weekly") ``` Komut zamanla: ```python >>> from huggingface_hub import create_scheduled_uv_job >>> script = "lighteval" >>> script_args= ["endpoint", "inference-providers", "model_name=openai/gpt-oss-20b,provider=auto", "lighteval|gsm8k|0|0"] >>> create_scheduled_uv_job(script, script_args=script_args, dependencies=["lighteval"], flavor="a10g-small", schedule="@weekly") ``` #### create_tag[[huggingface_hub.HfApi.create_tag]] ```python create_tag(repo_id: str, tag: str, tag_message: str | None = None, revision: str | None = None, token: bool | str | None = None, repo_type: str | None = None, exist_ok: bool = False) ``` [Kaynak](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L7095) **Parametreler:** repo_id (`str`) : Bir commit'in etiketleneceği depo. Örnek: `"user/my-cool-model"`. tag (`str`) : Oluşturulacak etiketin adı. tag_message (`str`, *isteğe bağlı*) : Oluşturulacak etiketin açıklaması. revision (`str`, *isteğe bağlı*) : Etiketlenmesi gereken git revizyonu. Bir dal adı veya bir commit'in OID/SHA'sı olarak, onaltılık bir dize olabilir. Kısaltmalar (ilk 7 karakter) de desteklenir. Varsayılan olarak `"main"` dalının başıdır. token (`bool` veya `str`, *isteğe bağlı*) : Geçerli bir kullanıcı erişim belirteci (dize). Varsayılan olarak, kimlik doğrulama için önerilen yöntem olan yerel olarak kaydedilmiş belirteç kullanılır (bkz. https://huggingface.co/docs/huggingface_hub/quick-start#authentication). Kimlik doğrulamayı devre dışı bırakmak için `False` geçirin. repo_type (`str`, *isteğe bağlı*) : Bir veri seti veya alan etiketlenecekse `"dataset"` veya `"space"` olarak, bir model etiketlenecekse `None` veya `"model"` olarak ayarlayın. Varsayılan değer `None`'dir. exist_ok (`bool`, *isteğe bağlı*, varsayılan `False`) : `True` ise, etiket zaten varsa hata yükseltilmez. **Yükseltir:** [RepositoryNotFoundError](/docs/huggingface_hub/v2.4.0/tr/package_reference/utilities#huggingface_hub.errors.RepositoryNotFoundError) veya [RevisionNotFoundError](/docs/huggingface_hub/v2.4.0/tr/package_reference/utilities#huggingface_hub.errors.RevisionNotFoundError) veya [HfHubHTTPError](/docs/huggingface_hub/v2.4.0/tr/package_reference/utilities#huggingface_hub.errors.HfHubHTTPError) - [RepositoryNotFoundError](/docs/huggingface_hub/v2.4.0/tr/package_reference/utilities#huggingface_hub.errors.RepositoryNotFoundError) -- Depo bulunamadıysa (hata 404): repo_id/repo_type yanlış, özel ama kimlik doğrulaması yapılmamış veya depo mevcut değil. - [RevisionNotFoundError](/docs/huggingface_hub/v2.4.0/tr/package_reference/utilities#huggingface_hub.errors.RevisionNotFoundError) -- Depoda revizyon bulunamadıysa (404 hatası). - [HfHubHTTPError](/docs/huggingface_hub/v2.4.0/tr/package_reference/utilities#huggingface_hub.errors.HfHubHTTPError) -- Dal zaten depoda mevcutsa (hata 409) ve `exist_ok` `False` olarak ayarlanmışsa. Hub'daki bir repoyu verilen bir commit ile etiketleyin. #### create_webhook[[huggingface_hub.HfApi.create_webhook]] ```python create_webhook(url: str | None = None, job_id: str | None = None, watched: list[dict | WebhookWatchedItem], domains: list[constants.WEBHOOK_DOMAIN_T] | None = None, secret: str | None = None, secrets: dict[str, str] | None = None, token: bool | str | None = None) ``` [Kaynak](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L11176) **Parametreler:** url (`str`) : Yükün gönderileceği URL. job_id (`str`) : WEBHOOK_PAYLOAD ortam değişkenindeki webhook yüküyle tetiklenecek kaynak Job'un kimliği. Kolaylık için ek ortam değişkenleri de mevcuttur: WEBHOOK_REPO_ID, WEBHOOK_REPO_TYPE ve WEBHOOK_SECRET. watched (`list[WebhookWatchedItem]`) : Webhook tarafından izlenecek [WebhookWatchedItem](/docs/huggingface_hub/v2.4.0/tr/package_reference/hf_api#huggingface_hub.WebhookWatchedItem) listesi. Kullanıcılar, kuruluşlar, modeller, veri kümeleri, uzaylar veya depolar olabilir. İzlenen öğeler düz sözlükler olarak da sağlanabilir. domains (`list[Literal["repo", "discussion"]]`, optional) : İzlenecek alanların listesi. "repo", "discussion" veya her ikisi olabilir. Varsayılan olarak her ikisi de izlenir. secret (`str`, isteğe bağlı) : Yükü imzalamak için kullanılacak gizli anahtar. secrets (`dict[str, str]`, isteğe bağlı) : Webhook tarafından tetiklenen Job için gizli ortam değişkenleri (ör. `{"HF_TOKEN": "hf_***"}`). Yalnızca `job_id` ile geçerlidir. Kaynak Job'un gizli bilgileri webhoook'a kopyalanmaz, bu nedenle bunları buradan iletin. token (`bool` veya `str`, *isteğe bağlı*) : Geçerli bir kullanıcı erişim belirteci (dize). Varsayılan olarak, kimlik doğrulama için önerilen yöntem olan yerel olarak kaydedilmiş belirteç kullanılır (bkz. https://huggingface.co/docs/huggingface_hub/quick-start#authentication). Kimlik doğrulamayı devre dışı bırakmak için `False` geçirin. **Dönüş:** [WebhookInfo](/docs/huggingface_hub/v2.4.0/tr/package_reference/hf_api#huggingface_hub.WebhookInfo) Yeni oluşturulan webhook hakkında bilgi. Yeni bir webhook oluşturun. Webhook, bir URL'ye yük (payload) gönderebilir veya Hugging Face altyapısında bir Job'un çalıştırılmasını tetikleyebilir. Bu fonksiyon, `url` veya `job_id` parametrelerinden yalnızca biriyle çağrılmalıdır; ikisi birlikte kullanılmamalıdır. Örnek: Bir URL'ye bir yük (payload) gönderen bir webhook oluşturun ```python >>> from huggingface_hub import create_webhook >>> payload = create_webhook( ... watched=[{"type": "user", "name": "julien-c"}, {"type": "org", "name": "HuggingFaceH4"}], ... url="https://webhook.site/a2176e82-5720-43ee-9e06-f91cb4c91548", ... domains=["repo", "discussion"], ... secret="my-secret", ... ) >>> print(payload) WebhookInfo( id="654bbbc16f2ec14d77f109cc", url="https://webhook.site/a2176e82-5720-43ee-9e06-f91cb4c91548", job=None, watched=[WebhookWatchedItem(type="user", name="julien-c"), WebhookWatchedItem(type="org", name="HuggingFaceH4")], domains=["repo", "discussion"], secret="my-secret", disabled=False, ) ``` Bir İş çalıştırın ve ardından bu İş'i tetikleyen bir webhook oluşturun ```python >>> from huggingface_hub import create_webhook, run_job >>> job = run_job( ... image="ubuntu", ... command=["bash", "-c", r"echo An event occurred in $WEBHOOK_REPO_ID: $WEBHOOK_PAYLOAD"], ... ) >>> payload = create_webhook( ... watched=[{"type": "user", "name": "julien-c"}, {"type": "org", "name": "HuggingFaceH4"}], ... job_id=job.id, ... domains=["repo", "discussion"], ... secret="my-secret", ... ) >>> print(payload) WebhookInfo( id="654bbbc16f2ec14d77f109cc", url=None, job=JobSpec( docker_image='ubuntu', space_id=None, command=['bash', '-c', 'echo An event occurred in $WEBHOOK_REPO_ID: $WEBHOOK_PAYLOAD'], arguments=[], environment={}, secrets=[], flavor='cpu-basic', timeout=None, tags=None, arch=None ), watched=[WebhookWatchedItem(type="user", name="julien-c"), WebhookWatchedItem(type="org", name="HuggingFaceH4")], domains=["repo", "discussion"], secret="my-secret", disabled=False, ) ``` #### dataset_info[[huggingface_hub.HfApi.dataset_info]] ```python dataset_info(repo_id: str, revision: str | None = None, timeout: float | None = None, files_metadata: bool = False, expand: list[ExpandDatasetProperty_T] | None = None, token: bool | str | None = None) ``` [Kaynak](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L3219) **Parametreler:** repo_id (`str`) : `/` ile ayrılmış bir ad alanı (kullanıcı veya kuruluş) ve bir depo adı. revision (`str`, *isteğe bağlı*) : Bilgilerin alınacağı veri seti deposunun revizyonu. timeout (`float`, *isteğe bağlı*) : Hub'a yapılan istek için bir zaman aşımı ayarlanıp ayarlanmayacağı. files_metadata (`bool`, *isteğe bağlı*) : Depodaki dosyalar için (boyut, LFS meta verisi vb.) meta verilerin alınıp alınmayacağını belirtir. Varsayılan değeri `False`'dir. expand (`list[ExpandDatasetProperty_T]`, *isteğe bağlı*) : Yanıtta döndürülecek özellik listesi. Kullanıldığında, yalnızca listedeki özellikler döndürülür. `files_metadata` geçirildiğinde bu parametre kullanılamaz. Olası değerler `"author"`, `"cardData"`, `"citation"`, `"createdAt"`, `"disabled"`, `"description"`, `"downloads"`, `"downloadsAllTime"`, `"gated"`, `"lastModified"`, `"likes"`, `"mainSize"`, `"paperswithcode_id"`, `"private"`, `"siblings"`, `"sha"`, `"tags"`, `"trendingScore"`, `"usedStorage"` ve `"resourceGroup"`'dir. token (`bool` veya `str`, *isteğe bağlı*) : Geçerli bir kullanıcı erişim belirteci (dize). Varsayılan olarak, kimlik doğrulama için önerilen yöntem olan yerel olarak kaydedilmiş belirteç kullanılır (bkz. https://huggingface.co/docs/huggingface_hub/quick-start#authentication). Kimlik doğrulamayı devre dışı bırakmak için `False` geçirin. **Dönüş:** [hf_api.DatasetInfo](/docs/huggingface_hub/v2.4.0/tr/package_reference/hf_api#huggingface_hub.DatasetInfo) Veri seti deposu bilgileri. huggingface.co'daki belirli bir veri seti hakkında bilgi alın. Geçerli bir token iletirseniz Dataset özel olabilir. > [!TIP] > Aşağıdaki hataları oluşturur: > > - [RepositoryNotFoundError](/docs/huggingface_hub/v2.4.0/tr/package_reference/utilities#huggingface_hub.errors.RepositoryNotFoundError) İndirilecek depo bulunamazsa. Bunun nedeni, deponun var olmaması veya `private` olarak ayarlanmış olması ve erişiminizin bulunmaması olabilir. - [RevisionNotFoundError](/docs/huggingface_hub/v2.4.0/tr/package_reference/utilities#huggingface_hub.errors.RevisionNotFoundError) İndirilecek revizyon bulunamazsa. #### delete_branch[[huggingface_hub.HfApi.delete_branch]] ```python delete_branch(repo_id: str, branch: str, token: bool | str | None = None, repo_type: str | None = None) ``` [Kaynak](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L7043) **Parametreler:** repo_id (`str`) : Bir dalın silineceği depo. Örnek: `"user/my-cool-model"`. branch (`str`) : Silinecek dalın adı. token (`bool` veya `str`, *isteğe bağlı*) : Geçerli bir kullanıcı erişim belirteci (dize). Varsayılan olarak, kimlik doğrulama için önerilen yöntem olan yerel olarak kaydedilmiş belirteç kullanılır (bkz. https://huggingface.co/docs/huggingface_hub/quick-start#authentication). Kimlik doğrulamayı devre dışı bırakmak için `False` geçirin. repo_type (`str`, *isteğe bağlı*) : Bir veri seti veya uzay üzerinde dal oluşturuyorsanız `"dataset"` veya `"space"` olarak, bir modele etiket atıyorsanız `None` veya `"model"` olarak ayarlayın. Varsayılan değer `None`'dir. **Yükseltir:** [RepositoryNotFoundError](/docs/huggingface_hub/v2.4.0/tr/package_reference/utilities#huggingface_hub.errors.RepositoryNotFoundError) veya [HfHubHTTPError](/docs/huggingface_hub/v2.4.0/tr/package_reference/utilities#huggingface_hub.errors.HfHubHTTPError) - [RepositoryNotFoundError](/docs/huggingface_hub/v2.4.0/tr/package_reference/utilities#huggingface_hub.errors.RepositoryNotFoundError) -- Depo bulunamadıysa (hata 404): repo_id/repo_type yanlış, özel ama kimlik doğrulaması yapılmamış veya depo mevcut değil. - [HfHubHTTPError](/docs/huggingface_hub/v2.4.0/tr/package_reference/utilities#huggingface_hub.errors.HfHubHTTPError) -- Korunan bir dalı silmeye çalışırken. Örnek: `main` silinemez. - [HfHubHTTPError](/docs/huggingface_hub/v2.4.0/tr/package_reference/utilities#huggingface_hub.errors.HfHubHTTPError) -- Silinmeye çalışılan dal mevcut değilse. Hub'daki bir depodan bir dalı silin. #### delete_bucket[[huggingface_hub.HfApi.delete_bucket]] ```python delete_bucket(bucket_id: str, missing_ok: bool = False, token: bool | str | None = None) ``` [Kaynak](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L14157) **Parametreler:** bucket_id (`str`) : Kovanın kimliği (ör. `"username/my-bucket"`). missing_ok (`bool`, *isteğe bağlı*, varsayılan `False`) : `True` ise, varlık (bucket) yoksa hata yükseltilmez. token (`bool` veya `str`, *isteğe bağlı*) : Geçerli bir kullanıcı erişim belirteci (dize). Varsayılan olarak, kimlik doğrulama için önerilen yöntem olan yerel olarak kaydedilmiş belirteç kullanılır (bkz. https://huggingface.co/docs/huggingface_hub/quick-start#authentication). Kimlik doğrulamayı devre dışı bırakmak için `False` geçirin. **Yükselen:** `BucketNotFoundError` - `BucketNotFoundError` -- Bucket bulunamadığında ve `missing_ok` `False` olarak ayarlanmışsa (varsayılan). Hub'dan bir varlık silin. Örnek: ```python >>> from huggingface_hub import delete_bucket >>> delete_bucket(bucket_id="Wauplin/first-bucket") >>> delete_bucket(bucket_id="Wauplin/first-bucket", missing_ok=True) ``` #### delete_collection[[huggingface_hub.HfApi.delete_collection]] ```python delete_collection(collection_slug: str, missing_ok: bool = False, token: bool | str | None = None) ``` [Kaynak](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L10373) **Parametreler:** collection_slug (`str`) : Silinecek koleksiyonun slug'ı. Örnek: `"TheBloke/recent-models-64f9a55bb3115b4f513ec026"`. missing_ok (`bool`, *isteğe bağlı*) : `True` ise, koleksiyon yoksa hata yükseltilmez. token (`bool` veya `str`, *isteğe bağlı*) : Geçerli bir kullanıcı erişim belirteci (dize). Varsayılan olarak, kimlik doğrulama için önerilen yöntem olan yerel olarak kaydedilmiş belirteç kullanılır (bkz. https://huggingface.co/docs/huggingface_hub/quick-start#authentication). Kimlik doğrulamayı devre dışı bırakmak için `False` geçirin. Hub'da bir koleksiyonu silin. Örnek: ```py >>> from huggingface_hub import delete_collection >>> collection = delete_collection("username/useless-collection-64f9a55bb3115b4f513ec026", missing_ok=True) ``` > [!WARNING] > Bu geri alınamaz bir eylemdir. Silinen bir koleksiyon geri yüklenemez. #### delete_collection_item[[huggingface_hub.HfApi.delete_collection_item]] ```python delete_collection_item(collection_slug: str, item_object_id: str, missing_ok: bool = False, token: bool | str | None = None) ``` [Kaynak](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L10548) **Parametreler:** collection_slug (`str`) : Güncellenecek koleksiyonun slug'ı. Örnek: `"TheBloke/recent-models-64f9a55bb3115b4f513ec026"`. item_object_id (`str`) : Koleksiyondaki öğenin kimliği. Bu, Hub'daki öğenin kimliği (repo_id veya makale kimliği) değildir. [CollectionItem](/docs/huggingface_hub/v2.4.0/tr/package_reference/collections#huggingface_hub.CollectionItem) nesnesinden alınmalıdır. Örnek: `collection.items[0].item_object_id`. missing_ok (`bool`, *isteğe bağlı*) : `True` ise, öğe mevcut değilse hata yükseltilmez. token (`bool` veya `str`, *isteğe bağlı*) : Geçerli bir kullanıcı erişim belirteci (dize). Varsayılan olarak, kimlik doğrulama için önerilen yöntem olan yerel olarak kaydedilmiş belirteç kullanılır (bkz. https://huggingface.co/docs/huggingface_hub/quick-start#authentication). Kimlik doğrulamayı devre dışı bırakmak için `False` geçirin. Bir koleksiyondan bir öğe silin. Örnek: ```py >>> from huggingface_hub import get_collection, delete_collection_item # Get collection first >>> collection = get_collection("TheBloke/recent-models-64f9a55bb3115b4f513ec026") # Delete item based on its ID >>> delete_collection_item( ... collection_slug="TheBloke/recent-models-64f9a55bb3115b4f513ec026", ... item_object_id=collection.items[-1].item_object_id, ... ) ``` #### delete_file[[huggingface_hub.HfApi.delete_file]] ```python delete_file(path_in_repo: str, repo_id: str, token: str | bool | None = None, repo_type: str | None = None, revision: str | None = None, commit_message: str | None = None, commit_description: str | None = None, create_pr: bool | None = None, parent_commit: str | None = None) ``` [Kaynak](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L6045) **Parametreler:** path_in_repo (`str`) : Depodaki göreli dosya yolu, örneğin: `"checkpoints/1fec34a/weights.bin"` repo_id (`str`) : Dosyanın silineceği depo, örneğin: `"username/custom_transformers"` token (`bool` veya `str`, *isteğe bağlı*) : Geçerli bir kullanıcı erişim belirteci (dize). Varsayılan olarak, kimlik doğrulama için önerilen yöntem olan yerel olarak kaydedilmiş belirteç kullanılır (bkz. https://huggingface.co/docs/huggingface_hub/quick-start#authentication). Kimlik doğrulamayı devre dışı bırakmak için `False` geçirin. repo_type (`str`, *isteğe bağlı*) : Dosya bir veri setinde veya uzaydaysa `"dataset"` veya `"space"` olarak ayarlanır, bir modeldeyse `None` veya `"model"`. Varsayılan `None`'dir. revision (`str`, *isteğe bağlı*) : Commit'in alınacağı git revizyonu. Varsayılan olarak `"main"` dalının başıdır. commit_message (`str`, *isteğe bağlı*) : Oluşturulan commit'in özeti / başlığı / ilk satırı. Varsayılan olarak `f"Delete {path_in_repo} with huggingface_hub"`. commit_description (`str`, *isteğe bağlı*) : Oluşturulan commit'in açıklaması create_pr (`boolean`, *isteğe bağlı*) : Bu commit ile bir Pull Request oluşturulup oluşturulmayacağı. Varsayılan olarak `False`. `revision` ayarlanmadıysa, PR `"main"` dalına karşı açılır. `revision` ayarlandıysa ve bir dal ise, PR bu dala karşı açılır. `revision` ayarlandıysa ve bir dal adı değilse (örneğin: bir commit oid), sunucu tarafından `RevisionNotFoundError` döndürülür. parent_commit (`str`, *isteğe bağlı*) : Ebeveyn commit'in OID / SHA'sı, onaltılık bir dize olarak. Kısaltmalar (ilk 7 karakter) de desteklenir. Belirtilirse ve `create_pr` `False` ise, `revision` `parent_commit`'e işaret etmiyorsa commit başarısız olur. Belirtilirse ve `create_pr` `True` ise, pull request `parent_commit`'ten oluşturulur. `parent_commit`'in belirtilmesi, değişiklikler commit edilmeden önce repoyun değişmediğinden emin olunmasını sağlar ve repo eşzamanlı olarak güncelleniyor / commit ediliyorsa özellikle faydalı olabilir. Verilen depodaki bir dosyayı siler. > [!TIP] > Aşağıdaki hataları oluşturur: > > - [`HTTPError`](https://requests.readthedocs.io/en/latest/api/#requests.HTTPError) HuggingFace API bir hata döndürürse - [`ValueError`](https://docs.python.org/3/library/exceptions.html#ValueError) bir parametre değeri geçersizse - [RepositoryNotFoundError](/docs/huggingface_hub/v2.4.0/tr/package_reference/utilities#huggingface_hub.errors.RepositoryNotFoundError) İndirme yapılacak deposu bulunamazsa. Bunun nedeni, deponun var olmaması veya `private` olarak ayarlanmış olması ve erişiminizin olmaması olabilir. - [RevisionNotFoundError](/docs/huggingface_hub/v2.4.0/tr/package_reference/utilities#huggingface_hub.errors.RevisionNotFoundError) İndirme yapılacak revizyon bulunamazsa. - [EntryNotFoundError](/docs/huggingface_hub/v2.4.0/tr/package_reference/utilities#huggingface_hub.errors.EntryNotFoundError) İndirilecek dosya bulunamazsa. #### delete_files[[huggingface_hub.HfApi.delete_files]] ```python delete_files(repo_id: str, delete_patterns: list[str], token: bool | str | None = None, repo_type: str | None = None, revision: str | None = None, commit_message: str | None = None, commit_description: str | None = None, create_pr: bool | None = None, parent_commit: str | None = None) ``` [Kaynak](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L6135) **Parametreler:** repo_id (`str`) : Klasörün silineceği depo, örneğin: `"username/custom_transformers"` delete_patterns (`list[str]`) : Silinecek dosya veya klasörlerin listesi. Her dize bir dosya yolu, bir klasör yolu veya bir joker deseni olabilir. Desenler, [burada](https://tldp.org/LDP/GNU-Linux-Tools-Summary/html/x11655.htm) belgelenen Standart Jokerler (globbing desenleri)dir. Desen eşleştirme [`fnmatch`](https://docs.python.org/3/library/fnmatch.html) tabanlıdır. Dikkat edin, `fnmatch`, geleneksel Unix kabuğu globbing'inden farklı olarak `*` karakterini yol sınırları boyunca eşleştirir. Örn. `["file.txt", "folder/", "data/*.parquet"]` token (`bool` veya `str`, *isteğe bağlı*) : Geçerli bir kullanıcı erişim belirteci (dize). Varsayılan olarak, kimlik doğrulama için önerilen yöntem olan yerel olarak kaydedilmiş belirteç kullanılır (bkz. https://huggingface.co/docs/huggingface_hub/quick-start#authentication). Kimlik doğrulamayı devre dışı bırakmak için `False` değerini kaydedilmiş belirtece iletin. repo_type (`str`, *isteğe bağlı*) : Dosyaların silineceği repoyu türü. `"model"`, `"dataset"` veya `"space"` olabilir. Varsayılan olarak `"model"` değerini alır. revision (`str`, *isteğe bağlı*) : Commit'in alınacağı git revizyonu. Varsayılan olarak `"main"` dalının başıdır. commit_message (`str`, *isteğe bağlı*) : Oluşturulan commit'in özeti (ilk satırı). Varsayılan olarak `f"Delete files using huggingface_hub"` değerini alır. commit_description (`str`, *isteğe bağlı*) : Oluşturulan commit'in açıklaması. create_pr (`boolean`, *isteğe bağlı*) : Bu commit ile bir Pull Request oluşturulup oluşturulmayacağı. Varsayılan olarak `False`. `revision` ayarlanmadıysa, PR `"main"` dalına karşı açılır. `revision` ayarlandıysa ve bir dal ise, PR bu dala karşı açılır. `revision` ayarlandıysa ve bir dal adı değilse (örneğin: bir commit oid), sunucu tarafından `RevisionNotFoundError` döndürülür. parent_commit (`str`, *isteğe bağlı*) : Ebeveyn commit'in OID / SHA'sı, onaltılık bir dize olarak. Kısaltmalar (ilk 7 karakter) de desteklenir. Belirtilirse ve `create_pr` `False` ise, `revision` `parent_commit`'e işaret etmiyorsa commit başarısız olur. Belirtilirse ve `create_pr` `True` ise, pull request `parent_commit`'ten oluşturulur. `parent_commit`'in belirtilmesi, değişiklikler commit edilmeden önce repoyun değişmediğinden emin olunmasını sağlar ve repo eşzamanlı olarak güncelleniyor / commit ediliyorsa özellikle faydalı olabilir. Hub'daki bir depodan dosyaları silin. Bir klasör yolu sağlanırsa, klasörün kendisi ve içindeki tüm dosyalar da silinir. #### delete_folder[[huggingface_hub.HfApi.delete_folder]] ```python delete_folder(path_in_repo: str, repo_id: str, token: bool | str | None = None, repo_type: str | None = None, revision: str | None = None, commit_message: str | None = None, commit_description: str | None = None, create_pr: bool | None = None, parent_commit: str | None = None) ``` [Kaynak](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L6214) **Parametreler:** path_in_repo (`str`) : Depodaki göreli klasör yolu, örneğin: `"checkpoints/1fec34a"`. repo_id (`str`) : Klasörün silineceği depo, örneğin: `"username/custom_transformers"` token (`bool` veya `str`, *isteğe bağlı*) : Geçerli bir kullanıcı erişim belirteci (dize). Varsayılan olarak, kimlik doğrulama için önerilen yöntem olan yerel olarak kaydedilmiş belirteç kullanılır (bkz. https://huggingface.co/docs/huggingface_hub/quick-start#authentication). Kimlik doğrulamayı devre dışı bırakmak için `False` değerini kaydedilmiş belirtece iletin. repo_type (`str`, *isteğe bağlı*) : Klasör bir veri setinde veya uzaydaysa `"dataset"` veya `"space"` olarak ayarlayın, bir modeldeyse `None` veya `"model"`. Varsayılan `None`'dir. revision (`str`, *isteğe bağlı*) : Commit'in alınacağı git revizyonu. Varsayılan olarak `"main"` dalının başıdır. commit_message (`str`, *isteğe bağlı*) : Oluşturulan commit'in özeti / başlığı / ilk satırı. Varsayılan olarak `f"Delete folder {path_in_repo} with huggingface_hub"`. commit_description (`str`, *isteğe bağlı*) : Oluşturulan commit'in açıklaması. create_pr (`boolean`, *isteğe bağlı*) : Bu commit ile bir Pull Request oluşturulup oluşturulmayacağı. Varsayılan olarak `False`. `revision` ayarlanmadıysa, PR `"main"` dalına karşı açılır. `revision` ayarlandıysa ve bir dal ise, PR bu dala karşı açılır. `revision` ayarlandıysa ve bir dal adı değilse (örneğin: bir commit oid), sunucu tarafından `RevisionNotFoundError` döndürülür. parent_commit (`str`, *isteğe bağlı*) : Ebeveyn commit'in OID / SHA'sı, onaltılık bir dize olarak. Kısaltmalar (ilk 7 karakter) de desteklenir. Belirtilirse ve `create_pr` `False` ise, `revision` `parent_commit`'e işaret etmiyorsa commit başarısız olur. Belirtilirse ve `create_pr` `True` ise, pull request `parent_commit`'ten oluşturulur. `parent_commit`'in belirtilmesi, değişiklikler commit edilmeden önce repoyun değişmediğinden emin olunmasını sağlar ve repo eşzamanlı olarak güncelleniyor / commit ediliyorsa özellikle faydalı olabilir. Verilen depodaki bir klasörü siler. [create_commit()](/docs/huggingface_hub/v2.4.0/tr/package_reference/hf_api#huggingface_hub.HfApi.create_commit) yönteminin basit bir sarmalayıcısı. #### delete_inference_endpoint[[huggingface_hub.HfApi.delete_inference_endpoint]] ```python delete_inference_endpoint(name: str, namespace: str | None = None, token: bool | str | None = None) ``` [Kaynak](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L9894) **Parametreler:** name (`str`) : Silinecek Inference Endpoint'in adı. namespace (`str`, *isteğe bağlı*) : Inference Endpoint'in bulunduğu ad alanı. Varsayılan olarak mevcut kullanıcıdır. token (`bool` veya `str`, *isteğe bağlı*) : Geçerli bir kullanıcı erişim belirteci (dize). Varsayılan olarak, kimlik doğrulama için önerilen yöntem olan yerel olarak kaydedilmiş belirteç kullanılır (bkz. https://huggingface.co/docs/huggingface_hub/quick-start#authentication). Kimlik doğrulamayı devre dışı bırakmak için `False` geçirin. Bir Inference Endpoint silin. Bu işlem geri alınamaz. Bir Inference Endpoint için ücretlendirilmek istemiyorsanız, onu [pause_inference_endpoint()](/docs/huggingface_hub/v2.4.0/tr/package_reference/hf_api#huggingface_hub.HfApi.pause_inference_endpoint) ile duraklatmak veya [scale_to_zero_inference_endpoint()](/docs/huggingface_hub/v2.4.0/tr/package_reference/hf_api#huggingface_hub.HfApi.scale_to_zero_inference_endpoint) ile sıfıra ölçeklendirmek tercih edilir. Kolaylık olması için bir Inference Endpoint'i [InferenceEndpoint.delete()](/docs/huggingface_hub/v2.4.0/tr/package_reference/inference_endpoints#huggingface_hub.InferenceEndpoint.delete) kullanarak da silebilirsiniz. #### delete_repo[[huggingface_hub.HfApi.delete_repo]] ```python delete_repo(repo_id: str, token: str | bool | None = None, repo_type: str | None = None, missing_ok: bool = False) ``` [Kaynak](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L4788) **Parametreler:** repo_id (`str`) : `/` ile ayrılmış bir ad alanı (kullanıcı veya kuruluş) ve bir depo adı. token (`bool` veya `str`, *isteğe bağlı*) : Geçerli bir kullanıcı erişim belirteci (dize). Varsayılan olarak, kimlik doğrulama için önerilen yöntem olan yerel olarak kaydedilmiş belirteç kullanılır (bkz. https://huggingface.co/docs/huggingface_hub/quick-start#authentication). Kimlik doğrulamayı devre dışı bırakmak için `False` geçirin. repo_type (`str`, *isteğe bağlı*) : Bir veri setine veya space'e yükleniyorsa `"dataset"` veya `"space"` olarak, bir modele yükleniyorsa `None` veya `"model"` olarak ayarlayın. missing_ok (`bool`, *isteğe bağlı*, varsayılan `False`) : `True` ise, depo yoksa hata yükseltilmez. **Yükselen:** [RepositoryNotFoundError](/docs/huggingface_hub/v2.4.0/tr/package_reference/utilities#huggingface_hub.errors.RepositoryNotFoundError) - [RepositoryNotFoundError](/docs/huggingface_hub/v2.4.0/tr/package_reference/utilities#huggingface_hub.errors.RepositoryNotFoundError) -- Silinmesi gereken depo bulunamadığında ve `missing_ok` False olarak ayarlanmışsa (varsayılan). HuggingFace Hub'dan bir repoyu silin. DİKKAT: bu işlem geri alınamaz. #### delete_scheduled_job[[huggingface_hub.HfApi.delete_scheduled_job]] ```python delete_scheduled_job(scheduled_job_id: str, namespace: str | None = None, token: bool | str | None = None) ``` [Kaynak](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L13324) **Parametreler:** scheduled_job_id (`str`) : Planlanan Job'un kimliği. namespace (`str`, *isteğe bağlı*) : Planlanan Job'un bulunduğu ad alanı. Varsayılan olarak mevcut kullanıcının ad alanıdır. token (`bool` veya `str`, *isteğe bağlı*) : Geçerli bir kullanıcı erişim belirteci. Sağlanmazsa, önerilen kimlik doğrulama yöntemi olan yerel olarak kaydedilmiş belirteç kullanılır. Kimlik doğrulamayı devre dışı bırakmak için `False` olarak ayarlayın. Aşağıdaki bağlantıya bakın: https://huggingface.co/docs/huggingface_hub/quick-start#authentication. Hugging Face altyapısında zamanlanmış bir hesaplama İşini siler. #### delete_space_secret[[huggingface_hub.HfApi.delete_space_secret]] ```python delete_space_secret(repo_id: str, key: str, token: bool | str | None = None) ``` [Kaynak](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L8083) **Parametreler:** repo_id (`str`) : Güncellenecek repozituarın kimliği. Örnek: `"bigcode/in-the-stack"`. key (`str`) : Gizli anahtar. Örnek: `"GITHUB_API_KEY"`. token (`bool` veya `str`, *isteğe bağlı*) : Geçerli bir kullanıcı erişim belirteci (dize). Varsayılan olarak, kimlik doğrulama için önerilen yöntem olan yerel olarak kaydedilmiş belirteç kullanılır (bkz. https://huggingface.co/docs/huggingface_hub/quick-start#authentication). Kimlik doğrulamayı devre dışı bırakmak için `False` geçirin. Bir Uzay'dan bir gizli değeri siler. Secrets, bir Space'e gizli anahtarlar veya jetonları bunları kodun içine gömmeden ayarlamayı sağlar. Daha fazla ayrıntı için https://huggingface.co/docs/hub/spaces-overview#managing-secrets adresine bakın. #### delete_space_variable[[huggingface_hub.HfApi.delete_space_variable]] ```python delete_space_variable(repo_id: str, key: str, token: bool | str | None = None) ``` [Kaynak](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L8210) **Parametreler:** repo_id (`str`) : Güncellenecek repozituarın kimliği. Örnek: `"bigcode/in-the-stack"`. key (`str`) : Değişken anahtarı. Örnek: `"MODEL_REPO_ID"` token (`bool` veya `str`, *isteğe bağlı*) : Geçerli bir kullanıcı erişim belirteci (dize). Varsayılan olarak, kimlik doğrulama için önerilen yöntem olan yerel olarak kaydedilmiş belirteç kullanılır (bkz. https://huggingface.co/docs/huggingface_hub/quick-start#authentication). Kimlik doğrulamayı devre dışı bırakmak için `False` geçirin. Bir Uzay'dan bir değişkeni siler. Değişkenler, bir Space'e ortam değişkenlerini sabit kodlamadan ayarlamayı sağlar. Daha fazla ayrıntı için bkz. https://huggingface.co/docs/hub/spaces-overview#managing-secrets-and-environment-variables #### delete_space_volumes[[huggingface_hub.HfApi.delete_space_volumes]] ```python delete_space_volumes(repo_id: str, token: bool | str | None = None) ``` [Kaynak](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L9108) **Parametreler:** repo_id (`str`) : Güncellenecek Space'in kimliği. Örnek: `"username/my-space"`. token (`bool` veya `str`, *isteğe bağlı*) : Geçerli bir kullanıcı erişim belirteci (dize). Varsayılan olarak, kimlik doğrulama için önerilen yöntem olan yerel olarak kaydedilmiş belirteç kullanılır (bkz. https://huggingface.co/docs/huggingface_hub/quick-start#authentication). Kimlik doğrulamayı devre dışı bırakmak için `False` geçirin. **Hata:** `BadRequestError` - `BadRequestError` -- Space'e bağlı birimler yoksa. Bir Uzay'dan tüm hacimleri kaldırın. Örnek: ```python >>> from huggingface_hub import HfApi >>> api = HfApi() >>> api.delete_space_volumes("username/my-space") ``` #### delete_tag[[huggingface_hub.HfApi.delete_tag]] ```python delete_tag(repo_id: str, tag: str, token: bool | str | None = None, repo_type: str | None = None) ``` [Kaynak](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L7169) **Parametreler:** repo_id (`str`) : Bir etiketin silineceği depo. Örnek: `"user/my-cool-model"`. tag (`str`) : Silinecek etiketin adı. token (`bool` veya `str`, *isteğe bağlı*) : Geçerli bir kullanıcı erişim belirteci (dize). Varsayılan olarak, kimlik doğrulama için önerilen yöntem olan yerel olarak kaydedilmiş belirteç kullanılır (bkz. https://huggingface.co/docs/huggingface_hub/quick-start#authentication). Kimlik doğrulamayı devre dışı bırakmak için `False` geçirin. repo_type (`str`, *isteğe bağlı*) : Bir veri seti veya alan etiketlenecekse `"dataset"` veya `"space"` olarak, bir model etiketlenecekse `None` veya `"model"` olarak ayarlayın. Varsayılan değer `None`'dir. **Yükselen:** [RepositoryNotFoundError](/docs/huggingface_hub/v2.4.0/tr/package_reference/utilities#huggingface_hub.errors.RepositoryNotFoundError) veya [RevisionNotFoundError](/docs/huggingface_hub/v2.4.0/tr/package_reference/utilities#huggingface_hub.errors.RevisionNotFoundError) - [RepositoryNotFoundError](/docs/huggingface_hub/v2.4.0/tr/package_reference/utilities#huggingface_hub.errors.RepositoryNotFoundError) -- Depo bulunamadıysa (hata 404): repo_id/repo_type yanlış, özel ama kimlik doğrulaması yapılmamış veya depo mevcut değil. - [RevisionNotFoundError](/docs/huggingface_hub/v2.4.0/tr/package_reference/utilities#huggingface_hub.errors.RevisionNotFoundError) -- Etiket bulunamazsa. Hub'daki bir depodan etiketi siler. #### delete_webhook[[huggingface_hub.HfApi.delete_webhook]] ```python delete_webhook(webhook_id: str, token: bool | str | None = None) ``` [Kaynak](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L11529) **Parametreler:** webhook_id (`str`) : Silinecek webhook'un benzersiz tanımlayıcısı. token (`bool` veya `str`, *isteğe bağlı*) : Geçerli bir kullanıcı erişim belirteci (dize). Varsayılan olarak, kimlik doğrulama için önerilen yöntem olan yerel olarak kaydedilmiş belirteç kullanılır (bkz. https://huggingface.co/docs/huggingface_hub/quick-start#authentication). Kimlik doğrulamayı devre dışı bırakmak için `False` geçirin. **Dönüş:** `None` Bir webhook silinir. Örnek: ```python >>> from huggingface_hub import delete_webhook >>> delete_webhook("654bbbc16f2ec14d77f109cc") ``` #### disable_space_dev_mode[[huggingface_hub.HfApi.disable_space_dev_mode]] ```python disable_space_dev_mode(repo_id: str, token: bool | str | None = None) ``` [Kaynak](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L8497) **Parametreler:** repo_id (`str`) : Dev modunun devre dışı bırakılacağı Space'in kimliği. Örnek: `"Salesforce/BLIP2"`. token (`bool` veya `str`, *isteğe bağlı*) : Geçerli bir kullanıcı erişim belirteci (dize). Varsayılan olarak, kimlik doğrulama için önerilen yöntem olan yerel olarak kaydedilmiş belirteç kullanılır (bkz. https://huggingface.co/docs/huggingface_hub/quick-start#authentication). Kimlik doğrulamayı devre dışı bırakmak için `False` geçirin. **Dönüş:** [SpaceRuntime](/docs/huggingface_hub/v2.4.0/tr/package_reference/space_runtime#huggingface_hub.SpaceRuntime) Space'inizin çalışma zamanı bilgileri. **Yükselen:** [RepositoryNotFoundError](/docs/huggingface_hub/v2.4.0/tr/package_reference/utilities#huggingface_hub.errors.RepositoryNotFoundError) veya [HfHubHTTPError](/docs/huggingface_hub/v2.4.0/tr/package_reference/utilities#huggingface_hub.errors.HfHubHTTPError) veya [BadRequestError](/docs/huggingface_hub/v2.4.0/tr/package_reference/utilities#huggingface_hub.errors.BadRequestError) - [RepositoryNotFoundError](/docs/huggingface_hub/v2.4.0/tr/package_reference/utilities#huggingface_hub.errors.RepositoryNotFoundError) -- Space'iniz bulunamadığında (hata 404). Büyük olasılıkla repo_id yanlış veya Space'iniz özel olup kimlik doğrulamanız yapılmamış. - [HfHubHTTPError](/docs/huggingface_hub/v2.4.0/tr/package_reference/utilities#huggingface_hub.errors.HfHubHTTPError) -- 403 Forbidden: dev modunu yalnızca bir Space'in sahibi ayarlayabilir. Sahibi olmadığınız bir Space ile ilgilenmek istiyorsanız, bir Discussion açarak sahibinden rica edebilir veya Space'i kopyalayabilirsiniz. - [BadRequestError](/docs/huggingface_hub/v2.4.0/tr/package_reference/utilities#huggingface_hub.errors.BadRequestError) -- Space'ınız statik bir Space ise. Statik Spaces her zaman çalışır durumda olur ve asla faturalandırılmaz. Statik bir Space'i gizlemek istiyorsanız, onu özel olarak ayarlayabilirsiniz. Bir Space'te dev modunu devre dışı bırakın. Spaces Dev Mode, Space konteynerinin kendisini durdurmadan uygulamanızı yeniden başlatmanıza olanak tanıyarak uygulamanızın hata ayıklamasını kolaylaştırır ve Spaces üzerinde iterasyon yapmayı hızlandırır. Dev modunu etkinleştirmek için PRO veya Team & Enterprise planı gereklidir, ancak dev modunu devre dışı bırakmaya her zaman izin verilir (ör. bir abonelik süresi dolduktan sonra). Daha fazla ayrıntı için https://huggingface.co/docs/hub/spaces-dev-mode adresine bakın. #### disable_webhook[[huggingface_hub.HfApi.disable_webhook]] ```python disable_webhook(webhook_id: str, token: bool | str | None = None) ``` [Kaynak](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L11476) **Parametreler:** webhook_id (`str`) : Devre dışı bırakılacak webhook'un benzersiz tanımlayıcısı. token (`bool` veya `str`, *isteğe bağlı*) : Geçerli bir kullanıcı erişim belirteci (dize). Varsayılan olarak, kimlik doğrulama için önerilen yöntem olan yerel olarak kaydedilmiş belirteç kullanılır (bkz. https://huggingface.co/docs/huggingface_hub/quick-start#authentication). Kimlik doğrulamayı devre dışı bırakmak için `False` geçirin. **Dönüş:** [WebhookInfo](/docs/huggingface_hub/v2.4.0/tr/package_reference/hf_api#huggingface_hub.WebhookInfo) Devre dışı bırakılan webhook hakkında bilgi. Bir webhook'ü devre dışı bırakın (durumu "devre dışı" olur). Örnek: ```python >>> from huggingface_hub import disable_webhook >>> disabled_webhook = disable_webhook("654bbbc16f2ec14d77f109cc") >>> disabled_webhook WebhookInfo( id="654bbbc16f2ec14d77f109cc", url="https://webhook.site/a2176e82-5720-43ee-9e06-f91cb4c91548", jon=None, watched=[WebhookWatchedItem(type="user", name="julien-c"), WebhookWatchedItem(type="org", name="HuggingFaceH4")], domains=["repo", "discussion"], secret="my-secret", disabled=True, ) ``` #### download_bucket_files[[huggingface_hub.HfApi.download_bucket_files]] ```python download_bucket_files(bucket_id: str, files: list[tuple[str | BucketFile, str | Path]], raise_on_missing_files: bool = False, token: str | bool | None = None) ``` [Kaynak](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L15069) **Parametreler:** bucket_id (`str`) : Kovanın kimliği (ör. `"username/my-bucket"`). files (`list[tuple[Union[str, BucketFile], Union[str, Path]]]`) : İndirilecek dosyalar, (kaynak, hedef) tuple listesi olarak. Biçim detayları için yukarıdaki açıklamaya bakın. raise_on_missing_files (`bool`, *isteğe bağlı*) : `True` ise, istenen dosya bucket'ta yoksa `EntryNotFoundError` fırlatılır. `False` ise (varsayılan), eksik dosyalar bir uyarıyla atlanır. token (`bool` veya `str`, *isteğe bağlı*) : Geçerli bir kullanıcı erişim belirteci (dize). Varsayılan olarak, kimlik doğrulama için önerilen yöntem olan yerel olarak kaydedilmiş belirteç kullanılır (bkz. https://huggingface.co/docs/huggingface_hub/quick-start#authentication). Kimlik doğrulamayı devre dışı bırakmak için `False` geçirin. Bir kovadan dosyaları indirin. Files girdisi, `remote file`'in bucket'taki dosyanın yolu veya bir [BucketFile](/docs/huggingface_hub/v2.4.0/tr/package_reference/hf_api#huggingface_hub.BucketFile) nesnesi, `local file`'ün ise yerel dosya sistemindeki hedef yolu olduğu `(remote file, local file)` demetlerinin bir listesidir. Bir [BucketFile](/docs/huggingface_hub/v2.4.0/tr/package_reference/hf_api#huggingface_hub.BucketFile) nesnesi ([list_bucket_tree()](/docs/huggingface_hub/v2.4.0/tr/package_reference/hf_api#huggingface_hub.HfApi.list_bucket_tree) ile elde edilen) geçirildiğinde, yöntem meta verileri alma adımını atlar ve dosyaları doğrudan indirir. Örnek: ```python >>> from huggingface_hub import download_bucket_files >>> download_bucket_files( ... bucket_id="username/my-bucket", ... files=[ ... ("models/model.safetensors", "./local/model.safetensors"), ... ("config.json", "./local/config.json"), ... ], ... ) ``` ```python >>> from huggingface_hub import download_bucket_files >>> parquet_files = [file for file in list_bucket_tree(bucket_id="username/my-bucket") if file.path.endswith(".parquet")] >>> download_bucket_files( ... bucket_id="username/my-bucket", ... files=[(file, f"./local/{file.path}") for file in parquet_files], ... ) ``` #### duplicate_repo[[huggingface_hub.HfApi.duplicate_repo]] ```python duplicate_repo(from_id: str, to_id: str | None = None, repo_type: str | None = None, private: bool | None = None, visibility: RepoVisibility_T | None = None, token: bool | str | None = None, exist_ok: bool = False, resource_group_id: str | None = None, space_hardware: SpaceHardware | None = None, space_sleep_time: int | None = None, space_secrets: list[dict[str, str]] | None = None, space_variables: list[dict[str, str]] | None = None, space_volumes: list[Volume] | None = None) ``` [Kaynak](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L8863) **Parametreler:** from_id (`str`) : Kopyalanacak repozituarın kimliği. Örnek: `"openai/gdpval"`. to_id (`str`, *isteğe bağlı*) : Yeni depoyun kimliği. Örnek: `"myorg/my-gdpval"`. Belirtilmezse, yeni depo orijinal depo ile aynı adı alır, ancak hesabınızda oluşturulur. repo_type (`str`, *isteğe bağlı*) : Bir veri seti veya Space kopyalanıyorsa `"dataset"` veya `"space"` olarak, bir model kopyalanıyorsa `None` veya `"model"` olarak ayarlayın. Varsayılan değer `None`'dir. private (`bool`, *isteğe bağlı*) : Yeni deponun özel olup olmayacağı. Varsayılan olarak, orijinal depo ile aynı gizliliğe sahiptir. `visibility` parametresiyle birlikte geçirilemez. visibility (`Literal["public", "private", "protected"]`, *isteğe bağlı*) : Yeni repozituarın görünürlüğü. `"public"` veya `"private"` olabilir, Spaces için `"protected"` olabilir. Varsayılan olarak, orijinal repozituarla aynı görünürlüğe sahiptir. token (`bool` veya `str`, *isteğe bağlı*) : Geçerli bir kullanıcı erişim belirteci (dize). Varsayılan olarak, kimlik doğrulama için önerilen yöntem olan yerel olarak kaydedilmiş belirteç kullanılır (bkz. https://huggingface.co/docs/huggingface_hub/quick-start#authentication). Kimlik doğrulamayı devre dışı bırakmak için `False` geçirin. exist_ok (`bool`, *isteğe bağlı*, varsayılan `False`) : `True` ise, depo zaten varsa hata yükseltilmez. resource_group_id (`str`, *isteğe bağlı*) : Yeni repoyu oluşturulacak kaynak grubu. Kaynak grupları yalnızca Enterprise Hub kuruluşları için kullanılabilir ve kuruluşun hangi üyelerinin kaynağa erişebileceğini tanımlamaya olanak tanır. Bir kaynak grubunun kimliği, Hub'daki kaynağın sayfasındaki URL'de bulunabilir (ör. `"66670e5163145ca562cb1988"`). Kaynak grupları hakkında daha fazla bilgi için https://huggingface.co/docs/hub/en/security-resource-groups adresine bakın. space_hardware (`SpaceHardware` veya `str`, *isteğe bağlı*) : repo_type "space" ise donanım seçimi. Örnek: `"t4-medium"`. Tam liste için [SpaceHardware](/docs/huggingface_hub/v2.4.0/tr/package_reference/space_runtime#huggingface_hub.SpaceHardware) bölümüne bakın. space_sleep_time (`int`, *isteğe bağlı*) : Bir Space'in uyku moduna alınmadan önce beklenmesi gereken boşta kalma süresi (saniye cinsinden). Space'inizin uyumasını istemiyorsanız `-1` olarak ayarlayın (yükseltilmiş donanımlar için varsayılan davranış). Ücretsiz donanımlarda uyku süresi yapılandırılamaz (değer 48 saat boşta kalma olarak sabittir). Yalnızca repo_type "space" ise geçerlidir. Daha fazla ayrıntı için https://huggingface.co/docs/hub/spaces-gpus#sleep-time adresine bakın. space_secrets (`list[dict[str, str]]`, *isteğe bağlı*) : Space'inizde ayarlanacak gizli anahtarların listesi. Her öğe `{"key": ..., "value": ..., "description": ...}` biçimindedir ve description isteğe bağlıdır. Yalnızca repo_type "space" ise geçerlidir. Daha fazla ayrıntı için https://huggingface.co/docs/hub/spaces-overview#managing-secrets adresine bakın. space_variables (`list[dict[str, str]]`, *isteğe bağlı*) : Space'inizde ayarlanacak herkese açık ortam değişkenlerinin listesi. Her öğe `{"key": ..., "value": ..., "description": ...}` biçimindedir ve description isteğe bağlıdır. Yalnızca repo_type "space" ise geçerlidir. Daha fazla ayrıntı için bkz. https://huggingface.co/docs/hub/spaces-overview#managing-secrets-and-environment-variables. space_volumes (`list[Volume]`, *isteğe bağlı*) : Kopyalama sırasında Space'e bağlanacak [Volume](/docs/huggingface_hub/v2.4.0/tr/package_reference/jobs#huggingface_hub.Volume) nesnelerinin listesi. Her hacmin bir `type` (`"bucket"`, `"model"`, `"dataset"` veya `"space"`), bir `source` (repo veya bucket kimliği), bir `mount_path` (konteyner içindeki yol) ve isteğe bağlı `revision`, `read_only` ile `path` alanları vardır. Yalnızca repo_type "space" ise geçerlidir. **Dönüş:** [DuplicatedRepoUrl](/docs/huggingface_hub/v2.4.0/tr/package_reference/hf_api#huggingface_hub.DuplicatedRepoUrl) Yeni oluşturulan depoya ait URL. Değer, `endpoint`, `repo_type`, `repo_id` ve `files_copy_pending` gibi öznitelikleri içeren [RepoUrl](/docs/huggingface_hub/v2.4.0/tr/package_reference/hf_api#huggingface_hub.RepoUrl)'nin (ve `str`'nin) bir alt sınıfıdır. **Yükselen:** [RepositoryNotFoundError](/docs/huggingface_hub/v2.4.0/tr/package_reference/utilities#huggingface_hub.errors.RepositoryNotFoundError) veya `HfHubHTTPError` - [RepositoryNotFoundError](/docs/huggingface_hub/v2.4.0/tr/package_reference/utilities#huggingface_hub.errors.RepositoryNotFoundError) -- `from_id` veya `to_id` bulunamazsa. Bunun nedeni, var olmaması veya `private` olarak ayarlanmış olması ve erişiminizin olmaması olabilir. - `HfHubHTTPError` -- HuggingFace API bir hata döndürdüyse Hub'da bir repoyu (model, veri seti veya Space) kopyalayın. Bu işlem, yerel bir indirme/yükleme döngüsü gerektirmeden tam git geçmişini ve LFS nesnelerini koruyan sunucu tarafında bir kopyalama gerçekleştirir. Git geçmişi hemen kopyalanır, ancak bu yöntem döndüğünde LFS/Xet dosyaları arka planda kopyalanmaya devam edebilir. Bu durumda, döndürülen değer üzerinde `files_copy_pending` `True` olur ve kopyalama tamamlanana kadar bu dosyaların yeni depodan indirilmesi başarısız olabilir. Örnek: ```python >>> from huggingface_hub import duplicate_repo # Duplicate a model to your account >>> repo_url = duplicate_repo("google/gemma-7b") >>> repo_url RepoUrl('https://huggingface.co/nateraw/gemma-7b',...) >>> repo_url.files_copy_pending True # Duplicate a dataset with a custom name >>> duplicate_repo("openai/gdpval", to_id="myorg/my-gdpval", repo_type="dataset") RepoUrl('https://huggingface.co/datasets/myorg/my-gdpval',...) # Duplicate a Space with custom hardware >>> duplicate_repo("multimodalart/dreambooth-training", repo_type="space", space_hardware="t4-medium") RepoUrl('https://huggingface.co/spaces/nateraw/dreambooth-training',...) ``` #### edit_discussion_comment[[huggingface_hub.HfApi.edit_discussion_comment]] ```python edit_discussion_comment(repo_id: str, discussion_num: int, comment_id: str, new_content: str, token: bool | str | None = None, repo_type: str | None = None) ``` [Kaynak](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L7883) **Parametreler:** repo_id (`str`) : `/` ile ayrılmış bir ad alanı (kullanıcı veya kuruluş) ve bir depo adı. discussion_num (`int`) : Tartışma veya Pull Request'in numarası. Kesinlikle pozitif bir tam sayı olmalıdır. comment_id (`str`) : Düzenlenecek yorumun kimliği. new_content (`str`) : Yorumun yeni içeriği. Yorumlar markdown biçimlendirmesini destekler. repo_type (`str`, *isteğe bağlı*) : Bir veri setine veya uzaya yükleniyorsa `"dataset"` veya `"space"` olarak, bir modele yükleniyorsa `None` veya `"model"` olarak ayarlayın. Varsayılan değer `None`'dir. token (`bool` veya `str`, *isteğe bağlı*) : Geçerli bir kullanıcı erişim belirteci (dize). Varsayılan olarak, kimlik doğrulama için önerilen yöntem olan yerel olarak kaydedilmiş belirteç kullanılır (bkz. https://huggingface.co/docs/huggingface_hub/quick-start#authentication). Kimlik doğrulamayı devre dışı bırakmak için `False` geçirin. **Dönüş:** [DiscussionComment](/docs/huggingface_hub/v2.4.0/tr/package_reference/community#huggingface_hub.DiscussionComment) düzenlenmiş yorum Bir Tartışma / Çekme İsteği'ndeki yorumu düzenler. > [!TIP] > Aşağıdaki hataları oluşturur: > > - [`HTTPError`](https://requests.readthedocs.io/en/latest/api/#requests.HTTPError) HuggingFace API bir hata döndürürse - [`ValueError`](https://docs.python.org/3/library/exceptions.html#ValueError) bir parametre değeri geçersizse - [RepositoryNotFoundError](/docs/huggingface_hub/v2.4.0/tr/package_reference/utilities#huggingface_hub.errors.RepositoryNotFoundError) İndirme yapılacak deposu bulunamazsa. Bunun nedeni, deponun var olmaması veya `private` olarak ayarlanmış olması ve erişiminizin bulunmaması olabilir. #### enable_space_dev_mode[[huggingface_hub.HfApi.enable_space_dev_mode]] ```python enable_space_dev_mode(repo_id: str, token: bool | str | None = None) ``` [Kaynak](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L8458) **Parametreler:** repo_id (`str`) : Dev modunun etkinleştirileceği Space'in kimliği. Örnek: `"Salesforce/BLIP2"`. token (`bool` veya `str`, *isteğe bağlı*) : Geçerli bir kullanıcı erişim belirteci (dize). Varsayılan olarak, kimlik doğrulama için önerilen yöntem olan yerel olarak kaydedilmiş belirteç kullanılır (bkz. https://huggingface.co/docs/huggingface_hub/quick-start#authentication). Kimlik doğrulamayı devre dışı bırakmak için `False` geçirin. **Dönüş:** [SpaceRuntime](/docs/huggingface_hub/v2.4.0/tr/package_reference/space_runtime#huggingface_hub.SpaceRuntime) Space'inizin çalışma zamanı bilgileri. **Yükselen:** [RepositoryNotFoundError](/docs/huggingface_hub/v2.4.0/tr/package_reference/utilities#huggingface_hub.errors.RepositoryNotFoundError) veya [HfHubHTTPError](/docs/huggingface_hub/v2.4.0/tr/package_reference/utilities#huggingface_hub.errors.HfHubHTTPError) veya [BadRequestError](/docs/huggingface_hub/v2.4.0/tr/package_reference/utilities#huggingface_hub.errors.BadRequestError) - [RepositoryNotFoundError](/docs/huggingface_hub/v2.4.0/tr/package_reference/utilities#huggingface_hub.errors.RepositoryNotFoundError) -- Space'iniz bulunamadığında (hata 404). Büyük olasılıkla repo_id yanlış veya Space'iniz özel olup kimlik doğrulamanız yapılmamış. - [HfHubHTTPError](/docs/huggingface_hub/v2.4.0/tr/package_reference/utilities#huggingface_hub.errors.HfHubHTTPError) -- 403 Forbidden: dev modunu yalnızca bir Space'in sahibi ayarlayabilir. Sahibi olmadığınız bir Space ile ilgilenmek istiyorsanız, bir Discussion açarak sahibinden rica edebilir veya Space'i kopyalayabilirsiniz. - [BadRequestError](/docs/huggingface_hub/v2.4.0/tr/package_reference/utilities#huggingface_hub.errors.BadRequestError) -- Space'ınız statik bir Space ise. Statik Spaces her zaman çalışır durumda olur ve asla faturalandırılmaz. Statik bir Space'i gizlemek istiyorsanız, onu özel olarak ayarlayabilirsiniz. Bir Space'te geliştirici modunu etkinleştirin. Spaces Dev Mode, Space konteynerinin kendisini durdurmadan uygulamanızı yeniden başlatmanıza olanak tanıyarak uygulamanızın hata ayıklamasını kolaylaştırır ve Spaces üzerinde iterasyon yapmayı hızlandırır. Bu özellik, PRO veya Team & Enterprise planının bir parçası olarak kullanılabilir. Daha fazla ayrıntı için https://huggingface.co/docs/hub/spaces-dev-mode adresine bakın. #### enable_webhook[[huggingface_hub.HfApi.enable_webhook]] ```python enable_webhook(webhook_id: str, token: bool | str | None = None) ``` [Kaynak](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L11423) **Parametreler:** webhook_id (`str`) : Etkinleştirilecek webhook'un benzersiz tanımlayıcısı. token (`bool` veya `str`, *isteğe bağlı*) : Geçerli bir kullanıcı erişim belirteci (dize). Varsayılan olarak, kimlik doğrulama için önerilen yöntem olan yerel olarak kaydedilmiş belirteç kullanılır (bkz. https://huggingface.co/docs/huggingface_hub/quick-start#authentication). Kimlik doğrulamayı devre dışı bırakmak için `False` geçirin. **Dönüş:** [WebhookInfo](/docs/huggingface_hub/v2.4.0/tr/package_reference/hf_api#huggingface_hub.WebhookInfo) Etkinleştirilen webhook hakkında bilgi. Bir webhook etkinleştirin (bunu "aktif" hale getirir). Örnek: ```python >>> from huggingface_hub import enable_webhook >>> enabled_webhook = enable_webhook("654bbbc16f2ec14d77f109cc") >>> enabled_webhook WebhookInfo( id="654bbbc16f2ec14d77f109cc", job=None, url="https://webhook.site/a2176e82-5720-43ee-9e06-f91cb4c91548", watched=[WebhookWatchedItem(type="user", name="julien-c"), WebhookWatchedItem(type="org", name="HuggingFaceH4")], domains=["repo", "discussion"], secret="my-secret", disabled=False, ) ``` #### fetch_job_logs[[huggingface_hub.HfApi.fetch_job_logs]] ```python fetch_job_logs(job_id: str, namespace: str | None = None, follow: bool = False, tail: int | None = None, token: bool | str | None = None) ``` [Kaynak](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L12327) **Parametreler:** job_id (`str`) : İşin kimliği. namespace (`str`, *isteğe bağlı*) : Job'un çalıştığı ad alanı. Varsayılan olarak mevcut kullanıcının ad alanıdır. follow (`bool`, *isteğe bağlı*) : `True` ise, iş tamamlanana kadar günlükleri gerçek zamanlı olarak akışa alır (engelleyici). `False` ise (varsayılan), yalnızca o anda mevcut olan günlükleri getirir ve hemen döner (engelleyici olmayan). tail (`int`, *isteğe bağlı*) : Kayıtlardan döndürülecek maksimum satır sayısı. `follow=True` ile birleştirildiğinde, son N satırdan başlar ve yeni kayıtları akış olarak devam ettirir. `follow=False` olduğunda, yalnızca mevcut kayıtlardan son N satırı döndürür. token (`bool` veya `str`, *isteğe bağlı*) : Geçerli bir kullanıcı erişim belirteci. Sağlanmazsa, önerilen kimlik doğrulama yöntemi olan yerel olarak kaydedilmiş belirteç kullanılır. Kimlik doğrulamayı devre dışı bırakmak için `False` olarak ayarlayın. Aşağıdaki bağlantıya bakın: https://huggingface.co/docs/huggingface_hub/quick-start#authentication. Hugging Face altyapısındaki bir hesaplama Job'undan tüm günlükleri getirir. Örnek: ```python >>> from huggingface_hub import fetch_job_logs, run_job >>> job = run_job(image="python:3.12", command=["python", "-c" ,"print('Hello from HF compute!')"]) >>> for log in fetch_job_logs(job_id=job.id): ... print(log) Hello from HF compute! >>> # Non-blocking: fetch only currently available logs >>> for log in fetch_job_logs(job_id=job.id, follow=False): ... print(log) >>> # Stream logs starting from the last 100 lines >>> for log in fetch_job_logs(job_id=job.id, follow=True, tail=100): ... print(log) ``` #### fetch_job_metrics[[huggingface_hub.HfApi.fetch_job_metrics]] ```python fetch_job_metrics(job_id: str, namespace: str | None = None, follow: bool = False, token: bool | str | None = None) ``` [Kaynak](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L12407) **Parametreler:** job_id (`str`) : İşin kimliği. namespace (`str`, *isteğe bağlı*) : Job'un çalıştığı ad alanı. Varsayılan olarak mevcut kullanıcının ad alanıdır. follow (`bool`, *isteğe bağlı*) : `True` ise, iş tamamlanana kadar metrikleri gerçek zamanlı olarak akışa alır (engelleyici). `False` ise (varsayılan), yalnızca güncel metrikleri getirir ve döner (engelleyici olmayan). token (`bool` veya `str`, *isteğe bağlı*) : Geçerli bir kullanıcı erişim belirteci. Sağlanmazsa, önerilen kimlik doğrulama yöntemi olan yerel olarak kaydedilmiş belirteç kullanılır. Kimlik doğrulamayı devre dışı bırakmak için `False` olarak ayarlayın. Aşağıdaki bağlantıya bakın: https://huggingface.co/docs/huggingface_hub/quick-start#authentication. Hugging Face altyapısındaki bir hesaplama Job'undan canlı metrikleri getirin. Örnek: ```python >>> from huggingface_hub import fetch_job_metrics, run_job >>> job = run_job(image="python:3.12", command=["python", "-c" ,"print('Hello from HF compute!')"], flavor="a10g-small") >>> for metrics in fetch_job_metrics(job_id=job.id): ... print(metrics) { "cpu_usage_pct": 0, "cpu_millicores": 3500, "memory_used_bytes": 1306624, "memory_total_bytes": 15032385536, "rx_bps": 0, "tx_bps": 0, "gpus": { "882fa930": { "utilization": 0, "memory_used_bytes": 0, "memory_total_bytes": 22836000000 } }, "replica": "57vr7" } >>> # Stream metrics until the job completes >>> for metrics in fetch_job_metrics(job_id=job.id, follow=True): ... print(metrics) ``` #### fetch_space_logs[[huggingface_hub.HfApi.fetch_space_logs]] ```python fetch_space_logs(repo_id: str, build: bool = False, follow: bool = False, token: bool | str | None = None) ``` [Kaynak](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L8737) **Parametreler:** repo_id (`str`) : Space'in kimliği. Örnek: `"bigcode/in-the-stack"`. build (`bool`, *isteğe bağlı*, varsayılan `False`) : `True` ise, konteyner derleme günlüklerini getirir (bir Space `BUILD_ERROR` durumunda takılı kaldığında faydalıdır). `False` ise (varsayılan), çalışma günlüklerini, yani çalışan uygulamanın stdout/stderr çıktısını getirir. follow (`bool`, *isteğe bağlı*, varsayılan `False`) : `True` ise, sunucu akışı kapatana veya `KeyboardInterrupt` fırlatılana kadar günlükleri gerçek zamanlı olarak (engelleyici) akış olarak görüntüler. `False` ise (varsayılan), yalnızca o anda tamponlanan günlükleri getirir ve hemen döner (engelsiz, `docker logs` gibi). token (`bool` veya `str`, *isteğe bağlı*) : Geçerli bir kullanıcı erişim belirteci. Varsayılan olarak, önerilen kimlik doğrulama yöntemi olan yerel olarak kaydedilmiş belirteç kullanılır. Kimlik doğrulamayı devre dışı bırakmak için `False` olarak ayarlayın. bkz. https://huggingface.co/docs/huggingface_hub/quick-start#authentication. **Dönüş:** `Iterable[str]` Müsait oldukça log satırları üreten bir üreteç. Hub'daki bir Space'in çalışma veya derleme günlüklerini getirin. Derleme sırasında hata veren veya çalışma zamanında çöken bir Space'i hata ayıklamak için faydalıdır; özellikle tarayıcıda günlükleri okumanın mümkün olmadığı bir betik veya ajan tabanlı iş akışında. Örnek: ```python >>> from huggingface_hub import fetch_space_logs >>> # Non-blocking: print currently available run logs and exit. >>> for line in fetch_space_logs("username/my-space"): ... print(line, end="") >>> # Debug a build failure: >>> for line in fetch_space_logs("username/my-space", build=True): ... print(line, end="") >>> # Stream run logs until the server closes the stream. >>> for line in fetch_space_logs("username/my-space", follow=True): ... print(line, end="") ``` #### file_exists[[huggingface_hub.HfApi.file_exists]] ```python file_exists(repo_id: str, filename: str, repo_type: str | None = None, revision: str | None = None, token: str | bool | None = None) ``` [Kaynak](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L3768) **Parametreler:** repo_id (`str`) : `/` ile ayrılmış bir ad alanı (kullanıcı veya kuruluş) ve bir depo adı. filename (`str`) : Kontrol edilecek dosyanın adı, örneğin: `"config.json"` repo_type (`str`, *isteğe bağlı*) : Bir veri setinden veya bir uzaydan depo bilgisi alınıyorsa `"dataset"` veya `"space"` olarak, bir modelden depo bilgisi alınıyorsa `None` veya `"model"` olarak ayarlayın. Varsayılan değer `None`'dir. revision (`str`, *isteğe bağlı*) : Bilgilerin alınacağı depoyun revizyonu. Varsayılan olarak `"main"` dalıdır. token (`bool` veya `str`, *isteğe bağlı*) : Geçerli bir kullanıcı erişim belirteci (dize). Varsayılan olarak, kimlik doğrulama için önerilen yöntem olan yerel olarak kaydedilmiş belirteç kullanılır (bkz. https://huggingface.co/docs/huggingface_hub/quick-start#authentication). Kimlik doğrulamayı devre dışı bırakmak için `False` geçirin. **Dönüş:** Dosya varsa True, aksi halde False. Hugging Face Hub'daki bir depoda bir dosyanın var olup olmadığını kontrol eder. Örnekler: ```py >>> from huggingface_hub import file_exists >>> file_exists("bigcode/starcoder", "config.json") True >>> file_exists("bigcode/starcoder", "not-a-file") False >>> file_exists("bigcode/not-a-repo", "config.json") False ``` #### get_bucket_file_metadata[[huggingface_hub.HfApi.get_bucket_file_metadata]] ```python get_bucket_file_metadata(bucket_id: str, remote_path: str, token: str | bool | None = None) ``` [Kaynak](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L15010) **Parametreler:** bucket_id (`str`) : Kovanın kimliği (ör. `"username/my-bucket"`). remote_path (`str`) : Kova içindeki dosyanın yolu. token (`bool` veya `str`, *isteğe bağlı*) : Geçerli bir kullanıcı erişim belirteci (dize). Varsayılan olarak, kimlik doğrulama için önerilen yöntem olan yerel olarak kaydedilmiş belirteç kullanılır (bkz. https://huggingface.co/docs/huggingface_hub/quick-start#authentication). Kimlik doğrulamayı devre dışı bırakmak için `False` geçirin. **Dönüş:** [BucketFileMetadata](/docs/huggingface_hub/v2.4.0/tr/package_reference/hf_api#huggingface_hub.BucketFileMetadata) Boyut ve xet bilgilerini içeren dosya meta verisi. Bir kovadaki bir dosyanın meta verilerini getirir. Örnek: ```python >>> from huggingface_hub import get_bucket_file_metadata >>> metadata = get_bucket_file_metadata( ... bucket_id="username/my-bucket", ... remote_path="models/model.safetensors", ... ) >>> metadata.size 42000 ``` #### get_bucket_paths_info[[huggingface_hub.HfApi.get_bucket_paths_info]] ```python get_bucket_paths_info(bucket_id: str, paths: Iterable[str], token: str | bool | None = None) ``` [Kaynak](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L14356) **Parametreler:** bucket_id (`str`) : Kovanın kimliği (ör. `"username/my-bucket"`). paths (`Iterable[str]`) : Bilgi alınacak yollar. Bir yol mevcut değilse, bir istisna fırlatılmadan yoksayılır. Yalnızca dosya yolları desteklenir. token (`bool` veya `str`, *isteğe bağlı*) : Geçerli bir kullanıcı erişim belirteci (dize). Varsayılan olarak, kimlik doğrulama için önerilen yöntem olan yerel olarak kaydedilmiş belirteç kullanılır (bkz. https://huggingface.co/docs/huggingface_hub/quick-start#authentication). Kimlik doğrulamayı devre dışı bırakmak için `False` geçirin. **Dönüş:** `Iterable[BucketFile]` [BucketFile](/docs/huggingface_hub/v2.4.0/tr/package_reference/hf_api#huggingface_hub.BucketFile) nesnelerinin bir iterable'i olarak yollar hakkında bilgi. Bir varlığın yolları hakkında bilgi alın. Çağrılar 1000 yolluk partiler halinde yapılır. Sonuçlar, geldikçe verilir. Örnek: ```py >>> from huggingface_hub import get_bucket_paths_info >>> paths_info = get_bucket_paths_info("username/my-bucket", ["file.txt", "checkpoints/model.safetensors"]) >>> for info in paths_info: ... print(info) BucketFile(type='file', path='file.txt', size=2379, xet_hash='96e637d9665bd35477b1908a23f2e254edfba0618dbd2d62f90a6baee7d139cf', mtime=datetime.datetime(2024, 9, 25, 15, 31, 2, 346000, tzinfo=datetime.timezone.utc)) BucketFile(type='file', path='checkpoints/model.safetensors', size=2408828, xet_hash='3ed0e9fefe788ddd61d1e26eba67057e9740a064b009256fbafadf6bb95785ca', mtime=datetime.datetime(2024, 9, 25, 15, 31, 2, 346000, tzinfo=datetime.timezone.utc)) ``` #### get_collection[[huggingface_hub.HfApi.get_collection]] ```python get_collection(collection_slug: str, token: bool | str | None = None) ``` [Kaynak](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L10152) **Parametreler:** collection_slug (`str`) : Hub'daki koleksiyonun slug'ı. Örnek: `"TheBloke/recent-models-64f9a55bb3115b4f513ec026"`. token (`bool` veya `str`, *isteğe bağlı*) : Geçerli bir kullanıcı erişim belirteci (dize). Varsayılan olarak, kimlik doğrulama için önerilen yöntem olan yerel olarak kaydedilmiş belirteç kullanılır (bkz. https://huggingface.co/docs/huggingface_hub/quick-start#authentication). Kimlik doğrulamayı devre dışı bırakmak için `False` geçirin. Hub'daki bir Koleksiyon hakkında bilgi alır. Dönüş: [Collection](/docs/huggingface_hub/v2.4.0/tr/package_reference/collections#huggingface_hub.Collection) Örnek: ```py >>> from huggingface_hub import get_collection >>> collection = get_collection("TheBloke/recent-models-64f9a55bb3115b4f513ec026") >>> collection.title 'Recent models' >>> len(collection.items) 37 >>> collection.items[0] CollectionItem( item_object_id='651446103cd773a050bf64c2', item_id='TheBloke/U-Amethyst-20B-AWQ', item_type='model', position=88, note=None ) ``` #### get_dataset_leaderboard[[huggingface_hub.HfApi.get_dataset_leaderboard]] ```python get_dataset_leaderboard(repo_id: str, base_model_only: bool | None = None, token: bool | str | None = None, timeout: float | None = None) ``` [Kaynak](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L3289) **Parametreler:** repo_id (`str`) : Bir ad alanı (kullanıcı veya kuruluş) ve `/` ile ayrılmış bir depo adı. Örneğin: `"allenai/olmOCR-bench"`. base_model_only (`bool` veya `None`, *isteğe bağlı*) : Varsayılan olarak, lider tablosu yalnızca beyan edilmiş bir `base_model` ilişkisi olmayan modelleri (yani kanonik/kök depoları) içerir; bu, Hub'un varsayılan lider tablosu görünümüyle eşleşir. Ebeveyn model beyan eden ince ayarlanmış veya türev depolar hariç tutulur. Bu filtreyi devre dışı bırakmak ve model bir temel model ilişkisi beyan etsin veya etmesin, gönderilen her sonucu dahil etmek için `base_model_only=False` değerini iletin. token (`bool` veya `str`, *isteğe bağlı*) : Geçerli bir kullanıcı erişim belirteci. Varsayılan olarak, kimlik doğrulama için önerilen yöntem olan yerel olarak kaydedilmiş belirteç kullanılır (bkz. https://huggingface.co/docs/huggingface_hub/quick-start#authentication). Kimlik doğrulamayı devre dışı bırakmak için `False` geçirin. timeout (`float`, *isteğe bağlı*) : Hub'a yapılan istek için bir zaman aşımı ayarlanıp ayarlanmayacağı. **Dönüş:** `list[DatasetLeaderboardEntry]` Sıralamaya göre sıralanmış, liderlik tablosu girdilerini temsil eden [DatasetLeaderboardEntry](/docs/huggingface_hub/v2.4.0/tr/package_reference/hf_api#huggingface_hub.DatasetLeaderboardEntry) nesnelerinin listesi. Hub'daki bir veri setinin lider tablosunu alın. Sıralama tablosu, modelleri verilen benchmark veri setindeki değerlendirme puanlarına göre sıralar. Tüm veri setlerinin sıralama tabloları yoktur — yalnızca kendilerine değerlendirme sonuçları gönderilen benchmark veri setleri bu özelliğe sahiptir. Bu, puanların veri seti odaklı bir görünümünü sunar; model odaklı bir görünüm için [model_info()](/docs/huggingface_hub/v2.4.0/tr/package_reference/hf_api#huggingface_hub.HfApi.model_info) fonksiyonunu `expand=["evalResults"]` parametresiyle kullanın. > [!TIP] > Aşağıdaki hataları oluşturur: > > - [RepositoryNotFoundError](/docs/huggingface_hub/v2.4.0/tr/package_reference/utilities#huggingface_hub.errors.RepositoryNotFoundError) Depo bulunamadığında. Bunun nedeni, depoyu var olmaması veya `private` olarak ayarlanmış olması ve erişiminizin olmaması olabilir. - [HfHubHTTPError](/docs/huggingface_hub/v2.4.0/tr/package_reference/utilities#huggingface_hub.errors.HfHubHTTPError) Veri setinin bir lider tablosu yoksa. Örnek: ```python >>> from huggingface_hub import HfApi >>> api = HfApi() >>> leaderboard = api.get_dataset_leaderboard("allenai/olmOCR-bench") >>> leaderboard[0].model_id 'datalab-to/chandra-ocr-2' >>> leaderboard[0].rank 1 # Include fine-tuned / derivative models too >>> full_leaderboard = api.get_dataset_leaderboard("allenai/olmOCR-bench", base_model_only=False) ``` #### get_dataset_tags[[huggingface_hub.HfApi.get_dataset_tags]] ```python get_dataset_tags() ``` [Kaynak](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L2301) Tüm geçerli veri seti etiketlerini iç içe geçmiş bir ad alanı nesnesi olarak listeler. #### get_discussion_details[[huggingface_hub.HfApi.get_discussion_details]] ```python get_discussion_details(repo_id: str, discussion_num: int, repo_type: str | None = None, token: bool | str | None = None) ``` [Kaynak](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L7364) **Parametreler:** repo_id (`str`) : `/` ile ayrılmış bir ad alanı (kullanıcı veya kuruluş) ve bir depo adı. discussion_num (`int`) : Tartışma veya Pull Request'in numarası. Kesinlikle pozitif bir tam sayı olmalıdır. repo_type (`str`, *isteğe bağlı*) : Bir veri setine veya uzaya yükleniyorsa `"dataset"` veya `"space"` olarak, bir modele yükleniyorsa `None` veya `"model"` olarak ayarlayın. Varsayılan değer `None`'dir. token (`bool` veya `str`, *isteğe bağlı*) : Geçerli bir kullanıcı erişim belirteci (dize). Varsayılan olarak, kimlik doğrulama için önerilen yöntem olan yerel olarak kaydedilmiş belirteç kullanılır (bkz. https://huggingface.co/docs/huggingface_hub/quick-start#authentication). Kimlik doğrulamayı devre dışı bırakmak için `False` geçirin. Hub'dan bir Tartışma'nın / Birleştirme İsteği'nin ayrıntılarını getirir. Dönüş: [DiscussionWithDetails](/docs/huggingface_hub/v2.4.0/tr/package_reference/community#huggingface_hub.DiscussionWithDetails) > [!TIP] > Aşağıdaki hataları oluşturur: > > - [`HTTPError`](https://requests.readthedocs.io/en/latest/api/#requests.HTTPError) HuggingFace API bir hata döndürürse - [`ValueError`](https://docs.python.org/3/library/exceptions.html#ValueError) bir parametre değeri geçersizse - [RepositoryNotFoundError](/docs/huggingface_hub/v2.4.0/tr/package_reference/utilities#huggingface_hub.errors.RepositoryNotFoundError) İndirme yapılacak deposu bulunamazsa. Bunun nedeni, deponun var olmaması veya `private` olarak ayarlanmış olması ve erişiminizin bulunmaması olabilir. #### get_full_repo_name[[huggingface_hub.HfApi.get_full_repo_name]] ```python get_full_repo_name(model_id: str, organization: str | None = None, token: bool | str | None = None) ``` [Kaynak](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L7218) **Parametreler:** model_id (`str`) : Modelin adı. organization (`str`, *isteğe bağlı*) : Geçirildiğinde, depo adı kullanıcı ad alanı yerine organizasyon ad alanında olacaktır. token (`bool` veya `str`, *isteğe bağlı*) : Geçerli bir kullanıcı erişim belirteci (dize). Varsayılan olarak, kimlik doğrulama için önerilen yöntem olan yerel olarak kaydedilmiş belirteç kullanılır (bkz. https://huggingface.co/docs/huggingface_hub/quick-start#authentication). Kimlik doğrulamayı devre dışı bırakmak için `False` geçirin. **Dönüş:** `str` Bir organizasyon geçirilmezse kullanıcının ad alanındaki depo adı ({username}/{model_id}), aksi takdirde organizasyon ad alanındaki ({organization}/{model_id}). Belirtilen model kimliği ve isteğe bağlı kuruluş için depo adını döndürür. #### get_hf_file_metadata[[huggingface_hub.HfApi.get_hf_file_metadata]] ```python get_hf_file_metadata(url: str, token: bool | str | None = None, timeout: float | None = 10) ``` [Kaynak](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L6285) **Parametreler:** url (`str`) : Dosya URL'si, örneğin [hf_hub_url()](/docs/huggingface_hub/v2.4.0/tr/package_reference/file_download#huggingface_hub.hf_hub_url) tarafından döndürülen. token (`bool` veya `str`, *isteğe bağlı*) : Geçerli bir kullanıcı erişim belirteci (dize). Varsayılan olarak, kimlik doğrulama için önerilen yöntem olan yerel olarak kaydedilmiş belirteç kullanılır (bkz. https://huggingface.co/docs/huggingface_hub/quick-start#authentication). Kimlik doğrulamayı devre dışı bırakmak için `False` geçirin. timeout (`float`, *opsiyonel*, varsayılan 10) : Sunucunun metadata göndermesi için vazgeçmeden önce kaç saniye beklenir. **Dönüş:** Konum, etag, boyut ve commit_hash gibi metadata içeren bir [HfFileMetadata](/docs/huggingface_hub/v2.4.0/tr/package_reference/file_download#huggingface_hub.HfFileMetadata) nesnesi. Belirtilen bir URL için Hub'da sürüm kontrolü yapılan bir dosyanın meta verilerini getirir. #### get_inference_endpoint[[huggingface_hub.HfApi.get_inference_endpoint]] ```python get_inference_endpoint(name: str, namespace: str | None = None, token: bool | str | None = None) ``` [Kaynak](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L9659) **Parametreler:** name (`str`) : Hakkında bilgi alınacak Inference Endpoint'in adı. namespace (`str`, *isteğe bağlı*) : Inference Endpoint'in bulunduğu ad alanı. Varsayılan olarak mevcut kullanıcıdır. token (`bool` veya `str`, *isteğe bağlı*) : Geçerli bir kullanıcı erişim belirteci (dize). Varsayılan olarak, kimlik doğrulama için önerilen yöntem olan yerel olarak kaydedilmiş belirteç kullanılır (bkz. https://huggingface.co/docs/huggingface_hub/quick-start#authentication). Kimlik doğrulamayı devre dışı bırakmak için `False` geçirin. **Dönüş:** [InferenceEndpoint](/docs/huggingface_hub/v2.4.0/tr/package_reference/inference_endpoints#huggingface_hub.InferenceEndpoint) istenen Inference Endpoint hakkında bilgi. Bir Inference Endpoint hakkında bilgi alın. Örnek: ```python >>> from huggingface_hub import HfApi >>> api = HfApi() >>> endpoint = api.get_inference_endpoint("my-text-to-image") >>> endpoint InferenceEndpoint(name='my-text-to-image', ...) # Get status >>> endpoint.status 'running' >>> endpoint.url 'https://my-text-to-image.region.vendor.endpoints.huggingface.cloud' # Run inference >>> endpoint.client.text_to_image(...) ``` #### get_model_tags[[huggingface_hub.HfApi.get_model_tags]] ```python get_model_tags() ``` [Kaynak](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L2292) Geçerli tüm model etiketlerini iç içe geçmiş bir ad alanı nesnesi olarak listele #### get_organization_overview[[huggingface_hub.HfApi.get_organization_overview]] ```python get_organization_overview(organization: str, token: bool | str | None = None) ``` [Kaynak](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L11747) **Parametreler:** organization (`str`) : Genel bakış alınacak kuruluşun adı. token (`bool` veya `str`, *isteğe bağlı*) : Geçerli bir kullanıcı erişim belirteci (dize). Varsayılan olarak, kimlik doğrulama için önerilen yöntem olan yerel olarak kaydedilmiş belirteç kullanılır (bkz. https://huggingface.co/docs/huggingface_hub/quick-start#authentication). Kimlik doğrulamayı devre dışı bırakmak için `False` geçirin. **Dönüş:** `Organization` Kuruluşun genel bakışını içeren bir `Organization` nesnesi. **Yükselen:** ``HTTPError`` - [`HTTPError`](https://requests.readthedocs.io/en/latest/api/#requests.HTTPError) -- HTTP 404 Organizasyon Hub'da mevcut değilse. Hub'da bir kuruluşun genel bakışını alın. #### get_paths_info[[huggingface_hub.HfApi.get_paths_info]] ```python get_paths_info(repo_id: str, paths: list[str] | str, expand: bool = False, revision: str | None = None, repo_type: str | None = None, token: str | bool | None = None) ``` [Kaynak](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L4269) **Parametreler:** repo_id (`str`) : `/` ile ayrılmış bir ad alanı (kullanıcı veya kuruluş) ve bir depo adı. paths (`Union[list[str], str]`, *isteğe bağlı*) : Hakkında bilgi alınacak yollar. Bir yol mevcut değilse, bir istisna fırlatılmadan yoksayılır. expand (`bool`, *isteğe bağlı*, varsayılan `False`) : Yollar hakkında daha fazla bilgi (ör. son commit ve dosyaların güvenlik tarama sonuçları) alınıp alınmayacağını belirtir. Bu işlem sunucu için daha maliyetli olduğundan sayfa başına yalnızca 50 sonuç döndürülür (1000 yerine). Sayfalama `huggingface_hub` içinde uygulandığından, sonuçları alma süresi dışında bu durum sizin için şeffaftır. revision (`str`, *isteğe bağlı*) : Bilgilerin alınacağı depoyun revizyonu. Varsayılan olarak `"main"` dalıdır. repo_type (`str`, *isteğe bağlı*) : Bilgilerin alınacağı depoyun türü (`"model"`, `"dataset"` veya `"space"`. Varsayılan olarak `"model"`. token (`bool` veya `str`, *isteğe bağlı*) : Geçerli bir kullanıcı erişim belirteci (dize). Varsayılan olarak, kimlik doğrulama için önerilen yöntem olan yerel olarak kaydedilmiş belirteç kullanılır (bkz. https://huggingface.co/docs/huggingface_hub/quick-start#authentication). Kimlik doğrulamayı devre dışı bırakmak için `False` geçirin. **Dönüş:** `list[Union[RepoFile, RepoFolder]]` Yollar hakkında bilgi, [RepoFile](/docs/huggingface_hub/v2.4.0/tr/package_reference/hf_api#huggingface_hub.RepoFile) ve `RepoFolder` nesnelerinin bir listesi olarak. **Yükselen:** [RepositoryNotFoundError](/docs/huggingface_hub/v2.4.0/tr/package_reference/utilities#huggingface_hub.errors.RepositoryNotFoundError) veya [RevisionNotFoundError](/docs/huggingface_hub/v2.4.0/tr/package_reference/utilities#huggingface_hub.errors.RevisionNotFoundError) - [RepositoryNotFoundError](/docs/huggingface_hub/v2.4.0/tr/package_reference/utilities#huggingface_hub.errors.RepositoryNotFoundError) -- Depo bulunamadıysa (hata 404): repo_id/repo_type yanlış, özel ama kimlik doğrulaması yapılmamış veya depo mevcut değil. - [RevisionNotFoundError](/docs/huggingface_hub/v2.4.0/tr/package_reference/utilities#huggingface_hub.errors.RevisionNotFoundError) -- Depoda revizyon bulunamadıysa (404 hatası). Bir depodaki yollar hakkında bilgi alın. Örnek: ```py >>> from huggingface_hub import get_paths_info >>> paths_info = get_paths_info("allenai/c4", ["README.md", "en"], repo_type="dataset") >>> paths_info [ RepoFile(path='README.md', size=2379, blob_id='f84cb4c97182890fc1dbdeaf1a6a468fd27b4fff', lfs=None, last_commit=None, security=None), RepoFolder(path='en', tree_id='dc943c4c40f53d02b31ced1defa7e5f438d5862e', last_commit=None) ] ``` #### get_repo_discussions[[huggingface_hub.HfApi.get_repo_discussions]] ```python get_repo_discussions(repo_id: str, author: str | None = None, discussion_type: constants.DiscussionTypeFilter | None = None, discussion_status: constants.DiscussionStatusFilter | None = None, repo_type: str | None = None, token: bool | str | None = None) ``` [Kaynak](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L7256) **Parametreler:** repo_id (`str`) : `/` ile ayrılmış bir ad alanı (kullanıcı veya kuruluş) ve bir depo adı. author (`str`, *isteğe bağlı*) : Tartışma yazarına göre filtrelemek için bir değer geçirin. `None` filtre uygulanmadığı anlamına gelir. Varsayılan değer `None`'dir. discussion_type (`str`, *isteğe bağlı*) : Yalnızca pull request'leri almak için `"pull_request"`, yalnızca tartışmaları almak için `"discussion"` olarak ayarlayın. İkisini de almak için `"all"` veya `None` olarak ayarlayın. Varsayılan değer `None`'dir. discussion_status (`str`, *isteğe bağlı*) : Yalnızca açık (sırasıyla kapalı) tartışmaları almak için `"open"` (sırasıyla `"closed"`) olarak ayarlayın. Her ikisini de almak için `"all"` veya `None` olarak ayarlayın. Varsayılan değer `None`'dir. repo_type (`str`, *isteğe bağlı*) : Bir veri setinden veya uzaydan alınacaksa `"dataset"` veya `"space"` olarak, bir modelden alınacaksa `None` veya `"model"` olarak ayarlayın. Varsayılan değer `None`'dir. token (`bool` veya `str`, *isteğe bağlı*) : Geçerli bir kullanıcı erişim belirteci (dize). Varsayılan olarak, kimlik doğrulama için önerilen yöntem olan yerel olarak kaydedilmiş belirteç kullanılır (bkz. https://huggingface.co/docs/huggingface_hub/quick-start#authentication). Kimlik doğrulamayı devre dışı bırakmak için `False` geçirin. **Dönüş:** `Iterator[Discussion]` [Discussion](/docs/huggingface_hub/v2.4.0/tr/package_reference/community#huggingface_hub.Discussion) nesnelerinin bir iteratörü. Verilen depo için Tartışmaları ve Birleştirme İsteklerini getirir. Örnek: Bir depodaki tüm tartışmaları bir listede toplama: ```python >>> from huggingface_hub import get_repo_discussions >>> discussions_list = list(get_repo_discussions(repo_id="bert-base-uncased")) ``` Bir repodaki tartışmaları döngüye alma: ```python >>> from huggingface_hub import get_repo_discussions >>> for discussion in get_repo_discussions(repo_id="bert-base-uncased"): ... print(discussion.num, discussion.title) ``` #### get_safetensors_metadata[[huggingface_hub.HfApi.get_safetensors_metadata]] ```python get_safetensors_metadata(repo_id: str, repo_type: str | None = None, revision: str | None = None, token: bool | str | None = None, timeout: float | None = 10) ``` [Kaynak](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L6669) **Parametreler:** repo_id (`str`) : `/` ile ayrılmış bir kullanıcı veya kuruluş adı ve bir depo adı. repo_type (`str`, *isteğe bağlı*) : Dosya bir veri setinde veya uzaydaysa `"dataset"` veya `"space"` olarak ayarlanır, bir modeldeyse `None` veya `"model"`. Varsayılan `None`'dir. revision (`str`, *isteğe bağlı*) : Dosyanın alınacağı git revizyonu. Bir dal adı, etiket veya commit hash'i olabilir. Varsayılan olarak `"main"` dalının başıdır. token (`bool` veya `str`, *isteğe bağlı*) : Geçerli bir kullanıcı erişim belirteci (dize). Varsayılan olarak, kimlik doğrulama için önerilen yöntem olan yerel olarak kaydedilmiş belirteç kullanılır (bkz. https://huggingface.co/docs/huggingface_hub/quick-start#authentication). Kimlik doğrulamayı devre dışı bırakmak için `False` geçirin. timeout (`float`, *opsiyonel*, varsayılan 10) : Sunucunun veri göndermesini bekleme süresi (saniye cinsinden); bu değer, safetensors dosyası başlığını getiren her isteğe iletilir. Zaman aşımını devre dışı bırakmak için `None` olarak ayarlayın (önerilmez, çünkü takılan bir bağlantı çağrıyı süresiz olarak asılı bırakabilir). **Dönüş:** `SafetensorsRepoMetadata` safetensors deposuyla ilgili bilgiler. **Yükseltir:** `NotASafetensorsRepoError` veya `SafetensorsParsingError` - `NotASafetensorsRepoError` -- Depo bir safetensors deposu değilse, yani `model.safetensors` veya `model.safetensors.index.json` dosyasından herhangi birine sahip değilse. - `SafetensorsParsingError` -- Bir safetensors dosyasının başlığı doğru şekilde ayrıştırılamadığında. Hub'daki bir safetensors deposu için meta verileri ayrıştırın. Önce repoda tek bir safetensors dosyası olup olmadığına yoksa parçalı (sharded) bir safetensors deposu olup olmadığına bakarız. Tek bir safetensors dosyası varsa, bu dosyadan metadata'yi ayrıştırırız. Parçalı bir safetensors deposu varsa, önce index dosyasından metadata'yi, ardından her shard'dan metadata'yi ayrıştırırız. Tek bir safetensors dosyasından meta verileri ayrıştırmak için [parse_safetensors_file_metadata()](/docs/huggingface_hub/v2.4.0/tr/package_reference/hf_api#huggingface_hub.HfApi.parse_safetensors_file_metadata) kullanın. Parçalı bir modelin tüm parça başlıklarını `main` üzerinde tek bir istekle almak için [get_sharded_safetensors_metadata()](/docs/huggingface_hub/v2.4.0/tr/package_reference/hf_api#huggingface_hub.HfApi.get_sharded_safetensors_metadata) kullanın. safetensors formatı hakkında daha fazla ayrıntı için https://huggingface.co/docs/safetensors/index#format adresine göz atın. Örnek: ```py # Parse repo with single weights file >>> metadata = get_safetensors_metadata("bigscience/bloomz-560m") >>> metadata SafetensorsRepoMetadata( metadata=None, sharded=False, weight_map={'h.0.input_layernorm.bias': 'model.safetensors', ...}, files_metadata={'model.safetensors': SafetensorsFileMetadata(...)} ) >>> metadata.files_metadata["model.safetensors"].metadata {'format': 'pt'} # Parse repo with sharded model >>> metadata = get_safetensors_metadata("bigscience/bloom") Parse safetensors files: 100%|██████████████████████████████████████████| 72/72 [00:12<00:00, 5.78it/s] >>> metadata SafetensorsRepoMetadata(metadata={'total_size': 352494542848}, sharded=True, weight_map={...}, files_metadata={...}) >>> len(metadata.files_metadata) 72 # All safetensors files have been fetched # Parse repo with sharded model >>> get_safetensors_metadata("runwayml/stable-diffusion-v1-5") NotASafetensorsRepoError: 'runwayml/stable-diffusion-v1-5' is not a safetensors repo. Couldn't find 'model.safetensors.index.json' or 'model.safetensors' files. ``` #### get_sharded_safetensors_metadata[[huggingface_hub.HfApi.get_sharded_safetensors_metadata]] ```python get_sharded_safetensors_metadata(repo_id: str, filename: str = 'model.safetensors.index.json', token: bool | str | None = None, timeout: float | None = 10) ``` [Kaynak](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L6824) **Parametreler:** repo_id (`str`) : `/` ile ayrılmış bir kullanıcı veya kuruluş adı ve bir depo adı. filename (`str`, *isteğe bağlı*) : Depodaki safetensors dizin dosyasının yolu. Varsayılan olarak `"model.safetensors.index.json"`. token (`bool` veya `str`, *isteğe bağlı*) : Geçerli bir kullanıcı erişim belirteci (dize). Varsayılan olarak, kimlik doğrulama için önerilen yöntem olan yerel olarak kaydedilmiş belirteç kullanılır (bkz. https://huggingface.co/docs/huggingface_hub/quick-start#authentication). Kimlik doğrulamayı devre dışı bırakmak için `False` geçirin. timeout (`float`, *opsiyonel*, varsayılan 10) : Sunucunun veri göndermesini bekleme süresi (saniye). Zaman aşımını devre dışı bırakmak için `None` olarak ayarlayın (önerilmez, çünkü takılan bir bağlantı çağrıyı süresiz olarak asabilir). **Dönüş:** `SafetensorsRepoMetadata` [get_safetensors_metadata()](/docs/huggingface_hub/v2.4.0/tr/package_reference/hf_api#huggingface_hub.HfApi.get_safetensors_metadata) ile aynı meta veriler. Hub'daki `main` dalındaki parçalı safetensors modelinin tüm parçalarının meta verilerini, [get_safetensors_metadata()](/docs/huggingface_hub/v2.4.0/tr/package_reference/hf_api#huggingface_hub.HfApi.get_safetensors_metadata)'in her parça başlığını ayrıştırması yerine tek bir istekle alın. Yalnızca Hugging Face Hub. Örnek: ```py >>> metadata = get_sharded_safetensors_metadata("HuggingFaceH4/zephyr-7b-beta") >>> len(metadata.files_metadata) 8 ``` #### get_space_runtime[[huggingface_hub.HfApi.get_space_runtime]] ```python get_space_runtime(repo_id: str, token: bool | str | None = None) ``` [Kaynak](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L8239) **Parametreler:** repo_id (`str`) : Güncellenecek repozituarın kimliği. Örnek: `"bigcode/in-the-stack"`. token (`bool` veya `str`, *isteğe bağlı*) : Geçerli bir kullanıcı erişim belirteci (dize). Varsayılan olarak, kimlik doğrulama için önerilen yöntem olan yerel olarak kaydedilmiş belirteç kullanılır (bkz. https://huggingface.co/docs/huggingface_hub/quick-start#authentication). Kimlik doğrulamayı devre dışı bırakmak için `False` geçirin. **Dönüş:** [SpaceRuntime](/docs/huggingface_hub/v2.4.0/tr/package_reference/space_runtime#huggingface_hub.SpaceRuntime) Bir Space hakkında çalışma zamanı bilgileri, Space aşaması ve donanımı dahil. Bir Space hakkında çalışma zamanı bilgilerini alır. #### get_space_secrets[[huggingface_hub.HfApi.get_space_secrets]] ```python get_space_secrets(repo_id: str, token: bool | str | None = None) ``` [Kaynak](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L8109) **Parametreler:** repo_id (`str`) : Sorgulanacak repozituarın kimliği. Örnek: `"bigcode/in-the-stack"`. token (`bool` veya `str`, *isteğe bağlı*) : Geçerli bir kullanıcı erişim belirteci (dize). Varsayılan olarak, kimlik doğrulama için önerilen yöntem olan yerel olarak kaydedilmiş belirteç kullanılır (bkz. https://huggingface.co/docs/huggingface_hub/quick-start#authentication). Kimlik doğrulamayı devre dışı bırakmak için `False` geçirin. **Dönüş:** `dict[str, SpaceSecret]` Gizli ad ile anahtarlanan `SpaceSecret` nesnelerinin sözlüğü. Bir Uzay'daki tüm gizli bilgileri alır. Secret değerler yalnızca yazılabilir ve geri okunamaz. Yalnızca anahtar, açıklama ve son güncelleme zamanı döndürülür. Secrets, bir Space'e gizli anahtarlar veya jetonları bunları kodun içine gömmeden ayarlamayı sağlar. Daha fazla ayrıntı için https://huggingface.co/docs/hub/spaces-overview#managing-secrets adresine bakın. Örnek: ```python >>> from huggingface_hub import HfApi >>> api = HfApi() >>> api.get_space_secrets("username/my-space") {'HF_TOKEN': SpaceSecret(key='HF_TOKEN', description='...', updated_at=datetime.datetime(...))} ``` #### get_space_variables[[huggingface_hub.HfApi.get_space_variables]] ```python get_space_variables(repo_id: str, token: bool | str | None = None) ``` [Kaynak](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L8146) **Parametreler:** repo_id (`str`) : Sorgulanacak repozituarın kimliği. Örnek: `"bigcode/in-the-stack"`. token (`bool` veya `str`, *isteğe bağlı*) : Geçerli bir kullanıcı erişim belirteci (dize). Varsayılan olarak, kimlik doğrulama için önerilen yöntem olan yerel olarak kaydedilmiş belirteç kullanılır (bkz. https://huggingface.co/docs/huggingface_hub/quick-start#authentication). Kimlik doğrulamayı devre dışı bırakmak için `False` geçirin. Bir Uzay'daki tüm değişkenleri alır. Değişkenler, bir Space'e ortam değişkenlerini sabit kodlamadan ayarlamayı sağlar. Daha fazla ayrıntı için bkz. https://huggingface.co/docs/hub/spaces-overview#managing-secrets-and-environment-variables #### get_user_overview[[huggingface_hub.HfApi.get_user_overview]] ```python get_user_overview(username: str, token: bool | str | None = None) ``` [Kaynak](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L11721) **Parametreler:** username (`str`) : Genel bakış alınacak kullanıcının kullanıcı adı. token (`bool` veya `str`, *isteğe bağlı*) : Geçerli bir kullanıcı erişim belirteci (dize). Varsayılan olarak, kimlik doğrulama için önerilen yöntem olan yerel olarak kaydedilmiş belirteç kullanılır (bkz. https://huggingface.co/docs/huggingface_hub/quick-start#authentication). Kimlik doğrulamayı devre dışı bırakmak için `False` geçirin. **Dönüş:** `User` Kullanıcının genel bakışını içeren bir [User](/docs/huggingface_hub/v2.4.0/tr/package_reference/hf_api#huggingface_hub.User) nesnesi. **Yükselen:** `HfHubHTTPError` - `HfHubHTTPError` -- Kullanıcı Hub'da yoksa HTTP 404. Hub'da bir kullanıcının genel bakışını alın. #### get_webhook[[huggingface_hub.HfApi.get_webhook]] ```python get_webhook(webhook_id: str, token: bool | str | None = None) ``` [Kaynak](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L11072) **Parametreler:** webhook_id (`str`) : Alınacak webhook'un benzersiz tanımlayıcısı. token (`bool` veya `str`, *isteğe bağlı*) : Geçerli bir kullanıcı erişim belirteci (dize). Varsayılan olarak, kimlik doğrulama için önerilen yöntem olan yerel olarak kaydedilmiş belirteç kullanılır (bkz. https://huggingface.co/docs/huggingface_hub/quick-start#authentication). Kimlik doğrulamayı devre dışı bırakmak için `False` geçirin. **Dönüş:** [WebhookInfo](/docs/huggingface_hub/v2.4.0/tr/package_reference/hf_api#huggingface_hub.WebhookInfo) Webhook hakkında bilgi. Kimliğiyle bir webhook alın. Örnek: ```python >>> from huggingface_hub import get_webhook >>> webhook = get_webhook("654bbbc16f2ec14d77f109cc") >>> print(webhook) WebhookInfo( id="654bbbc16f2ec14d77f109cc", job=None, watched=[WebhookWatchedItem(type="user", name="julien-c"), WebhookWatchedItem(type="org", name="HuggingFaceH4")], url="https://webhook.site/a2176e82-5720-43ee-9e06-f91cb4c91548", secret="my-secret", domains=["repo", "discussion"], disabled=False, ) ``` #### get_zero_gpu_quota[[huggingface_hub.HfApi.get_zero_gpu_quota]] ```python get_zero_gpu_quota(token: bool | str | None = None) ``` [Kaynak](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L8283) **Parametreler:** token (`bool` veya `str`, *isteğe bağlı*) : Geçerli bir kullanıcı erişim belirteci (dize). Varsayılan olarak, kimlik doğrulama için önerilen yöntem olan yerel olarak kaydedilmiş belirteç kullanılır (bkz. https://huggingface.co/docs/huggingface_hub/quick-start#authentication). İnce taneli bir belirtecin "Billing > Read billing usage and payment method status" iznine sahip olması ve bir OAuth belirtecinin `read-billing` kapsamına sahip olması gerekir. **Dönüş:** [ZeroGpuQuota](/docs/huggingface_hub/v2.4.0/tr/package_reference/space_runtime#huggingface_hub.ZeroGpuQuota) Kimlik doğrulaması yapılmış kullanıcının ZeroGPU kotası. Kimlik doğrulaması yapılmış kullanıcının ZeroGPU kota değerini getirir. Bir uygulamadan, bir ajandan veya bir MCP sunucusundan programatik olarak ZeroGPU Spaces çağrılırken ZeroGPU kullanımını izlemek için faydalıdır. Daha fazla ayrıntı için https://huggingface.co/docs/hub/spaces-zerogpu adresine bakın. Örnek: ```py >>> from huggingface_hub import get_zero_gpu_quota >>> quota = get_zero_gpu_quota() >>> quota ZeroGpuQuota(base=2400, remaining=1810, resets_at=datetime.datetime(2026, 9, 30, 9, 12, 3, tzinfo=datetime.timezone.utc), overquota_used=0) >>> print(f"{quota.remaining / 60:.1f} minutes left") 30.2 minutes left ``` #### grant_access[[huggingface_hub.HfApi.grant_access]] ```python grant_access(repo_id: str, user: str, repo_type: str | None = None, token: bool | str | None = None) ``` [Kaynak](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L11017) **Parametreler:** repo_id (`str`) : Erişim izni verilecek repozituarın kimliği. user (`str`) : Erişim izni verilecek kullanıcının kullanıcı adı. repo_type (`str`, *isteğe bağlı*) : Erişim izni verilecek repoyun türü. `model`, `dataset` veya `space` değerlerinden biri olmalıdır. Varsayılan değer `model`'dir. token (`bool` veya `str`, *isteğe bağlı*) : Geçerli bir kullanıcı erişim belirteci (dize). Varsayılan olarak, kimlik doğrulama için önerilen yöntem olan yerel olarak kaydedilmiş belirteç kullanılır (bkz. https://huggingface.co/docs/huggingface_hub/quick-start#authentication). Kimlik doğrulamayı devre dışı bırakmak için `False` geçirin. **Yükselen:** `HfHubHTTPError` - `HfHubHTTPError` -- Depo gated değilse HTTP 400. - `HfHubHTTPError` -- Kullanıcının zaten depoya erişimi varsa HTTP 400. - `HfHubHTTPError` -- Depoya yalnızca salt okunur erişiminiz varsa HTTP 403. Deponun ait olduğu organizasyonda `write` veya `admin` rolünüz yoksa ya da bir `read` belirteci geçirdiyseniz bu durumla karşılaşabilirsiniz. - `HfHubHTTPError` -- Kullanıcı Hub'da yoksa HTTP 404. Belirli bir gated repo için bir kullanıcıya erişim izni verin. Erişim yetkisi verilmesi, kullanıcının kendi başına bir erişim isteği göndermesini gerektirmez. Kullanıcı, dosyaları indirebileceği kabul edilenler listesine otomatik olarak eklenir. Verilen erişim yetkisini [cancel_access_request()](/docs/huggingface_hub/v2.4.0/tr/package_reference/hf_api#huggingface_hub.HfApi.cancel_access_request) veya [reject_access_request()](/docs/huggingface_hub/v2.4.0/tr/package_reference/hf_api#huggingface_hub.HfApi.reject_access_request) kullanarak istediğiniz zaman iptal edebilirsiniz. Kapalı depolar hakkında daha fazla bilgi için https://huggingface.co/docs/hub/models-gated adresine bakın. #### hf_hub_download[[huggingface_hub.HfApi.hf_hub_download]] ```python hf_hub_download(repo_id: str, filename: str, subfolder: str | None = None, repo_type: str | None = None, revision: str | None = None, cache_dir: str | Path | None = None, local_dir: str | Path | None = None, force_download: bool = False, etag_timeout: float = 10, token: bool | str | None = None, local_files_only: bool = False, tqdm_class: type[base_tqdm] | None = None, dry_run: bool = False) ``` [Kaynak](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L6364) **Parametreler:** repo_id (`str`) : `/` ile ayrılmış bir kullanıcı veya kuruluş adı ve bir depo adı. filename (`str`) : Depodaki dosyanın adı. subfolder (`str`, *isteğe bağlı*) : Depodaki bir klasöre karşılık gelen isteğe bağlı bir değer. repo_type (`str`, *isteğe bağlı*) : Bir veri setinden veya uzaydan indiriliyorsa `"dataset"` veya `"space"` olarak, bir modelden indiriliyorsa `None` veya `"model"` olarak ayarlayın. Varsayılan değer `None`'dir. revision (`str`, *isteğe bağlı*) : Bir dal adı, etiket veya commit hash'i olabilen isteğe bağlı bir Git revizyon kimliği. cache_dir (`str`, `Path`, *isteğe bağlı*) : Önbelleğe alınan dosyaların saklandığı klasörün yolu. local_dir (`str` veya `Path`, *isteğe bağlı*) : Verilirse, indirilen dosya bu dizinin altına yerleştirilir. force_download (`bool`, *isteğe bağlı*, varsayılan `False`) : Dosya yerel önbellekte zaten varsa bile indirilip indirilmeyeceği. etag_timeout (`float`, *isteğe bağlı*, varsayılan `10`) : ETag alınırken, `httpx2.request`'e iletilen, sunucunun veri göndermesini bekleme süresi (saniye cinsinden); bu süre dolunca denemeden vazgeçilir. token (`bool` veya `str`, *isteğe bağlı*) : Geçerli bir kullanıcı erişim belirteci (dize). Varsayılan olarak, kimlik doğrulama için önerilen yöntem olan yerel olarak kaydedilmiş belirteç kullanılır (bkz. https://huggingface.co/docs/huggingface_hub/quick-start#authentication). Kimlik doğrulamayı devre dışı bırakmak için `False` geçirin. local_files_only (`bool`, *isteğe bağlı*, varsayılan `False`) : `True` ise, dosyanın indirilmesini engeller ve varsa yerel önbellekteki dosyanın yolunu döndürür. tqdm_class (`tqdm`, *isteğe bağlı*) : Verildiğinde, ilerleme çubuğu için varsayılan davranışı yazar. Geçirilen argüman `tqdm.auto.tqdm` sınıfından türetmeli veya en azından davranışını taklit etmelidir. Varsayılan olarak, `HF_HUB_DISABLE_PROGRESS_BARS` ortam değişkeni ayarlanarak devre dışı bırakılabilen özel HF ilerleme çubuğu kullanılır. dry_run (`bool`, *isteğe bağlı*, varsayılan `False`) : `True` ise, dosyayı gerçekten indirmeden kuru bir çalışma (dry run) gerçekleştirir. İndirilecek olanlarla ilgili bilgileri içeren bir [DryRunFileInfo](/docs/huggingface_hub/v2.4.0/tr/package_reference/hf_api#huggingface_hub.DryRunFileInfo) nesnesi döndürür. **Dönüş:** `str` veya [DryRunFileInfo](/docs/huggingface_hub/v2.4.0/tr/package_reference/hf_api#huggingface_hub.DryRunFileInfo) - `dry_run=False` ise: Dosyanın yerel yolu veya ağ kapalıysa, diskte önbelleğe alınmış dosyanın son sürümü. - `dry_run=True` ise: İndirme bilgilerini içeren bir [DryRunFileInfo](/docs/huggingface_hub/v2.4.0/tr/package_reference/hf_api#huggingface_hub.DryRunFileInfo) nesnesi. **Yükseltir:** [RepositoryNotFoundError](/docs/huggingface_hub/v2.4.0/tr/package_reference/utilities#huggingface_hub.errors.RepositoryNotFoundError) veya [RevisionNotFoundError](/docs/huggingface_hub/v2.4.0/tr/package_reference/utilities#huggingface_hub.errors.RevisionNotFoundError) veya `~utils.RemoteEntryNotFoundError` veya [LocalEntryNotFoundError](/docs/huggingface_hub/v2.4.0/tr/package_reference/utilities#huggingface_hub.errors.LocalEntryNotFoundError) veya ``EnvironmentError`` veya ``OSError`` veya ``ValueError`` - [RepositoryNotFoundError](/docs/huggingface_hub/v2.4.0/tr/package_reference/utilities#huggingface_hub.errors.RepositoryNotFoundError) -- İndirilecek depo bulunamadığında. Bunun nedeni, deponun var olmaması veya `private` olarak ayarlanmış olması ve erişiminizin bulunmaması olabilir. - [RevisionNotFoundError](/docs/huggingface_hub/v2.4.0/tr/package_reference/utilities#huggingface_hub.errors.RevisionNotFoundError) -- İndirilecek revizyon bulunamadığında. - `~utils.RemoteEntryNotFoundError` -- İndirilecek dosya bulunamadığında. - [LocalEntryNotFoundError](/docs/huggingface_hub/v2.4.0/tr/package_reference/utilities#huggingface_hub.errors.LocalEntryNotFoundError) -- Ağ devre dışıysa veya kullanılamıyorsa ve dosya önbellekte bulunamıyorsa. - [`EnvironmentError`](https://docs.python.org/3/library/exceptions.html#EnvironmentError) -- `token=True` ise ancak token bulunamazsa. - [`OSError`](https://docs.python.org/3/library/exceptions.html#OSError) -- ETag belirlenemezse. - [`ValueError`](https://docs.python.org/3/library/exceptions.html#ValueError) -- Bazı parametre değeri geçersizse. Yerel önbellekte henüz yoksa verilen dosyayı indirir. Yeni önbellek dosya düzeni şu şekildedir: - Önbellek dizini, repo_id başına bir alt klasör içerir (repo türüne göre ad alanılandırılmıştır) - her depo klasörünün içinde: - refs, bilinen en son revizyon => commit_hash çiftlerinin bir listesidir - blobs, LFS dosyaları olup olmadığına bağlı olarak git-sha veya sha256 ile tanımlanan gerçek dosya bloblarını içerir - snapshots, her commit için bir alt klasör içerir; her "commit", o belirli commit'te çözümlenmiş dosyaların alt kümesini barındırır. Her dosya adı, o belirli commit'teki blob'a giden bir sembolik bağlantıdır. ``` [ 96] . └── [ 160] models--julien-c--EsperBERTo-small ├── [ 160] blobs │ ├── [321M] 403450e234d65943a7dcf7e05a771ce3c92faa84dd07db4ac20f592037a1e4bd │ ├── [ 398] 7cb18dc9bafbfcf74629a4b760af1b160957a83e │ └── [1.4K] d7edf6bd2a681fb0175f7735299831ee1b22b812 ├── [ 96] refs │ └── [ 40] main └── [ 128] snapshots ├── [ 128] 2439f60ef33a0d46d85da5001d52aeda5b00ce9f │ ├── [ 52] README.md -> ../../blobs/d7edf6bd2a681fb0175f7735299831ee1b22b812 │ └── [ 76] pytorch_model.bin -> ../../blobs/403450e234d65943a7dcf7e05a771ce3c92faa84dd07db4ac20f592037a1e4bd └── [ 128] bbc77c8132af1cc5cf678da3f1ddf2de43606d48 ├── [ 52] README.md -> ../../blobs/7cb18dc9bafbfcf74629a4b760af1b160957a83e └── [ 76] pytorch_model.bin -> ../../blobs/403450e234d65943a7dcf7e05a771ce3c92faa84dd07db4ac20f592037a1e4bd ``` `local_dir` sağlanırsa, depodaki dosya yapısı bu konumda yeniden oluşturulur. Bu seçenek kullanıldığında `cache_dir` kullanılmaz ve indirilen dosyalarla ilgili bazı meta verileri depolamak için `local_dir` kökünde bir `.cache/huggingface/` klasörü oluşturulur. Bu mekanizma ana önbellek sistemi kadar sağlam olmasa da, bir deponun en son sürümünü düzenli olarak çekmek için optimize edilmiştir. #### hide_discussion_comment[[huggingface_hub.HfApi.hide_discussion_comment]] ```python hide_discussion_comment(repo_id: str, discussion_num: int, comment_id: str, token: bool | str | None = None, repo_type: str | None = None) ``` [Kaynak](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L7940) **Parametreler:** repo_id (`str`) : `/` ile ayrılmış bir ad alanı (kullanıcı veya kuruluş) ve bir depo adı. discussion_num (`int`) : Tartışma veya Pull Request'in numarası. Kesinlikle pozitif bir tam sayı olmalıdır. comment_id (`str`) : Düzenlenecek yorumun kimliği. repo_type (`str`, *isteğe bağlı*) : Bir veri setine veya uzaya yükleniyorsa `"dataset"` veya `"space"` olarak, bir modele yükleniyorsa `None` veya `"model"` olarak ayarlayın. Varsayılan değer `None`'dir. token (`bool` veya `str`, *isteğe bağlı*) : Geçerli bir kullanıcı erişim belirteci (dize). Varsayılan olarak, kimlik doğrulama için önerilen yöntem olan yerel olarak kaydedilmiş belirteç kullanılır (bkz. https://huggingface.co/docs/huggingface_hub/quick-start#authentication). Kimlik doğrulamayı devre dışı bırakmak için `False` geçirin. **Dönüş:** [DiscussionComment](/docs/huggingface_hub/v2.4.0/tr/package_reference/community#huggingface_hub.DiscussionComment) gizli yorum Bir Tartışma / Çekme İsteği'ndeki yorumu gizler. > [!WARNING] > Gizli yorumların içeriği artık alınamaz. Bir yorumu gizlemek geri alınamaz. > [!TIP] > Aşağıdaki hataları oluşturur: > > - [`HTTPError`](https://requests.readthedocs.io/en/latest/api/#requests.HTTPError) HuggingFace API bir hata döndürürse - [`ValueError`](https://docs.python.org/3/library/exceptions.html#ValueError) bir parametre değeri geçersizse - [RepositoryNotFoundError](/docs/huggingface_hub/v2.4.0/tr/package_reference/utilities#huggingface_hub.errors.RepositoryNotFoundError) İndirme yapılacak deposu bulunamazsa. Bunun nedeni, deponun var olmaması veya `private` olarak ayarlanmış olması ve erişiminizin bulunmaması olabilir. #### inspect_job[[huggingface_hub.HfApi.inspect_job]] ```python inspect_job(job_id: str, namespace: str | None = None, token: bool | str | None = None) ``` [Kaynak](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L12563) **Parametreler:** job_id (`str`) : İşin kimliği. namespace (`str`, *isteğe bağlı*) : Job'un çalıştığı ad alanı. Varsayılan olarak mevcut kullanıcının ad alanıdır. token (`bool` veya `str`, *isteğe bağlı*) : Geçerli bir kullanıcı erişim belirteci. Sağlanmazsa, önerilen kimlik doğrulama yöntemi olan yerel olarak kaydedilmiş belirteç kullanılır. Kimlik doğrulamayı devre dışı bırakmak için `False` olarak ayarlayın. Aşağıdaki bağlantıya bakın: https://huggingface.co/docs/huggingface_hub/quick-start#authentication. Hugging Face altyapısında bir hesaplama işini inceleyin. Örnek: ```python >>> from huggingface_hub import inspect_job, run_job >>> job = run_job(image="python:3.12", command=["python", "-c" ,"print('Hello from HF compute!')"]) >>> inspect_job(job_id=job.id) JobInfo( id='68780d00bbe36d38803f645f', created_at=datetime.datetime(2025, 7, 16, 20, 35, 12, 808000, tzinfo=datetime.timezone.utc), docker_image='python:3.12', space_id=None, command=['python', '-c', "print('Hello from HF compute!')"], arguments=[], environment={}, secrets={}, flavor='cpu-basic', status=JobStatus(stage='RUNNING', message=None) ) ``` #### inspect_scheduled_job[[huggingface_hub.HfApi.inspect_scheduled_job]] ```python inspect_scheduled_job(scheduled_job_id: str, namespace: str | None = None, token: bool | str | None = None) ``` [Kaynak](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L13285) **Parametreler:** scheduled_job_id (`str`) : Planlanan Job'un kimliği. namespace (`str`, *isteğe bağlı*) : Planlanan Job'un bulunduğu ad alanı. Varsayılan olarak mevcut kullanıcının ad alanıdır. token (`bool` veya `str`, *isteğe bağlı*) : Geçerli bir kullanıcı erişim belirteci. Sağlanmazsa, önerilen kimlik doğrulama yöntemi olan yerel olarak kaydedilmiş belirteç kullanılır. Kimlik doğrulamayı devre dışı bırakmak için `False` olarak ayarlayın. Aşağıdaki bağlantıya bakın: https://huggingface.co/docs/huggingface_hub/quick-start#authentication. Hugging Face altyapısında planlanmış bir hesaplama İşini denetleyin. Örnek: ```python >>> from huggingface_hub import inspect_scheduled_job, create_scheduled_job >>> scheduled_job = create_scheduled_job(image="python:3.12", command=["python", "-c" ,"print('Hello from HF compute!')"], schedule="@hourly") >>> inspect_scheduled_job(scheduled_job_id=scheduled_job.id) ``` #### kernel_info[[huggingface_hub.HfApi.kernel_info]] ```python kernel_info(repo_id: str, revision: str | None = None, timeout: float | None = None, token: bool | str | None = None) ``` [Kaynak](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L3429) **Parametreler:** repo_id (`str`) : `/` ile ayrılmış bir ad alanı (kullanıcı veya kuruluş) ve bir depo adı. revision (`str`, *isteğe bağlı*) : Bilgilerin alınacağı çekirdek deposunun revizyonu. timeout (`float`, *isteğe bağlı*) : Hub'a yapılan istek için bir zaman aşımı ayarlanıp ayarlanmayacağı. token (`bool` veya `str`, *isteğe bağlı*) : Geçerli bir kullanıcı erişim belirteci (dize). Varsayılan olarak, kimlik doğrulama için önerilen yöntem olan yerel olarak kaydedilmiş belirteç kullanılır (bkz. https://huggingface.co/docs/huggingface_hub/quick-start#authentication). Kimlik doğrulamayı devre dışı bırakmak için `False` geçirin. **Dönüş:** [ModelInfo](/docs/huggingface_hub/v2.4.0/tr/package_reference/hf_api#huggingface_hub.ModelInfo) Çekirdek deposu bilgileri. huggingface.co'daki belirli bir çekirdeğin bilgilerini alın. #### list_accepted_access_requests[[huggingface_hub.HfApi.list_accepted_access_requests]] ```python list_accepted_access_requests(repo_id: str, repo_type: str | None = None, token: bool | str | None = None) ``` [Kaynak](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L10669) **Parametreler:** repo_id (`str`) : Erişim isteklerinin alınacağı repozitörün kimliği. repo_type (`str`, *isteğe bağlı*) : Erişim isteklerinin alınacağı repoyu türü. `model`, `dataset` veya `space` değerlerinden biri olmalıdır. Varsayılan değer `model`'dir. token (`bool` veya `str`, *isteğe bağlı*) : Geçerli bir kullanıcı erişim belirteci (dize). Varsayılan olarak, kimlik doğrulama için önerilen yöntem olan yerel olarak kaydedilmiş belirteç kullanılır (bkz. https://huggingface.co/docs/huggingface_hub/quick-start#authentication). Kimlik doğrulamayı devre dışı bırakmak için `False` geçirin. **Dönüş:** `Iterable[AccessRequest]` `AccessRequest` nesnelerinden oluşan bir iterable. Her öğe bir `username`, `request_id`, `email`, `status` ve `timestamp` özniteliği içerir. Gated repo özel bir form içeriyorsa, `fields` özniteliği kullanıcının yanıtlarıyla doldurulur. **Yükselen:** `HfHubHTTPError` - `HfHubHTTPError` -- Depo gated değilse HTTP 400. - `HfHubHTTPError` -- Depoya yalnızca salt okunur erişiminiz varsa HTTP 403. Deponun ait olduğu organizasyonda `write` veya `admin` rolünüz yoksa ya da bir `read` belirteci geçirdiyseniz bu durumla karşılaşabilirsiniz. Belirli bir gated repo için kabul edilen erişim isteklerini alın. Kabul edilen bir istek, kullanıcının depoya erişim istediğini ve bu isteğin kabul edildiğini ifade eder. Kullanıcı, depodaki herhangi bir dosyayı indirebilir. Onay modu otomatikse, bu liste varsayılan olarak tüm istekleri içermelidir. Kabul edilen istekler, [cancel_access_request()](/docs/huggingface_hub/v2.4.0/tr/package_reference/hf_api#huggingface_hub.HfApi.cancel_access_request) ve [reject_access_request()](/docs/huggingface_hub/v2.4.0/tr/package_reference/hf_api#huggingface_hub.HfApi.reject_access_request) kullanılarak herhangi bir zamanda iptal edilebilir veya reddedilebilir. İptal edilen bir istek bekleyenler listesine geri dönerken, reddedilen bir istek reddedilenler listesine geçer. Her iki durumda da kullanıcının depoya erişimi sona erer. Kapalı depolar hakkında daha fazla bilgi için https://huggingface.co/docs/hub/models-gated adresine bakın. Örnek: ```py >>> from huggingface_hub import list_accepted_access_requests >>> requests = list(list_accepted_access_requests("meta-llama/Llama-2-7b")) >>> len(requests) 411 >>> requests[0] [ AccessRequest( username='clem', request_id='655f3a1c9e6b2d4f8a7c1e05', fullname='Clem 🤗', email='***', timestamp=datetime.datetime(2023, 11, 23, 18, 4, 53, 828000, tzinfo=datetime.timezone.utc), status='accepted', fields=None, ), ... ] ``` #### list_bucket_tree[[huggingface_hub.HfApi.list_bucket_tree]] ```python list_bucket_tree(bucket_id: str, prefix: str | None = None, recursive: bool | None = None, token: str | bool | None = None) ``` [Kaynak](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L14301) **Parametreler:** bucket_id (`str`) : Kovanın kimliği (ör. `"username/my-bucket"`). prefix (`str`, *isteğe bağlı*) : Sonuçları, yolu bu önekle başlayan dosyalara daraltır. recursive (`bool`, *isteğe bağlı*) : `True` ise dosyaları özyinelemeli olarak listeler. `False` (varsayılan) ise yalnızca kök dizindeki dosyaları ve dizinleri listeler. token (`bool` veya `str`, *isteğe bağlı*) : Geçerli bir kullanıcı erişim belirteci (dize). Varsayılan olarak, kimlik doğrulama için önerilen yöntem olan yerel olarak kaydedilmiş belirteç kullanılır (bkz. https://huggingface.co/docs/huggingface_hub/quick-start#authentication). Kimlik doğrulamayı devre dışı bırakmak için `False` geçirin. **Dönüş:** `Iterable[Union[BucketFile, BucketFolder]]` Dosya ve dizin bilgilerini (yol vb.) içeren [BucketFile](/docs/huggingface_hub/v2.4.0/tr/package_reference/hf_api#huggingface_hub.BucketFile) ve `BucketFolder` nesnelerinden oluşan bir iterable. Bir kovadaki dosyaları listele. Örnek: ```python >>> from huggingface_hub import list_bucket_tree >>> for file_info in list_bucket_tree(bucket_id="username/my-bucket"): ... print(file_info.path) >>> # Filter by prefix >>> for file_info in list_bucket_tree(bucket_id="username/my-bucket", prefix="models/"): ... print(file_info.path) ``` #### list_buckets[[huggingface_hub.HfApi.list_buckets]] ```python list_buckets(namespace: str | None = None, search: str | None = None, token: bool | str | None = None) ``` [Kaynak](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L14108) **Parametreler:** namespace (`str`, *isteğe bağlı*) : Bu ad alanı (kullanıcı veya kuruluş) altındaki varlık depolarını (bucket) listeler. Varsayılan olarak kullanıcının varlık depolarını listeler. search (`str`, *isteğe bağlı*) : Kova adlarını filtrelemek için bir arama dizesi. token (`bool` veya `str`, *isteğe bağlı*) : Geçerli bir kullanıcı erişim belirteci (dize). Varsayılan olarak, kimlik doğrulama için önerilen yöntem olan yerel olarak kaydedilmiş belirteç kullanılır (bkz. https://huggingface.co/docs/huggingface_hub/quick-start#authentication). Kimlik doğrulamayı devre dışı bırakmak için `False` geçirin. **Dönüş:** `Iterable[BucketInfo]` [BucketInfo](/docs/huggingface_hub/v2.4.0/tr/package_reference/hf_api#huggingface_hub.BucketInfo) nesnelerinden oluşan bir iterable. Belirli bir ad alanı altında Hub'daki varlıkları listeler. Örnek: ```python >>> from huggingface_hub import list_buckets >>> for bucket in list_buckets(): # lists buckets in the user's namespace ... print(bucket) >>> for bucket in list_buckets(namespace="huggingface"): # lists buckets in the "huggingface" organization ... print(bucket) >>> for bucket in list_buckets(search="my-prefix"): # filter buckets by name ... print(bucket) ``` #### list_collections[[huggingface_hub.HfApi.list_collections]] ```python list_collections(owner: list[str] | str | None = None, item: list[str] | str | None = None, sort: CollectionSort_T | None = None, limit: int | None = None, token: bool | str | None = None) ``` [Kaynak](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L10096) **Parametreler:** owner (`list[str]` veya `str`, *isteğe bağlı*) : Sahibin kullanıcı adına göre filtrele. item (`list[str]` veya `str`, *isteğe bağlı*) : Belirli öğeler içeren koleksiyonları filtreler. Örnek: `"models/teknium/OpenHermes-2.5-Mistral-7B"`, `"datasets/squad"` veya `"papers/2311.12983"`. sort (`Literal["lastModified", "trending", "upvotes"]`, *isteğe bağlı*) : Koleksiyonları son değiştirilme zamanına, trende olanlara veya oy sayısına göre sıralar. limit (`int`, *isteğe bağlı*) : Dönülecek en fazla koleksiyon sayısı. token (`bool` veya `str`, *isteğe bağlı*) : Geçerli bir kullanıcı erişim belirteci (dize). Varsayılan olarak, kimlik doğrulama için önerilen yöntem olan yerel olarak kaydedilmiş belirteç kullanılır (bkz. https://huggingface.co/docs/huggingface_hub/quick-start#authentication). Kimlik doğrulamayı devre dışı bırakmak için `False` geçirin. **Dönüş:** `Iterable[Collection]` [Collection](/docs/huggingface_hub/v2.4.0/tr/package_reference/collections#huggingface_hub.Collection) nesnelerinden oluşan bir iterable. Bazı filtreler verildiğinde Huggingface Hub'daki koleksiyonları listeler. > [!WARNING] > Koleksiyonları listelerken, koleksiyon başına öğe listesi en fazla 4 öğeyle sınırlıdır. Bir koleksiyondaki tüm öğeleri almak için [get_collection()](/docs/huggingface_hub/v2.4.0/tr/package_reference/hf_api#huggingface_hub.HfApi.get_collection) kullanmanız gerekir. #### list_daily_papers[[huggingface_hub.HfApi.list_daily_papers]] ```python list_daily_papers(date: str | None = None, token: bool | str | None = None, week: str | None = None, month: str | None = None, submitter: str | None = None, sort: DailyPapersSort_T | None = None, p: int | None = None, limit: int | None = None) ``` [Kaynak](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L11978) **Parametreler:** date (`str`, *isteğe bağlı*) : Günlük makalelerin getirileceği ISO biçiminde (YYYY-AA-GG) tarih. Varsayılan olarak en güncelleri getirilir. token (Union[bool, str, None], *isteğe bağlı*) : Geçerli bir kullanıcı erişim belirteci (dize). Varsayılan olarak yerel olarak kaydedilmiş belirteç kullanılır. Kimlik doğrulamayı devre dışı bırakmak için `False` geçirin. week (`str`, *isteğe bağlı*) : Günlük makalelerin alınacağı ISO formatındaki hafta (YYYY-Www). Örnek, `2025-W09`. month (`str`, *isteğe bağlı*) : Günlük makalelerin getirileceği ISO biçimindeki ay (YYYY-MM). Örnek, `2025-02`. submitter (`str`, *isteğe bağlı*) : Günlük makaleleri filtrelemek için göndericinin kullanıcı adı. sort (`Literal["publishedAt", "trending"]`, *isteğe bağlı*) : Günlük makaleler için sıralama düzeni. `publishedAt` veya `trending` olabilir. Varsayılan değer `"publishedAt"`'tir. p (`int`, *isteğe bağlı*) : Sayfalama için sayfa numarası. Varsayılan olarak 0'dır. limit (`int`, *isteğe bağlı*) : Alınacak makalelerin sınırı. Varsayılan değer 50'dir. **Dönüş:** `Iterable[PaperInfo]` `huggingface_hub.hf_api.PaperInfo` nesnelerinden oluşan bir iterable. Hugging Face Hub'da belirli bir tarihte yayımlanan günlük makaleleri listeler. Örnek: ```python >>> from huggingface_hub import HfApi >>> api = HfApi() >>> list(api.list_daily_papers(date="2025-10-29")) ``` #### list_dataset_parquet_files[[huggingface_hub.HfApi.list_dataset_parquet_files]] ```python list_dataset_parquet_files(repo_id: str, config: str | None = None, token: bool | str | None = None) ``` [Kaynak](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L2707) **Parametreler:** repo_id (`str`) : Veri seti deposu kimliği (ör. `"username/dataset-name"`). config (`str`, *isteğe bağlı*) : Belirli bir yapılandırma/alt küme adına göre filtreler. Verildiğinde, yalnızca o yapılandırmaya ait parquet dosyaları döndürülür. token (`bool` veya `str`, *isteğe bağlı*) : Geçerli bir kullanıcı erişim belirteci (dize). Varsayılan olarak, kimlik doğrulama için önerilen yöntem olan yerel olarak kaydedilmiş belirteç kullanılır (bkz. https://huggingface.co/docs/huggingface_hub/quick-start#authentication). Kimlik doğrulamayı devre dışı bırakmak için `False` geçirin. **Dönüş:** `list[DatasetParquetEntry]` Her parquet dosyası için yapılandırma, bölme, URL ve boyut içeren `DatasetParquetEntry` nesnelerinin listesi. Hub'daki bir veri seti için kullanılabilir parquet dosyalarını listeler. Hub'da barındırılan tüm veri setleri, [Dataset Viewer](https://huggingface.co/docs/dataset-viewer/parquet) tarafından otomatik olarak Parquet biçimine dönüştürülür. Bu yöntem, parquet dosyalarının URL'lerini, yapılandırmalarını, bölümlerini ve boyutlarını içeren listeyi döndürür. Örnek: ```python >>> from huggingface_hub import list_dataset_parquet_files >>> list_dataset_parquet_files("lhoestq/demo1") >>> entries[0] DatasetParquetEntry(config='default', split='train', url='https://huggingface.co/...', size=5038) ``` #### list_datasets[[huggingface_hub.HfApi.list_datasets]] ```python list_datasets(filter: str | Iterable[str] | None = None, author: str | None = None, benchmark: Literal[True] | Literal['official'] | str | None = None, dataset_name: str | None = None, gated: bool | None = None, language_creators: str | list[str] | None = None, language: str | list[str] | None = None, multilinguality: str | list[str] | None = None, size_categories: str | list[str] | None = None, task_categories: str | list[str] | None = None, task_ids: str | list[str] | None = None, search: str | None = None, sort: DatasetSort_T | None = None, limit: int | None = None, expand: list[ExpandDatasetProperty_T] | None = None, full: bool | None = None, token: bool | str | None = None) ``` [Kaynak](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L2502) **Parametreler:** filter (`str` veya `Iterable[str]`, *isteğe bağlı*) : Hub'daki veri setlerini filtrelemek için bir dize veya dize listesi. author (`str`, *isteğe bağlı*) : Dönen veri setlerinin yazarını tanımlayan bir dize. benchmark (`True`, `"official"`, `str`, *isteğe bağlı*) : Veri setlerini benchmark'a göre filtreler. Resmi benchmark veri setlerini döndürmek için `True` veya `"official"` olabilir. Gelecekteki uyumluluk için, benchmark adını temsil eden bir dize de olabilir (şu anda yalnızca "official" desteklenmektedir). dataset_name (`str`, *isteğe bağlı*) : Hub'da veri setlerini adlarıyla tanımlamak için kullanılabilen bir dize veya dize listesi, örneğin `SQAC` veya `wikineural` gated (`bool`, *isteğe bağlı*) : Hub'daki veri setlerini kapılı veya kapısız olarak filtrelemek için bir boole değeri. Varsayılan olarak tüm veri setleri döndürülür. `gated=True` geçirilirse yalnızca kapılı veri setleri döndürülür. `gated=False` geçirilirse yalnızca kapısız veri setleri döndürülür. language_creators (`str` veya `List`, *isteğe bağlı*) : Hub'daki veri setlerini, verilerin nasıl derlendiğini belirten `crowdsourced` veya `machine_generated` gibi etiketlerle tanımlamak için kullanılabilen bir dize veya dize listesi. language (`str` veya `List`, *isteğe bağlı*) : Hub'da veri setlerini iki karakterlik bir dile göre filtrelemek için kullanılan bir dize veya dize listesi. multilinguality (`str` veya `List`, *isteğe bağlı*) : Birden fazla dil içeren veri setleri için bir filtre temsil eden bir dize veya dize listesi. size_categories (`str` veya `List`, *isteğe bağlı*) : Hub'da veri setlerini, veri setinin boyutu gibi `100K>> from huggingface_hub import HfApi >>> api = HfApi() # List all datasets >>> api.list_datasets() # List only the text classification datasets >>> api.list_datasets(filter="task_categories:text-classification") # List only the datasets in russian for language modeling >>> api.list_datasets( ... filter=("language:ru", "task_ids:language-modeling") ... ) # List FiftyOne datasets (identified by the tag "fiftyone" in dataset card) >>> api.list_datasets(filter="fiftyone") ``` `search` argümanı ile kullanım örneği: ```python >>> from huggingface_hub import HfApi >>> api = HfApi() # List all datasets with "text" in their name >>> api.list_datasets(search="text") # List all datasets with "text" in their name made by google >>> api.list_datasets(search="text", author="google") ``` #### list_inference_catalog[[huggingface_hub.HfApi.list_inference_catalog]] ```python list_inference_catalog(accelerator: Literal['cpu', 'gpu', 'neuron'] | str | None = None, engine: Literal['llamacpp', 'sglang', 'tei', 'vllm'] | str | None = None, license: str | None = None, task: str | None = None, search: str | None = None, limit: int | None = None, token: bool | str | None = None) ``` [Kaynak](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L9587) **Parametreler:** accelerator (`str`, *isteğe bağlı*) : Yalnızca bu hızlandırıcı için (`"cpu"`, `"gpu"` veya `"neuron"`) bir tarifi olan modelleri döndürür. engine (`str`, *isteğe bağlı*) : Yalnızca bu çıkarım motoru için bir tarifi olan modelleri döndür (ör. `"vllm"`, `"llamacpp"`, `"tei"`, `"sglang"`). license (`str`, *isteğe bağlı*) : Yalnızca bu lisans altındaki modelleri döndür (ör. `"Apache 2.0"`). task (`str`, *isteğe bağlı*) : Yalnızca bu görev için modelleri döndür (ör. `"text-generation"`). search (`str`, *isteğe bağlı*) : Yalnızca bu arama sorgusuyla eşleşen modelleri döndürür. limit (`int`, *isteğe bağlı*) : Döndürülecek en fazla model sayısı. token (`bool` veya `str`, *isteğe bağlı*) : Geçerli bir kullanıcı erişim belirteci (dize). Varsayılan olarak, kimlik doğrulama için önerilen yöntem olan yerel olarak kaydedilmiş belirteç kullanılır (bkz. https://huggingface.co/docs/huggingface_hub/quick-start#authentication). **Dönüş:** `list[InferenceCatalogModel]` Katalogda mevcut modeller, her biri test edilmiş tarifleriyle birlikte. Hugging Face Inference Catalog'da kullanılabilir modelleri listeler. Inference Catalog'un amacı, çıkarım için optimize edilmiş ve varsayılan yapılandırmaları test edilmiş modellerin küratörlü bir listesini sağlamaktır. Katalogdaki mevcut modellerin listesini https://endpoints.huggingface.co/catalog adresinde görüntüleyebilirsiniz. Katalogdan bir model veya tarif dağıtmak için [create_inference_endpoint_from_catalog()](/docs/huggingface_hub/v2.4.0/tr/package_reference/hf_api#huggingface_hub.HfApi.create_inference_endpoint_from_catalog) kullanın. Örnek: ```python >>> from huggingface_hub import HfApi >>> api = HfApi() >>> catalog = api.list_inference_catalog(task="text-generation", accelerator="neuron") >>> [(model.repo_id, [recipe.id for recipe in model.recipes]) for model in catalog] [('meta-llama/Llama-3.1-8B-Instruct', ['sizzling-biryani-g4xsi1ac', 'artisanal-quinoa-yz9ynamx']), ...] ``` > [!WARNING] > `list_inference_catalog` deneyseldir. API'si gelecekte değişiklik gösterebilir. Öneri veya talepleriniz varsa lütfen geri bildirimde bulunun. #### list_inference_endpoints[[huggingface_hub.HfApi.list_inference_endpoints]] ```python list_inference_endpoints(namespace: str | None = None, token: bool | str | None = None) ``` [Kaynak](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L9147) **Parametreler:** namespace (`str`, *isteğe bağlı*) : Uç noktaların listeleneceği ad alanı. Varsayılan olarak mevcut kullanıcıdır. Kullanıcının ait olduğu tüm ad alanlarındaki (yani kişisel ad alanı ve kullanıcının üye olduğu tüm kuruluşlar) uç noktaları listelemek için `"*"` olarak ayarlayın. token (`bool` veya `str`, *isteğe bağlı*) : Geçerli bir kullanıcı erişim belirteci (dize). Varsayılan olarak, kimlik doğrulama için önerilen yöntem olan yerel olarak kaydedilmiş belirteç kullanılır (bkz. https://huggingface.co/docs/huggingface_hub/quick-start#authentication). Kimlik doğrulamayı devre dışı bırakmak için `False` geçirin. **Dönüş:** list[InferenceEndpoint](/docs/huggingface_hub/v2.4.0/tr/package_reference/inference_endpoints#huggingface_hub.InferenceEndpoint) Belirtilen ad alanı için tüm çıkarım uç noktalarının listesi. Belirtilen ad alanı için tüm çıkarım uç noktalarını listeler. Örnek: ```python >>> from huggingface_hub import HfApi >>> api = HfApi() >>> api.list_inference_endpoints() [InferenceEndpoint(name='my-endpoint', ...), ...] ``` #### list_inference_endpoints_hardware[[huggingface_hub.HfApi.list_inference_endpoints_hardware]] ```python list_inference_endpoints_hardware(namespace: str | None = None, token: bool | str | None = None) ``` [Kaynak](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L10038) **Parametreler:** namespace (`str`, *isteğe bağlı*) : Listelenecek kullanılabilir donanım ve hızlandırıcı kotasına sahip ad alanı. Varsayılan olarak mevcut kullanıcıdır. token (`bool` veya `str`, *isteğe bağlı*) : Geçerli bir kullanıcı erişim belirteci (dize). Varsayılan olarak, kimlik doğrulama için önerilen yöntem olan yerel olarak kaydedilmiş belirteç kullanılır (bkz. https://huggingface.co/docs/huggingface_hub/quick-start#authentication). **Dönüş:** `list[InferenceEndpointHardware]` Her satıcı ve bölgede mevcut olan donanımlar, şu anda kullanılamayan veya kullanımdan kaldırılan donanımlar dahil. Bir Inference Endpoint'ü dağıtmak için kullanılabilir donanımları listeler. Her kayıt, [create_inference_endpoint()](/docs/huggingface_hub/v2.4.0/tr/package_reference/hf_api#huggingface_hub.HfApi.create_inference_endpoint) tarafından beklenen tam `vendor`, `region`, `accelerator`, `instance_type` ve `instance_size` değerlerinin yanı sıra fiyatı ve ad alanının hızlandırıcı kota değerini taşır. Örnek: ```python >>> from huggingface_hub import HfApi >>> api = HfApi() >>> hardware = api.list_inference_endpoints_hardware() >>> [hw.id for hw in hardware if hw.accelerator == "gpu" and hw.status == "available"] ['aws-us-east-1-nvidia-l4-x1', 'aws-us-east-1-nvidia-l4-x4', ...] ``` #### list_jobs[[huggingface_hub.HfApi.list_jobs]] ```python list_jobs(status: list[JobStage | str] | JobStage | str | None = None, labels: dict[str, str] | None = None, timeout: int | None = None, namespace: str | None = None, token: bool | str | None = None) ``` [Kaynak](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L12487) **Parametreler:** status (`JobStage`, `str` veya `list`, *isteğe bağlı*) : Yalnızca verilen durum(lar)a sahip İşleri döndürür, örn. `"RUNNING"` veya `[JobStage.RUNNING, JobStage.SCHEDULING]`. Olası değerler için [JobStage](/docs/huggingface_hub/v2.4.0/tr/package_reference/jobs#huggingface_hub.JobStage) bölümüne bakın. labels (`dict[str, str]`, *isteğe bağlı*) : Sadece verilen `key=value` etiketlerinin tümüne sahip olan İşleri döndürür, örn. `{"env": "prod", "team": "ml"}`. timeout (`float`, *isteğe bağlı*) : Hub'a yapılan istek için bir zaman aşımı ayarlanıp ayarlanmayacağı. namespace (`str`, *isteğe bağlı*) : İşlerin listelendiği ad alanı. Varsayılan olarak mevcut kullanıcının ad alanıdır. token (`bool` veya `str`, *isteğe bağlı*) : Geçerli bir kullanıcı erişim belirteci. Sağlanmazsa, önerilen kimlik doğrulama yöntemi olan yerel olarak kaydedilmiş belirteç kullanılır. Kimlik doğrulamayı devre dışı bırakmak için `False` olarak ayarlayın. Aşağıdaki bağlantıya bakın: https://huggingface.co/docs/huggingface_hub/quick-start#authentication. **Dönüş:** `Iterable[JobInfo]` [JobInfo](/docs/huggingface_hub/v2.4.0/tr/package_reference/jobs#huggingface_hub.JobInfo) nesnelerinden oluşan bir iterable. Hugging Face altyapısında hesaplamalı işleri listele. #### list_jobs_hardware[[huggingface_hub.HfApi.list_jobs_hardware]] ```python list_jobs_hardware(token: bool | str | None = None) ``` [Kaynak](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L12535) **Dönüş:** `list[JobHardwareInfo]` Kullanılabilir donanım yapılandırmalarının listesi. Hugging Face altyapısındaki İşler için kullanılabilir donanım seçeneklerini listeler. Örnek: ```python >>> from huggingface_hub import HfApi >>> api = HfApi() >>> hardware_list = api.list_jobs_hardware() >>> hardware_list[0] JobHardwareInfo(name='cpu-basic', pretty_name='CPU Basic', cpu='2 vCPU', ram='16 GB', ephemeral_storage='20 GB', accelerator=None, unit_cost_micro_usd=167, unit_cost_usd=0.000167, unit_label='minute') >>> hardware_list[0].name 'cpu-basic' # Filter GPU options >>> gpu_hardware = [hw for hw in hardware_list if hw.accelerator is not None] >>> gpu_hardware[0].accelerator.model 'T4' ``` #### list_lfs_files[[huggingface_hub.HfApi.list_lfs_files]] ```python list_lfs_files(repo_id: str, repo_type: str | None = None, token: bool | str | None = None) ``` [Kaynak](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L4426) **Parametreler:** repo_id (`str`) : LFS dosyalarını listelediğiniz depo. repo_type (`str`, *isteğe bağlı*) : Depo türü. Bir veri setinden veya uzaydan listeleme yapılıyorsa `"dataset"` veya `"space"` olarak ayarlayın, bir modelden listeleme yapılıyorsa `None` veya `"model"` olarak ayarlayın. Varsayılan değer `None`'dir. token (`bool` veya `str`, *isteğe bağlı*) : Geçerli bir kullanıcı erişim belirteci (dize). Varsayılan olarak, kimlik doğrulama için önerilen yöntem olan yerel olarak kaydedilmiş belirteç kullanılır (bkz. https://huggingface.co/docs/huggingface_hub/quick-start#authentication). Kimlik doğrulamayı devre dışı bırakmak için `False` geçirin. **Dönüş:** `Iterable[LFSFileInfo]` `LFSFileInfo` nesnelerinin bir iteratörü. Hub'daki bir depodaki tüm LFS dosyalarını listeler. Bu, bir reponun ne kadar depolama alanı kullandığını saymak ve büyük dosyaları [permanently_delete_lfs_files()](/docs/huggingface_hub/v2.4.0/tr/package_reference/hf_api#huggingface_hub.HfApi.permanently_delete_lfs_files) ile temizlemek için başlıca olarak faydalıdır. Dikkat edin, bu kalıcı bir eylemdir; silinen dosyalara atıfta bulunan tüm commit'leri etkileyecek ve geri alınamayacaktır. Örnek: ```py >>> from huggingface_hub import HfApi >>> api = HfApi() >>> lfs_files = api.list_lfs_files("username/my-cool-repo") # Filter files to delete based on a combination of `filename`, `pushed_at`, `ref` or `size`. # e.g. select only LFS files in the "checkpoints" folder >>> lfs_files_to_delete = (lfs_file for lfs_file in lfs_files if lfs_file.filename.startswith("checkpoints/")) # Permanently delete LFS files >>> api.permanently_delete_lfs_files("username/my-cool-repo", lfs_files_to_delete) ``` #### list_liked_repos[[huggingface_hub.HfApi.list_liked_repos]] ```python list_liked_repos(user: str | None = None, token: bool | str | None = None) ``` [Kaynak](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L2988) **Parametreler:** user (`str`, *isteğe bağlı*) : Beğenilerini almak istediğiniz kullanıcının adı. token (`bool` veya `str`, *isteğe bağlı*) : Geçerli bir kullanıcı erişim belirteci (dize). Varsayılan olarak, kimlik doğrulama için önerilen yöntem olan yerel olarak kaydedilmiş belirteç kullanılır (bkz. https://huggingface.co/docs/huggingface_hub/quick-start#authentication). Kimlik doğrulamayı devre dışı bırakmak için `False` geçirin. **Dönüş:** [UserLikes](/docs/huggingface_hub/v2.4.0/tr/package_reference/hf_api#huggingface_hub.UserLikes) kullanıcı adını ve 3 depo kimliği listesini (1'i modeller için, 1'i veri kümeleri için ve 1'i Spaces için) içeren nesne. **Yükselen:** ``ValueError`` - [`ValueError`](https://docs.python.org/3/library/exceptions.html#ValueError) -- `user` geçirilmediyse ve hiçbir token bulunamazsa (argümandan veya makineden). huggingface.co'da bir kullanıcının beğendiği tüm herkese açık depoları listeler. Bu liste herkese açıktır, bu nedenle token isteğe bağlıdır. `user` geçirilmezse, oturum açmış kullanıcı varsayılan olarak kullanılır. Ayrıca [unlike()](/docs/huggingface_hub/v2.4.0/tr/package_reference/hf_api#huggingface_hub.HfApi.unlike) bkz. Örnek: ```python >>> from huggingface_hub import list_liked_repos >>> likes = list_liked_repos("julien-c") >>> likes.user "julien-c" >>> likes.models ["osanseviero/streamlit_1.15", "Xhaheen/ChatGPT_HF", ...] ``` #### list_models[[huggingface_hub.HfApi.list_models]] ```python list_models(filter: str | Iterable[str] | None = None, author: str | None = None, apps: str | list[str] | None = None, gated: bool | None = None, inference: Literal['warm'] | None = None, inference_provider: Literal['all'] | PROVIDER_T | list[PROVIDER_T] | None = None, trained_dataset: str | list[str] | None = None, search: str | None = None, pipeline_tag: str | None = None, num_parameters: str | None = None, emissions_thresholds: tuple[float, float] | None = None, sort: ModelSort_T | None = None, limit: int | None = None, expand: list[ExpandModelProperty_T] | None = None, full: bool | None = None, cardData: bool = False, fetch_config: bool = False, token: bool | str | None = None) ``` [Kaynak](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L2310) **Parametreler:** filter (`str` veya `Iterable[str]`, *isteğe bağlı*) : Hub'daki modelleri filtrelemek için bir dize veya dize listesi. Modeller; kütüphane, dil, görev, etiketler ve daha fazlasına göre filtrelenebilir. author (`str`, *isteğe bağlı*) : Dönen modellerin yazarını (kullanıcı veya kuruluşu) tanımlayan bir dize. apps (`str` veya `List`, *isteğe bağlı*) : Hub'daki, belirtilen uygulamaları destekleyen modelleri filtrelemek için bir dize veya dize listesi. Örnek değerler arasında `"ollama"` veya `["ollama", "vllm"]` bulunur. gated (`bool`, *isteğe bağlı*) : Hub'daki modelleri kapılı veya kapısız olarak filtrelemek için bir boole. Varsayılan olarak tüm modeller döndürülür. `gated=True` geçirilirse yalnızca kapılı modeller döndürülür. `gated=False` geçirilirse yalnızca kapısız modeller döndürülür. inference (`Literal["warm"]`, *isteğe bağlı*) : "warm" değeri verilirse, Hub'da şu anda en az bir sağlayıcı tarafından sunulan modelleri filtreler. inference_provider (`Literal["all"]` veya `str`, *isteğe bağlı*) : Hub'daki belirli bir sağlayıcı tarafından sunulan modelleri filtrelemek için bir dize. En az bir sağlayıcı tarafından sunulan tüm modelleri almak için `"all"` geçirin. trained_dataset (`str` veya `List`, *isteğe bağlı*) : Hub'daki bir modelin eğitim verisi için bir dize etiketi veya dize etiketleri listesi. search (`str`, *isteğe bağlı*) : Dönen model kimliklerinde yer alacak bir dize. pipeline_tag (`str`, *isteğe bağlı*) : Hub'daki modelleri filtrelemek için kullanılacak bir dize pipeline etiketi, örneğin `summarization`. num_parameters (`str`, *isteğe bağlı*) : Modelleri parametre sayısına göre filtreler. Hub arayüzü ve API'siyle aynı aralık sözdizimini kabul eder, örneğin `"min:6B,max:128B"`, `"min:6B"` veya `"max:128B"`. emissions_thresholds (`Tuple`, *isteğe bağlı*) : Sonuç olarak elde edilen modelleri gram cinsinden filtrelemek için kullanılan, minimum ve maksimum karbon ayak izini temsil eden iki tam sayıdan veya ondalık sayıdan oluşan bir demet. sort (`ModelSort_T`, *isteğe bağlı*) : Sonuç modellerinin sıralanacağı anahtar. Olası değerler "created_at", "downloads", "last_modified", "likes" ve "trending_score" şeklindedir. limit (`int`, *isteğe bağlı*) : Alınacak model sayısının sınırı. Bu seçeneği `None` olarak bırakmak tüm modelleri alır. expand (`list[ExpandModelProperty_T]`, *isteğe bağlı*) : Yanıtta döndürülecek liste özellikleri. Kullanıldığında, yalnızca listedeki özellikler döndürülür. `full`, `cardData` veya `fetch_config` geçirildiğinde bu parametre kullanılamaz. Olası değerler `"author"`, `"cardData"`, `"config"`, `"createdAt"`, `"disabled"`, `"downloads"`, `"downloadsAllTime"`, `"evalResults"`, `"gated"`, `"gguf"`, `"inference"`, `"inferenceProviderMapping"`, `"lastModified"`, `"library_name"`, `"likes"`, `"mask_token"`, `"model-index"`, `"pipeline_tag"`, `"private"`, `"safetensors"`, `"sha"`, `"siblings"`, `"spaces"`, `"tags"`, `"transformersInfo"`, `"trendingScore"`, `"widgetData"` ve `"resourceGroup"`'dir. full (`bool`, *isteğe bağlı*) : `last_modified`, `sha`, dosyalar ve `tags` dahil olmak üzere tüm model verilerinin getirilip getirilmeyeceğini belirtir. Bir filtre kullanıldığında bu değer varsayılan olarak `True` olarak ayarlanır. cardData (`bool`, *isteğe bağlı*) : Modelin meta verilerinin de alınması gerekip gerekmediğini belirtir. Karbon emisyonları, metrikler ve eğitimde kullanılan veri setleri gibi faydalı bilgiler içerebilir. fetch_config (`bool`, *isteğe bağlı*) : Model yapılandırmalarının da getirilip getirilmeyeceğini belirtir. Boyutu nedeniyle `full` içinde yer almaz. token (`bool` veya `str`, *isteğe bağlı*) : Geçerli bir kullanıcı erişim belirteci (dize). Varsayılan olarak, kimlik doğrulama için önerilen yöntem olan yerel olarak kaydedilmiş belirteç kullanılır (bkz. https://huggingface.co/docs/huggingface_hub/quick-start#authentication). Kimlik doğrulamayı devre dışı bırakmak için `False` geçirin. **Dönüş:** `Iterable[ModelInfo]` [huggingface_hub.hf_api.ModelInfo](/docs/huggingface_hub/v2.4.0/tr/package_reference/hf_api#huggingface_hub.ModelInfo) nesnelerinden oluşan bir yineleyici. Bazı filtreler verildiğinde, Huggingface Hub üzerinde barındırılan modelleri listeler. Örnek: ```python >>> from huggingface_hub import HfApi >>> api = HfApi() # List all models >>> api.list_models() # List text classification models >>> api.list_models(filter="text-classification") # List models from the KerasHub library >>> api.list_models(filter="keras-hub") # List models served by Cohere >>> api.list_models(inference_provider="cohere") # List models with "bert" in their name >>> api.list_models(search="bert") # List models with "bert" in their name and pushed by google >>> api.list_models(search="bert", author="google") # List models with 6B to 128B parameters >>> api.list_models(num_parameters="min:6B,max:128B", sort="likes") ``` #### list_organization_followers[[huggingface_hub.HfApi.list_organization_followers]] ```python list_organization_followers(organization: str, token: bool | str | None = None) ``` [Kaynak](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L11774) **Parametreler:** organization (`str`) : Takipçilerinin alınacağı kuruluşun adı. token (`bool` veya `str`, *isteğe bağlı*) : Geçerli bir kullanıcı erişim belirteci (dize). Varsayılan olarak, kimlik doğrulama için önerilen yöntem olan yerel olarak kaydedilmiş belirteç kullanılır (bkz. https://huggingface.co/docs/huggingface_hub/quick-start#authentication). Kimlik doğrulamayı devre dışı bırakmak için `False` geçirin. **Dönüş:** `Iterable[User]` Organizasyonun takipçilerini içeren [User](/docs/huggingface_hub/v2.4.0/tr/package_reference/hf_api#huggingface_hub.User) nesnelerinin listesi. **Yükselen:** `HfHubHTTPError` - `HfHubHTTPError` -- HTTP 404 Organizasyon Hub'da yoksa. Hub'da bir kuruluşun takipçilerini listele. #### list_organization_members[[huggingface_hub.HfApi.list_organization_members]] ```python list_organization_members(organization: str, token: bool | str | None = None) ``` [Kaynak](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L11803) **Parametreler:** organization (`str`) : Üyelerinin alınacağı organizasyonun adı. token (`bool` veya `str`, *isteğe bağlı*) : Geçerli bir kullanıcı erişim belirteci (dize). Varsayılan olarak, kimlik doğrulama için önerilen yöntem olan yerel olarak kaydedilmiş belirteç kullanılır (bkz. https://huggingface.co/docs/huggingface_hub/quick-start#authentication). Kimlik doğrulamayı devre dışı bırakmak için `False` geçirin. **Dönüş:** `Iterable[User]` Organizasyonun üyelerini içeren [User](/docs/huggingface_hub/v2.4.0/tr/package_reference/hf_api#huggingface_hub.User) nesnelerinin listesi. **Yükselen:** `HfHubHTTPError` - `HfHubHTTPError` -- HTTP 404 Organizasyon Hub'da yoksa. Hub'daki bir organizasyonun üyelerinin listesi. #### list_papers[[huggingface_hub.HfApi.list_papers]] ```python list_papers(query: str | None = None, limit: int | None = None, token: bool | str | None = None) ``` [Kaynak](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L11887) **Parametreler:** query (`str`, *isteğe bağlı*) : Makaleleri bulmak için bir arama sorgu dizesi. Sağlanırsa, sorguyla eşleşen makaleleri döndürür. limit (`int`, *isteğe bağlı*) : Dönülecek en fazla makale sayısı. token (Union[bool, str, None], *isteğe bağlı*) : Geçerli bir kullanıcı erişim belirteci (dize). Varsayılan olarak, kimlik doğrulama için önerilen yöntem olan yerel olarak kaydedilmiş belirteç kullanılır (bkz. https://huggingface.co/docs/huggingface_hub/quick-start#authentication). Kimlik doğrulamayı devre dışı bırakmak için `False` geçirin. **Dönüş:** `Iterable[PaperInfo]` `huggingface_hub.hf_api.PaperInfo` nesnelerinden oluşan bir iterable. Bir arama sorgusu verildiğinde Hugging Face Hub'daki günlük makaleleri listeler. Örnek: ```python >>> from huggingface_hub import HfApi >>> api = HfApi() # List all papers with "attention" in their title >>> api.list_papers(query="attention") ``` #### list_pending_access_requests[[huggingface_hub.HfApi.list_pending_access_requests]] ```python list_pending_access_requests(repo_id: str, repo_type: str | None = None, token: bool | str | None = None) ``` [Kaynak](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L10604) **Parametreler:** repo_id (`str`) : Erişim isteklerinin alınacağı repozitörün kimliği. repo_type (`str`, *isteğe bağlı*) : Erişim isteklerinin alınacağı repoyu türü. `model`, `dataset` veya `space` değerlerinden biri olmalıdır. Varsayılan değer `model`'dir. token (`bool` veya `str`, *isteğe bağlı*) : Geçerli bir kullanıcı erişim belirteci (dize). Varsayılan olarak, kimlik doğrulama için önerilen yöntem olan yerel olarak kaydedilmiş belirteç kullanılır (bkz. https://huggingface.co/docs/huggingface_hub/quick-start#authentication). Kimlik doğrulamayı devre dışı bırakmak için `False` geçirin. **Dönüş:** `Iterable[AccessRequest]` `AccessRequest` nesnelerinden oluşan bir iterable. Her öğe bir `username`, `request_id`, `email`, `status` ve `timestamp` özniteliği içerir. Gated repo özel bir form içeriyorsa, `fields` özniteliği kullanıcının yanıtlarıyla doldurulur. **Yükselen:** `HfHubHTTPError` - `HfHubHTTPError` -- Depo gated değilse HTTP 400. - `HfHubHTTPError` -- Depoya yalnızca salt okunur erişiminiz varsa HTTP 403. Deponun ait olduğu organizasyonda `write` veya `admin` rolünüz yoksa ya da bir `read` belirteci geçirdiyseniz bu durumla karşılaşabilirsiniz. Belirli bir gated repo için bekleyen erişim isteklerini alın. Bekleyen bir istek, kullanıcının repoya erişim istediğini ancak isteğin henüz işlenmediğini ifade eder. Onay modu otomatikse, bu liste boş olmalıdır. Bekleyen istekler [accept_access_request()](/docs/huggingface_hub/v2.4.0/tr/package_reference/hf_api#huggingface_hub.HfApi.accept_access_request) ve [reject_access_request()](/docs/huggingface_hub/v2.4.0/tr/package_reference/hf_api#huggingface_hub.HfApi.reject_access_request) kullanılarak kabul edilebilir veya reddedilebilir. Kapalı depolar hakkında daha fazla bilgi için https://huggingface.co/docs/hub/models-gated adresine bakın. Örnek: ```py >>> from huggingface_hub import list_pending_access_requests, accept_access_request # List pending requests >>> requests = list(list_pending_access_requests("meta-llama/Llama-2-7b")) >>> len(requests) 411 >>> requests[0] [ AccessRequest( username='clem', request_id='655f3a1c9e6b2d4f8a7c1e05', fullname='Clem 🤗', email='***', timestamp=datetime.datetime(2023, 11, 23, 18, 4, 53, 828000, tzinfo=datetime.timezone.utc), status='pending', fields=None, ), ... ] # Accept Clem's request >>> accept_access_request("meta-llama/Llama-2-7b", "clem") ``` #### list_rejected_access_requests[[huggingface_hub.HfApi.list_rejected_access_requests]] ```python list_rejected_access_requests(repo_id: str, repo_type: str | None = None, token: bool | str | None = None) ``` [Kaynak](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L10732) **Parametreler:** repo_id (`str`) : Erişim isteklerinin alınacağı repozitörün kimliği. repo_type (`str`, *isteğe bağlı*) : Erişim isteklerinin alınacağı repoyu türü. `model`, `dataset` veya `space` değerlerinden biri olmalıdır. Varsayılan değer `model`'dir. token (`bool` veya `str`, *isteğe bağlı*) : Geçerli bir kullanıcı erişim belirteci (dize). Varsayılan olarak, kimlik doğrulama için önerilen yöntem olan yerel olarak kaydedilmiş belirteç kullanılır (bkz. https://huggingface.co/docs/huggingface_hub/quick-start#authentication). Kimlik doğrulamayı devre dışı bırakmak için `False` geçirin. **Dönüş:** `Iterable[AccessRequest]` `AccessRequest` nesnelerinden oluşan bir iterable. Her öğe bir `username`, `request_id`, `email`, `status` ve `timestamp` özniteliği içerir. Gated repo özel bir form içeriyorsa, `fields` özniteliği kullanıcının yanıtlarıyla doldurulur. **Yükselen:** `HfHubHTTPError` - `HfHubHTTPError` -- Depo gated değilse HTTP 400. - `HfHubHTTPError` -- Depoya yalnızca salt okunur erişiminiz varsa HTTP 403. Deponun ait olduğu organizasyonda `write` veya `admin` rolünüz yoksa ya da bir `read` belirteci geçirdiyseniz bu durumla karşılaşabilirsiniz. Belirli bir gated repo için reddedilen erişim isteklerini alın. Reddedilen bir istek, kullanıcının depoya erişim istediğini ve bu isteğin bir depo sahibi (sizin veya organizasyonunuzdaki başka bir kullanıcı) tarafından açıkça reddedildiğini gösterir. Kullanıcı, depodaki hiçbir dosyayı indiremez. Reddedilen istekler, [accept_access_request()](/docs/huggingface_hub/v2.4.0/tr/package_reference/hf_api#huggingface_hub.HfApi.accept_access_request) ve [cancel_access_request()](/docs/huggingface_hub/v2.4.0/tr/package_reference/hf_api#huggingface_hub.HfApi.cancel_access_request) kullanılarak herhangi bir zamanda kabul edilebilir veya iptal edilebilir. İptal edilen bir istek bekleyenler listesine geri dönerken, kabul edilen bir istek kabul edilenler listesine geçer. Kapalı depolar hakkında daha fazla bilgi için https://huggingface.co/docs/hub/models-gated adresine bakın. Örnek: ```py >>> from huggingface_hub import list_rejected_access_requests >>> requests = list(list_rejected_access_requests("meta-llama/Llama-2-7b")) >>> len(requests) 411 >>> requests[0] [ AccessRequest( username='clem', request_id='655f3a1c9e6b2d4f8a7c1e05', fullname='Clem 🤗', email='***', timestamp=datetime.datetime(2023, 11, 23, 18, 4, 53, 828000, tzinfo=datetime.timezone.utc), status='rejected', fields=None, ), ... ] ``` #### list_repo_commits[[huggingface_hub.HfApi.list_repo_commits]] ```python list_repo_commits(repo_id: str, repo_type: str | None = None, token: bool | str | None = None, revision: str | None = None, formatted: bool = False) ``` [Kaynak](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L4183) **Parametreler:** repo_id (`str`) : `/` ile ayrılmış bir ad alanı (kullanıcı veya kuruluş) ve bir depo adı. repo_type (`str`, *isteğe bağlı*) : Bir veri setinden veya Space'ten commit'leri listeliyorsanız `"dataset"` veya `"space"` olarak, bir modelden listeliyorsanız `None` veya `"model"` olarak ayarlayın. Varsayılan değer `None`'dir. token (`bool` veya `str`, *isteğe bağlı*) : Geçerli bir kullanıcı erişim belirteci (dize). Varsayılan olarak, kimlik doğrulama için önerilen yöntem olan yerel olarak kaydedilmiş belirteç kullanılır (bkz. https://huggingface.co/docs/huggingface_hub/quick-start#authentication). Kimlik doğrulamayı devre dışı bırakmak için `False` geçirin. revision (`str`, *isteğe bağlı*) : Commit'in alınacağı git revizyonu. Varsayılan olarak `"main"` dalının başıdır. formatted (`bool`) : Commit'lerin HTML biçimlendirilmiş başlık ve açıklamalarının döndürülüp döndürülmeyeceğini belirtir. Varsayılan olarak False. **Dönüş:** list[[GitCommitInfo](/docs/huggingface_hub/v2.4.0/tr/package_reference/hf_api#huggingface_hub.GitCommitInfo)] Hub'daki bir repoya ait commit'ler hakkında bilgi içeren nesnelerin listesi. **Yükselen:** [RepositoryNotFoundError](/docs/huggingface_hub/v2.4.0/tr/package_reference/utilities#huggingface_hub.errors.RepositoryNotFoundError) veya [RevisionNotFoundError](/docs/huggingface_hub/v2.4.0/tr/package_reference/utilities#huggingface_hub.errors.RevisionNotFoundError) - [RepositoryNotFoundError](/docs/huggingface_hub/v2.4.0/tr/package_reference/utilities#huggingface_hub.errors.RepositoryNotFoundError) -- Depo bulunamadıysa (hata 404): repo_id/repo_type yanlış, özel ama kimlik doğrulaması yapılmamış veya depo mevcut değil. - [RevisionNotFoundError](/docs/huggingface_hub/v2.4.0/tr/package_reference/utilities#huggingface_hub.errors.RevisionNotFoundError) -- Depoda revizyon bulunamadıysa (404 hatası). Hub'daki bir depoyun belirli bir revizyonuna ait commit listesini alın. Commitler tarihe göre sıralanır (son commit en üstte). Örnek: ```py >>> from huggingface_hub import HfApi >>> api = HfApi() # Commits are sorted by date (last commit first) >>> initial_commit = api.list_repo_commits("gpt2")[-1] # Initial commit is always a system commit containing the `.gitattributes` file. >>> initial_commit GitCommitInfo( commit_id='9b865efde13a30c13e0a33e536cf3e4a5a9d71d8', authors=['system'], created_at=datetime.datetime(2019, 2, 18, 10, 36, 15, tzinfo=datetime.timezone.utc), title='initial commit', message='', formatted_title=None, formatted_message=None ) # Create an empty branch by deriving from initial commit >>> api.create_branch("gpt2", branch="new_empty_branch", revision=initial_commit.commit_id) ``` #### list_repo_files[[huggingface_hub.HfApi.list_repo_files]] ```python list_repo_files(repo_id: str, revision: str | None = None, repo_type: str | None = None, token: str | bool | None = None) ``` [Kaynak](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L3829) **Parametreler:** repo_id (`str`) : `/` ile ayrılmış bir ad alanı (kullanıcı veya kuruluş) ve bir depo adı. revision (`str`, *isteğe bağlı*) : Bilgilerin alınacağı depoyun revizyonu. repo_type (`str`, *isteğe bağlı*) : Bir veri setine veya uzaya yükleniyorsa `"dataset"` veya `"space"` olarak, bir modele yükleniyorsa `None` veya `"model"` olarak ayarlayın. Varsayılan değer `None`'dir. token (`bool` veya `str`, *isteğe bağlı*) : Geçerli bir kullanıcı erişim belirteci (dize). Varsayılan olarak, kimlik doğrulama için önerilen yöntem olan yerel olarak kaydedilmiş belirteç kullanılır (bkz. https://huggingface.co/docs/huggingface_hub/quick-start#authentication). Kimlik doğrulamayı devre dışı bırakmak için `False` geçirin. **Dönüş:** `list[str]` belirtilen bir depodaki dosya listesi. Belirtilen depodaki dosya listesini alın. #### list_repo_likers[[huggingface_hub.HfApi.list_repo_likers]] ```python list_repo_likers(repo_id: str, repo_type: str | None = None, token: bool | str | None = None) ``` [Kaynak](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L3105) **Parametreler:** repo_id (`str`) : Alınacak depo. Örnek: `"user/my-cool-model"`. token (`bool` veya `str`, *isteğe bağlı*) : Geçerli bir kullanıcı erişim belirteci (dize). Varsayılan olarak, kimlik doğrulama için önerilen yöntem olan yerel olarak kaydedilmiş belirteç kullanılır (bkz. https://huggingface.co/docs/huggingface_hub/quick-start#authentication). Kimlik doğrulamayı devre dışı bırakmak için `False` geçirin. repo_type (`str`, *isteğe bağlı*) : Bir veri setine veya uzaya yükleniyorsa `"dataset"` veya `"space"` olarak, bir modele yükleniyorsa `None` veya `"model"` olarak ayarlayın. Varsayılan değer `None`'dir. **Dönüş:** `Iterable[User]` [huggingface_hub.hf_api.User](/docs/huggingface_hub/v2.4.0/tr/package_reference/hf_api#huggingface_hub.User) nesnelerinden oluşan bir iterable. Hugging Face Hub'da belirli bir repoyu beğenen tüm kullanıcıları listeler. Ayrıca [list_liked_repos()](/docs/huggingface_hub/v2.4.0/tr/package_reference/hf_api#huggingface_hub.HfApi.list_liked_repos) bkz. #### list_repo_refs[[huggingface_hub.HfApi.list_repo_refs]] ```python list_repo_refs(repo_id: str, repo_type: str | None = None, include_pull_requests: bool = False, token: str | bool | None = None) ``` [Kaynak](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L4111) **Parametreler:** repo_id (`str`) : `/` ile ayrılmış bir ad alanı (kullanıcı veya kuruluş) ve bir depo adı. repo_type (`str`, *isteğe bağlı*) : Bir veri seti, Space veya Kernel'den referansları listeliyorsanız `"dataset"`, `"space"` veya `"kernel"` olarak; bir modelden listeliyorsanız `None` veya `"model"` olarak ayarlayın. Varsayılan değer `None`'dir. include_pull_requests (`bool`, *isteğe bağlı*) : Listede pull request referanslarının dahil edilip edilmeyeceğini belirtir. Varsayılan değeri `False`'dir. token (`bool` veya `str`, *isteğe bağlı*) : Geçerli bir kullanıcı erişim belirteci (dize). Varsayılan olarak, kimlik doğrulama için önerilen yöntem olan yerel olarak kaydedilmiş belirteç kullanılır (bkz. https://huggingface.co/docs/huggingface_hub/quick-start#authentication). Kimlik doğrulamayı devre dışı bırakmak için `False` geçirin. **Dönüş:** [GitRefs](/docs/huggingface_hub/v2.4.0/tr/package_reference/hf_api#huggingface_hub.GitRefs) Hub'daki bir repoya ait dallar ve etiketler hakkında tüm bilgileri içeren nesne. Belirtilen bir repoda bulunan referansların (hem etiketler hem de dallar) listesini alın. Örnek: ```py >>> from huggingface_hub import HfApi >>> api = HfApi() >>> api.list_repo_refs("gpt2") GitRefs(branches=[GitRefInfo(name='main', ref='refs/heads/main', target_commit='e7da7f221d5bf496a48136c0cd264e630fe9fcc8')], converts=[], tags=[]) >>> api.list_repo_refs("bigcode/the-stack", repo_type='dataset') GitRefs( branches=[ GitRefInfo(name='main', ref='refs/heads/main', target_commit='18edc1591d9ce72aa82f56c4431b3c969b210ae3'), GitRefInfo(name='v1.1.a1', ref='refs/heads/v1.1.a1', target_commit='f9826b862d1567f3822d3d25649b0d6d22ace714') ], converts=[], tags=[ GitRefInfo(name='v1.0', ref='refs/tags/v1.0', target_commit='c37a8cd1e382064d8aced5e05543c5f7753834da') ] ) ``` #### list_repo_tree[[huggingface_hub.HfApi.list_repo_tree]] ```python list_repo_tree(repo_id: str, path_in_repo: str | None = None, recursive: bool = False, expand: bool = False, revision: str | None = None, repo_type: str | None = None, token: str | bool | None = None) ``` [Kaynak](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L3866) **Parametreler:** repo_id (`str`) : `/` ile ayrılmış bir ad alanı (kullanıcı veya kuruluş) ve bir depo adı. path_in_repo (`str`, *isteğe bağlı*) : Depodaki ağacın (klasörün) göreli yolu, örneğin: `"checkpoints/1fec34a/results"`. Varsayılan olarak deponun kök ağacına (klasörüne) ayarlanır. recursive (`bool`, *isteğe bağlı*, varsayılan `False`) : Ağacın dosyalarının ve klasörlerinin özyinelemeli olarak listelenip listelenmeyeceğini belirtir. expand (`bool`, *isteğe bağlı*, varsayılan `False`) : Ağaçtaki dosyalar ve klasörler hakkında daha fazla bilgi alınıp alınmayacağını belirtir (ör. son commit ve dosyaların güvenlik tarama sonuçları). Bu işlem sunucu için daha maliyetli olduğundan sayfa başına yalnızca 50 sonuç döndürülür (1000 yerine). Sayfalama `huggingface_hub` içinde uygulandığından, sonuçları alma süresi dışında bu durum sizin için şeffaftır. revision (`str`, *isteğe bağlı*) : Ağacın alınacağı depoyun revizyonu. Varsayılan olarak `"main"` dalıdır. repo_type (`str`, *isteğe bağlı*) : Ağacın alınacağı depoyun türü (`"model"`, `"dataset"`, `"space"` veya `"kernel"`). Varsayılan değer `"model"`'dir. token (`bool` veya `str`, *isteğe bağlı*) : Geçerli bir kullanıcı erişim belirteci (dize). Varsayılan olarak, kimlik doğrulama için önerilen yöntem olan yerel olarak kaydedilmiş belirteç kullanılır (bkz. https://huggingface.co/docs/huggingface_hub/quick-start#authentication). Kimlik doğrulamayı devre dışı bırakmak için `False` geçirin. **Dönüş:** `Iterable[Union[RepoFile, RepoFolder]]` Ağaçtaki dosyalar ve klasörler hakkında bilgi, [RepoFile](/docs/huggingface_hub/v2.4.0/tr/package_reference/hf_api#huggingface_hub.RepoFile) ve `RepoFolder` nesnelerinden oluşan bir iterable olarak. Dosyaların ve klasörlerin sırası garanti edilmez. **Yükseltir:** [RepositoryNotFoundError](/docs/huggingface_hub/v2.4.0/tr/package_reference/utilities#huggingface_hub.errors.RepositoryNotFoundError) veya [RevisionNotFoundError](/docs/huggingface_hub/v2.4.0/tr/package_reference/utilities#huggingface_hub.errors.RevisionNotFoundError) veya `~utils.RemoteEntryNotFoundError` - [RepositoryNotFoundError](/docs/huggingface_hub/v2.4.0/tr/package_reference/utilities#huggingface_hub.errors.RepositoryNotFoundError) -- Depo bulunamadıysa (hata 404): repo_id/repo_type yanlış, özel ama kimlik doğrulaması yapılmamış veya depo mevcut değil. - [RevisionNotFoundError](/docs/huggingface_hub/v2.4.0/tr/package_reference/utilities#huggingface_hub.errors.RevisionNotFoundError) -- Depoda revizyon bulunamadıysa (404 hatası). - `~utils.RemoteEntryNotFoundError` -- Depoda ağacın (klasörün) var olmaması durumunda (404 hatası). Bir depo ağacının dosyalarını ve klasörlerini listele ve bunlar hakkında bilgi al. Örnekler: Bir repozituarın ağacı hakkında bilgi alın. ```py >>> from huggingface_hub import list_repo_tree >>> repo_tree = list_repo_tree("lysandre/arxiv-nlp") >>> repo_tree >>> list(repo_tree) [ RepoFile(path='.gitattributes', size=391, blob_id='ae8c63daedbd4206d7d40126955d4e6ab1c80f8f', lfs=None, last_commit=None, security=None), RepoFile(path='README.md', size=391, blob_id='43bd404b159de6fba7c2f4d3264347668d43af25', lfs=None, last_commit=None, security=None), RepoFile(path='config.json', size=554, blob_id='2f9618c3a19b9a61add74f70bfb121335aeef666', lfs=None, last_commit=None, security=None), RepoFile( path='flax_model.msgpack', size=497764107, blob_id='8095a62ccb4d806da7666fcda07467e2d150218e', lfs={'size': 497764107, 'sha256': 'd88b0d6a6ff9c3f8151f9d3228f57092aaea997f09af009eefd7373a77b5abb9', 'pointer_size': 134}, last_commit=None, security=None ), RepoFile(path='merges.txt', size=456318, blob_id='226b0752cac7789c48f0cb3ec53eda48b7be36cc', lfs=None, last_commit=None, security=None), RepoFile( path='pytorch_model.bin', size=548123560, blob_id='64eaa9c526867e404b68f2c5d66fd78e27026523', lfs={'size': 548123560, 'sha256': '9be78edb5b928eba33aa88f431551348f7466ba9f5ef3daf1d552398722a5436', 'pointer_size': 134}, last_commit=None, security=None ), RepoFile(path='vocab.json', size=898669, blob_id='b00361fece0387ca34b4b8b8539ed830d644dbeb', lfs=None, last_commit=None, security=None)] ] ``` Bir depoyun ağacı hakkında daha fazla bilgi alın (son commit ve dosyaların güvenlik taraması sonuçları) ```py >>> from huggingface_hub import list_repo_tree >>> repo_tree = list_repo_tree("prompthero/openjourney-v4", expand=True) >>> list(repo_tree) [ RepoFolder( path='feature_extractor', tree_id='aa536c4ea18073388b5b0bc791057a7296a00398', last_commit={ 'oid': '47b62b20b20e06b9de610e840282b7e6c3d51190', 'title': 'Upload diffusers weights (#48)', 'date': datetime.datetime(2023, 3, 21, 9, 5, 27, tzinfo=datetime.timezone.utc) } ), RepoFolder( path='safety_checker', tree_id='65aef9d787e5557373fdf714d6c34d4fcdd70440', last_commit={ 'oid': '47b62b20b20e06b9de610e840282b7e6c3d51190', 'title': 'Upload diffusers weights (#48)', 'date': datetime.datetime(2023, 3, 21, 9, 5, 27, tzinfo=datetime.timezone.utc) } ), RepoFile( path='model_index.json', size=582, blob_id='d3d7c1e8c3e78eeb1640b8e2041ee256e24c9ee1', lfs=None, last_commit={ 'oid': 'b195ed2d503f3eb29637050a886d77bd81d35f0e', 'title': 'Fix deprecation warning by changing `CLIPFeatureExtractor` to `CLIPImageProcessor`. (#54)', 'date': datetime.datetime(2023, 5, 15, 21, 41, 59, tzinfo=datetime.timezone.utc) }, security={ 'safe': True, 'av_scan': {'virusFound': False, 'virusNames': None}, 'pickle_import_scan': None } ) ... ] ``` #### list_scheduled_jobs[[huggingface_hub.HfApi.list_scheduled_jobs]] ```python list_scheduled_jobs(labels: dict[str, str] | None = None, timeout: int | None = None, namespace: str | None = None, token: bool | str | None = None) ``` [Kaynak](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L13231) **Parametreler:** labels (`dict[str, str]`, *isteğe bağlı*) : Sadece verilen `key=value` etiketlerinin tümüne sahip olan planlanmış Job'ları döndürür, örneğin `{"env": "prod", "team": "ml"}`. timeout (`float`, *isteğe bağlı*) : Hub'a yapılan istek için bir zaman aşımı ayarlanıp ayarlanmayacağı. namespace (`str`, *isteğe bağlı*) : İşlerin listelendiği ad alanı. Varsayılan olarak mevcut kullanıcının ad alanıdır. token (`bool` veya `str`, *isteğe bağlı*) : Geçerli bir kullanıcı erişim belirteci. Sağlanmazsa, önerilen kimlik doğrulama yöntemi olan yerel olarak kaydedilmiş belirteç kullanılır. Kimlik doğrulamayı devre dışı bırakmak için `False` olarak ayarlayın. Aşağıdaki bağlantıya bakın: https://huggingface.co/docs/huggingface_hub/quick-start#authentication. **Dönüş:** `list[ScheduledJobInfo]` `ScheduledJobInfo` nesnelerinin listesi. Hugging Face altyapısında zamanlanmış hesaplamalı İşleri listeler. #### list_space_templates[[huggingface_hub.HfApi.list_space_templates]] ```python list_space_templates(token: str | bool | None = None) ``` [Kaynak](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L4548) **Parametreler:** token (`bool` veya `str`, *isteğe bağlı*) : Geçerli bir kullanıcı erişim belirteci (dize). Varsayılan olarak, kimlik doğrulama için önerilen yöntem olan yerel olarak kaydedilmiş belirteç kullanılır (bkz. https://huggingface.co/docs/huggingface_hub/quick-start#authentication). Kimlik doğrulamayı devre dışı bırakmak için `False` geçirin. **Dönüş:** `list[SpaceTemplate]` Kullanılabilir Space şablonlarının listesi. Hub'da kullanılabilir resmi Space şablonlarını listeler. Dönen bir şablonun `repo_id`'si (veya kısa `name`'i), bu şablondan yeni bir Space oluşturmak için [HfApi.create_repo()](/docs/huggingface_hub/v2.4.0/tr/package_reference/hf_api#huggingface_hub.HfApi.create_repo) fonksiyonuna `space_template` olarak geçirilebilir. Örnek: ```py >>> from huggingface_hub import list_space_templates >>> templates = list_space_templates() >>> templates[0] SpaceTemplate(name='Streamlit', repo_id='streamlit/streamlit-template-space', sdk='docker', preferred_private=False) ``` #### list_spaces[[huggingface_hub.HfApi.list_spaces]] ```python list_spaces(filter: str | Iterable[str] | None = None, author: str | None = None, search: str | None = None, datasets: str | Iterable[str] | None = None, models: str | Iterable[str] | None = None, linked: bool = False, sort: SpaceSort_T | None = None, limit: int | None = None, expand: list[ExpandSpaceProperty_T] | None = None, full: bool | None = None, token: bool | str | None = None) ``` [Kaynak](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L2774) **Parametreler:** filter (`str` veya `Iterable`, *isteğe bağlı*) : Hub'daki Spaces'leri tanımlamak için kullanılabilen bir dize etiketi veya etiket listesi. author (`str`, *isteğe bağlı*) : Dönen Spaces'lerin yazarını tanımlayan bir dize. search (`str`, *isteğe bağlı*) : Dönen Spaces içinde yer alacak bir dize. datasets (`str` veya `Iterable`, *isteğe bağlı*) : Bir veri seti kullanan Spaces'leri döndürüp döndürmeyeceğini belirtir. Belirli bir veri setinin adı bir dize olarak geçirilebilir. models (`str` veya `Iterable`, *isteğe bağlı*) : Bir model kullanan Spaces'leri döndürüp döndürmeyeceğini belirtir. Belirli bir modelin adı bir dize olarak geçirilebilir. linked (`bool`, *isteğe bağlı*) : Bir model veya veri seti kullanan Spaces'leri döndürüp döndürmeyeceğini belirtir. sort (`SpaceSort_T`, *isteğe bağlı*) : Sonuç uzaylarını sıralamak için kullanılan anahtar. Olası değerler "created_at", "last_modified", "likes" ve "trending_score" şeklindedir. limit (`int`, *isteğe bağlı*) : Alınacak Spaces sayısının sınırı. Bu seçeneği `None` olarak bırakmak tüm Spaces'leri alır. expand (`list[ExpandSpaceProperty_T]`, *isteğe bağlı*) : Yanıtta döndürülecek özellik listesi. Kullanıldığında, yalnızca listedeki özellikler döndürülür. `full` parametresi geçirildiğinde bu parametre kullanılamaz. Olası değerler `"author"`, `"cardData"`, `"datasets"`, `"disabled"`, `"lastModified"`, `"createdAt"`, `"likes"`, `"models"`, `"private"`, `"region"`, `"runtime"`, `"sdk"`, `"siblings"`, `"sha"`, `"subdomain"`, `"tags"`, `"trendingScore"`, `"usedStorage"` ve `"resourceGroup"`'dir. full (`bool`, *isteğe bağlı*) : `last_modified`, `siblings` ve `card_data` alanlarını da içeren tüm Spaces verilerinin getirilip getirilmeyeceğini belirtir. token (`bool` veya `str`, *isteğe bağlı*) : Geçerli bir kullanıcı erişim belirteci (dize). Varsayılan olarak, kimlik doğrulama için önerilen yöntem olan yerel olarak kaydedilmiş belirteç kullanılır (bkz. https://huggingface.co/docs/huggingface_hub/quick-start#authentication). Kimlik doğrulamayı devre dışı bırakmak için `False` geçirin. **Dönüş:** `Iterable[SpaceInfo]` [huggingface_hub.hf_api.SpaceInfo](/docs/huggingface_hub/v2.4.0/tr/package_reference/hf_api#huggingface_hub.SpaceInfo) nesnelerinden oluşan bir yineleyici. Bazı filtreler verildiğinde, Huggingface Hub üzerinde barındırılan boşlukları listeler. #### list_spaces_hardware[[huggingface_hub.HfApi.list_spaces_hardware]] ```python list_spaces_hardware(token: bool | str | None = None) ``` [Kaynak](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L8260) **Dönüş:** `list[JobHardwareInfo]` Kullanılabilir donanım yapılandırmalarının listesi. Spaces için kullanılabilir donanım seçeneklerini listeler. Örnek: ```python >>> from huggingface_hub import list_spaces_hardware >>> hardware_list = list_spaces_hardware() >>> hardware_list[0] JobHardwareInfo(name='cpu-basic', pretty_name='CPU Basic', cpu='2 vCPU', ram='16 GB', ...) >>> hardware_list[0].name 'cpu-basic' ``` #### list_user_followers[[huggingface_hub.HfApi.list_user_followers]] ```python list_user_followers(username: str, token: bool | str | None = None) ``` [Kaynak](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L11831) **Parametreler:** username (`str`) : Takipçilerinin alınacağı kullanıcının kullanıcı adı. token (`bool` veya `str`, *isteğe bağlı*) : Geçerli bir kullanıcı erişim belirteci (dize). Varsayılan olarak, kimlik doğrulama için önerilen yöntem olan yerel olarak kaydedilmiş belirteç kullanılır (bkz. https://huggingface.co/docs/huggingface_hub/quick-start#authentication). Kimlik doğrulamayı devre dışı bırakmak için `False` geçirin. **Dönüş:** `Iterable[User]` Kullanıcının takipçilerini içeren [User](/docs/huggingface_hub/v2.4.0/tr/package_reference/hf_api#huggingface_hub.User) nesnelerinin listesi. **Yükselen:** `HfHubHTTPError` - `HfHubHTTPError` -- Kullanıcı Hub'da yoksa HTTP 404. Hub'da bir kullanıcının takipçi listesini alın. #### list_user_following[[huggingface_hub.HfApi.list_user_following]] ```python list_user_following(username: str, token: bool | str | None = None) ``` [Kaynak](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L11859) **Parametreler:** username (`str`) : Kullanıcının takip ettiği kullanıcıları almak için kullanıcının kullanıcı adı. token (`bool` veya `str`, *isteğe bağlı*) : Geçerli bir kullanıcı erişim belirteci (dize). Varsayılan olarak, kimlik doğrulama için önerilen yöntem olan yerel olarak kaydedilmiş belirteç kullanılır (bkz. https://huggingface.co/docs/huggingface_hub/quick-start#authentication). Kimlik doğrulamayı devre dışı bırakmak için `False` geçirin. **Dönüş:** `Iterable[User]` Kullanıcının takip ettiği kullanıcıların [User](/docs/huggingface_hub/v2.4.0/tr/package_reference/hf_api#huggingface_hub.User) nesnelerinden oluşan bir liste. **Yükselen:** `HfHubHTTPError` - `HfHubHTTPError` -- Kullanıcı Hub'da yoksa HTTP 404. Hub'da bir kullanıcının takip ettiği kullanıcıların listesini alın. #### list_user_repos[[huggingface_hub.HfApi.list_user_repos]] ```python list_user_repos(namespace: str | None = None, token: bool | str | None = None) ``` [Kaynak](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L3065) **Parametreler:** namespace (`str`, *isteğe bağlı*) : Organizasyon adı. Verilmezse, kimliği doğrulanmış kullanıcının depolarını listeler. token (`bool` veya `str`, *isteğe bağlı*) : Geçerli bir kullanıcı erişim belirteci. Varsayılan olarak yerel olarak kaydedilmiş belirteç kullanılır. **Dönüş:** `Iterable[RepoStorageInfo]` `RepoStorageInfo` nesnelerinden oluşan bir iterable. Depolama bilgileriyle birlikte bir kullanıcı veya kuruluşun tüm depolarını (modeller, veri kümeleri, uzaylar, variller) listeler. Kimlik doğrulaması yapılmış kullanıcı için `/api/settings/repositories` uç noktasını veya bir kuruluş için `/api/organizations/{namespace}/settings/repositories` uç noktasını kullanır. Örnek: ```python >>> from huggingface_hub import list_user_repos >>> repos = list(list_user_repos()) >>> repos[0] RepoStorageInfo(id='username/my-model', type='model', ...) >>> # List repos from an organization >>> repos = list(list_user_repos(namespace="my-org")) ``` #### list_webhooks[[huggingface_hub.HfApi.list_webhooks]] ```python list_webhooks(token: bool | str | None = None) ``` [Kaynak](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L11125) **Parametreler:** token (`bool` veya `str`, *isteğe bağlı*) : Geçerli bir kullanıcı erişim belirteci (dize). Varsayılan olarak, kimlik doğrulama için önerilen yöntem olan yerel olarak kaydedilmiş belirteç kullanılır (bkz. https://huggingface.co/docs/huggingface_hub/quick-start#authentication). Kimlik doğrulamayı devre dışı bırakmak için `False` geçirin. **Dönüş:** `list[WebhookInfo]` Webhook bilgi nesneleri listesi. Yapılandırılmış tüm webhook'ları listeler. Örnek: ```python >>> from huggingface_hub import list_webhooks >>> webhooks = list_webhooks() >>> len(webhooks) 2 >>> webhooks[0] WebhookInfo( id="654bbbc16f2ec14d77f109cc", watched=[WebhookWatchedItem(type="user", name="julien-c"), WebhookWatchedItem(type="org", name="HuggingFaceH4")], url="https://webhook.site/a2176e82-5720-43ee-9e06-f91cb4c91548", secret="my-secret", domains=["repo", "discussion"], disabled=False, ) ``` #### merge_pull_request[[huggingface_hub.HfApi.merge_pull_request]] ```python merge_pull_request(repo_id: str, discussion_num: int, token: bool | str | None = None, comment: str | None = None, repo_type: str | None = None) ``` [Kaynak](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L7830) **Parametreler:** repo_id (`str`) : `/` ile ayrılmış bir ad alanı (kullanıcı veya kuruluş) ve bir depo adı. discussion_num (`int`) : Tartışma veya Pull Request'in numarası. Kesinlikle pozitif bir tam sayı olmalıdır. comment (`str`, *isteğe bağlı*) : Durum değişikliğiyle birlikte gönderilecek isteğe bağlı bir yorum. repo_type (`str`, *isteğe bağlı*) : Bir veri setine veya uzaya yükleniyorsa `"dataset"` veya `"space"` olarak, bir modele yükleniyorsa `None` veya `"model"` olarak ayarlayın. Varsayılan değer `None`'dir. token (`bool` veya `str`, *isteğe bağlı*) : Geçerli bir kullanıcı erişim belirteci (dize). Varsayılan olarak, kimlik doğrulama için önerilen yöntem olan yerel olarak kaydedilmiş belirteç kullanılır (bkz. https://huggingface.co/docs/huggingface_hub/quick-start#authentication). Kimlik doğrulamayı devre dışı bırakmak için `False` geçirin. **Dönüş:** [DiscussionStatusChange](/docs/huggingface_hub/v2.4.0/tr/package_reference/community#huggingface_hub.DiscussionStatusChange) durum değişikliği olayı Bir Birleştirme İsteğini (Pull Request) birleştirir. > [!TIP] > Aşağıdaki hataları oluşturur: > > - [`HTTPError`](https://requests.readthedocs.io/en/latest/api/#requests.HTTPError) HuggingFace API bir hata döndürürse - [`ValueError`](https://docs.python.org/3/library/exceptions.html#ValueError) bir parametre değeri geçersizse - [RepositoryNotFoundError](/docs/huggingface_hub/v2.4.0/tr/package_reference/utilities#huggingface_hub.errors.RepositoryNotFoundError) İndirme yapılacak deposu bulunamazsa. Bunun nedeni, deponun var olmaması veya `private` olarak ayarlanmış olması ve erişiminizin bulunmaması olabilir. #### model_info[[huggingface_hub.HfApi.model_info]] ```python model_info(repo_id: str, revision: str | None = None, timeout: float | None = None, securityStatus: bool | None = None, files_metadata: bool = False, expand: list[ExpandModelProperty_T] | None = None, token: bool | str | None = None) ``` [Kaynak](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L3144) **Parametreler:** repo_id (`str`) : `/` ile ayrılmış bir ad alanı (kullanıcı veya kuruluş) ve bir depo adı. revision (`str`, *isteğe bağlı*) : Bilgilerin alınacağı model deposunun revizyonu. timeout (`float`, *isteğe bağlı*) : Hub'a yapılan istek için bir zaman aşımı ayarlanıp ayarlanmayacağı. securityStatus (`bool`, *isteğe bağlı*) : Güvenlik durumunun model deposundan da alınıp alınmayacağını belirtir. Güvenlik durumu `security_repo_status` alanında döndürülür. files_metadata (`bool`, *isteğe bağlı*) : Depodaki dosyalar için (boyut, LFS meta verisi vb.) meta verilerin alınıp alınmayacağını belirtir. Varsayılan değeri `False`'dir. expand (`list[ExpandModelProperty_T]`, *isteğe bağlı*) : Yanıtta döndürülecek liste özellikleri. Kullanıldığında, yalnızca listedeki özellikler döndürülür. `securityStatus` veya `files_metadata` geçirildiğinde bu parametre kullanılamaz. Olası değerler `"author"`, `"baseModels"`, `"cardData"`, `"childrenModelCount"`, `"config"`, `"createdAt"`, `"disabled"`, `"downloads"`, `"downloadsAllTime"`, `"evalResults"`, `"gated"`, `"gguf"`, `"inference"`, `"inferenceProviderMapping"`, `"lastModified"`, `"library_name"`, `"likes"`, `"mask_token"`, `"model-index"`, `"pipeline_tag"`, `"private"`, `"safetensors"`, `"sha"`, `"siblings"`, `"spaces"`, `"tags"`, `"transformersInfo"`, `"trendingScore"`, `"widgetData"`, `"usedStorage"` ve `"resourceGroup"`'tür. token (`bool` veya `str`, *isteğe bağlı*) : Geçerli bir kullanıcı erişim belirteci (dize). Varsayılan olarak, kimlik doğrulama için önerilen yöntem olan yerel olarak kaydedilmiş belirteç kullanılır (bkz. https://huggingface.co/docs/huggingface_hub/quick-start#authentication). Kimlik doğrulamayı devre dışı bırakmak için `False` geçirin. **Dönüş:** [huggingface_hub.hf_api.ModelInfo](/docs/huggingface_hub/v2.4.0/tr/package_reference/hf_api#huggingface_hub.ModelInfo) Model deposu bilgileri. huggingface.co'daki belirli bir model hakkında bilgi alın Geçerli bir token iletirseniz veya oturum açmışsanız model özel olabilir. > [!TIP] > Aşağıdaki hataları oluşturur: > > - [RepositoryNotFoundError](/docs/huggingface_hub/v2.4.0/tr/package_reference/utilities#huggingface_hub.errors.RepositoryNotFoundError) İndirilecek depo bulunamazsa. Bunun nedeni, deponun var olmaması veya `private` olarak ayarlanmış olması ve erişiminizin bulunmaması olabilir. - [RevisionNotFoundError](/docs/huggingface_hub/v2.4.0/tr/package_reference/utilities#huggingface_hub.errors.RevisionNotFoundError) İndirilecek revizyon bulunamazsa. #### move_bucket[[huggingface_hub.HfApi.move_bucket]] ```python move_bucket(from_id: str, to_id: str, token: bool | str | None = None) ``` [Kaynak](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L14199) **Parametreler:** from_id (`str`) : Bir ad alanı (kullanıcı veya bir kuruluş) ve `/` ile ayrılmış bir varlık adı. Orijinal varlık tanımlayıcısı (ör. `"username/my-bucket"`). to_id (`str`) : Bir ad alanı (kullanıcı veya bir kuruluş) ve `/` ile ayrılmış bir varlık adı. Son varlık tanımlayıcısı (ör. `"username/new-bucket-name"` veya `"organization/my-bucket"`). token (`bool` veya `str`, *isteğe bağlı*) : Geçerli bir kullanıcı erişim belirteci (dize). Varsayılan olarak, kimlik doğrulama için önerilen yöntem olan yerel olarak kaydedilmiş belirteç kullanılır (bkz. https://huggingface.co/docs/huggingface_hub/quick-start#authentication). Kimlik doğrulamayı devre dışı bırakmak için `False` geçirin. **Yükselen:** `BucketNotFoundError` - `BucketNotFoundError` -- Kaynak bucket bulunamadığında. Bunun nedeni, bucket'ın var olmaması veya `private` olarak ayarlanmış olması ve erişiminizin bulunmaması olabilir. Bir kovayı "namespace1/repo_name1" konumundan "namespace2/repo_name2" konumuna taşıyın Belirli kısıtlamalar bulunduğunu unutmayın. Depoları taşıma hakkında daha fazla bilgi için https://hf.co/docs/hub/repositories-settings#renaming-or-transferring-a-repo adresine bakın. Örnek: ```python >>> from huggingface_hub import move_bucket >>> # Rename a bucket within the same namespace >>> move_bucket(from_id="username/old-name", to_id="username/new-name") >>> # Transfer a bucket to an organization >>> move_bucket(from_id="username/my-bucket", to_id="my-org/my-bucket") ``` #### move_repo[[huggingface_hub.HfApi.move_repo]] ```python move_repo(from_id: str, to_id: str, repo_type: str | None = None, token: str | bool | None = None) ``` [Kaynak](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L4918) **Parametreler:** from_id (`str`) : Bir ad alanı (kullanıcı veya kuruluş) ve `/` ile ayrılmış bir depo adı. Orijinal depo tanımlayıcısı. to_id (`str`) : Bir ad alanı (kullanıcı veya kuruluş) ve `/` ile ayrılmış bir depo adı. Son depo tanımlayıcısı. repo_type (`str`, *isteğe bağlı*) : Bir veri setine veya uzaya yükleniyorsa `"dataset"` veya `"space"` olarak, bir modele yükleniyorsa `None` veya `"model"` olarak ayarlayın. Varsayılan değer `None`'dir. token (`bool` veya `str`, *isteğe bağlı*) : Geçerli bir kullanıcı erişim belirteci (dize). Varsayılan olarak, kimlik doğrulama için önerilen yöntem olan yerel olarak kaydedilmiş belirteç kullanılır (bkz. https://huggingface.co/docs/huggingface_hub/quick-start#authentication). Kimlik doğrulamayı devre dışı bırakmak için `False` geçirin. namespace1/repo_name1 adlı bir depoyu namespace2/repo_name2 olarak taşıma Belirli kısıtlamalar bulunduğunu unutmayın. Depoları taşıma hakkında daha fazla bilgi için https://hf.co/docs/hub/repositories-settings#renaming-or-transferring-a-repo adresine bakın. > [!TIP] > Aşağıdaki hataları oluşturur: > > - [RepositoryNotFoundError](/docs/huggingface_hub/v2.4.0/tr/package_reference/utilities#huggingface_hub.errors.RepositoryNotFoundError) İndirme yapılacak deposu bulunamazsa. Bunun nedeni, deponun var olmaması veya `private` olarak ayarlanmış olması ve erişiminizin bulunmaması olabilir. #### paper_info[[huggingface_hub.HfApi.paper_info]] ```python paper_info(id: str) ``` [Kaynak](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L11938) **Parametreler:** id (`str`, **isteğe bağlı**) : Makalenin ArXiv kimliği. **Dönüş:** `PaperInfo` Bir `PaperInfo` nesnesi. **Yükselen:** `HfHubHTTPError` - `HfHubHTTPError` -- HTTP 404 Makale Hub'da yoksa. Hub'daki bir makale için bilgi alın. #### parse_safetensors_file_metadata[[huggingface_hub.HfApi.parse_safetensors_file_metadata]] ```python parse_safetensors_file_metadata(repo_id: str, filename: str, repo_type: str | None = None, revision: str | None = None, token: bool | str | None = None, timeout: float | None = 10) ``` [Kaynak](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L6882) **Parametreler:** repo_id (`str`) : `/` ile ayrılmış bir kullanıcı veya kuruluş adı ve bir depo adı. filename (`str`) : Depodaki dosyanın adı. repo_type (`str`, *isteğe bağlı*) : Dosya bir veri setinde veya uzaydaysa `"dataset"` veya `"space"` olarak ayarlanır, bir modeldeyse `None` veya `"model"`. Varsayılan `None`'dir. revision (`str`, *isteğe bağlı*) : Dosyanın alınacağı git revizyonu. Bir dal adı, etiket veya commit hash'i olabilir. Varsayılan olarak `"main"` dalının başıdır. token (`bool` veya `str`, *isteğe bağlı*) : Geçerli bir kullanıcı erişim belirteci (dize). Varsayılan olarak, kimlik doğrulama için önerilen yöntem olan yerel olarak kaydedilmiş belirteç kullanılır (bkz. https://huggingface.co/docs/huggingface_hub/quick-start#authentication). Kimlik doğrulamayı devre dışı bırakmak için `False` geçirin. timeout (`float`, *opsiyonel*, varsayılan 10) : Sunucunun veri göndermesini bekleme süresi (saniye). Zaman aşımını devre dışı bırakmak için `None` olarak ayarlayın (önerilmez, çünkü takılan bir bağlantı çağrıyı süresiz olarak asabilir). **Dönüş:** `SafetensorsFileMetadata` safetensors dosyasıyla ilgili bilgiler. **Yükseltir:** `NotASafetensorsRepoError` veya `SafetensorsParsingError` - `NotASafetensorsRepoError` -- Depo bir safetensors deposu değilse, yani `model.safetensors` veya `model.safetensors.index.json` dosyasından herhangi birine sahip değilse. - `SafetensorsParsingError` -- Bir safetensors dosyasının başlığı doğru şekilde ayrıştırılamadığında. Hub'daki bir safetensors dosyasından meta verileri ayrıştırın. Bir depodaki tüm safetensors dosyalarından meta verileri aynı anda ayrıştırmak için [get_safetensors_metadata()](/docs/huggingface_hub/v2.4.0/tr/package_reference/hf_api#huggingface_hub.HfApi.get_safetensors_metadata) kullanın. safetensors formatı hakkında daha fazla ayrıntı için https://huggingface.co/docs/safetensors/index#format adresine göz atın. #### pause_inference_endpoint[[huggingface_hub.HfApi.pause_inference_endpoint]] ```python pause_inference_endpoint(name: str, namespace: str | None = None, token: bool | str | None = None) ``` [Kaynak](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L9922) **Parametreler:** name (`str`) : Duraklatılacak Inference Endpoint'in adı. namespace (`str`, *isteğe bağlı*) : Inference Endpoint'in bulunduğu ad alanı. Varsayılan olarak mevcut kullanıcıdır. token (`bool` veya `str`, *isteğe bağlı*) : Geçerli bir kullanıcı erişim belirteci (dize). Varsayılan olarak, kimlik doğrulama için önerilen yöntem olan yerel olarak kaydedilmiş belirteç kullanılır (bkz. https://huggingface.co/docs/huggingface_hub/quick-start#authentication). Kimlik doğrulamayı devre dışı bırakmak için `False` geçirin. **Dönüş:** [InferenceEndpoint](/docs/huggingface_hub/v2.4.0/tr/package_reference/inference_endpoints#huggingface_hub.InferenceEndpoint) Duraklatılmış Inference Endpoint hakkında bilgi. Bir Çıkarım Uç noktasını Durdurun. Duraklatılmış bir Inference Endpoint için ücretlendirme yapılmaz. [resume_inference_endpoint()](/docs/huggingface_hub/v2.4.0/tr/package_reference/hf_api#huggingface_hub.HfApi.resume_inference_endpoint) kullanılarak istenilen her an yeniden başlatılabilir. Bu, [scale_to_zero_inference_endpoint()](/docs/huggingface_hub/v2.4.0/tr/package_reference/hf_api#huggingface_hub.HfApi.scale_to_zero_inference_endpoint) ile Inference Endpoint'in sıfıra ölçeklendirilmesinden farklıdır; bu durumda bir istek yapıldığında otomatik olarak yeniden başlatılır. Kolaylık olması için, bir Inference Endpoint'i [pause_inference_endpoint()](/docs/huggingface_hub/v2.4.0/tr/package_reference/hf_api#huggingface_hub.HfApi.pause_inference_endpoint) kullanarak da duraklatabilirsiniz. #### pause_space[[huggingface_hub.HfApi.pause_space]] ```python pause_space(repo_id: str, token: bool | str | None = None) ``` [Kaynak](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L8419) **Parametreler:** repo_id (`str`) : Duraklatılacak Space'in kimliği. Örnek: `"Salesforce/BLIP2"`. token (`bool` veya `str`, *isteğe bağlı*) : Geçerli bir kullanıcı erişim belirteci (dize). Varsayılan olarak, kimlik doğrulama için önerilen yöntem olan yerel olarak kaydedilmiş belirteç kullanılır (bkz. https://huggingface.co/docs/huggingface_hub/quick-start#authentication). Kimlik doğrulamayı devre dışı bırakmak için `False` geçirin. **Dönüş:** [SpaceRuntime](/docs/huggingface_hub/v2.4.0/tr/package_reference/space_runtime#huggingface_hub.SpaceRuntime) `stage=PAUSED` ve istenen donanım dahil olmak üzere Space'inizin çalışma zamanı bilgileri. **Yükselen:** [RepositoryNotFoundError](/docs/huggingface_hub/v2.4.0/tr/package_reference/utilities#huggingface_hub.errors.RepositoryNotFoundError) veya [HfHubHTTPError](/docs/huggingface_hub/v2.4.0/tr/package_reference/utilities#huggingface_hub.errors.HfHubHTTPError) veya [BadRequestError](/docs/huggingface_hub/v2.4.0/tr/package_reference/utilities#huggingface_hub.errors.BadRequestError) - [RepositoryNotFoundError](/docs/huggingface_hub/v2.4.0/tr/package_reference/utilities#huggingface_hub.errors.RepositoryNotFoundError) -- Space'iniz bulunamadığında (hata 404). Büyük olasılıkla repo_id yanlış veya Space'iniz özel olup kimlik doğrulamanız yapılmamış. - [HfHubHTTPError](/docs/huggingface_hub/v2.4.0/tr/package_reference/utilities#huggingface_hub.errors.HfHubHTTPError) -- 403 Forbidden: bir Space'i yalnızca sahibi duraklatabilir. Sahibi olmadığınız bir Space'i yönetmek istiyorsanız, bir Discussion açarak sahibinden rica edin veya Space'i kopyalayın. - [BadRequestError](/docs/huggingface_hub/v2.4.0/tr/package_reference/utilities#huggingface_hub.errors.BadRequestError) -- Space'ınız statik bir Space ise. Statik Spaces her zaman çalışır durumda olur ve asla faturalandırılmaz. Statik bir Space'i gizlemek istiyorsanız, onu özel olarak ayarlayabilirsiniz. Space'inizi duraklatın. Duraklatılmış bir Space, sahibi tarafından manuel olarak yeniden başlatılana kadar çalışmayı durdurur. Bu, ücretsiz Spaces'in 48 saatlik hareketsizlikten sonra girdiği uyku durumundan farklıdır. Seçtiğiniz donanım ne olursa olsun, duraklatma süresi hesabınıza faturalandırılmaz. Space'inizi yeniden başlatmak için [restart_space()](/docs/huggingface_hub/v2.4.0/tr/package_reference/hf_api#huggingface_hub.HfApi.restart_space) kullanın ve Space ayarlar sayfanıza gidin. Daha fazla ayrıntı için lütfen [belgelere](https://huggingface.co/docs/hub/spaces-gpus#pause) göz atın. #### permanently_delete_lfs_files[[huggingface_hub.HfApi.permanently_delete_lfs_files]] ```python permanently_delete_lfs_files(repo_id: str, lfs_files: Iterable[LFSFileInfo], rewrite_history: bool = True, repo_type: str | None = None, token: bool | str | None = None) ``` [Kaynak](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L4480) **Parametreler:** repo_id (`str`) : LFS dosyalarını listelediğiniz depo. lfs_files (`Iterable[LFSFileInfo]`) : Kalıcı olarak depodan silinecek `LFSFileInfo` öğelerinin bir iterable'ı. Depodaki tüm LFS dosyalarını listelemek için [list_lfs_files()](/docs/huggingface_hub/v2.4.0/tr/package_reference/hf_api#huggingface_hub.HfApi.list_lfs_files) kullanın. rewrite_history (`bool`, *isteğe bağlı*, varsayılan `True`) : Silinen LFS dosyalarına atıfta bulunan dosya işaretçilerini kaldırmak için depo geçmişinin yeniden yazılıp yazılmayacağını belirtir (önerilir). repo_type (`str`, *isteğe bağlı*) : Depo türü. Bir veri setinden veya uzaydan listeleme yapılıyorsa `"dataset"` veya `"space"` olarak ayarlayın, bir modelden listeleme yapılıyorsa `None` veya `"model"` olarak ayarlayın. Varsayılan değer `None`'dir. token (`bool` veya `str`, *isteğe bağlı*) : Geçerli bir kullanıcı erişim belirteci (dize). Varsayılan olarak, kimlik doğrulama için önerilen yöntem olan yerel olarak kaydedilmiş belirteç kullanılır (bkz. https://huggingface.co/docs/huggingface_hub/quick-start#authentication). Kimlik doğrulamayı devre dışı bırakmak için `False` geçirin. Hub'daki bir depodan LFS dosyalarını kalıcı olarak silin. > [!WARNING] > Bu, silinen dosyaları referans veren tüm commit'leri etkileyecek kalıcı bir eylemdir ve depoyu bozabilir. Bu işlem geri alınamaz. Ne yaptığınızı biliyorsanız kullanın. Örnek: ```py >>> from huggingface_hub import HfApi >>> api = HfApi() >>> lfs_files = api.list_lfs_files("username/my-cool-repo") # Filter files to delete based on a combination of `filename`, `pushed_at`, `ref` or `size`. # e.g. select only LFS files in the "checkpoints" folder >>> lfs_files_to_delete = (lfs_file for lfs_file in lfs_files if lfs_file.filename.startswith("checkpoints/")) # Permanently delete LFS files >>> api.permanently_delete_lfs_files("username/my-cool-repo", lfs_files_to_delete) ``` #### preupload_lfs_files[[huggingface_hub.HfApi.preupload_lfs_files]] ```python preupload_lfs_files(repo_id: str, additions: Iterable[CommitOperationAdd], token: str | bool | None = None, repo_type: str | None = None, revision: str | None = None, create_pr: bool | None = None, num_threads: int = 5, free_memory: bool = True, gitignore_content: str | None = None) ``` [Kaynak](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L5311) **Parametreler:** repo_id (`str`) : Dosyaları commit edeceğiniz depo, örneğin: `"username/custom_transformers"`. additions (`Iterable` of [CommitOperationAdd](/docs/huggingface_hub/v2.4.0/tr/package_reference/hf_api#huggingface_hub.CommitOperationAdd)) : Yüklemek için dosya listesi. Uyarı: Bu listedeki nesneler, yüklemeyle ilgili bilgileri içerecek şekilde değiştirilecektir. Aynı nesneleri birden fazla commit için yeniden kullanmayın. token (`bool` veya `str`, *isteğe bağlı*) : Geçerli bir kullanıcı erişim belirteci (dize). Varsayılan olarak, kimlik doğrulama için önerilen yöntem olan yerel olarak kaydedilmiş belirteç kullanılır (bkz. https://huggingface.co/docs/huggingface_hub/quick-start#authentication). Kimlik doğrulamayı devre dışı bırakmak için `False` geçirin. repo_type (`str`, *isteğe bağlı*) : Yüklemenin yapılacağı depoyun türü (ör. `"model"` -varsayılan-, `"dataset"`, `"space"` veya `"kernel"`). revision (`str`, *isteğe bağlı*) : Commit'in alınacağı git revizyonu. Varsayılan olarak `"main"` dalının başıdır. create_pr (`boolean`, *isteğe bağlı*) : O commit ile bir Pull Request oluşturmayı planlayıp planlamadığınızı belirtir. Varsayılan değeri `False`'dir. num_threads (`int`, *isteğe bağlı*) : Dosyaları yüklemek için eşzamanlı iş parçacığı sayısı. Varsayılan değer 5'tir. 2 olarak ayarlanması, en fazla 2 dosyanın eşzamanlı yükleneceği anlamına gelir. free_memory (`bool`, *isteğe bağlı*, varsayılan `True`) : `True` ise, bellek tasarrufu sağlamak için her `CommitOperationAdd` nesnesinin `path_or_fileobj` özniteliği, yükleme işleminden sonra boş bir `bytes` nesnesiyle değiştirilir. İşlem nesnelerini, sonraki bir [create_commit()](/docs/huggingface_hub/v2.4.0/tr/package_reference/hf_api#huggingface_hub.HfApi.create_commit) çağrısının dışında yeniden kullanmanız gerekiyorsa `False` olarak ayarlayın. gitignore_content (`str`, *isteğe bağlı*) : Hangi dosyaların yok sayılması gerektiğini bilmek için `.gitignore` dosyasının içeriği. Öncelik sırası, önce `gitignore_content`'in geçirilip geçirilmediğini kontrol etmek, ardından `.gitignore` dosyasının yüklenecek dosyalar listesinde olup olmadığını kontrol etmek ve son olarak Hub'da zaten barındırılan `.gitignore` dosyasına (varsa) varsayılan olarak başvurmak şeklindedir. Gelecekteki bir commit'e hazırlık olarak LFS dosyalarını S3'e önceden yükleyin. Bu yöntem, yüklemek üzere dosyaları anlık olarak oluşturuyorsanız ve hepsini tek seferde yüklemekten önce bellekte saklamak istemiyorsanız faydalıdır. > [!WARNING] > Bu, gelişmiş kullanıcılar için bir yöntemdir. Normal bir commit oluşturmak için bunu doğrudan çağırmak zorunda değilsiniz. Bunun yerine [create_commit()](/docs/huggingface_hub/v2.4.0/tr/package_reference/hf_api#huggingface_hub.HfApi.create_commit) fonksiyonunu doğrudan kullanın. > [!WARNING] > Commit işlemleri süreç sırasında değiştirilecektir. Özellikle, yüklemeye eklenmiş `path_or_fileobj`, belleği tasarruflu kullanmak için yükleme sonrasında kaldırılacaktır (ve boş bir `bytes` nesnesiyle değiştirilecektir). Aynı nesneleri, [create_commit()](/docs/huggingface_hub/v2.4.0/tr/package_reference/hf_api#huggingface_hub.HfApi.create_commit) fonksiyonuna geçirmek dışında yeniden kullanmayın. Commit işlemi nesnesinden eklenmiş içeriği kaldırmak istemiyorsanız, `free_memory=False` parametresini geçirin. Örnek: ```py >>> from huggingface_hub import CommitOperationAdd, preupload_lfs_files, create_commit, create_repo >>> repo_id = create_repo("test_preupload").repo_id # Generate and preupload LFS files one by one >>> operations = [] # List of all `CommitOperationAdd` objects that will be generated >>> for i in range(5): ... content = ... # generate binary content ... addition = CommitOperationAdd(path_in_repo=f"shard_{i}_of_5.bin", path_or_fileobj=content) ... preupload_lfs_files(repo_id, additions=[addition]) # upload + free memory ... operations.append(addition) # Create commit >>> create_commit(repo_id, operations=operations, commit_message="Commit all shards") ``` #### read_paper[[huggingface_hub.HfApi.read_paper]] ```python read_paper(id: str) ``` [Kaynak](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L11958) **Parametreler:** id (`str`) : Makalenin ArXiv kimliği. **Dönüş:** `str` Makale sayfası içeriği markdown olarak. **Yükselen:** `HfHubHTTPError` - `HfHubHTTPError` -- HTTP 404 Makale Hub'da yoksa. Hub'daki bir makale sayfasının markdown içeriğini alın. #### reject_access_request[[huggingface_hub.HfApi.reject_access_request]] ```python reject_access_request(repo_id: str, user: str | None = None, request_id: str | None = None, repo_type: str | None = None, rejection_reason: str | None, token: bool | str | None = None) ``` [Kaynak](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L10925) **Parametreler:** repo_id (`str`) : Erişim isteğinin reddedileceği repozituarın kimliği. user (`str`, *isteğe bağlı*) : Erişim isteğinin reddedilmesi gereken kullanıcının kullanıcı adı. `user` veya `request_id` parametrelerinden tam olarak biri sağlanmalıdır. request_id (`str`, *isteğe bağlı*) : Reddedilecek erişim isteğinin kimliği (bkz. `AccessRequest`). Depo, istek sahiplerinin kullanıcı adlarını paylaşmayacak şekilde yapılandırıldığında zorunludur. `user` veya `request_id` parametrelerinden tam olarak biri sağlanmalıdır. repo_type (`str`, *isteğe bağlı*) : Erişim isteğinin reddedileceği repoyu türü. `model`, `dataset` veya `space` değerlerinden biri olmalıdır. Varsayılan değer `model`'dir. rejection_reason (`str`, *isteğe bağlı*) : Kullanıcıya görünecek isteğe bağlı reddetme nedeni (en fazla 200 karakter). token (`bool` veya `str`, *isteğe bağlı*) : Geçerli bir kullanıcı erişim belirteci (dize). Varsayılan olarak, kimlik doğrulama için önerilen yöntem olan yerel olarak kaydedilmiş belirteç kullanılır (bkz. https://huggingface.co/docs/huggingface_hub/quick-start#authentication). Kimlik doğrulamayı devre dışı bırakmak için `False` geçirin. **Yükselen:** `HfHubHTTPError` - `HfHubHTTPError` -- Depo gated değilse HTTP 400. - `HfHubHTTPError` -- Depoya yalnızca salt okunur erişiminiz varsa HTTP 403. Deponun ait olduğu organizasyonda `write` veya `admin` rolünüz yoksa ya da bir `read` belirteci geçirdiyseniz bu durumla karşılaşabilirsiniz. - `HfHubHTTPError` -- Kullanıcı Hub'da yoksa HTTP 404. - `HfHubHTTPError` -- Kullanıcı erişim isteği bulunamazsa HTTP 404. - `HfHubHTTPError` -- Kullanıcı erişim isteği zaten reddedilenler listesindeyse HTTP 404. Belirli bir gated repo için bir kullanıcının erişim isteğini reddet. Reddedilen bir istek, reddedilenler listesine gider. Kullanıcı, repodaki hiçbir dosyayı indiremez. Reddedilen istekler, [accept_access_request()](/docs/huggingface_hub/v2.4.0/tr/package_reference/hf_api#huggingface_hub.HfApi.accept_access_request) ve [cancel_access_request()](/docs/huggingface_hub/v2.4.0/tr/package_reference/hf_api#huggingface_hub.HfApi.cancel_access_request) kullanılarak herhangi bir zamanda kabul edilebilir veya iptal edilebilir. İptal edilen bir istek bekleyenler listesine geri dönerken, kabul edilen bir istek kabul edilenler listesine gider. Kapalı depolar hakkında daha fazla bilgi için https://huggingface.co/docs/hub/models-gated adresine bakın. #### rename_discussion[[huggingface_hub.HfApi.rename_discussion]] ```python rename_discussion(repo_id: str, discussion_num: int, new_title: str, token: bool | str | None = None, repo_type: str | None = None) ``` [Kaynak](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L7689) **Parametreler:** repo_id (`str`) : `/` ile ayrılmış bir ad alanı (kullanıcı veya kuruluş) ve bir depo adı. discussion_num (`int`) : Tartışma veya Pull Request'in numarası. Kesinlikle pozitif bir tam sayı olmalıdır. new_title (`str`) : Tartışma için yeni başlık repo_type (`str`, *isteğe bağlı*) : Bir veri setine veya uzaya yükleniyorsa `"dataset"` veya `"space"` olarak, bir modele yükleniyorsa `None` veya `"model"` olarak ayarlayın. Varsayılan değer `None`'dir. token (`bool` veya `str`, *isteğe bağlı*) : Geçerli bir kullanıcı erişim belirteci (dize). Varsayılan olarak, kimlik doğrulama için önerilen yöntem olan yerel olarak kaydedilmiş belirteç kullanılır (bkz. https://huggingface.co/docs/huggingface_hub/quick-start#authentication). Kimlik doğrulamayı devre dışı bırakmak için `False` geçirin. **Dönüş:** [DiscussionTitleChange](/docs/huggingface_hub/v2.4.0/tr/package_reference/community#huggingface_hub.DiscussionTitleChange) başlık değiştirme olayı Bir Tartışmayı Yeniden Adlandırır. Örnekler: ```python >>> new_title = "New title, fixing a typo" >>> HfApi().rename_discussion( ... repo_id="username/repo_name", ... discussion_num=34, ... new_title=new_title ... ) # DiscussionTitleChange(id='deadbeef0000000', type='title-change', ...) ``` > [!TIP] > Aşağıdaki hataları oluşturur: > > - [`HTTPError`](https://requests.readthedocs.io/en/latest/api/#requests.HTTPError) HuggingFace API bir hata döndürürse - [`ValueError`](https://docs.python.org/3/library/exceptions.html#ValueError) bir parametre değeri geçersizse - [RepositoryNotFoundError](/docs/huggingface_hub/v2.4.0/tr/package_reference/utilities#huggingface_hub.errors.RepositoryNotFoundError) İndirme yapılacak deposu bulunamazsa. Bunun nedeni, deponun var olmaması veya `private` olarak ayarlanmış olması ve erişiminizin bulunmaması olabilir. #### repo_exists[[huggingface_hub.HfApi.repo_exists]] ```python repo_exists(repo_id: str, repo_type: str | None = None, token: str | bool | None = None) ``` [Kaynak](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L3677) **Parametreler:** repo_id (`str`) : `/` ile ayrılmış bir ad alanı (kullanıcı veya kuruluş) ve bir depo adı. repo_type (`str`, *isteğe bağlı*) : Bir veri setinden veya bir uzaydan depo bilgisi alınıyorsa `"dataset"` veya `"space"` olarak, bir modelden depo bilgisi alınıyorsa `None` veya `"model"` olarak ayarlayın. Varsayılan değer `None`'dir. token (`bool` veya `str`, *isteğe bağlı*) : Geçerli bir kullanıcı erişim belirteci (dize). Varsayılan olarak, kimlik doğrulama için önerilen yöntem olan yerel olarak kaydedilmiş belirteç kullanılır (bkz. https://huggingface.co/docs/huggingface_hub/quick-start#authentication). Kimlik doğrulamayı devre dışı bırakmak için `False` geçirin. **Dönüş:** Depo varsa True, aksi halde False. Bir deponun Hugging Face Hub üzerinde var olup olmadığını kontrol eder. Örnekler: ```py >>> from huggingface_hub import repo_exists >>> repo_exists("google/gemma-7b") True >>> repo_exists("google/not-a-repo") False ``` #### repo_info[[huggingface_hub.HfApi.repo_info]] ```python repo_info(repo_id: str, revision: str | None = None, repo_type: str | None = None, timeout: float | None = None, files_metadata: bool = False, expand: ExpandModelProperty_T | ExpandDatasetProperty_T | ExpandSpaceProperty_T | None = None, token: bool | str | None = None) ``` [Kaynak](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L3469) **Parametreler:** repo_id (`str`) : `/` ile ayrılmış bir ad alanı (kullanıcı veya kuruluş) ve bir depo adı. revision (`str`, *isteğe bağlı*) : Bilgilerin alınacağı depoyun revizyonu. repo_type (`str`, *isteğe bağlı*) : Bir veri setinden veya bir uzaydan depo bilgisi alınıyorsa `"dataset"` veya `"space"` olarak, bir modelden depo bilgisi alınıyorsa `None` veya `"model"` olarak ayarlayın. Varsayılan değer `None`'dir. timeout (`float`, *isteğe bağlı*) : Hub'a yapılan istek için bir zaman aşımı ayarlanıp ayarlanmayacağı. expand (`ExpandModelProperty_T` veya `ExpandDatasetProperty_T` veya `ExpandSpaceProperty_T`, *isteğe bağlı*) : Yanıtta döndürülecek özellik listesi. Kullanıldığında, yalnızca listedeki özellikler döndürülür. `files_metadata` geçirildiğinde bu parametre kullanılamaz. Kullanılabilir özelliklerin kapsamlı listesi için [model_info()](/docs/huggingface_hub/v2.4.0/tr/package_reference/hf_api#huggingface_hub.HfApi.model_info), [dataset_info()](/docs/huggingface_hub/v2.4.0/tr/package_reference/hf_api#huggingface_hub.HfApi.dataset_info) veya [space_info()](/docs/huggingface_hub/v2.4.0/tr/package_reference/hf_api#huggingface_hub.HfApi.space_info) işlevlerine göz atın. files_metadata (`bool`, *isteğe bağlı*) : Depodaki dosyalar için (boyut, LFS meta verisi vb.) meta verilerin alınıp alınmayacağını belirtir. Varsayılan değeri `False`'dir. token (`bool` veya `str`, *isteğe bağlı*) : Geçerli bir kullanıcı erişim belirteci (dize). Varsayılan olarak, kimlik doğrulama için önerilen yöntem olan yerel olarak kaydedilmiş belirteç kullanılır (bkz. https://huggingface.co/docs/huggingface_hub/quick-start#authentication). Kimlik doğrulamayı devre dışı bırakmak için `False` geçirin. **Dönüş:** `Union[SpaceInfo, DatasetInfo, ModelInfo]` Depo bilgisi, bir [huggingface_hub.hf_api.DatasetInfo](/docs/huggingface_hub/v2.4.0/tr/package_reference/hf_api#huggingface_hub.DatasetInfo), [huggingface_hub.hf_api.ModelInfo](/docs/huggingface_hub/v2.4.0/tr/package_reference/hf_api#huggingface_hub.ModelInfo) veya [huggingface_hub.hf_api.SpaceInfo](/docs/huggingface_hub/v2.4.0/tr/package_reference/hf_api#huggingface_hub.SpaceInfo) nesnesi olarak. Belirli bir türdeki belirli bir depo için bilgi nesnesini alın. > [!TIP] > Aşağıdaki hataları oluşturur: > > - [RepositoryNotFoundError](/docs/huggingface_hub/v2.4.0/tr/package_reference/utilities#huggingface_hub.errors.RepositoryNotFoundError) İndirilecek depo bulunamazsa. Bunun nedeni, deponun var olmaması veya `private` olarak ayarlanmış olması ve erişiminizin bulunmaması olabilir. - [RevisionNotFoundError](/docs/huggingface_hub/v2.4.0/tr/package_reference/utilities#huggingface_hub.errors.RevisionNotFoundError) İndirilecek revizyon bulunamazsa. #### request_space_hardware[[huggingface_hub.HfApi.request_space_hardware]] ```python request_space_hardware(repo_id: str, hardware: SpaceHardware, token: bool | str | None = None, sleep_time: int | None = None) ``` [Kaynak](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L8323) **Parametreler:** repo_id (`str`) : Güncellenecek repozituarın kimliği. Örnek: `"bigcode/in-the-stack"`. hardware (`str` veya [SpaceHardware](/docs/huggingface_hub/v2.4.0/tr/package_reference/space_runtime#huggingface_hub.SpaceHardware)) : Space'in çalıştırılacağı donanım. Örnek: `"t4-medium"`. token (`bool` veya `str`, *isteğe bağlı*) : Geçerli bir kullanıcı erişim belirteci (dize). Varsayılan olarak, kimlik doğrulama için önerilen yöntem olan yerel olarak kaydedilmiş belirteç kullanılır (bkz. https://huggingface.co/docs/huggingface_hub/quick-start#authentication). Kimlik doğrulamayı devre dışı bırakmak için `False` geçirin. sleep_time (`int`, *isteğe bağlı*) : Bir Space'in uyku moduna alınmadan önce beklenmesi gereken boşta kalma süresi (saniye cinsinden). Space'inizin uyumasını istemiyorsanız `-1` olarak ayarlayın (yükseltilmiş donanımlar için varsayılan davranış). Ücretsiz donanımlarda uyku süresi yapılandırılamaz (değer 48 saat boşta kalma olarak sabittir). Daha fazla ayrıntı için https://huggingface.co/docs/hub/spaces-gpus#sleep-time adresine bakın. **Dönüş:** [SpaceRuntime](/docs/huggingface_hub/v2.4.0/tr/package_reference/space_runtime#huggingface_hub.SpaceRuntime) Bir Space hakkında çalışma zamanı bilgileri, Space aşaması ve donanımı dahil. Bir Space için yeni donanım talep edin. > [!TIP] > Space deposu oluşturulurken donanımın doğrudan istenmesi de mümkündür! Ayrıntılar için [create_repo()](/docs/huggingface_hub/v2.4.0/tr/package_reference/hf_api#huggingface_hub.HfApi.create_repo) işlevine bakın. #### rerun_job[[huggingface_hub.HfApi.rerun_job]] ```python rerun_job(job_id: str, namespace: str | None = None, token: bool | str | None = None) ``` [Kaynak](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L12728) **Parametreler:** job_id (`str`) : Yeniden çalıştırılacak İş'in kimliği. namespace (`str`, *isteğe bağlı*) : İşin ad alanı. Varsayılan olarak mevcut kullanıcının ad alanıdır. token (`bool` veya `str`, *isteğe bağlı*) : Kullanıcı erişim belirteci. Varsayılan olarak yerel olarak kaydedilmiş belirteç kullanılır. **Dönüş:** [JobInfo](/docs/huggingface_hub/v2.4.0/tr/package_reference/jobs#huggingface_hub.JobInfo) Yeni başlatılan İş. Mevcut İş'in yeniden deneme ve kaynak ayarlarını da içeren spesifikasyonunu kullanarak yeni bir İş çalıştırın. #### resolve_revision[[huggingface_hub.HfApi.resolve_revision]] ```python resolve_revision(repo_id: str, repo_type: str | None = None, revision: str | None = None, cache_dir: str | Path | None = None, local_files_only: bool = False, token: bool | str | None = None) ``` [Kaynak](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L3544) **Parametreler:** repo_id (`str`) : `/` ile ayrılmış bir kullanıcı veya kuruluş adı ve bir depo adı. repo_type (`str`, *isteğe bağlı*) : Depo bir veri seti, space veya kernel deposuysa `"dataset"`, `"space"` veya `"kernel"` olarak ayarlanır; bir model ise `None` veya `"model"` olarak ayarlanır. Varsayılan değer `None`'dir. revision (`str`, *isteğe bağlı*) : Çözümlenecek revizyon. Bir dal adı, etiket, PR referansı veya commit hash'i olabilir. Varsayılan olarak varsayılan dal kullanılır. Bir [ResolvedRevision](/docs/huggingface_hub/v2.4.0/tr/package_reference/file_download#huggingface_hub.ResolvedRevision) geçirilirse, olduğu gibi döndürülür - başka bir depoya karşı çözümlenmişse, başlangıçta istenen revizyon yeniden çözümlenir. cache_dir (`str`, `Path`, *isteğe bağlı*) : Önbelleğe alınan dosyaların saklandığı klasörün yolu. Varsayılan olarak `HF_HUB_CACHE` değerini kullanır. local_files_only (`bool`, *isteğe bağlı*, varsayılan `False`) : `True` ise, Hub ile iletişim kurmadan revizyonu yalnızca yerel önbellekten çözer. token (`bool` veya `str`, *isteğe bağlı*) : Geçerli bir kullanıcı erişim belirteci (dize). Varsayılan olarak, kimlik doğrulama için önerilen yöntem olan yerel olarak kaydedilmiş belirteç kullanılır (bkz. https://huggingface.co/docs/huggingface_hub/quick-start#authentication). Kimlik doğrulamayı devre dışı bırakmak için `False` geçirin. **Dönüş:** [ResolvedRevision](/docs/huggingface_hub/v2.4.0/tr/package_reference/file_download#huggingface_hub.ResolvedRevision) Hem istenen revizyonu hem de çözümlendiği commit hash'ini tutan bir `str` alt sınıfı. **Yükselen:** [RevisionResolutionError](/docs/huggingface_hub/v2.4.0/tr/package_reference/utilities#huggingface_hub.errors.RevisionResolutionError) veya [RevisionNotFoundError](/docs/huggingface_hub/v2.4.0/tr/package_reference/utilities#huggingface_hub.errors.RevisionNotFoundError) veya [RepositoryNotFoundError](/docs/huggingface_hub/v2.4.0/tr/package_reference/utilities#huggingface_hub.errors.RepositoryNotFoundError) - [RevisionResolutionError](/docs/huggingface_hub/v2.4.0/tr/package_reference/utilities#huggingface_hub.errors.RevisionResolutionError) -- Revizyon çözümlenemezse: Hub'a ulaşılamadı ve yerel olarak hiçbir şey önbelleğe alınmadı. - [RevisionNotFoundError](/docs/huggingface_hub/v2.4.0/tr/package_reference/utilities#huggingface_hub.errors.RevisionNotFoundError) -- Revizyon Hub'da mevcut değilse. - [RepositoryNotFoundError](/docs/huggingface_hub/v2.4.0/tr/package_reference/utilities#huggingface_hub.errors.RepositoryNotFoundError) -- Depo bulunamadığında. Bunun nedeni, depoyun var olmaması veya `private` olarak ayarlanmış olması ve erişiminizin bulunmaması olabilir. Bir revizyonu (dal, etiket, PR referansı) bir commit hash'ine çözümler. Bu, bir repodaki birkaç bileşeni (config, weights, tokenizer, ...) ayrı ayrı indirip yükleyen kütüphaneler içindir. Revizyonu bir kez çözmek ve döndürülen [ResolvedRevision](/docs/huggingface_hub/v2.4.0/tr/package_reference/file_download#huggingface_hub.ResolvedRevision) nesnesini iletmek, repo bu arada güncellense bile her sonraki çağrının tam olarak aynı commit'i hedeflediğini garanti eder. Ayrıca HTTP çağrılarını da azaltır; çünkü commit hash'i ile yapılan indirmeler, Hub'a bağlanmadan yerel önbellekten sunulabilir. `revision` -> `commit hash` eşlemesi, diskte (önbelleğin `refs/` klasöründe) en iyi çaba (best-effort) esasına göre önbelleğe alınır. Hub daha sonra erişilemezse (çevrimdışı mod, bağlantı hatası, zaman aşımı, Hub kesintisi, ...), önbelleğe alınan değer yedek olarak kullanılır. > [!TIP] > Sadece tam bir depo anlık görüntüsü indirmeniz gerekiyorsa, tek bir [snapshot_download()](/docs/huggingface_hub/v2.4.0/tr/package_reference/file_download#huggingface_hub.snapshot_download) çağrısı yeterlidir ve zaten doğru işi yapar. `resolve_revision` yalnızca dosyaları ayrı ayrı indirirken işe yarar. Örnek: ```py >>> from huggingface_hub import hf_hub_download, resolve_revision >>> revision = resolve_revision("openai-community/gpt2") >>> revision ResolvedRevision(initial=None, resolved='607a30d783dfa663caf39e06633721c8d4cfcd7e') # Pass it around: every download is pinned to the same commit >>> config = hf_hub_download("openai-community/gpt2", "config.json", revision=revision) >>> weights = hf_hub_download("openai-community/gpt2", "model.safetensors", revision=revision) ``` #### restart_space[[huggingface_hub.HfApi.restart_space]] ```python restart_space(repo_id: str, token: bool | str | None = None, factory_reboot: bool = False) ``` [Kaynak](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L8542) **Parametreler:** repo_id (`str`) : Yeniden başlatılacak Space'in kimliği. Örnek: `"Salesforce/BLIP2"`. token (`bool` veya `str`, *isteğe bağlı*) : Geçerli bir kullanıcı erişim belirteci (dize). Varsayılan olarak, kimlik doğrulama için önerilen yöntem olan yerel olarak kaydedilmiş belirteç kullanılır (bkz. https://huggingface.co/docs/huggingface_hub/quick-start#authentication). Kimlik doğrulamayı devre dışı bırakmak için `False` geçirin. factory_reboot (`bool`, *isteğe bağlı*) : `True` ise, Space hiçbir gereksinim önbelleğe almadan sıfırdan yeniden oluşturulur. **Dönüş:** [SpaceRuntime](/docs/huggingface_hub/v2.4.0/tr/package_reference/space_runtime#huggingface_hub.SpaceRuntime) Space'inizin çalışma zamanı bilgileri. **Yükselen:** [RepositoryNotFoundError](/docs/huggingface_hub/v2.4.0/tr/package_reference/utilities#huggingface_hub.errors.RepositoryNotFoundError) veya [HfHubHTTPError](/docs/huggingface_hub/v2.4.0/tr/package_reference/utilities#huggingface_hub.errors.HfHubHTTPError) veya [BadRequestError](/docs/huggingface_hub/v2.4.0/tr/package_reference/utilities#huggingface_hub.errors.BadRequestError) - [RepositoryNotFoundError](/docs/huggingface_hub/v2.4.0/tr/package_reference/utilities#huggingface_hub.errors.RepositoryNotFoundError) -- Space'iniz bulunamadığında (hata 404). Büyük olasılıkla repo_id yanlış veya Space'iniz özel olup kimlik doğrulamanız yapılmamış. - [HfHubHTTPError](/docs/huggingface_hub/v2.4.0/tr/package_reference/utilities#huggingface_hub.errors.HfHubHTTPError) -- 403 Forbidden: bir Space'i yalnızca sahibi yeniden başlatabilir. Sahibi olmadığınız bir Space'i yeniden başlatmak istiyorsanız, bir Discussion açarak sahibinden isteyebilir veya Space'i kopyalayabilirsiniz. - [BadRequestError](/docs/huggingface_hub/v2.4.0/tr/package_reference/utilities#huggingface_hub.errors.BadRequestError) -- Space'ınız statik bir Space ise. Statik Spaces her zaman çalışır durumda olur ve asla faturalandırılmaz. Statik bir Space'i gizlemek istiyorsanız, onu özel olarak ayarlayabilirsiniz. Space'inizi yeniden başlatın. Bir Space'i Duraklatma durumuna aldıysanız (bkz. [pause_space()](/docs/huggingface_hub/v2.4.0/tr/package_reference/hf_api#huggingface_hub.HfApi.pause_space)), programatik olarak yeniden başlatmanın tek yolu budur. Yeniden başlatmak için Space'in sahibi olmanız gerekir. Yükseltilmiş bir donanım kullanıyorsanız, Space yeniden başlatıldığında hesabınıza fatura kesilir. Bir Space'in mevcut durumu ne olursa olsun yeniden başlatma tetikleyebilirsiniz. Daha fazla ayrıntı için lütfen [belgelere](https://huggingface.co/docs/hub/spaces-gpus#pause) göz atın. #### resume_inference_endpoint[[huggingface_hub.HfApi.resume_inference_endpoint]] ```python resume_inference_endpoint(name: str, namespace: str | None = None, running_ok: bool = True, token: bool | str | None = None) ``` [Kaynak](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L9957) **Parametreler:** name (`str`) : Devam edilecek Inference Endpoint'in adı. namespace (`str`, *isteğe bağlı*) : Inference Endpoint'in bulunduğu ad alanı. Varsayılan olarak mevcut kullanıcıdır. running_ok (`bool`, *isteğe bağlı*) : `True` ise, Inference Endpoint zaten çalışıyorsa yöntem hata yükseltmez. Varsayılan olarak `True`'dur. token (`bool` veya `str`, *isteğe bağlı*) : Geçerli bir kullanıcı erişim belirteci (dize). Varsayılan olarak, kimlik doğrulama için önerilen yöntem olan yerel olarak kaydedilmiş belirteç kullanılır (bkz. https://huggingface.co/docs/huggingface_hub/quick-start#authentication). Kimlik doğrulamayı devre dışı bırakmak için `False` geçirin. **Dönüş:** [InferenceEndpoint](/docs/huggingface_hub/v2.4.0/tr/package_reference/inference_endpoints#huggingface_hub.InferenceEndpoint) devam ettirilen Inference Endpoint hakkında bilgi. Bir Çıkarım Uç noktasını Devam Ettirin. Kolaylık olması için, [InferenceEndpoint.resume()](/docs/huggingface_hub/v2.4.0/tr/package_reference/inference_endpoints#huggingface_hub.InferenceEndpoint.resume) kullanarak bir Inference Endpoint'i yeniden başlatabilirsiniz. #### resume_scheduled_job[[huggingface_hub.HfApi.resume_scheduled_job]] ```python resume_scheduled_job(scheduled_job_id: str, namespace: str | None = None, token: bool | str | None = None) ``` [Kaynak](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L13384) **Parametreler:** scheduled_job_id (`str`) : Planlanan Job'un kimliği. namespace (`str`, *isteğe bağlı*) : Planlanan Job'un bulunduğu ad alanı. Varsayılan olarak mevcut kullanıcının ad alanıdır. token (`bool` veya `str`, *isteğe bağlı*) : Geçerli bir kullanıcı erişim belirteci. Sağlanmazsa, önerilen kimlik doğrulama yöntemi olan yerel olarak kaydedilmiş belirteç kullanılır. Kimlik doğrulamayı devre dışı bırakmak için `False` olarak ayarlayın. Aşağıdaki bağlantıya bakın: https://huggingface.co/docs/huggingface_hub/quick-start#authentication. Resume Hugging Face altyapısında zamanlanmış bir hesaplama İşini (unpause) yapın. #### revision_exists[[huggingface_hub.HfApi.revision_exists]] ```python revision_exists(repo_id: str, revision: str, repo_type: str | None = None, token: str | bool | None = None) ``` [Kaynak](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L3721) **Parametreler:** repo_id (`str`) : `/` ile ayrılmış bir ad alanı (kullanıcı veya kuruluş) ve bir depo adı. revision (`str`) : Kontrol edilecek depoyu sürümü. repo_type (`str`, *isteğe bağlı*) : Bir veri setinden veya bir uzaydan depo bilgisi alınıyorsa `"dataset"` veya `"space"` olarak, bir modelden depo bilgisi alınıyorsa `None` veya `"model"` olarak ayarlayın. Varsayılan değer `None`'dir. token (`bool` veya `str`, *isteğe bağlı*) : Geçerli bir kullanıcı erişim belirteci (dize). Varsayılan olarak, kimlik doğrulama için önerilen yöntem olan yerel olarak kaydedilmiş belirteç kullanılır (bkz. https://huggingface.co/docs/huggingface_hub/quick-start#authentication). Kimlik doğrulamayı devre dışı bırakmak için `False` geçirin. **Dönüş:** Depo ve revizyon varsa True, aksi halde False. Hugging Face Hub'daki bir depoda belirli bir revizyonun var olup olmadığını kontrol eder. Örnekler: ```py >>> from huggingface_hub import revision_exists >>> revision_exists("google/gemma-7b", "float16") True >>> revision_exists("google/gemma-7b", "not-a-revision") False ``` #### run_as_future[[huggingface_hub.HfApi.run_as_future]] ```python run_as_future(fn: Callable[..., R], *args, **kwargs) ``` [Kaynak](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L2178) **Parametreler:** fn (`Callable`) : Arka planda çalıştırılacak yöntem. - ***args,** **kwargs : Yöntemin çağrılacağı argümanlar. **Dönüş:** `Future` Görevin sonucunu almak için bir [Future](https://docs.python.org/3/library/concurrent.futures.html#future-objects) örneği. Bir yöntemi arka planda çalıştırın ve bir Future örneği döndürün. Ana hedef, ana iş parçacığını bloklamadan yöntemleri çalıştırmaktır (ör. eğitim sırasında veri göndermek). Arka plan işleri sırayı korumak için kuyruğa alınır ancak paralel olarak çalıştırılmaz. API'ye yapılan çok sayıda çağrıyı paralelleştirerek betiklerinizi hızlandırmak gerekiyorsa, kendi [ThreadPoolExecutor](https://docs.python.org/3/library/concurrent.futures.html#threadpoolexecutor) örneğinizi yapılandırıp kullanmanız gerekir. Not: [upload_file()](/docs/huggingface_hub/v2.4.0/tr/package_reference/hf_api#huggingface_hub.HfApi.upload_file), [upload_folder()](/docs/huggingface_hub/v2.4.0/tr/package_reference/hf_api#huggingface_hub.HfApi.upload_folder) ve [create_commit()](/docs/huggingface_hub/v2.4.0/tr/package_reference/hf_api#huggingface_hub.HfApi.create_commit) gibi en çok kullanılan yöntemler, bunları doğrudan arka planda çağırmak için `run_as_future: bool` argümanına sahiptir. Bu, onlara `api.run_as_future(...)` çağrısı yapmaya eşdeğerdir ancak daha az sözdebirimseldir. Örnek: ```py >>> from huggingface_hub import HfApi >>> api = HfApi() >>> future = api.run_as_future(api.whoami) # instant >>> future.done() False >>> future.result() # wait until complete and return result (...) >>> future.done() True ``` #### run_job[[huggingface_hub.HfApi.run_job]] ```python run_job(image: str, command: list[str], env: dict[str, Any] | None = None, secrets: dict[str, Any] | None = None, flavor: JobHardware | str | None = None, timeout: int | float | str | None = None, attempts: int | None = None, name: str | None = None, labels: dict[str, str] | None = None, volumes: list[Volume] | None = None, expose: list[int] | None = None, expose_public: list[int] | None = None, ssh: bool = False, network_group: str | None = None, network_aliases: list[str] | None = None, resource_group_id: str | None = None, namespace: str | None = None, token: bool | str | None = None) ``` [Kaynak](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L12122) **Parametreler:** image (`str`) : Kullanılacak Docker görüntüsü. Örnekler: `"ubuntu"`, `"python:3.12"`, `"pytorch/pytorch:2.6.0-cuda12.4-cudnn9-devel"`. Bir Space'ten görüntü örneği: `"hf.co/spaces/lhoestq/duckdb"`. command (`list[str]`) : Çalıştırılacak komut. Örnek: `["echo", "hello"]`. env (`dict[str, Any]`, *isteğe bağlı*) : Job için ortam değişkenlerini tanımlar. secrets (`dict[str, Any]`, *isteğe bağlı*) : Job için gizli ortam değişkenlerini tanımlar. flavor (`str`, *isteğe bağlı*) : Donanım için tür. Olası değerler için `JobHardware`'a bakın. Varsayılan değer `"cpu-basic"`'tir. timeout (`Union[int, float, str]`, *isteğe bağlı*) : İşin (Job) maksimum süresi: int ile s (saniye, varsayılan), m (dakika), h (saat) veya d (gün). Örnek: 5 dakika için `300` veya `"5m"`. attempts (`int`, *isteğe bağlı*) : İlk çalıştırma dahil olmak üzere maksimum deneme sayısı. Varsayılan değer 1'dir. Örneğin, 3, başarısız bir Job'u en fazla 2 kez yeniden dener. name (`str`, *isteğe bağlı*) : İş için bir ad. `name` etiketi olarak saklanır. `labels` içindeki `name` anahtarıyla birlikte geçirilemez. Adların benzersiz olması gerekmez. Varsayılan olarak, görüntüden ve komuttan türetilen bir ad (kısa bir hash sonekiyle) kullanılır. labels (`dict[str, str]`, *isteğe bağlı*) : İşe eklenecek etiketler (anahtar-değer çiftleri). volumes (`list[Volume]`, *isteğe bağlı*) : İş konteynerinde hacim olarak bağlanacak Hugging Face Buckets veya Repos. Her hacim, `type` (`"bucket"`, `"model"`, `"dataset"` veya `"space"`), `source` (ör. `"username/my-bucket"`) ve `mount_path` (ör. `"/data"`) içeren bir [Volume](/docs/huggingface_hub/v2.4.0/tr/package_reference/jobs#huggingface_hub.Volume)'dir. expose (`list[int]`, *isteğe bağlı*) : İşler vekili (jobs proxy) üzerinden açılacak konteyner portları. Listelenen her port, herkese açık işler alan adında erişilebilir durumda olur (ör. `https://--8000.hf.jobs`). Erişim için her zaman, işin ad alanına (namespace) okuma erişimi olan bir HF jetonu (token) gerekir. Kimlik doğrulamasız erişim için `expose_public` kullanın. expose_public (`list[int]`, *isteğe bağlı*) : Kimlik doğrulama olmadan Jobs proxy üzerinden açılacak portlar. Bunların `expose` içinde listelenmesine gerek yoktur. ssh (`bool`, *isteğe bağlı*) : True ise, işin konteyneri `job.status.ssh_url` tarafından verilen URL üzerinden SSH ile erişilebilir (ör. `ssh @ssh.hf.jobs` veya CLI'dan `hf jobs ssh `). Bağlanmak için işin ad alanına yazma erişimi ve Hub'da (https://huggingface.co/settings/keys) kayıtlı bir SSH anahtar çifti gerektirir. Varsayılan olarak False'dur. network_group (`str`, *isteğe bağlı*) : Katılınacak ağ grubunun adı. Aynı namespace ve resource group içinde aynı grubu paylaşan işler birlikte yerleştirilir ve her port üzerinden birbirine erişebilir. Her üyenin içinde, `HF_NETWORK_GROUP_HOSTNAME` grubun tüm üyelerine çözümlenir. Küçük harfli alfanümerik karakterler ve tireler, en fazla 46 karakter. network_aliases (`list[str]`, *isteğe bağlı*) : Bu işin ağ grubunda iddia ettiği takma adlar. Üyeler, bir takma adı iddia eden işlere `${HF_NETWORK_GROUP_PREFIX}` üzerinden erişir. Birden fazla iş aynı takma adı iddia edebilir. Küçük harfli alfanümerik karakterler ve tireler, en fazla 34 karakter, iş içinde benzersiz olmalıdır. `network_group` gerektirir. resource_group_id (`str`, *isteğe bağlı*) : Job'ın oluşturulacağı kaynak grubunun kimliği. Bir organizasyon içindeki kaynaklara erişimi kontrol etmek ve maliyet atama/harcama limiti özellikleri için kullanılır. Sağlanmazsa, Job herhangi bir kaynak grubunun dışında oluşturulur. namespace (`str`, *isteğe bağlı*) : Job'ün oluşturulacağı ad alanı. Varsayılan olarak mevcut kullanıcının ad alanıdır. token (`bool` veya `str`, *isteğe bağlı*) : Geçerli bir kullanıcı erişim belirteci. Sağlanmazsa, önerilen kimlik doğrulama yöntemi olan yerel olarak kaydedilmiş belirteç kullanılır. Kimlik doğrulamayı devre dışı bırakmak için `False` olarak ayarlayın. Aşağıdaki bağlantıya bakın: https://huggingface.co/docs/huggingface_hub/quick-start#authentication. Hugging Face altyapısında compute işlerini çalıştırın. Örnek: İlk Job'unuzu çalıştırın: ```python >>> from huggingface_hub import run_job >>> run_job(image="python:3.12", command=["python", "-c" ,"print('Hello from HF compute!')"]) ``` GPU İşini Çalıştırın: ```python >>> from huggingface_hub import run_job >>> image = "pytorch/pytorch:2.6.0-cuda12.4-cudnn9-devel" >>> command = ["python", "-c", "import torch; print(f'This code ran with the following GPU: {torch.cuda.get_device_name()}')"] >>> run_job(image=image, command=command, flavor="a10g-small") ``` Hacimlerle bir İş Çalıştırın: ```python >>> from huggingface_hub import Volume, run_job >>> dataset_volume = Volume(type="dataset", source="HuggingFaceFW/fineweb", mount_path="/data") >>> output_bucket_volume = Volume(type="bucket", source="username/my-bucket", mount_path="/output") >>> image = "duckdb/duckdb" >>> command = ["duckdb", "-c", "COPY (SELECT * FROM '/data/**/*.parquet' LIMIT 5) TO '/output/first-rows.parquet'"] >>> run_job(image=image, command=command, volumes=[dataset_volume, output_bucket_volume]) ``` #### run_uv_job[[huggingface_hub.HfApi.run_uv_job]] ```python run_uv_job(script: str, script_args: list[str] | None = None, dependencies: list[str] | None = None, python: str | None = None, image: str | None = None, env: dict[str, Any] | None = None, secrets: dict[str, Any] | None = None, flavor: JobHardware | str | None = None, timeout: int | float | str | None = None, attempts: int | None = None, name: str | None = None, labels: dict[str, str] | None = None, volumes: list[Volume] | None = None, expose: list[int] | None = None, expose_public: list[int] | None = None, ssh: bool = False, network_group: str | None = None, network_aliases: list[str] | None = None, resource_group_id: str | None = None, namespace: str | None = None, token: bool | str | None = None) ``` [Kaynak](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L12871) **Parametreler:** script (`str`) : UV betiğinin yolu veya URL'si, ya da bir komut. script_args (`list[str]`, *isteğe bağlı*) : Betiğe veya komuta iletilecek argümanlar. dependencies (`list[str]`, *isteğe bağlı*) : UV betiğini çalıştırmak için kullanılacak bağımlılıklar. python (`str`, *isteğe bağlı*) : Belirli bir Python sürümü kullanın. Varsayılan 3.12'dir. image (`str`, *isteğe bağlı*, varsayılan "ghcr.io/astral-sh/uv --python3.12-bookworm"): `uv` yüklü özel bir Docker görüntüsü kullanın. env (`dict[str, Any]`, *isteğe bağlı*) : Job için ortam değişkenlerini tanımlar. secrets (`dict[str, Any]`, *isteğe bağlı*) : Job için gizli ortam değişkenlerini tanımlar. flavor (`str`, *isteğe bağlı*) : Donanım için tür. Olası değerler için `JobHardware`'a bakın. Varsayılan değer `"cpu-basic"`'tir. timeout (`Union[int, float, str]`, *isteğe bağlı*) : İşin (Job) maksimum süresi: int ile s (saniye, varsayılan), m (dakika), h (saat) veya d (gün). Örnek: 5 dakika için `300` veya `"5m"`. attempts (`int`, *isteğe bağlı*) : İlk çalıştırma dahil olmak üzere maksimum deneme sayısı. Varsayılan değer 1'dir. name (`str`, *isteğe bağlı*) : İş için bir ad. `name` etiketi olarak saklanır. `labels` içindeki `name` anahtarıyla birlikte geçirilemez. Adların benzersiz olması gerekmez. Varsayılan olarak, betikten ve argümanlarından türetilen bir ad (kısa bir hash sonekiyle) kullanılır. labels (`dict[str, str]`, *isteğe bağlı*) : İşe eklenecek etiketler (anahtar-değer çiftleri). volumes (`list[Volume]`, *isteğe bağlı*) : İş konteynerinde hacim olarak bağlanacak Hugging Face Buckets veya Repos. Her hacim, `type` (`"bucket"`, `"model"`, `"dataset"` veya `"space"`), `source` (ör. `"username/my-bucket"`) ve `mount_path` (ör. `"/data"`) içeren bir [Volume](/docs/huggingface_hub/v2.4.0/tr/package_reference/jobs#huggingface_hub.Volume)'dir. expose (`list[int]`, *isteğe bağlı*) : İşler vekili (jobs proxy) üzerinden açılacak konteyner portları. Listelenen her port, herkese açık işler alan adında erişilebilir durumda olur (ör. `https://--8000.hf.jobs`). Erişim için her zaman, işin ad alanına (namespace) okuma erişimi olan bir HF jetonu (token) gerekir. Kimlik doğrulamasız erişim için `expose_public` kullanın. expose_public (`list[int]`, *isteğe bağlı*) : Kimlik doğrulama olmadan Jobs proxy üzerinden açılacak portlar. Bunların `expose` içinde listelenmesine gerek yoktur. ssh (`bool`, *isteğe bağlı*) : True ise, işin konteyneri `job.status.ssh_url` tarafından verilen URL üzerinden SSH ile erişilebilir (ör. `ssh @ssh.hf.jobs` veya CLI'dan `hf jobs ssh `). Bağlanmak için işin ad alanına yazma erişimi ve Hub'da (https://huggingface.co/settings/keys) kayıtlı bir SSH anahtar çifti gerektirir. Varsayılan olarak False'dur. network_group (`str`, *isteğe bağlı*) : Katılınacak ağ grubunun adı. Aynı namespace ve resource group içinde aynı grubu paylaşan işler birlikte yerleştirilir ve her port üzerinden birbirine erişebilir. Her üyenin içinde, `HF_NETWORK_GROUP_HOSTNAME` grubun tüm üyelerine çözümlenir. Küçük harfli alfanümerik karakterler ve tireler, en fazla 46 karakter. network_aliases (`list[str]`, *isteğe bağlı*) : Bu işin ağ grubunda iddia ettiği takma adlar. Üyeler, bir takma adı iddia eden işlere `${HF_NETWORK_GROUP_PREFIX}` üzerinden erişir. Birden fazla iş aynı takma adı iddia edebilir. Küçük harfli alfanümerik karakterler ve tireler, en fazla 34 karakter, iş içinde benzersiz olmalıdır. `network_group` gerektirir. resource_group_id (`str`, *isteğe bağlı*) : Job'ın oluşturulacağı kaynak grubunun kimliği. Bir organizasyon içindeki kaynaklara erişimi kontrol etmek ve maliyet atama/harcama limiti özellikleri için kullanılır. Sağlanmazsa, Job herhangi bir kaynak grubunun dışında oluşturulur. namespace (`str`, *isteğe bağlı*) : Job'ün oluşturulacağı ad alanı. Varsayılan olarak mevcut kullanıcının ad alanıdır. token (`bool` veya `str`, *isteğe bağlı*) : Geçerli bir kullanıcı erişim belirteci. Sağlanmazsa, önerilen kimlik doğrulama yöntemi olan yerel olarak kaydedilmiş belirteç kullanılır. Kimlik doğrulamayı devre dışı bırakmak için `False` olarak ayarlayın. Aşağıdaki bağlantıya bakın: https://huggingface.co/docs/huggingface_hub/quick-start#authentication. Hugging Face altyapısında bir UV script Job çalıştırın. > [!WARNING] > `hf jobs uv run`'un aksine, bu yöntem, bir UV betiğinin PEP 723 başlığında taşıyabileceği isteğe bağlı `[tool.hf-jobs]` tablosunu görmezden gelir ([Jobs kılavuzu](../guides/jobs#ship-the-launch-config-with-the-script) bkz.): başlatma yapılandırmasının burada açıkça iletilmesi gerekir. Örnek: Bir URL'den betik çalıştırın: ```python >>> from huggingface_hub import run_uv_job >>> script = "https://raw.githubusercontent.com/huggingface/trl/refs/heads/main/trl/scripts/sft.py" >>> script_args = ["--model_name_or_path", "Qwen/Qwen2-0.5B", "--dataset_name", "trl-lib/Capybara", "--push_to_hub"] >>> run_uv_job(script, script_args=script_args, dependencies=["trl"], flavor="a10g-small") ``` Yerel bir betik çalıştırın: ```python >>> from huggingface_hub import run_uv_job >>> script = "my_sft.py" >>> script_args = ["--model_name_or_path", "Qwen/Qwen2-0.5B", "--dataset_name", "trl-lib/Capybara", "--push_to_hub"] >>> run_uv_job(script, script_args=script_args, dependencies=["trl"], flavor="a10g-small") ``` Komut çalıştırın: ```python >>> from huggingface_hub import run_uv_job >>> script = "lighteval" >>> script_args= ["endpoint", "inference-providers", "model_name=openai/gpt-oss-20b,provider=auto", "lighteval|gsm8k|0|0"] >>> run_uv_job(script, script_args=script_args, dependencies=["lighteval"], flavor="a10g-small") ``` Model denetim noktalarını eğitim sırasında kaydetmek için hacimler bağlayın: ```python >>> from huggingface_hub import Volume, run_uv_job >>> script = "my_sft.py" >>> script_args = ["--output_dir", "/training-outputs/training-v3-final", ...] >>> checkpoints_bucket = Volume(type="bucket", source="username/my-bucket", mount_path="/training-outputs") >>> run_uv_job(script, script_args=script_args, volumes=[checkpoints_bucket]) ``` #### scale_to_zero_inference_endpoint[[huggingface_hub.HfApi.scale_to_zero_inference_endpoint]] ```python scale_to_zero_inference_endpoint(name: str, namespace: str | None = None, token: bool | str | None = None) ``` [Kaynak](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L10003) **Parametreler:** name (`str`) : Sıfıra ölçeklendirilecek Inference Endpoint'in adı. namespace (`str`, *isteğe bağlı*) : Inference Endpoint'in bulunduğu ad alanı. Varsayılan olarak mevcut kullanıcıdır. token (`bool` veya `str`, *isteğe bağlı*) : Geçerli bir kullanıcı erişim belirteci (dize). Varsayılan olarak, kimlik doğrulama için önerilen yöntem olan yerel olarak kaydedilmiş belirteç kullanılır (bkz. https://huggingface.co/docs/huggingface_hub/quick-start#authentication). Kimlik doğrulamayı devre dışı bırakmak için `False` geçirin. **Dönüş:** [InferenceEndpoint](/docs/huggingface_hub/v2.4.0/tr/package_reference/inference_endpoints#huggingface_hub.InferenceEndpoint) sıfıra ölçeklendirilmiş Inference Endpoint hakkında bilgi. Inference Endpoint'ı sıfıra ölçekleyin. Sıfıra ölçeklendirilmiş bir Inference Endpoint için ücretlendirme yapılmaz. Bir sonraki istek geldiğinde, soğuk başlatma gecikmesiyle birlikte yeniden başlatılır. Bu, [pause_inference_endpoint()](/docs/huggingface_hub/v2.4.0/tr/package_reference/hf_api#huggingface_hub.HfApi.pause_inference_endpoint) ile Inference Endpoint'i duraklatmaktan farklıdır; bu durumda [resume_inference_endpoint()](/docs/huggingface_hub/v2.4.0/tr/package_reference/hf_api#huggingface_hub.HfApi.resume_inference_endpoint) ile manuel olarak yeniden başlatma gerektirir. Kolaylık olması için, [InferenceEndpoint.scale_to_zero()](/docs/huggingface_hub/v2.4.0/tr/package_reference/inference_endpoints#huggingface_hub.InferenceEndpoint.scale_to_zero) kullanarak bir Inference Endpoint'i sıfıra ölçeklendirebilirsiniz. #### search_spaces[[huggingface_hub.HfApi.search_spaces]] ```python search_spaces(query: str, filter: str | Iterable[str] | None = None, sdk: str | list[str] | None = None, include_non_running: bool = False, token: bool | str | None = None) ``` [Kaynak](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L2878) **Parametreler:** query (`str`) : Arama sorgu dizesi. filter (`str` veya `Iterable[str]`, *isteğe bağlı*) : Filtrelemek için bir dize etiketi veya etiket listesi. sdk (`str` veya `list[str]`, *isteğe bağlı*) : SDK'ye göre filtrele (ör. `"gradio"`, `"docker"`, `"static"`). include_non_running (`bool`, *isteğe bağlı*) : Sonuçlara çalışmayan Spaces'leri dahil edip etmeyeceğini belirtir. Varsayılan değeri `False`'dir. token (`bool` veya `str`, *isteğe bağlı*) : Geçerli bir kullanıcı erişim belirteci (dize). Varsayılan olarak, kimlik doğrulama için önerilen yöntem olan yerel olarak kaydedilmiş belirteç kullanılır (bkz. https://huggingface.co/docs/huggingface_hub/quick-start#authentication). Kimlik doğrulamayı devre dışı bırakmak için `False` geçirin. **Dönüş:** `Iterable[SpaceSearchResult]` [SpaceSearchResult](/docs/huggingface_hub/v2.4.0/tr/package_reference/hf_api#huggingface_hub.SpaceSearchResult) nesnelerinden oluşan bir iterable. Hub'da semantik arama kullanarak Arama Alanlarını arayın. Bu uç nokta, çok kelimeli sorgular için anlamsal arama (gömme tabanlı) ve tek kelimeli sorgular için tam metin araması kullanır. Örnek: ```python >>> from huggingface_hub import HfApi >>> api = HfApi() >>> results = list(api.search_spaces("generate image")) >>> results[0].id 'mrfakename/Z-Image-Turbo' >>> results[0].ai_category 'Image Generation' ``` #### set_space_sleep_time[[huggingface_hub.HfApi.set_space_sleep_time]] ```python set_space_sleep_time(repo_id: str, sleep_time: int, token: bool | str | None = None) ``` [Kaynak](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L8373) **Parametreler:** repo_id (`str`) : Güncellenecek repozituarın kimliği. Örnek: `"bigcode/in-the-stack"`. sleep_time (`int`, *isteğe bağlı*) : Bir Space'in uyku moduna alınmadan önce beklenmesi gereken boşta kalma süresi (saniye cinsinden). Space'inizin duraklamasını istemiyorsanız `-1` olarak ayarlayın (yükseltilmiş donanımlar için varsayılan davranış). Ücretsiz donanımlarda uyku süresi yapılandırılamaz (değer 48 saat boşta kalma olarak sabittir). Daha fazla ayrıntı için https://huggingface.co/docs/hub/spaces-gpus#sleep-time adresine bakın. token (`bool` veya `str`, *isteğe bağlı*) : Geçerli bir kullanıcı erişim belirteci (dize). Varsayılan olarak, kimlik doğrulama için önerilen yöntem olan yerel olarak kaydedilmiş belirteç kullanılır (bkz. https://huggingface.co/docs/huggingface_hub/quick-start#authentication). Kimlik doğrulamayı devre dışı bırakmak için `False` geçirin. **Dönüş:** [SpaceRuntime](/docs/huggingface_hub/v2.4.0/tr/package_reference/space_runtime#huggingface_hub.SpaceRuntime) Bir Space hakkında çalışma zamanı bilgileri, Space aşaması ve donanımı dahil. Yükseltilmiş donanımda çalışan bir Space için özel bir uyku süresi ayarlayın. X saniye boyunca hareketsizlik durumunda Space'iniz uyku moduna geçer. Space'iniz "uyku" modundayken faturalandırılmaz. Yeni bir ziyaretçi Space'inize ulaştığında, Space "uyandırılır". Yalnızca yükseltilmiş donanımlarda yapılandırılabilir bir uyku süresi bulunabilir. Uyku aşaması hakkında daha fazla bilgi için lütfen https://huggingface.co/docs/hub/spaces-gpus#sleep-time adresine bakın. > [!TIP] > Donanım istenirken [request_space_hardware()](/docs/huggingface_hub/v2.4.0/tr/package_reference/hf_api#huggingface_hub.HfApi.request_space_hardware) ile özel bir uyku süresi ayarlamak da mümkündür. #### set_space_volumes[[huggingface_hub.HfApi.set_space_volumes]] ```python set_space_volumes(repo_id: str, volumes: list[Volume], token: bool | str | None = None) ``` [Kaynak](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L9057) **Parametreler:** repo_id (`str`) : Güncellenecek Space'in kimliği. Örnek: `"username/my-space"`. volumes (`list[Volume]`) : Bağlanacak [Volume](/docs/huggingface_hub/v2.4.0/tr/package_reference/jobs#huggingface_hub.Volume) nesnelerinin listesi. Her hacmin bir `type` (`"bucket"`, `"model"`, `"dataset"` veya `"space"`), bir `source` (repo veya bucket kimliği), bir `mount_path` (konteyner içindeki yol) ve isteğe bağlı `revision`, `read_only` ile `path` alanları vardır. token (`bool` veya `str`, *isteğe bağlı*) : Geçerli bir kullanıcı erişim belirteci (dize). Varsayılan olarak, kimlik doğrulama için önerilen yöntem olan yerel olarak kaydedilmiş belirteç kullanılır (bkz. https://huggingface.co/docs/huggingface_hub/quick-start#authentication). Kimlik doğrulamayı devre dışı bırakmak için `False` geçirin. **Hata:** `BadRequestError` - `BadRequestError` -- Space statik bir Space ise (statik Spaces'te volume desteklenmez). Bir Space için ses seviyelerini ayarlayın. Sets (veya değiştirir) Space'te bağlanan birimlerin listesini. Her birim, Space'in konteynerine bir Hub kaynağına (model, veri seti veya depolama kovası) erişim sağlar. Örnek: ```python >>> from huggingface_hub import HfApi, Volume >>> api = HfApi() >>> api.set_space_volumes( ... "username/my-space", ... volumes=[ ... Volume(type="model", source="username/my-model", mount_path="/models", read_only=True), ... Volume(type="bucket", source="username/my-bucket", mount_path="/data"), ... ], ... ) ``` #### snapshot_download[[huggingface_hub.HfApi.snapshot_download]] ```python snapshot_download(repo_id: str, repo_type: str | None = None, revision: str | None = None, cache_dir: str | Path | None = None, local_dir: str | Path | None = None, etag_timeout: float = 10, force_download: bool = False, token: bool | str | None = None, local_files_only: bool = False, allow_patterns: list[str] | str | None = None, ignore_patterns: list[str] | str | None = None, max_workers: int = 8, tqdm_class: type[base_tqdm] | None = None, dry_run: bool = False) ``` [Kaynak](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L6546) **Parametreler:** repo_id (`str`) : `/` ile ayrılmış bir kullanıcı veya kuruluş adı ve bir depo adı. repo_type (`str`, *isteğe bağlı*) : Bir veri setinden veya uzaydan indiriliyorsa `"dataset"` veya `"space"` olarak, bir modelden indiriliyorsa `None` veya `"model"` olarak ayarlayın. Varsayılan değer `None`'dir. revision (`str`, *isteğe bağlı*) : Bir dal adı, etiket veya commit hash'i olabilen isteğe bağlı bir Git revizyon kimliği. cache_dir (`str`, `Path`, *isteğe bağlı*) : Önbelleğe alınan dosyaların saklandığı klasörün yolu. local_dir (`str` veya `Path`, *isteğe bağlı*) : Verilirse, indirilen dosyalar bu dizinin altına yerleştirilir. etag_timeout (`float`, *isteğe bağlı*, varsayılan `10`) : ETag alınırken, `httpx2.request`'e iletilen, sunucunun veri göndermesini bekleme süresi (saniye cinsinden); bu süre dolunca denemeden vazgeçilir. force_download (`bool`, *isteğe bağlı*, varsayılan `False`) : Dosya yerel önbellekte zaten varsa bile indirilip indirilmeyeceği. token (`bool` veya `str`, *isteğe bağlı*) : Geçerli bir kullanıcı erişim belirteci (dize). Varsayılan olarak, kimlik doğrulama için önerilen yöntem olan yerel olarak kaydedilmiş belirteç kullanılır (bkz. https://huggingface.co/docs/huggingface_hub/quick-start#authentication). Kimlik doğrulamayı devre dışı bırakmak için `False` geçirin. local_files_only (`bool`, *isteğe bağlı*, varsayılan `False`) : `True` ise, dosyanın indirilmesini engeller ve varsa yerel önbellekteki dosyanın yolunu döndürür. allow_patterns (`list[str]` veya `str`, *isteğe bağlı*) : Verilirse, en az bir desenle eşleşen dosyalar indirilir. ignore_patterns (`list[str]` veya `str`, *isteğe bağlı*) : Verilirse, desenlerden herhangi biriyle eşleşen dosyalar indirilmez. max_workers (`int`, *isteğe bağlı*) : Dosyaları indirmek için kullanılacak eşzamanlı iş parçacığı sayısı (1 iş parçacığı = 1 dosya indirme). Varsayılan değer 8'dir. tqdm_class (`tqdm`, *isteğe bağlı*) : Verildiğinde, ilerleme çubuğu için varsayılan davranışı yazar. Geçirilen argüman `tqdm.auto.tqdm` sınıfından türemeli veya en azından davranışını taklit etmelidir. `tqdm_class`'in her bireysel indirmeye geçirilmediğine dikkat edin. `HF_HUB_DISABLE_PROGRESS_BARS` ortam değişkeni ayarlanarak devre dışı bırakılabilen özel HF ilerleme çubuğu varsayılandır. dry_run (`bool`, *isteğe bağlı*, varsayılan `False`) : `True` ise, dosyaları gerçekten indirmeden kuru bir çalışma (dry run) gerçekleştirir. İndirilecekler hakkında bilgi içeren [DryRunFileInfo](/docs/huggingface_hub/v2.4.0/tr/package_reference/hf_api#huggingface_hub.DryRunFileInfo) nesnelerinin listesini döndürür. **Dönüş:** `str` veya [DryRunFileInfo](/docs/huggingface_hub/v2.4.0/tr/package_reference/hf_api#huggingface_hub.DryRunFileInfo) listesi - `dry_run=False` ise: Depo anlık görüntüsünün klasör yolu. - `dry_run=True` ise: İndirme bilgilerini içeren [DryRunFileInfo](/docs/huggingface_hub/v2.4.0/tr/package_reference/hf_api#huggingface_hub.DryRunFileInfo) nesnelerinden oluşan bir liste. **Yükselen:** [RepositoryNotFoundError](/docs/huggingface_hub/v2.4.0/tr/package_reference/utilities#huggingface_hub.errors.RepositoryNotFoundError) veya [RevisionNotFoundError](/docs/huggingface_hub/v2.4.0/tr/package_reference/utilities#huggingface_hub.errors.RevisionNotFoundError) veya ``EnvironmentError`` veya ``OSError`` veya ``ValueError`` - [RepositoryNotFoundError](/docs/huggingface_hub/v2.4.0/tr/package_reference/utilities#huggingface_hub.errors.RepositoryNotFoundError) -- İndirilecek depo bulunamadığında. Bunun nedeni, deponun var olmaması veya `private` olarak ayarlanmış olması ve erişiminizin bulunmaması olabilir. - [RevisionNotFoundError](/docs/huggingface_hub/v2.4.0/tr/package_reference/utilities#huggingface_hub.errors.RevisionNotFoundError) -- İndirilecek revizyon bulunamadığında. - [`EnvironmentError`](https://docs.python.org/3/library/exceptions.html#EnvironmentError) -- `token=True` ise ve token bulunamazsa. - [`OSError`](https://docs.python.org/3/library/exceptions.html#OSError) -- ETag belirlenemezse. - [`ValueError`](https://docs.python.org/3/library/exceptions.html#ValueError) -- bazı parametre değeri geçersizse. Depo dosyalarını indirin. Belirtilen revizyonda bir depodaki dosyaların tamamını içeren bir anlık görüntüyü indirir. Bir depodaki tüm dosyalara ihtiyacınız olduğunda, önceden hangi dosyaların gerekli olacağını bilmediğiniz durumlarda bu işe yarar. Tüm dosyalar, o klasöre göre gerçek dosya adlarını korumak amacıyla bir klasörün içine yerleştirilir. `allow_patterns` ve `ignore_patterns` kullanarak indirilecek dosyaları filtreleyebilirsiniz. `local_dir` sağlanırsa, depodaki dosya yapısı bu konumda yeniden oluşturulur. Bu seçenek kullanıldığında `cache_dir` kullanılmaz ve indirilen dosyalarla ilgili bazı meta verileri depolamak için `local_dir` kökünde bir `.cache/huggingface/` klasörü oluşturulur. Bu mekanizma ana önbellek sistemi kadar sağlam olmasa da, bir deponun en son sürümünü düzenli olarak çekmek için optimize edilmiştir. Alternatif olarak depoyu klonlamak mümkündür ancak bunun için git ve git-lfs'in yüklü ve doğru şekilde yapılandırılmış olması gerekir. Ayrıca git kullanarak bir depoyu klonlarken indirilecek dosyaları filtrelemek mümkün değildir. #### space_info[[huggingface_hub.HfApi.space_info]] ```python space_info(repo_id: str, revision: str | None = None, timeout: float | None = None, files_metadata: bool = False, expand: list[ExpandSpaceProperty_T] | None = None, token: bool | str | None = None) ``` [Kaynak](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L3359) **Parametreler:** repo_id (`str`) : `/` ile ayrılmış bir ad alanı (kullanıcı veya kuruluş) ve bir depo adı. revision (`str`, *isteğe bağlı*) : Bilgilerin alınacağı space deposunun revizyonu. timeout (`float`, *isteğe bağlı*) : Hub'a yapılan istek için bir zaman aşımı ayarlanıp ayarlanmayacağı. files_metadata (`bool`, *isteğe bağlı*) : Depodaki dosyalar için (boyut, LFS meta verisi vb.) meta verilerin alınıp alınmayacağını belirtir. Varsayılan değeri `False`'dir. expand (`list[ExpandSpaceProperty_T]`, *isteğe bağlı*) : Yanıtta döndürülecek özellik listesi. Kullanıldığında, yalnızca listedeki özellikler döndürülür. `full` parametresi geçirildiğinde bu parametre kullanılamaz. Olası değerler `"author"`, `"cardData"`, `"createdAt"`, `"datasets"`, `"disabled"`, `"lastModified"`, `"likes"`, `"models"`, `"private"`, `"region"`, `"runtime"`, `"sdk"`, `"siblings"`, `"sha"`, `"subdomain"`, `"tags"`, `"trendingScore"`, `"usedStorage"` ve `"resourceGroup"`'dir. token (`bool` veya `str`, *isteğe bağlı*) : Geçerli bir kullanıcı erişim belirteci (dize). Varsayılan olarak, kimlik doğrulama için önerilen yöntem olan yerel olarak kaydedilmiş belirteç kullanılır (bkz. https://huggingface.co/docs/huggingface_hub/quick-start#authentication). Kimlik doğrulamayı devre dışı bırakmak için `False` geçirin. **Dönüş:** [SpaceInfo](/docs/huggingface_hub/v2.4.0/tr/package_reference/hf_api#huggingface_hub.SpaceInfo) Space deposu bilgileri. huggingface.co'daki belirli bir Space hakkında bilgi alın. Geçerli bir token iletirseniz Space özel olabilir. > [!TIP] > Aşağıdaki hataları oluşturur: > > - [RepositoryNotFoundError](/docs/huggingface_hub/v2.4.0/tr/package_reference/utilities#huggingface_hub.errors.RepositoryNotFoundError) İndirilecek depo bulunamazsa. Bunun nedeni, deponun var olmaması veya `private` olarak ayarlanmış olması ve erişiminizin bulunmaması olabilir. - [RevisionNotFoundError](/docs/huggingface_hub/v2.4.0/tr/package_reference/utilities#huggingface_hub.errors.RevisionNotFoundError) İndirilecek revizyon bulunamazsa. #### super_squash_history[[huggingface_hub.HfApi.super_squash_history]] ```python super_squash_history(repo_id: str, branch: str | None = None, commit_message: str | None = None, repo_type: str | None = None, token: str | bool | None = None) ``` [Kaynak](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L4346) **Parametreler:** repo_id (`str`) : `/` ile ayrılmış bir ad alanı (kullanıcı veya kuruluş) ve bir depo adı. branch (`str`, *isteğe bağlı*) : Birleştirilecek dal. Varsayılan olarak `"main"` dalının başıdır. commit_message (`str`, *isteğe bağlı*) : Birleştirilmiş (squashed) commit için kullanılacak commit mesajı. repo_type (`str`, *isteğe bağlı*) : Bir veri setinden veya Space'ten commit'leri listeliyorsanız `"dataset"` veya `"space"` olarak, bir modelden listeliyorsanız `None` veya `"model"` olarak ayarlayın. Varsayılan değer `None`'dir. token (`bool` veya `str`, *isteğe bağlı*) : Geçerli bir kullanıcı erişim belirteci (dize). Varsayılan olarak, kimlik doğrulama için önerilen yöntem olan yerel olarak kaydedilmiş belirteç kullanılır (bkz. https://huggingface.co/docs/huggingface_hub/quick-start#authentication). Kimlik doğrulamayı devre dışı bırakmak için `False` geçirin. **Yükseltir:** [RepositoryNotFoundError](/docs/huggingface_hub/v2.4.0/tr/package_reference/utilities#huggingface_hub.errors.RepositoryNotFoundError) veya [RevisionNotFoundError](/docs/huggingface_hub/v2.4.0/tr/package_reference/utilities#huggingface_hub.errors.RevisionNotFoundError) veya [BadRequestError](/docs/huggingface_hub/v2.4.0/tr/package_reference/utilities#huggingface_hub.errors.BadRequestError) - [RepositoryNotFoundError](/docs/huggingface_hub/v2.4.0/tr/package_reference/utilities#huggingface_hub.errors.RepositoryNotFoundError) -- Depo bulunamadıysa (hata 404): repo_id/repo_type yanlış, özel ama kimlik doğrulaması yapılmamış veya depo mevcut değil. - [RevisionNotFoundError](/docs/huggingface_hub/v2.4.0/tr/package_reference/utilities#huggingface_hub.errors.RevisionNotFoundError) -- Squash edilecek dal bulunamazsa. - [BadRequestError](/docs/huggingface_hub/v2.4.0/tr/package_reference/utilities#huggingface_hub.errors.BadRequestError) -- Geçersiz bir branch referansı. Tag'lerde geçmiş sıkıştırılamaz. Hub'daki bir repoda bir dal için commit geçmişini birleştirin. Depo geçmişini sıkıştırmak, yüzlerce commit yapacağınızı biliyorsanız ve geçmişi dağınık hale getirmek istemiyorsanız faydalıdır. Commit'leri sıkıştırmak yalnızca bir branch'in başından (head) yapılabilir. > [!WARNING] > Sıkıştırıldıktan sonra, commit geçmişi geri alınamaz. Bu, geri alınamaz bir işlemdir. > [!WARNING] > Bir dalın geçmişi birleştirildikten (squash) sonra, geçmişleri ayrıldığı için başka bir dala geri birleştirilemez. Örnek: ```py >>> from huggingface_hub import HfApi >>> api = HfApi() # Create repo >>> repo_id = api.create_repo("test-squash").repo_id # Make a lot of commits. >>> api.upload_file(repo_id=repo_id, path_in_repo="file.txt", path_or_fileobj=b"content") >>> api.upload_file(repo_id=repo_id, path_in_repo="lfs.bin", path_or_fileobj=b"content") >>> api.upload_file(repo_id=repo_id, path_in_repo="file.txt", path_or_fileobj=b"another_content") # Squash history >>> api.super_squash_history(repo_id=repo_id) ``` #### suspend_scheduled_job[[huggingface_hub.HfApi.suspend_scheduled_job]] ```python suspend_scheduled_job(scheduled_job_id: str, namespace: str | None = None, token: bool | str | None = None) ``` [Kaynak](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L13354) **Parametreler:** scheduled_job_id (`str`) : Planlanan Job'un kimliği. namespace (`str`, *isteğe bağlı*) : Planlanan Job'un bulunduğu ad alanı. Varsayılan olarak mevcut kullanıcının ad alanıdır. token (`bool` veya `str`, *isteğe bağlı*) : Geçerli bir kullanıcı erişim belirteci. Sağlanmazsa, önerilen kimlik doğrulama yöntemi olan yerel olarak kaydedilmiş belirteç kullanılır. Kimlik doğrulamayı devre dışı bırakmak için `False` olarak ayarlayın. Aşağıdaki bağlantıya bakın: https://huggingface.co/docs/huggingface_hub/quick-start#authentication. Suspend (pause) Hugging Face altyapısında planlanmış bir compute Job. #### sync_bucket[[huggingface_hub.HfApi.sync_bucket]] ```python sync_bucket(source: str | None = None, dest: str | None = None, delete: bool = False, ignore_times: bool = False, ignore_sizes: bool = False, existing: bool = False, ignore_existing: bool = False, include: list[str] | None = None, exclude: list[str] | None = None, filter_from: str | None = None, plan: str | None = None, apply: str | None = None, dry_run: bool = False, verbose: bool = False, quiet: bool = False, token: bool | str | None = None) ``` [Kaynak](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L15207) **Parametreler:** source (*str*, *isteğe bağlı*) : Kaynak yolu: yerel dizin veya `hf://buckets/namespace/bucket_name(/prefix)`. `apply` kullanılmadıkça zorunludur. dest (*str*, *isteğe bağlı*) : Hedef yol: yerel dizin veya `hf://buckets/namespace/bucket_name(/prefix)`. `apply` kullanılmadıkça zorunludur. delete (*bool*, *opsiyonel*, varsayılan *False*) : Kaynakta bulunmayan hedef dosyaları siler. ignore_times (*bool*, *opsiyonel*, varsayılan *False*) : Dosyaları yalnızca boyutlarına göre atlayın, değişiklik zamanlarını yok sayın. ignore_sizes (*bool*, *opsiyonel*, varsayılan *False*) : Dosyaları yalnızca değiştirilme zamanlarına göre atlayın, boyutları yok sayın. existing (*bool*, *opsiyonel*, varsayılan *False*) : Alıcıda yeni dosya oluşturmaktan kaçının (yalnızca mevcut dosyaları güncelleyin). ignore_existing (*bool*, *opsiyonel*, varsayılan *False*) : Alıcıda zaten var olan dosyaların güncellenmesini atlayın (yalnızca yeni dosyalar oluşturun). include (*list[str]*, *opsiyonel*) : Desenlerle eşleşen dosyaları dahil edin (fnmatch tarzı). exclude (*list[str]*, *opsiyonel*) : Desenlerle eşleşen dosyaları hariç tutar (fnmatch tarzı). filter_from (*str*, *opsiyonel*) : Dahil et/dışla kuralları içeren bir filtre dosyasının yolu. plan (*str*, *opsiyonel*) : Senkronizasyon planını çalıştırmak yerine bu JSONL dosyasına kaydet. apply (*str*, *isteğe bağlı*) : Daha önce kaydedilmiş bir plan dosyasını uygular. Ayarlandığında `source` ve `dest` gerekmez. dry_run (*bool*, *opsiyonel*, varsayılan *False*) : Senkronizasyon planını çalıştırmadan stdout'a JSONL olarak yazdırır. verbose (*bool*, *opsiyonel*, varsayılan *False*) : Dosya başına ayrıntılı işlemleri gösterir. quiet (*bool*, *opsiyonel*, varsayılan *False*) : Tüm çıktıları ve ilerleme çubuklarını bastırır. token (Union[bool, str, None], isteğe bağlı) : Geçerli bir kullanıcı erişim belirteci. Sağlanmazsa, yerel olarak kaydedilmiş belirteç kullanılır. **Dönüş:** [*SyncPlan*] Hesaplanan (veya yüklenen) senkronizasyon planı. Yerel bir dizin ile bir varlık kovası (bucket) arasındaki dosyaları senkronize edin. Bu, `hf buckets sync` komut satırı komutuna eşdeğerdir. `source` veya `dest` parametrelerinden biri bir bucket yolu (`hf://buckets/...`) ve diğeri bir yerel dizin yolu olmalıdır. Örnek: ```python >>> from huggingface_hub import HfApi >>> api = HfApi() # Upload local directory to bucket >>> api.sync_bucket("./data", "hf://buckets/username/my-bucket") # Download bucket to local directory >>> api.sync_bucket("hf://buckets/username/my-bucket", "./data") # Sync with delete and filtering >>> api.sync_bucket( ... "./data", ... "hf://buckets/username/my-bucket", ... delete=True, ... include=["*.safetensors"], ... ) # Dry run: preview what would be synced >>> plan = api.sync_bucket("./data", "hf://buckets/username/my-bucket", dry_run=True) >>> plan.summary() &lcub;'uploads': 3, 'downloads': 0, 'deletes': 0, 'skips': 1, 'total_size': 4096} # Save plan for review, then apply >>> api.sync_bucket("./data", "hf://buckets/username/my-bucket", plan="sync-plan.jsonl") >>> api.sync_bucket(apply="sync-plan.jsonl") ``` #### sync_job_volume[[huggingface_hub.HfApi.sync_job_volume]] ```python sync_job_volume(source: str | Path, mount_path: str, remote_name: str | None = None, read_only: bool = True, namespace: str | None = None, token: bool | str | None = None) ``` [Kaynak](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L13857) **Parametreler:** source (`str` veya `Path`) : Senkronize edilecek yerel dizinin yolu. mount_path (`str`) : İş (Job) konteyneri içindeki bağlama yolu, örn. `"/inputs"`. `/` ile başlamalıdır. remote_name (`str`, *isteğe bağlı*) : Senkronize edilecek bucket alt klasörünün adı. Varsayılan olarak, kaynak yolundan ve makinenin ana bilgisayar adından türetilen bir `{dirname}-{hash}` adı kullanılır. read_only (`bool`, *isteğe bağlı*, varsayılan `True`) : Hacmi, Job'da salt okunur olarak bağlar. Job'un bucket klasörüne geri yazabilmesi için `False` geçin (ör. çıktıları daha sonra [sync_bucket()](/docs/huggingface_hub/v2.4.0/tr/package_reference/hf_api#huggingface_hub.HfApi.sync_bucket) ile almak için). namespace (`str`, *isteğe bağlı*) : `jobs-artifacts` kovasını (bucket) barındıran ad alanı (namespace). Varsayılan olarak mevcut kullanıcının ad alanıdır. Hacmi (volume) bağlayacak İş (Job) ile aynı ad alanını kullanın. token (`Union[bool, str, None]`, *isteğe bağlı*) : Geçerli bir kullanıcı erişim belirteci. Sağlanmazsa, önerilen kimlik doğrulama yöntemi olan yerel olarak kaydedilmiş belirteç kullanılır. Kimlik doğrulamayı devre dışı bırakmak için `False` olarak ayarlayın. Aşağıdaki bağlantıya bakın: https://huggingface.co/docs/huggingface_hub/quick-start#authentication. **Dönüş:** [Volume](/docs/huggingface_hub/v2.4.0/tr/package_reference/jobs#huggingface_hub.Volume) Senkronize alt klasöre göre kapsamlandırılmış bir bucket hacmi, [run_job()](/docs/huggingface_hub/v2.4.0/tr/package_reference/hf_api#huggingface_hub.HfApi.run_job), [run_uv_job()](/docs/huggingface_hub/v2.4.0/tr/package_reference/hf_api#huggingface_hub.HfApi.run_uv_job), [create_scheduled_job()](/docs/huggingface_hub/v2.4.0/tr/package_reference/hf_api#huggingface_hub.HfApi.create_scheduled_job) veya [create_scheduled_uv_job()](/docs/huggingface_hub/v2.4.0/tr/package_reference/hf_api#huggingface_hub.HfApi.create_scheduled_uv_job) içindeki `volumes` listesine aktarılacak. Yerel bir dizini bir kovaya (bucket) eşitleyin ve bir İş (Job) içinde bağlanmaya hazır bir [Volume](/docs/huggingface_hub/v2.4.0/tr/package_reference/jobs#huggingface_hub.Volume) döndürün. Dosyalar, [sync_bucket()](/docs/huggingface_hub/v2.4.0/tr/package_reference/hf_api#huggingface_hub.HfApi.sync_bucket) ile aynı senkronizasyon mantığını kullanarak `{namespace}/jobs-artifacts` varlığının bir alt klasörüne yüklenir (otomatik olarak özel olarak oluşturulur; zaten var ve herkese açıksa bir uyarı yayılır): aynı dizinin yeniden senkronize edilmesi yalnızca yeni veya değiştirilmiş dosyaları yükler. Varsayılan olarak alt klasör adı, dizin yolundan ve makinenin ana bilgisayar adından türetilir, böylece aynı dizinden yapılan tekrarlayan çağrılar aynı uzak klasörü yeniden kullanır. Bunun yerine sabit bir ad kullanmak için `remote_name` parametresini iletin. Verinin canlı olarak bağlanmadığını, kovaya *kopyalandığını* unutmayın: senkronizasyon sonrası yerel olarak yapılan değişiklikler Job tarafından görünmez (güncellemek için `sync_job_volume` komutunu yeniden çalıştırın) ve hacim varsayılan olarak salt okunur olarak bağlanır. Bir Job tarafından salt okunur-yazılır bir hacme yazılan verileri almak için kovadaki klasörü [sync_bucket()](/docs/huggingface_hub/v2.4.0/tr/package_reference/hf_api#huggingface_hub.HfApi.sync_bucket) ile geri senkronize edin. Kaynak dizin boşsa (ör. bir çıktı dizini), hacmin yine de bağlanabilmesi için bir yer tutucu `.keep` dosyası yüklenir. Örnek: ```python >>> from huggingface_hub import run_uv_job, sync_job_volume # Upload ./training-data once, then run multiple jobs against it >>> volume = sync_job_volume("./training-data", "/data") >>> run_uv_job("train.py", script_args=["--learning-rate", "0.01"], volumes=[volume]) >>> run_uv_job("train.py", script_args=["--learning-rate", "0.05"], volumes=[volume]) # Read-write volume to retrieve outputs after the job completes >>> volume = sync_job_volume("./outputs", "/outputs", read_only=False) >>> job = run_uv_job("process.py", volumes=[volume]) ``` #### trigger_scheduled_job[[huggingface_hub.HfApi.trigger_scheduled_job]] ```python trigger_scheduled_job(scheduled_job_id: str, namespace: str | None = None, token: bool | str | None = None) ``` [Kaynak](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L13466) **Parametreler:** scheduled_job_id (`str`) : Planlanan Job'un kimliği. namespace (`str`, *isteğe bağlı*) : Planlanan Job'un bulunduğu ad alanı. Varsayılan olarak mevcut kullanıcının ad alanıdır. token (`bool` veya `str`, *isteğe bağlı*) : Geçerli bir kullanıcı erişim belirteci. Sağlanmazsa, önerilen kimlik doğrulama yöntemi olan yerel olarak kaydedilmiş belirteç kullanılır. Kimlik doğrulamayı devre dışı bırakmak için `False` olarak ayarlayın. Aşağıdaki bağlantıya bakın: https://huggingface.co/docs/huggingface_hub/quick-start#authentication. **Dönüş:** [JobInfo](/docs/huggingface_hub/v2.4.0/tr/package_reference/jobs#huggingface_hub.JobInfo) Tetiklenen çalışmaya dair bilgi. **Yükselen:** [HfHubHTTPError](/docs/huggingface_hub/v2.4.0/tr/package_reference/utilities#huggingface_hub.errors.HfHubHTTPError) - [HfHubHTTPError](/docs/huggingface_hub/v2.4.0/tr/package_reference/utilities#huggingface_hub.errors.HfHubHTTPError) -- başka bir örnek zaten çalışıyorsa ve zamanlanmış işte `concurrency` devre dışıysa HTTP 409. Planlanmış bir Job'ı derhal çalıştırmak için tetikleyin. Bu, zamanlanmış işin spec'ini bir kez derhal çalıştırır. Zamanlamayı **değiştirmez** ve bir sonraki zamanlanmış çalışmayı **etkilemez**. Bir örnek zaten çalışıyorsa ve zamanlanmış iş eşzamanlı çalıştırmalara izin vermiyorsa, istek reddedilir (HTTP 409). #### farklı olarak[[huggingface_hub.HfApi.unlike]] ```python unlike(repo_id: str, token: bool | str | None = None, repo_type: str | None = None) ``` [Kaynak](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L2937) **Parametreler:** repo_id (`str`) : Beğenilmeyecek depo. Örnek: `"user/my-cool-model"`. token (`bool` veya `str`, *isteğe bağlı*) : Geçerli bir kullanıcı erişim belirteci (dize). Varsayılan olarak, kimlik doğrulama için önerilen yöntem olan yerel olarak kaydedilmiş belirteç kullanılır (bkz. https://huggingface.co/docs/huggingface_hub/quick-start#authentication). Kimlik doğrulamayı devre dışı bırakmak için `False` geçirin. repo_type (`str`, *isteğe bağlı*) : Bir veri seti veya alanın bağlantısı kaldırılıyorsa `"dataset"` veya `"space"` olarak, bir modelin bağlantısı kaldırılıyorsa `None` veya `"model"` olarak ayarlayın. Varsayılan değer `None`'dir. **Yükselen:** [RepositoryNotFoundError](/docs/huggingface_hub/v2.4.0/tr/package_reference/utilities#huggingface_hub.errors.RepositoryNotFoundError) - [RepositoryNotFoundError](/docs/huggingface_hub/v2.4.0/tr/package_reference/utilities#huggingface_hub.errors.RepositoryNotFoundError) -- Depo bulunamadıysa (hata 404): repo_id/repo_type yanlış, özel ama kimlik doğrulaması yapılmamış veya depo mevcut değil. Hub'daki belirli bir repodan farklı olarak (ör. favori listesinden kaldır). Spam kullanımını önlemek için bir betikten bir depoya `like` gönderilemez. Ayrıca [list_liked_repos()](/docs/huggingface_hub/v2.4.0/tr/package_reference/hf_api#huggingface_hub.HfApi.list_liked_repos) bkz. Örnek: ```python >>> from huggingface_hub import list_liked_repos, unlike >>> "gpt2" in list_liked_repos().models # we assume you have already liked gpt2 True >>> unlike("gpt2") >>> "gpt2" in list_liked_repos().models False ``` #### update_bucket_settings[[huggingface_hub.HfApi.update_bucket_settings]] ```python update_bucket_settings(bucket_id: str, private: bool, token: bool | str | None = None) ``` [Kaynak](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L14256) **Parametreler:** bucket_id (`str`) : Kovanın kimliği (ör. `"username/my-bucket"`). private (`bool`) : Kovanın özel olarak oluşturulup oluşturulmayacağı. token (`bool` veya `str`, *isteğe bağlı*) : Geçerli bir kullanıcı erişim belirteci (dize). Varsayılan olarak, kimlik doğrulama için önerilen yöntem olan yerel olarak kaydedilmiş belirteç kullanılır (bkz. https://huggingface.co/docs/huggingface_hub/quick-start#authentication). Kimlik doğrulamayı devre dışı bırakmak için `False` geçirin. **Yükselen:** `BucketNotFoundError` veya ``or`` - `BucketNotFoundError` -- Bucket bulunamadığında. Bunun nedeni, bucket'ın var olmaması olabilir, - ``or`` -- çünkü `private` olarak ayarlanmış ve erişiminiz yok. Hub'da bir varlığın ayarlarını güncelleyin. Şu anda desteklenen tek ayar, varlığın görünürlüğüdür. Örnek: ```python >>> from huggingface_hub import update_bucket_settings >>> # Make a bucket public >>> update_bucket_settings(bucket_id="Wauplin/first-bucket", private=False) >>> # Make it private again >>> update_bucket_settings(bucket_id="Wauplin/first-bucket", private=True) ``` #### update_collection_item[[huggingface_hub.HfApi.update_collection_item]] ```python update_collection_item(collection_slug: str, item_object_id: str, note: str | None = None, position: int | None = None, token: bool | str | None = None) ``` [Kaynak](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L10495) **Parametreler:** collection_slug (`str`) : Güncellenecek koleksiyonun slug'ı. Örnek: `"TheBloke/recent-models-64f9a55bb3115b4f513ec026"`. item_object_id (`str`) : Koleksiyondaki öğenin kimliği. Bu, Hub'daki öğenin kimliği (repo_id veya makale kimliği) değildir. [CollectionItem](/docs/huggingface_hub/v2.4.0/tr/package_reference/collections#huggingface_hub.CollectionItem) nesnesinden alınmalıdır. Örnek: `collection.items[0].item_object_id`. note (`str`, *isteğe bağlı*) : Koleksiyondaki öğeye eklemek için bir not. Bir notun maksimum boyutu 500 karakterdir. position (`int`, *isteğe bağlı*) : Öğenin koleksiyondaki yeni konumu. token (`bool` veya `str`, *isteğe bağlı*) : Geçerli bir kullanıcı erişim belirteci (dize). Varsayılan olarak, kimlik doğrulama için önerilen yöntem olan yerel olarak kaydedilmiş belirteç kullanılır (bkz. https://huggingface.co/docs/huggingface_hub/quick-start#authentication). Kimlik doğrulamayı devre dışı bırakmak için `False` geçirin. Bir koleksiyondaki öğeyi günceller. Örnek: ```py >>> from huggingface_hub import get_collection, update_collection_item # Get collection first >>> collection = get_collection("TheBloke/recent-models-64f9a55bb3115b4f513ec026") # Update item based on its ID (add note + update position) >>> update_collection_item( ... collection_slug="TheBloke/recent-models-64f9a55bb3115b4f513ec026", ... item_object_id=collection.items[-1].item_object_id, ... note="Newly updated model!", ... position=0, ... ) ``` #### update_collection_metadata[[huggingface_hub.HfApi.update_collection_metadata]] ```python update_collection_metadata(collection_slug: str, title: str | None = None, description: str | None = None, position: int | None = None, private: bool | None = None, theme: str | None = None, token: bool | str | None = None) ``` [Kaynak](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L10265) **Parametreler:** collection_slug (`str`) : Güncellenecek koleksiyonun slug'ı. Örnek: `"TheBloke/recent-models-64f9a55bb3115b4f513ec026"`. title (`str`) : Güncellenecek koleksiyonun başlığı. description (`str`, *isteğe bağlı*) : Güncellenecek koleksiyonun açıklaması. Bir açıklama için maksimum boyut 150 karakterdir. position (`int`, *isteğe bağlı*) : Kullanıcının koleksiyonları listesinde koleksiyonun yeni konumu. private (`bool`, *isteğe bağlı*) : Koleksiyonun özel olup olmaması. theme (`str`, *isteğe bağlı*) : Hub'daki koleksiyonun teması. token (`bool` veya `str`, *isteğe bağlı*) : Geçerli bir kullanıcı erişim belirteci (dize). Varsayılan olarak, kimlik doğrulama için önerilen yöntem olan yerel olarak kaydedilmiş belirteç kullanılır (bkz. https://huggingface.co/docs/huggingface_hub/quick-start#authentication). Kimlik doğrulamayı devre dışı bırakmak için `False` geçirin. Hub'daki bir koleksiyonun meta verilerini günceller. Tüm argümanlar isteğe bağlıdır. Yalnızca sağlanan meta veriler güncellenir. Dönüş: [Collection](/docs/huggingface_hub/v2.4.0/tr/package_reference/collections#huggingface_hub.Collection) Örnek: ```py >>> from huggingface_hub import update_collection_metadata >>> collection = update_collection_metadata( ... collection_slug="username/iccv-2023-64f9a55bb3115b4f513ec026", ... title="ICCV Oct. 2023", ... description="Portfolio of models, datasets, papers and demos I presented at ICCV Oct. 2023", ... private=False, ... theme="pink", ... ) >>> collection.slug "username/iccv-oct-2023-64f9a55bb3115b4f513ec026" # ^collection slug got updated but not the trailing ID ``` #### update_collection_resource_group[[huggingface_hub.HfApi.update_collection_resource_group]] ```python update_collection_resource_group(collection_slug: str, resource_group_id: str | None, token: bool | str | None = None) ``` [Kaynak](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L10333) **Parametreler:** collection_slug (`str`) : Güncellenecek koleksiyonun slug'ı. Örnek: `"TheBloke/recent-models-64f9a55bb3115b4f513ec026"`. resource_group_id (`str` veya `None`) : Koleksiyonun atanacağı kaynak grubu, 24 karakterli onaltılık bir dize olarak. `None` ise, koleksiyon herhangi bir kaynak grubundan kaldırılır. token (`bool` veya `str`, *isteğe bağlı*) : Geçerli bir kullanıcı erişim belirteci (dize). Varsayılan olarak, kimlik doğrulama için önerilen yöntem olan yerel olarak kaydedilmiş belirteç kullanılır (bkz. https://huggingface.co/docs/huggingface_hub/quick-start#authentication). Kimlik doğrulamayı devre dışı bırakmak için `False` geçirin. Bir koleksiyonu bir kaynak grubuna atayın veya herhangi bir kaynak grubundan kaldırın. Yalnızca organizasyona ait koleksiyonlar için geçerlidir. Örnek: ```py >>> from huggingface_hub import update_collection_resource_group >>> update_collection_resource_group( ... collection_slug="my-org/iccv-2023-64f9a55bb3115b4f513ec026", ... resource_group_id="66980ecfc1e12a49c8f0e42d", ... ) ``` #### update_inference_endpoint[[huggingface_hub.HfApi.update_inference_endpoint]] ```python update_inference_endpoint(name: str, accelerator: str | None = None, instance_size: str | None = None, instance_type: str | None = None, min_replica: int | None = None, max_replica: int | None = None, scale_to_zero_timeout: int | None = None, scaling_metric: InferenceEndpointScalingMetric | None = None, scaling_threshold: float | None = None, repository: str | None = None, framework: str | None = None, revision: str | None = None, task: str | None = None, custom_image: dict | None = None, container_command: list[str] | None = None, container_args: list[str] | None = None, tensor_parallel_size: int | None = None, data_parallel_size: int | None = None, env: dict[str, str] | None = None, secrets: dict[str, str] | None = None, domain: str | None = None, path: str | None = None, cache_http_responses: bool | None = None, tags: list[str] | None = None, namespace: str | None = None, token: bool | str | None = None) ``` [Kaynak](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L9706) **Parametreler:** name (`str`) : Güncellenecek Inference Endpoint'in adı. accelerator (`str`, *isteğe bağlı*) : Çıkarım için kullanılacak donanım hızlandırıcısı (ör. `"cpu"`). instance_size (`str`, *isteğe bağlı*) : Modeli barındırmak için kullanılacak örneğin boyutu veya türü (ör. `"x4"`). instance_type (`str`, *isteğe bağlı*) : Inference Endpoint'in dağıtılacağı bulut örneği türü (ör. `"intel-icl"`). min_replica (`int`, *isteğe bağlı*) : Inference Endpoint için çalışır durumda tutulacak en az replika (örnek) sayısı. max_replica (`int`, *isteğe bağlı*) : Inference Endpoint için ölçeklenecek maksimum replika (örnek) sayısı. scale_to_zero_timeout (`int`, *isteğe bağlı*) : Pasif bir uç noktanın sıfıra ölçeklenmeden önce geçen dakika cinsinden süre. scaling_metric (`str` veya `InferenceEndpointScalingMetric `, *isteğe bağlı*) : Ölçeklendirme için metrik referansı. Verildiğinde "pendingRequests" veya "hardwareUsage" olmalıdır. Varsayılan değeri None'dır. scaling_threshold (`float`, *isteğe bağlı*) : Ölçek büyütme tetiklemek için kullanılan ölçekleme metriği eşiği. Ölçekleme metriği sağlanmadığında yok sayılır. Varsayılan değeri None'dır. repository (`str`, *isteğe bağlı*) : Inference Endpoint ile ilişkili model deposunun adı (ör. `"gpt2"`). framework (`str`, *isteğe bağlı*) : Model için kullanılan makine öğrenimi çerçevesi (ör. `"custom"`). revision (`str`, *isteğe bağlı*) : Inference Endpoint üzerinde dağıtılacak belirli model revizyonu (ör. `"6c0e6080953db56375760c0471a8c5f2929baf11"`). task (`str`, *isteğe bağlı*) : Modelin dağıtılacağı görev (ör. `"text-classification"`). custom_image (`dict`, *isteğe bağlı*) : Çalıştırılacak konteyner görüntüsü. Anahtarları görüntü varyantı olan bir sözlük (ör. `{"vLLM": {"url": "vllm/vllm-openai:v0.23.0", "port": 8000}}`, ayrıca `sGLang`, `tgi`, `tei`, `llamacpp`, `hfServe`, ...), olduğu gibi iletilir; ya da özel bir konteyneri tanımlayan düz bir sözlük (ör. `{"url": ..., "port": ...}`), `{"custom": ...}` olarak gönderilir. container_command (`list[str]`, *isteğe bağlı*) : Konteyner giriş noktası komutunu geçersiz kılar (API yükünde `model.command` alanına eşlenir). Hem yönetilen motor görüntüleriyle (ör. vLLM, SGLang) hem de özel görüntülerle çalışır. container_args (`list[str]`, *isteğe bağlı*) : Konteyner giriş noktasına eklenen argümanlar (API yükünde `model.args`'a eşlenir). Hem yönetilen motor görüntüleriyle (ör. vLLM, SGLang) hem de özel görüntülerle çalışır. tensor_parallel_size (`int`, *isteğe bağlı*) : Tek bir model kopyasının dağıtılacağı hızlandırıcı sayısı (vLLM ve SGLang görüntüleri). Motor görüntü yapılandırması içine yazılır. API, `model.image` alanını bütünüyle gerektirdiğinden, `custom_image` verilmediğinde uç noktada (endpoint) şu anda yapılandırılmış görüntü getirilir ve yerinde güncellenir. data_parallel_size (`int`, *isteğe bağlı*) : Çalıştırılacak model kopyalarının sayısı, hızlandırıcı başına bir adet (vLLM görüntüleri). `tensor_parallel_size` ile aynı işleme tabidir. env (`dict[str, str]`, *isteğe bağlı*) : Konteyner ortamına enjekte edilecek gizli olmayan ortam değişkenleri secrets (`dict[str, str]`, *isteğe bağlı*) : Konteyner ortamına enjekte edilecek gizli değerler. domain (`str`, *isteğe bağlı*) : Inference Endpoint dağıtımı için özel alan adı, yapılandırılmışsa inference endpoint bu alan adında kullanılabilir olacak (ör. `"my-new-domain.cool-website.woof"`). path (`str`, *isteğe bağlı*) : Dağıtılan modelin özel yolu, `/` ile başlamalıdır (ör. `"/models/google-bert/bert-base-uncased"`). cache_http_responses (`bool`, *isteğe bağlı*) : Inference Endpoint'ten gelen HTTP yanıtlarının önbelleğe alınıp alınmayacağını belirtir. tags (`list[str]`, *isteğe bağlı*) : Inference Endpoint ile ilişkilendirilecek etiketlerin listesi. namespace (`str`, *isteğe bağlı*) : Inference Endpoint'in güncelleneceği ad alanı. Varsayılan olarak mevcut kullanıcının ad alanıdır. token (`bool` veya `str`, *isteğe bağlı*) : Geçerli bir kullanıcı erişim belirteci (dize). Varsayılan olarak, kimlik doğrulama için önerilen yöntem olan yerel olarak kaydedilmiş belirteç kullanılır (bkz. https://huggingface.co/docs/huggingface_hub/quick-start#authentication). Kimlik doğrulamayı devre dışı bırakmak için `False` geçirin. **Dönüş:** [InferenceEndpoint](/docs/huggingface_hub/v2.4.0/tr/package_reference/inference_endpoints#huggingface_hub.InferenceEndpoint) güncellenmiş Inference Endpoint hakkında bilgi. Bir Inference Endpoint güncelleyin. Bu yöntem, hesaplama yapılandırmasının, dağıtılan modelin, rotanın veya bunların herhangi bir kombinasyonunun güncellenmesine olanak tanır. Tüm argümanlar isteğe bağlıdır ancak en az birinin sağlanması gerekir. Kolaylık olması için bir Inference Endpoint'i [InferenceEndpoint.update()](/docs/huggingface_hub/v2.4.0/tr/package_reference/inference_endpoints#huggingface_hub.InferenceEndpoint.update) kullanarak da güncelleyebilirsiniz. #### update_job_expose[[huggingface_hub.HfApi.update_job_expose]] ```python update_job_expose(job_id: str, expose: list[int] | None = None, expose_public: list[int] | None = None, namespace: str | None = None, token: bool | str | None = None) ``` [Kaynak](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L12787) **Parametreler:** job_id (`str`) : Çalışan Job'un kimliği. expose (`list[int]`, *isteğe bağlı*) : Jobs proxy üzerinden açılacak portlar. Erişim, Job'un namespace'ine okuma erişimi olan bir HF token gerektirir. expose_public (`list[int]`, *isteğe bağlı*) : Kimlik doğrulama olmadan Jobs proxy üzerinden açılacak portlar. Bunların `expose` içinde listelenmesine gerek yoktur. namespace (`str`, *isteğe bağlı*) : İşin ad alanı. Varsayılan olarak mevcut kullanıcının ad alanıdır. token (`bool` veya `str`, *isteğe bağlı*) : Kullanıcı erişim belirteci. Varsayılan olarak yerel olarak kaydedilmiş belirteç kullanılır. **Dönüş:** [JobInfo](/docs/huggingface_hub/v2.4.0/tr/package_reference/jobs#huggingface_hub.JobInfo) Güncellenmiş İş. Çalışan bir Job'ın açık portlarını yeniden çalıştırmadan değiştirin. `expose` ve `expose_public` birlikte tam port yapılandırmasını oluşturur: her iki listede de olmayan portlar kapalıdır. Tüm açık portları kapatmak için ikisini de geçmeyin. #### update_job_labels[[huggingface_hub.HfApi.update_job_labels]] ```python update_job_labels(job_id: str, labels: dict[str, str], namespace: str | None = None, token: bool | str | None = None) ``` [Kaynak](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L12828) **Parametreler:** job_id (`str`) : İşin kimliği. labels (`dict[str, str]`) : İşe ayarlanacak yeni etiketler. Mevcut tüm etiketlerin yerini alır. Hem anahtarlar hem de değerler en fazla 100 karakter olmalı ve yalnızca alfanümerik karakterler, tireler ve alt çizgiler içermelidir. namespace (`str`, *isteğe bağlı*) : Job'un çalıştığı ad alanı. Varsayılan olarak mevcut kullanıcının ad alanıdır. token (`bool` veya `str`, *isteğe bağlı*) : Geçerli bir kullanıcı erişim belirteci. Sağlanmazsa, önerilen kimlik doğrulama yöntemi olan yerel olarak kaydedilmiş belirteç kullanılır. Kimlik doğrulamayı devre dışı bırakmak için `False` olarak ayarlayın. Aşağıdaki bağlantıya bakın: https://huggingface.co/docs/huggingface_hub/quick-start#authentication. **Dönüş:** [JobInfo](/docs/huggingface_hub/v2.4.0/tr/package_reference/jobs#huggingface_hub.JobInfo) Güncellenmiş İş bilgisi. Mevcut bir Job'un etiketlerini günceller. Tüm mevcut kullanıcı sağlanan etiketleri yeni etiketlerle değiştirir. #### update_repo_settings[[huggingface_hub.HfApi.update_repo_settings]] ```python update_repo_settings(repo_id: str, gated: Literal['auto', 'manual', False] | None = None, private: bool | None = None, visibility: RepoVisibility_T | None = None, token: str | bool | None = None, repo_type: str | None = None) ``` [Kaynak](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L4838) **Parametreler:** repo_id (`str`) : Bir ad alanı (kullanıcı veya kuruluş) ve / ile ayrılmış bir depo adı. gated (`Literal["auto", "manual", False]`, *isteğe bağlı*) : Deponun kapılı durumu. `None` (varsayılan) olarak ayarlanırsa, depoyun `gated` ayarı güncellenmez. * "auto": Depo kapılıdır ve erişim istekleri, önceden tanımlanmış kriterlere göre otomatik olarak onaylanır veya reddedilir. * "manual": Depo kapılıdır ve erişim istekleri manuel onay gerektirir. * False : Depo kapılı değildir ve herkes erişebilir. private (`bool`, *isteğe bağlı*) : Deponun özel olup olmayacağı. `visibility` parametresiyle birlikte geçirilemez. visibility (`Literal["public", "private", "protected"]`, *isteğe bağlı*) : Deponun görünürlüğü. `"public"` veya `"private"` olabilir, Spaces için `"protected"` olabilir. token (`Union[str, bool, None]`, *isteğe bağlı*) : Geçerli bir kullanıcı erişim belirteci (dize). Varsayılan olarak, kimlik doğrulama için önerilen yöntem olan yerel olarak kaydedilmiş belirteç kullanılır (bkz. https://huggingface.co/docs/huggingface_hub/quick-start#authentication). Kimlik doğrulamayı devre dışı bırakmak için False geçirin. repo_type (`str`, *isteğe bağlı*) : Ayarların güncelleneceği depoyun türü (`"model"`, `"dataset"` veya `"space"`). Varsayılan olarak `"model"`. **Yükselen:** ``ValueError`` veya [HfHubHTTPError](/docs/huggingface_hub/v2.4.0/tr/package_reference/utilities#huggingface_hub.errors.HfHubHTTPError) veya [RepositoryNotFoundError](/docs/huggingface_hub/v2.4.0/tr/package_reference/utilities#huggingface_hub.errors.RepositoryNotFoundError) - [`ValueError`](https://docs.python.org/3/library/exceptions.html#ValueError) -- gated, "auto", "manual" veya False değerlerinden biri değilse. - [`ValueError`](https://docs.python.org/3/library/exceptions.html#ValueError) -- repo_type, constants.REPO_TYPES içindeki değerlerden biri değilse. - [HfHubHTTPError](/docs/huggingface_hub/v2.4.0/tr/package_reference/utilities#huggingface_hub.errors.HfHubHTTPError) -- Hugging Face Hub API'ye yapılan istek başarısız olursa. - [RepositoryNotFoundError](/docs/huggingface_hub/v2.4.0/tr/package_reference/utilities#huggingface_hub.errors.RepositoryNotFoundError) -- İndirilecek depo bulunamadığında. Bunun nedeni, deponun var olmaması veya `private` olarak ayarlanmış olması ve erişiminizin bulunmaması olabilir. Gated erişim ve görünürlük dahil olmak üzere bir depoyun ayarlarını günceller. Depoların kullanımına daha fazla kontrol sağlamak için Hub, depo yazarlarının depoları için erişim isteklerini etkinleştirmesine ve deponun görünürlüğünü değiştirmesine olanak tanır. #### update_scheduled_job_labels[[huggingface_hub.HfApi.update_scheduled_job_labels]] ```python update_scheduled_job_labels(scheduled_job_id: str, labels: dict[str, str], namespace: str | None = None, token: bool | str | None = None) ``` [Kaynak](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L13508) **Parametreler:** scheduled_job_id (`str`) : Planlanan Job'un kimliği. labels (`dict[str, str]`) : Planlanan işe ayarlanacak yeni etiketler. Mevcut tüm etiketlerin yerini alır. Hem anahtarlar hem de değerler en fazla 100 karakter olmalı ve yalnızca alfanümerik karakterler, tireler ve alt çizgiler içermelidir. namespace (`str`, *isteğe bağlı*) : Planlanan Job'un bulunduğu ad alanı. Varsayılan olarak mevcut kullanıcının ad alanıdır. token (`bool` veya `str`, *isteğe bağlı*) : Geçerli bir kullanıcı erişim belirteci. Sağlanmazsa, önerilen kimlik doğrulama yöntemi olan yerel olarak kaydedilmiş belirteç kullanılır. Kimlik doğrulamayı devre dışı bırakmak için `False` olarak ayarlayın. Aşağıdaki bağlantıya bakın: https://huggingface.co/docs/huggingface_hub/quick-start#authentication. **Dönüş:** `ScheduledJobInfo` Güncellenmiş zamanlanmış İş bilgisi. Mevcut zamanlanmış bir Job'un etiketlerini günceller. Tüm mevcut kullanıcı sağlanan etiketleri yeni etiketlerle değiştirir. #### update_scheduled_job_schedule[[huggingface_hub.HfApi.update_scheduled_job_schedule]] ```python update_scheduled_job_schedule(scheduled_job_id: str, schedule: str, namespace: str | None = None, token: bool | str | None = None) ``` [Kaynak](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L13414) **Parametreler:** scheduled_job_id (`str`) : Planlanan Job'un kimliği. schedule (`str`) : "@annually", "@yearly", "@monthly", "@weekly", "@daily", "@hourly" değerlerinden biri veya bir CRON zamanlama ifadesi (ör. her Pazartesi saat 9:00 için '0 9 * * 1'). namespace (`str`, *isteğe bağlı*) : Planlanan Job'un bulunduğu ad alanı. Varsayılan olarak mevcut kullanıcının ad alanıdır. token (`bool` veya `str`, *isteğe bağlı*) : Geçerli bir kullanıcı erişim belirteci. Sağlanmazsa, önerilen kimlik doğrulama yöntemi olan yerel olarak kaydedilmiş belirteç kullanılır. Kimlik doğrulamayı devre dışı bırakmak için `False` olarak ayarlayın. Aşağıdaki bağlantıya bakın: https://huggingface.co/docs/huggingface_hub/quick-start#authentication. **Dönüş:** `ScheduledJobInfo` Güncellenmiş zamanlanmış İş bilgisi. Mevcut zamanlanmış bir Job'un ne zaman çalışacağını değiştirin. Yalnızca zamanlama güncellenir: Job spec, etiketler ve askıya alınmış durum korunur. Zamanlamasını değiştirmeden planlanan Job'u şimdi bir kez çalıştırmak için bunun yerine [trigger_scheduled_job()](/docs/huggingface_hub/v2.4.0/tr/package_reference/hf_api#huggingface_hub.HfApi.trigger_scheduled_job) kullanın. Örnek: ```python >>> from huggingface_hub import update_scheduled_job_schedule >>> scheduled_job = update_scheduled_job_schedule(scheduled_job_id="6abb8dc9c617607c354d45f4", schedule="@daily") >>> scheduled_job.schedule '@daily' ``` #### update_webhook[[huggingface_hub.HfApi.update_webhook]] ```python update_webhook(webhook_id: str, url: str | None = None, job_id: str | None = None, watched: list[dict | WebhookWatchedItem] | None = None, domains: list[constants.WEBHOOK_DOMAIN_T] | None = None, secret: str | None = None, secrets: dict[str, str] | None = None, token: bool | str | None = None) ``` [Kaynak](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L11319) **Parametreler:** webhook_id (`str`) : Güncellenecek webhook'un benzersiz tanımlayıcısı. url (`str`, isteğe bağlı) : Yükün gönderileceği URL. job_id (`str`, isteğe bağlı) : Webhook yüküyle tetiklenecek kaynak Job'un kimliği. `secrets` ayarlanırken zorunludur. watched (`list[WebhookWatchedItem]`, optional) : İzlenecek öğelerin listesi. Kullanıcılar, kuruluşlar, modeller, veri kümeleri veya uzaylar olabilir. Daha fazla ayrıntı için [WebhookWatchedItem](/docs/huggingface_hub/v2.4.0/tr/package_reference/hf_api#huggingface_hub.WebhookWatchedItem) öğesine bakın. İzlenen öğeler düz sözlükler olarak da sağlanabilir. domains (`list[Literal["repo", "discussion"]]`, optional) : İzlenecek alanlar. Bu, "repo", "discussion" veya her ikisini içerebilir. secret (`str`, isteğe bağlı) : Yükü imzalamak için kullanılan bir gizli anahtar, ek bir güvenlik katmanı sağlar. secrets (`dict[str, str]`, optional) : Webhook tarafından tetiklenen Job için gizli ortam değişkenleri. Listelenen anahtarlar, depolanan değeri değiştirir; boş bir dize o gizli değeri kaldırır; atlanan anahtarlar ise depolanan değerlerini korur. `job_id` gerektirir. token (`bool` veya `str`, *isteğe bağlı*) : Geçerli bir kullanıcı erişim belirteci (dize). Varsayılan olarak, kimlik doğrulama için önerilen yöntem olan yerel olarak kaydedilmiş belirteç kullanılır (bkz. https://huggingface.co/docs/huggingface_hub/quick-start#authentication). Kimlik doğrulamayı devre dışı bırakmak için `False` geçirin. **Dönüş:** [WebhookInfo](/docs/huggingface_hub/v2.4.0/tr/package_reference/hf_api#huggingface_hub.WebhookInfo) Güncellenen webhook hakkında bilgi. Mevcut bir webhook'ü güncelleyin. Örnek: ```python >>> from huggingface_hub import update_webhook >>> updated_payload = update_webhook( ... webhook_id="654bbbc16f2ec14d77f109cc", ... url="https://new.webhook.site/a2176e82-5720-43ee-9e06-f91cb4c91548", ... watched=[{"type": "user", "name": "julien-c"}, {"type": "org", "name": "HuggingFaceH4"}], ... domains=["repo"], ... secret="my-secret", ... ) >>> print(updated_payload) WebhookInfo( id="654bbbc16f2ec14d77f109cc", job=None, url="https://new.webhook.site/a2176e82-5720-43ee-9e06-f91cb4c91548", watched=[WebhookWatchedItem(type="user", name="julien-c"), WebhookWatchedItem(type="org", name="HuggingFaceH4")], domains=["repo"], secret="my-secret", disabled=False, ``` #### upload_attachment[[huggingface_hub.HfApi.upload_attachment]] ```python upload_attachment(path: str | Path, token: bool | str | None = None) ``` [Kaynak](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L8000) **Parametreler:** path (`str` veya `Path`) : Yüklenecek dosyanın yolu. Desteklenen biçimler PNG, JPEG, GIF, WebP, MP4, MOV, WebM, MP3 ve WAV'dir. Dosyalar 10MB'tan (videolar için 50MB) küçük olmalıdır. token (`bool` veya `str`, *isteğe bağlı*) : Geçerli bir kullanıcı erişim belirteci (dize). Varsayılan olarak, kimlik doğrulama için önerilen yöntem olan yerel olarak kaydedilmiş belirteç kullanılır (bkz. https://huggingface.co/docs/huggingface_hub/quick-start#authentication). Belirtecin `discussion.write` iznine sahip olması gerekir. Anonim olarak yüklemek için `False` geçirin. **Dönüş:** `str` yüklenen dosyanın URL'si. **Yükselen:** ``ValueError`` - [`ValueError`](https://docs.python.org/3/library/exceptions.html#ValueError) -- Dosya biçimi desteklenmiyorsa. Bir görüntü, video veya ses dosyasını Hub'a yükler ve URL'sini döndürür. Hub web düzenleyicisi, bir dosyayı Tartışma veya Pull Request yorum kutusuna sürüklediğinizde bunu yapar. Dönen URL'yi bir açıklamaya veya yoruma gömün: bir görsel için `![alt text](url)`, bir video için çıplak URL ve bir ses dosyası için ``. Örnek: ```python >>> from huggingface_hub import HfApi >>> api = HfApi() >>> url = api.upload_attachment("screenshot.png") >>> api.create_discussion("username/my-model", title="Rendering bug", description=f"![screenshot]({url})") ``` #### upload_file[[huggingface_hub.HfApi.upload_file]] ```python upload_file(path_or_fileobj: str | Path | bytes | BinaryIO, path_in_repo: str, repo_id: str, token: str | bool | None = None, repo_type: str | None = None, revision: str | None = None, commit_message: str | None = None, commit_description: str | None = None, create_pr: bool | None = None, parent_commit: str | None = None, run_as_future: bool = False, _hot_reload: bool | None = None) ``` [Kaynak](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L5621) **Parametreler:** path_or_fileobj (`str`, `Path`, `bytes` veya `IO`) : Yerel makinedeki bir dosyanın yolu veya ikili veri akışı / fileobj / tampon. path_in_repo (`str`) : Depodaki göreli dosya yolu, örneğin: `"checkpoints/1fec34a/weights.bin"` repo_id (`str`) : Dosyanın yükleneceği depo, örneğin: `"username/custom_transformers"` token (`bool` veya `str`, *isteğe bağlı*) : Geçerli bir kullanıcı erişim belirteci (dize). Varsayılan olarak, kimlik doğrulama için önerilen yöntem olan yerel olarak kaydedilmiş belirteç kullanılır (bkz. https://huggingface.co/docs/huggingface_hub/quick-start#authentication). Kimlik doğrulamayı devre dışı bırakmak için `False` geçirin. repo_type (`str`, *isteğe bağlı*) : Bir veri seti, space veya kernel deposuna yükleniyorsa `"dataset"`, `"space"` veya `"kernel"` olarak ayarlayın; bir modele yükleniyorsa `None` veya `"model"` olarak ayarlayın. Varsayılan değer `None`'dir. revision (`str`, *isteğe bağlı*) : Commit'in alınacağı git revizyonu. Varsayılan olarak `"main"` dalının başıdır. commit_message (`str`, *isteğe bağlı*) : Oluşturulan commit'in özeti / başlığı / ilk satırı commit_description (`str`, *isteğe bağlı*) : Oluşturulan commit'in açıklaması create_pr (`boolean`, *isteğe bağlı*) : Bu commit ile bir Pull Request oluşturulup oluşturulmayacağı. Varsayılan olarak `False`. `revision` ayarlanmadıysa, PR `"main"` dalına karşı açılır. `revision` ayarlandıysa ve bir dal ise, PR bu dala karşı açılır. `revision` ayarlandıysa ve bir dal adı değilse (örneğin: bir commit oid), sunucu tarafından `RevisionNotFoundError` döndürülür. parent_commit (`str`, *isteğe bağlı*) : Ebeveyn commit'in OID / SHA'sı, onaltılık bir dize olarak. Kısaltmalar (ilk 7 karakter) de desteklenir. Belirtilirse ve `create_pr` `False` ise, `revision` `parent_commit`'e işaret etmiyorsa commit başarısız olur. Belirtilirse ve `create_pr` `True` ise, pull request `parent_commit`'ten oluşturulur. `parent_commit`'in belirtilmesi, değişiklikler commit edilmeden önce repoyun değişmediğinden emin olunmasını sağlar ve repo eşzamanlı olarak güncelleniyor / commit ediliyorsa özellikle faydalı olabilir. run_as_future (`bool`, *isteğe bağlı*) : Bu yöntemin arka planda çalıştırılıp çalıştırılmayacağını belirtir. Arka plan işleri, ana iş parçacığını bloklamadan sıralı olarak çalıştırılır. `run_as_future=True` geçirilirse bir [Future](https://docs.python.org/3/library/concurrent.futures.html#future-objects) nesnesi döndürülür. Varsayılan değer `False`'tir. **Dönüş:** [CommitInfo](/docs/huggingface_hub/v2.4.0/tr/package_reference/hf_api#huggingface_hub.CommitInfo) veya `Future` Yeni oluşturulan commit hakkında bilgi içeren [CommitInfo](/docs/huggingface_hub/v2.4.0/tr/package_reference/hf_api#huggingface_hub.CommitInfo) örneği (commit hash, commit url, pr url, commit message,...). `run_as_future=True` geçirilirse, çalıştırıldığında sonucu içerecek bir Future nesnesi döndürülür. Verilen depoya yerel bir dosya (en fazla 50 GB) yükleyin. Yükleme, bir HTTP post isteği üzerinden yapılır ve git veya git-lfs'in kurulu olmasını gerektirmez. > [!TIP] > Aşağıdaki hataları oluşturur: > > - [`HTTPError`](https://requests.readthedocs.io/en/latest/api/#requests.HTTPError) HuggingFace API bir hata döndürürse - [`ValueError`](https://docs.python.org/3/library/exceptions.html#ValueError) bir parametre değeri geçersizse - [RepositoryNotFoundError](/docs/huggingface_hub/v2.4.0/tr/package_reference/utilities#huggingface_hub.errors.RepositoryNotFoundError) İndirme yapılacak deposu bulunamazsa. Bunun nedeni, deponun var olmaması veya `private` olarak ayarlanmış olması ve erişiminizin olmaması olabilir. - [RevisionNotFoundError](/docs/huggingface_hub/v2.4.0/tr/package_reference/utilities#huggingface_hub.errors.RevisionNotFoundError) İndirme yapılacak revizyon bulunamazsa. > [!WARNING] > `upload_file`, Hub'da zaten var olan bir repoyu varsayar. 404 istemci hatası alırsanız, kimlik doğrulamanızın yapıldığından, token'ınızın gerekli izinlere sahip olduğundan ve `repo_id` ile `repo_type` değerlerinin doğru ayarlandığından emin olun. Repo yoksa, önce [create_repo()](/docs/huggingface_hub/v2.4.0/tr/package_reference/hf_api#huggingface_hub.HfApi.create_repo) kullanarak oluşturun. Örnek: ```python >>> from huggingface_hub import upload_file >>> with open("./local/filepath", "rb") as fobj: ... upload_file( ... path_or_fileobj=fileobj, ... path_in_repo="remote/file/path.h5", ... repo_id="username/my-dataset", ... repo_type="dataset", ... token="my_token", ... ) >>> upload_file( ... path_or_fileobj=".\\local\\file\\path", ... path_in_repo="remote/file/path.h5", ... repo_id="username/my-model", ... token="my_token", ... ) >>> upload_file( ... path_or_fileobj=".\\local\\file\\path", ... path_in_repo="remote/file/path.h5", ... repo_id="username/my-model", ... token="my_token", ... create_pr=True, ... ) ``` #### upload_folder[[huggingface_hub.HfApi.upload_folder]] ```python upload_folder(repo_id: str, folder_path: str | Path, path_in_repo: str | None = None, commit_message: str | None = None, commit_description: str | None = None, token: str | bool | None = None, repo_type: str | None = None, revision: str | None = None, create_pr: bool | None = None, parent_commit: str | None = None, allow_patterns: list[str] | str | None = None, ignore_patterns: list[str] | str | None = None, delete_patterns: list[str] | str | None = None, run_as_future: bool = False) ``` [Kaynak](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L5808) **Parametreler:** repo_id (`str`) : Dosyanın yükleneceği depo, örneğin: `"username/custom_transformers"` folder_path (`str` veya `Path`) : Yerel dosya sisteminde yüklenecek klasörün yolu path_in_repo (`str`, *isteğe bağlı*) : Depodaki dizinin göreli yolu, örneğin: `"checkpoints/1fec34a/results"`. Varsayılan olarak deponun kök klasörü kullanılır. token (`bool` veya `str`, *isteğe bağlı*) : Geçerli bir kullanıcı erişim belirteci (dize). Varsayılan olarak, kimlik doğrulama için önerilen yöntem olan yerel olarak kaydedilmiş belirteç kullanılır (bkz. https://huggingface.co/docs/huggingface_hub/quick-start#authentication). Kimlik doğrulamayı devre dışı bırakmak için `False` geçirin. repo_type (`str`, *isteğe bağlı*) : Bir veri seti, space veya kernel deposuna yükleniyorsa `"dataset"`, `"space"` veya `"kernel"` olarak ayarlayın; bir modele yükleniyorsa `None` veya `"model"` olarak ayarlayın. Varsayılan değer `None`'dir. revision (`str`, *isteğe bağlı*) : Commit'in alınacağı git revizyonu. Varsayılan olarak `"main"` dalının başıdır. commit_message (`str`, *isteğe bağlı*) : Oluşturulan commit'in özeti / başlığı / ilk satırı. Varsayılan değer: `f"Upload {path_in_repo} with huggingface_hub"` commit_description (`str` *isteğe bağlı*) : Oluşturulan commit'in açıklaması create_pr (`boolean`, *isteğe bağlı*) : O commit ile bir Pull Request oluşturulup oluşturulmayacağı. Varsayılan olarak `False`'dir. PR her zaman varsayılan branch'e karşı açılır: hem `create_pr=True` hem de `revision` ayarlanırsa bir `ValueError` yükseltilir. `create_pr=True` ile yapılan her çağrının yeni bir pull request açtığını unutmayın: yarıda kalmış bir yüklemeyi mevcut PR'a devam ettirmek için bunun yerine `revision="refs/pr/N"` ile yeniden çalıştırın. parent_commit (`str`, *isteğe bağlı*) : Ebeveyn commit'in OID / SHA'sı, onaltılık bir dize olarak. Kısaltmalar (ilk 7 karakter) de desteklenir. Belirtilirse ve `create_pr` `False` ise, `revision` `parent_commit`'e işaret etmiyorsa commit başarısız olur. `parent_commit`'in belirtilmesi, değişiklikler commit edilmeden önce repoyun değişmediğinden emin olunmasını sağlar ve repo eşzamanlı olarak güncelleniyor / commit ediliyorsa özellikle faydalı olabilir. Yükleme birden fazla commite bölünürse (büyük klasörler), `parent_commit` yalnızca ilkinde geçerlidir. allow_patterns (`list[str]` veya `str`, *isteğe bağlı*) : Verilirse, yalnızca en az bir desenle eşleşen dosyalar yüklenir. ignore_patterns (`list[str]` veya `str`, *isteğe bağlı*) : Verilirse, desenlerden herhangi biriyle eşleşen dosyalar yüklenmez. delete_patterns (`list[str]` veya `str`, *isteğe bağlı*) : Verilirse, kalıbı eşleşen uzak dosyalar yeni dosyalar commit edilirken repodan silinir. Hangi dosyaların zaten yüklendiğini bilmiyorsanız bu işe yarar. Not: tutarsızlıkları önlemek için `.gitattributes` dosyası, kalıpla eşleşse bile silinmez. run_as_future (`bool`, *isteğe bağlı*) : Bu yöntemin arka planda çalıştırılıp çalıştırılmayacağını belirtir. Arka plan işleri, ana iş parçacığını bloklamadan sıralı olarak çalıştırılır. `run_as_future=True` geçirilirse bir [Future](https://docs.python.org/3/library/concurrent.futures.html#future-objects) nesnesi döndürülür. Varsayılan değer `False`'tir. **Dönüş:** [CommitInfo](/docs/huggingface_hub/v2.4.0/tr/package_reference/hf_api#huggingface_hub.CommitInfo) veya `Future` Yeni oluşturulan commit hakkında bilgi içeren [CommitInfo](/docs/huggingface_hub/v2.4.0/tr/package_reference/hf_api#huggingface_hub.CommitInfo) örneği (commit hash, commit url, pr url, commit message,...). `run_as_future=True` geçirilirse, çalıştırıldığında sonucu içerecek bir Future nesnesi döndürülür. Yerel bir klasörü verilen depoya yükler. Yükleme, HTTP istekleri aracılığıyla yapılır ve git veya git-lfs'in kurulu olmasını gerektirmez. Klasör yapısı korunacaktır. Depoda zaten aynı ada sahip dosyalar üzerine yazılacaktır. Diğer dosyalara dokunulmayacaktır. Hangi dosyaların yükleneceğini belirtmek için `allow_patterns` ve `ignore_patterns` argümanlarını kullanın. Bu parametreler tek bir desen veya desen listesi kabul eder. Desenler, [burada](https://tldp.org/LDP/GNU-Linux-Tools-Summary/html/x11655.htm) belgelenen Standart Jolly Jokerler (globbing desenleri)dir. Hem `allow_patterns` hem de `ignore_patterns` sağlanırsa, her iki kısıt da uygulanır. Varsayılan olarak, klasördeki tüm dosyalar yüklenir. Uzak depodan silmek istediğiniz dosyaları belirtmek için `delete_patterns` argümanını kullanın. Girdi türü, `allow_patterns` için olanla aynıdır (bkz. yukarıdaki bölüm). `path_in_repo` de sağlanırsa, desenler bu klasöre göre göreli yollarla eşleştirilir. Örneğin, `upload_folder(..., path_in_repo="experiment", delete_patterns="logs/*")` ifadesi, `./experiment/logs/` altındaki tüm uzak dosyaları siler. Desenlerle eşleşse bile `.gitattributes` dosyasının silinmeyeceğini unutmayın. Herhangi bir alt dizinde bulunan `.git/` klasörü yok sayılır. Ancak `.gitignore` dosyasının dikkate alınmadığını lütfen unutmayın. `hf_xet` yüklüyse (varsayılan), dosyalar akışkan bir boru hattı üzerinden yüklenir: klasör Hub ile karşılaştırılmaya devam ederken yüklemeler başlar, dosyalar yükleme için parçalara ayrılırken özetlenir (tek okuma geçişi) ve büyük klasörler, sunucu sınırlarının altında kalmak için otomatik olarak birkaç partide taahhüt edilir (takip eden taahhütler, taahhüt mesajında ` (part N)` eki alır). Yükleme yarıda kalırsa, aynı çağrının yeniden çalıştırılması kaldığı yerden devam eder: zaten taahhüt edilen dosyalar atlanır ve zaten yüklenen veriler yinelenme giderilir. `hf_xet` yüklü değilse, [create_commit()](/docs/huggingface_hub/v2.4.0/tr/package_reference/hf_api#huggingface_hub.HfApi.create_commit) ile oluşturulan tek bir taahhüde geri düşülür. > [!TIP] > Aşağıdaki hataları oluşturur: > > - HuggingFace API bir hata döndürürse [`HTTPError`](https://requests.readthedocs.io/en/latest/api/#requests.HTTPError) - bazı parametre değerleri geçersizse [`ValueError`](https://docs.python.org/3/library/exceptions.html#ValueError) > [!WARNING] > `upload_folder`, Hub'da zaten var olan bir repoyu varsayar. 404 Client hatası alırsanız, kimlik doğrulamanızın yapıldığından, token'ınızın gerekli izinlere sahip olduğundan ve `repo_id` ile `repo_type` değerlerinin doğru ayarlandığından emin olun. Repo yoksa, önce [create_repo()](/docs/huggingface_hub/v2.4.0/tr/package_reference/hf_api#huggingface_hub.HfApi.create_repo) kullanarak oluşturun. Örnek: ```python # Upload checkpoints folder except the log files >>> upload_folder( ... folder_path="local/checkpoints", ... path_in_repo="remote/experiment/checkpoints", ... repo_id="username/my-dataset", ... repo_type="datasets", ... token="my_token", ... ignore_patterns="**/logs/*.txt", ... ) # Upload checkpoints folder including logs while deleting existing logs from the repo # Useful if you don't know exactly which log files have already being pushed >>> upload_folder( ... folder_path="local/checkpoints", ... path_in_repo="remote/experiment/checkpoints", ... repo_id="username/my-dataset", ... repo_type="datasets", ... token="my_token", ... delete_patterns="**/logs/*.txt", ... ) # Upload checkpoints folder while creating a PR >>> upload_folder( ... folder_path="local/checkpoints", ... path_in_repo="remote/experiment/checkpoints", ... repo_id="username/my-dataset", ... repo_type="datasets", ... token="my_token", ... create_pr=True, ... ) ``` #### verify_repo_checksums[[huggingface_hub.HfApi.verify_repo_checksums]] ```python verify_repo_checksums(repo_id: str, repo_type: str | None = None, revision: str | None = None, local_dir: str | Path | None = None, cache_dir: str | Path | None = None, token: str | bool | None = None) ``` [Kaynak](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L4035) **Parametreler:** repo_id (`str`) : `/` ile ayrılmış bir ad alanı (kullanıcı veya kuruluş) ve bir depo adı. repo_type (`str`, *isteğe bağlı*) : Ağacın alınacağı depoyun türü (`"model"`, `"dataset"` veya `"space"`. Varsayılan olarak `"model"`. revision (`str`, *isteğe bağlı*) : Ağacın alınacağı depoyun revizyonu. Varsayılan olarak `"main"` dalıdır. local_dir (`str` veya `Path`, *isteğe bağlı*) : Doğrulanacak yerel dizin. cache_dir (`str` veya `Path`, *isteğe bağlı*) : Doğrulanacak önbellek dizini. token (Union[bool, str, None], isteğe bağlı) : Geçerli bir kullanıcı erişim belirteci (dize). Varsayılan olarak, kimlik doğrulama için önerilen yöntem olan yerel olarak kaydedilmiş belirteç kullanılır (bkz. https://huggingface.co/docs/huggingface_hub/quick-start#authentication). Kimlik doğrulamayı devre dışı bırakmak için `False` geçirin. **Dönüş:** `FolderVerification` doğrulama ayrıntılarını içeren yapılandırılmış bir sonuç. **Yükselen:** [RepositoryNotFoundError](/docs/huggingface_hub/v2.4.0/tr/package_reference/utilities#huggingface_hub.errors.RepositoryNotFoundError) veya [RevisionNotFoundError](/docs/huggingface_hub/v2.4.0/tr/package_reference/utilities#huggingface_hub.errors.RevisionNotFoundError) - [RepositoryNotFoundError](/docs/huggingface_hub/v2.4.0/tr/package_reference/utilities#huggingface_hub.errors.RepositoryNotFoundError) -- Depo bulunamadıysa (hata 404): repo_id/repo_type yanlış, özel ama kimlik doğrulaması yapılmamış veya depo mevcut değil. - [RevisionNotFoundError](/docs/huggingface_hub/v2.4.0/tr/package_reference/utilities#huggingface_hub.errors.RevisionNotFoundError) -- Depoda revizyon bulunamadıysa (404 hatası). Bir repodaki yerel dosyaları Hub kontrol toplamlarıyla doğrulayın. #### wait_for_job[[huggingface_hub.HfApi.wait_for_job]] ```python wait_for_job(job_id: str | list[str], timeout: float | None = None, poll_interval: float = 1.0, stages: list[JobStage] | None = None, namespace: str | None = None, token: bool | str | None = None) ``` [Kaynak](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L12638) **Parametreler:** job_id (`str` veya `list[str]`) : Job kimliği veya beklenmesi istenen Job kimlikleri listesi. Liste geçirilirse, [JobInfo](/docs/huggingface_hub/v2.4.0/tr/package_reference/jobs#huggingface_hub.JobInfo) listesi döndürülür (aynı sırayla). timeout (`float`, *isteğe bağlı*) : İşlerin (Job) bitmesi için saniye cinsinden beklenmesi gereken maksimum süre. `None` ise, süresiz beklenir. poll_interval (`float`, *isteğe bağlı*) : Her durum denetimi arasında beklenen süre, saniye cinsinden. Varsayılan değer 1 sn'dir. stages (`list[JobStage]`, *isteğe bağlı*) : Beklenecek aşamalar. Varsayılan olarak son aşamalar (`"COMPLETED"`, `"CANCELED"`, `"ERROR"`, `"DELETED"`). Job'un çalışmaya başlamasını beklemek için örneğin `[JobStage.RUNNING]` geçin. Son aşamalar, bu değerden bağımsız olarak bekleme işlemini her zaman durdurur. namespace (`str`, *isteğe bağlı*) : İş(ler)in çalıştığı ad alanı. Varsayılan olarak mevcut kullanıcının ad alanıdır. token (`bool` veya `str`, *isteğe bağlı*) : Geçerli bir kullanıcı erişim belirteci. Sağlanmazsa, önerilen kimlik doğrulama yöntemi olan yerel olarak kaydedilmiş belirteç kullanılır. Kimlik doğrulamayı devre dışı bırakmak için `False` olarak ayarlayın. Aşağıdaki bağlantıya bakın: https://huggingface.co/docs/huggingface_hub/quick-start#authentication. **Dönüş:** [JobInfo](/docs/huggingface_hub/v2.4.0/tr/package_reference/jobs#huggingface_hub.JobInfo) veya `list[JobInfo]` son İş bilgileri. **Yükselen:** ``TimeoutError`` - ``TimeoutError`` -- En az bir Job, `timeout` saniye içinde hedef aşamalardan birine ulaşmadıysa. Hugging Face altyapısındaki bir veya daha fazla hesaplama İşinin (Job) belirli bir aşamaya ulaşmasını bekleyin. Her Job durumu, aşaması `stages` içindeki bir değer olana kadar (varsayılan olarak son aşamalar: `"COMPLETED"`, `"CANCELED"`, `"ERROR"` veya `"DELETED"`) her `poll_interval` saniyede bir ([inspect_job()](/docs/huggingface_hub/v2.4.0/tr/package_reference/hf_api#huggingface_hub.HfApi.inspect_job) ile) sorgulanır. Her durumda son [JobInfo](/docs/huggingface_hub/v2.4.0/tr/package_reference/jobs#huggingface_hub.JobInfo) döndürülür: başarısız veya iptal edilen bir Job **istisna** fırlatmaz — sonucu işlemek için `job.status.stage` değerini kontrol edin. Terminal aşamalar, `stages` içinde listelenmemiş olsa bile bekleme işlemini her zaman durdurur. Bu, Job'un asla ulaşamayacağı bir aşama için sonsuza kadar beklenmesini önler (ör. zamanlama sırasında başarısız olan bir Job için `"RUNNING"` beklenmesi). Örnek: ```python >>> from huggingface_hub import run_job, wait_for_job >>> job = run_job(image="python:3.12", command=["python", "-c", "print('Hello from HF compute!')"]) >>> wait_for_job(job_id=job.id).status.stage 'COMPLETED' ``` #### wait_for_space[[huggingface_hub.HfApi.wait_for_space]] ```python wait_for_space(repo_id: str, timeout: float | None = None, poll_interval: float = 1.0, token: bool | str | None = None) ``` [Kaynak](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L8803) **Parametreler:** repo_id (`str`) : Beklenmesi gereken Space'in kimliği. Örnek: `"username/my-space"`. timeout (`float`, *isteğe bağlı*) : Saniye cinsinden en fazla bekleme süresi. `None` ise, sonsuza kadar bekler. poll_interval (`float`, *isteğe bağlı*) : Durum denetimleri arasındaki saniye sayısı. Varsayılan olarak 1 sn'dir. token (`bool` veya `str`, *isteğe bağlı*) : Geçerli bir kullanıcı erişim belirteci. Varsayılan olarak, önerilen kimlik doğrulama yöntemi olan yerel olarak kaydedilmiş belirteç kullanılır. Kimlik doğrulamayı devre dışı bırakmak için `False` olarak ayarlayın. bkz. https://huggingface.co/docs/huggingface_hub/quick-start#authentication. **Dönüş:** [SpaceRuntime](/docs/huggingface_hub/v2.4.0/tr/package_reference/space_runtime#huggingface_hub.SpaceRuntime) Space son aşamaya ulaştığında nihai çalışma zamanı bilgisi. **Yükselen:** ``TimeoutError`` - ``TimeoutError`` -- Space, `timeout` saniye içinde son bir aşamaya ulaşmadıysa. Bir Space'in son bir aşamaya (derleniyor/başlatılıyor değil) ulaşmasını bekleyin. Polls, Space'in aşaması artık ara bir durum (`BUILDING`, `RUNNING_BUILDING`, `APP_STARTING`, `RUNNING_APP_STARTING`) olmadıkça her `poll_interval` saniyede bir [get_space_runtime()](/docs/huggingface_hub/v2.4.0/tr/package_reference/hf_api#huggingface_hub.HfApi.get_space_runtime) çağrısı yapar. Tüm durumlarda nihai [SpaceRuntime](/docs/huggingface_hub/v2.4.0/tr/package_reference/space_runtime#huggingface_hub.SpaceRuntime) değerini döndürür — sonucu işlemek için `runtime.stage` değerini kontrol edin (ör. `RUNNING` ile `BUILD_ERROR`). Örnek: ```python >>> from huggingface_hub import restart_space, wait_for_space >>> restart_space("username/my-space") >>> runtime = wait_for_space("username/my-space") >>> runtime.stage 'RUNNING' ``` #### whoami[[huggingface_hub.HfApi.whoami]] ```python whoami(token: bool | str | None = None, cache: bool = False) ``` [Kaynak](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L2218) **Parametreler:** token (`bool` veya `str`, *isteğe bağlı*) : Geçerli bir kullanıcı erişim belirteci (dize). Varsayılan olarak, kimlik doğrulama için önerilen yöntem olan yerel olarak kaydedilmiş belirteç kullanılır (bkz. https://huggingface.co/docs/huggingface_hub/quick-start#authentication). Kimlik doğrulamayı devre dışı bırakmak için `False` geçirin. cache (`bool`, *isteğe bağlı*) : `whoami` çağrısının sonucunun sonraki çağrılar için önbelleğe alınıp alınmayacağını belirtir. İlk çağrı sırasında bir hata oluşursa, sonuç önbelleğe alınmaz. Varsayılan değer `False`'tür. "whoami" bilgisini öğrenmek için HF API'sini çağırın. `cache=True` geçirilirse, sonuç Python sürecinin ömrü boyunca sonraki çağrılar için önbelleğe alınır. Bu, güvenlik nedenleriyle yoğun şekilde hız sınırlamasına tabi olan bu uç noktayı `whoami` üzerinden birden fazla kez çağırmayı planlıyorsanız faydalıdır. ## API Veri Sınıfları ### AccessRequest[[huggingface_hub.hf_api.AccessRequest]] #### huggingface_hub.hf_api.AccessRequest[[huggingface_hub.hf_api.AccessRequest]] ```python huggingface_hub.hf_api.AccessRequest(username: str | None, request_id: str, fullname: str | None, email: str | None, timestamp: datetime, status: Literal['pending', 'accepted', 'rejected'], fields: dict[str, Any] | None = None) ``` [Kaynak](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L445) **Parametreler:** username (`str`, *isteğe bağlı*) : Erişim talep eden kullanıcının kullanıcı adı. Kullanıcı adlarının paylaşılmaması yapılandırılmışsa `None`. Bu durumda, talebi kabul etmek, reddetmek veya iptal etmek için `request_id` kullanın. request_id (`str`) : Erişim isteğinin kimliği. Kullanıcı adı paylaşılmamış olsa bile her zaman ayarlanır. fullname (`str`, *isteğe bağlı*) : Erişim talep eden kullanıcının tam adı. Kullanıcı adlarının paylaşılmaması yapılandırılmışsa depo için `None`. email (`str`, *isteğe bağlı*) : Erişim talep eden kullanıcının e-posta adresi. Kullanıcıya erişim manuel olarak verilmişse veya depo, talep edenlerin e-posta adreslerini paylaşmamak üzere yapılandırılmışsa `None`. timestamp (`datetime`) : İsteğin zaman damgası. status (`Literal["pending", "accepted", "rejected"]`) : İsteğin durumu. `["pending", "accepted", "rejected"]` değerlerinden biri olabilir. fields (`dict[str, Any]`, *isteğe bağlı*) : Geçit formunda kullanıcı tarafından doldurulan ek alanlar. Bir kullanıcı erişim isteği hakkında bilgi içeren veri yapısı. ### BucketFile[[huggingface_hub.BucketFile]] #### huggingface_hub.BucketFile[[huggingface_hub.BucketFile]] ```python huggingface_hub.BucketFile(**kwargs) ``` [Kaynak](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/_buckets.py#L197) Hub'daki bir kovadaki dosya hakkında bilgi içerir. Bu nesne [list_bucket_tree()](/docs/huggingface_hub/v2.4.0/tr/package_reference/hf_api#huggingface_hub.HfApi.list_bucket_tree) tarafından döndürülür. [RepoFile](/docs/huggingface_hub/v2.4.0/tr/package_reference/hf_api#huggingface_hub.RepoFile)'e benzer ancak bucketlardaki dosyalar için. ### BucketFileMetadata[[huggingface_hub.BucketFileMetadata]] #### huggingface_hub.BucketFileMetadata[[huggingface_hub.BucketFileMetadata]] ```python huggingface_hub.BucketFileMetadata(size: int, xet_file_data: XetFileData) ``` [Kaynak](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/_buckets.py#L140) **Parametreler:** size (`int`) : Dosyanın bayt cinsinden boyutu. xet_file_data (`XetFileData`) : Dosya için Xet bilgileri (hash ve yenileme rotası). Bir kovadaki dosya hakkında bilgi içeren veri yapısı. [get_bucket_file_metadata()](/docs/huggingface_hub/v2.4.0/tr/package_reference/hf_api#huggingface_hub.HfApi.get_bucket_file_metadata) tarafından döndürülür. ### BucketInfo[[huggingface_hub.BucketInfo]] #### huggingface_hub.BucketInfo[[huggingface_hub.BucketInfo]] ```python huggingface_hub.BucketInfo(**kwargs) ``` [Kaynak](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/_buckets.py#L65) **Parametreler:** id (`str`) : Kovanın kimliği. private (`bool`) : Bucket özel mi. created_at (`datetime`) : Hub'da bucket'ın oluşturulma tarihi. size (`int`) : Bayt cinsinden varillerin boyutu. total_files (`int`) : Kova içindeki dosyaların toplam sayısı. Hub'daki bir varlık hakkındaki bilgileri içerir. Bu nesne [bucket_info()](/docs/huggingface_hub/v2.4.0/tr/package_reference/hf_api#huggingface_hub.HfApi.bucket_info) ve [list_buckets()](/docs/huggingface_hub/v2.4.0/tr/package_reference/hf_api#huggingface_hub.HfApi.list_buckets) tarafından döndürülür. ### BucketUrl[[huggingface_hub.BucketUrl]] #### huggingface_hub.BucketUrl[[huggingface_hub.BucketUrl]] ```python huggingface_hub.BucketUrl(url: str, endpoint: str = '') ``` [Kaynak](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/_buckets.py#L157) **Parametreler:** url (`str`) : Bucket URL'sinin string değeri. endpoint (`str`, *isteğe bağlı*) : Hub'un uç noktası. Varsayılan olarak . Hub'daki bir varlık URL'sini açıklar. `BucketUrl`, [create_bucket()](/docs/huggingface_hub/v2.4.0/tr/package_reference/hf_api#huggingface_hub.HfApi.create_bucket) tarafından döndürülür. Başlatma sırasında URL, özellikleri doldurmak için ayrıştırılır: - endpoint (`str`) - namespace (`str`) - bucket_id (`str`) - url (`str`) - uri (`HfUri`) ### DatasetLeaderboardEntry[[huggingface_hub.DatasetLeaderboardEntry]] #### huggingface_hub.DatasetLeaderboardEntry[[huggingface_hub.DatasetLeaderboardEntry]] ```python huggingface_hub.DatasetLeaderboardEntry(**kwargs) ``` [Kaynak](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L1948) **Parametreler:** rank (`int`) : Modelin liderlik tablosundaki sırası (1'den başlar). model_id (`str`) : Modelin kimliği (ör. `"meta-llama/Llama-3-8b"`). value (`float`) : Değerlendirme puanı değeri. filename (`str`) : Değerlendirme verilerini içeren sonuç dosyasının adı. verified (`bool`) : Sonucun doğrulanıp doğrulanmadığı. source (`dict[str, Any]`, *isteğe bağlı*) : Değerlendirme sonucunun kaynağına dair bilgi. `"url"`, `"name"` ve `"isExternal"` gibi anahtarlar içerir. Tüm girdilerin bir kaynağı yoktur. author (`User` veya `Organization`) : API yanıtındaki `"type"` alanına göre ayrıştırılan model yazarı. pull_request (`int`, *isteğe bağlı*) : Lider tablosu girdisiyle ilişkili olan, varsa, çekme isteği numarası. notes (`str`, *isteğe bağlı*) : Lider tablosu girdisiyle ilişkili notlar, varsa. Hub'daki bir veri seti lider tablosundaki tek bir girdi hakkında bilgi içerir. Bir liderlik tablosu, modelleri belirli bir referans veri setindeki değerlendirme puanlarına göre sıralar. Bu nesne [get_dataset_leaderboard()](/docs/huggingface_hub/v2.4.0/tr/package_reference/hf_api#huggingface_hub.HfApi.get_dataset_leaderboard) tarafından döndürülür. Belirli bir modelin referans setleri genelindeki değerlendirme sonuçlarını almak için [model_info()](/docs/huggingface_hub/v2.4.0/tr/package_reference/hf_api#huggingface_hub.HfApi.model_info) ile `expand=["evalResults"]` parametresi kullanılarak `ModelInfo.eval_results` ve [EvalResultEntry](/docs/huggingface_hub/v2.4.0/tr/package_reference/hf_api#huggingface_hub.EvalResultEntry) öğelerine bakın. ### EvalResultEntry[[huggingface_hub.EvalResultEntry]] #### huggingface_hub.EvalResultEntry[[huggingface_hub.EvalResultEntry]] ```python huggingface_hub.EvalResultEntry(dataset_id: str, task_id: str, value: typing.Any, dataset_revision: str | None = None, verify_token: str | None = None, date: str | None = None, source_url: str | None = None, source_name: str | None = None, source_user: str | None = None, source_org: str | None = None, notes: str | None = None) ``` [Kaynak](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/_eval_results.py#L17) **Parametreler:** dataset_id (`str`) : Hub'dan benchmark veri seti kimliği. Örnek: "cais/hle", "Idavidrein/gpqa". task_id (`str`) : Benchmark içindeki görev tanımlayıcısı. Örnek: "gpqa_diamond". value (`Any`) : Metrik değeri. Örnek: 20.90. dataset_revision (`str`, *isteğe bağlı*) : Benchmark veri setinin Git SHA'sı. verify_token (`str`, *isteğe bağlı*) : Değerlendirmenin kanıtlanabilir şekilde denetlenebilir ve yeniden üretilebilir olduğunu kanıtlamak için kullanılabilen bir imza. date (`str`, *isteğe bağlı*) : Değerlendirme ne zaman çalıştırıldı (ISO-8601 tarih/saat). Varsayılan olarak git commit zamanı kullanılır. source_url (`str`, *isteğe bağlı*) : Değerlendirme kaynağına bağlantı (ör. https://huggingface.co/spaces/SaylorTwift/smollm3-mmlu-pro). `source_name`, `source_user` veya `source_org` sağlanırsa zorunludur. source_name (`str`, *isteğe bağlı*) : Kaynağın görüntülenen adı. Örnek: "Eval Logs". source_user (`str`, *isteğe bağlı*) : Atıf için HF kullanıcı adı. Örnek: "celinah". source_org (`str`, *isteğe bağlı*) : Atıf için HF org adı. Örnek: "cais". notes (`str`, *isteğe bağlı*) : Değerlendirme kurulumuyla ilgili ayrıntılar. Örnek: "tools", "no-tools", "chain-of-thought". `.eval_results/*.yaml` biçimi için değerlendirme sonucu girişi. Model depolarında saklanan ve model sayfasında ile referans veri setinin liderlik tablosunda otomatik olarak görünen değerlendirme puanlarını temsil eder. `README.md` içindeki eski `model-index` biçimi için bunun yerine [EvalResult](/docs/huggingface_hub/v2.4.0/tr/package_reference/cards#huggingface_hub.EvalResult) kullanın. Daha fazla ayrıntı için https://huggingface.co/docs/hub/eval-results adresine bakın. Örnek: ```python >>> from huggingface_hub import EvalResultEntry >>> # Minimal example with required fields only >>> result = EvalResultEntry( ... dataset_id="Idavidrein/gpqa", ... task_id="gpqa_diamond", ... value=0.412, ... ) >>> # Full example with all fields >>> result = EvalResultEntry( ... dataset_id="cais/hle", ... task_id="default", ... value=20.90, ... dataset_revision="5503434ddd753f426f4b38109466949a1217c2bb", ... verify_token="eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...", ... date="2025-01-15T10:30:00Z", ... source_url="https://huggingface.co/datasets/cais/hle", ... source_name="CAIS HLE", ... source_org="cais", ... notes="no-tools", ... ) ``` ### SyncOperation[[huggingface_hub.SyncOperation]] #### huggingface_hub.SyncOperation[[huggingface_hub.SyncOperation]] ```python huggingface_hub.SyncOperation(action: typing.Literal['upload', 'download', 'delete', 'skip'], path: str, size: int | None = None, reason: str = '', local_mtime: str | None = None, remote_mtime: str | None = None, bucket_file: huggingface_hub._buckets.BucketFile | None = None) ``` [Kaynak](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/_buckets.py#L289) Yapılacak bir senkronizasyon işlemini temsil eder. ### SyncPlan[[huggingface_hub.SyncPlan]] #### huggingface_hub.SyncPlan[[huggingface_hub.SyncPlan]] ```python huggingface_hub.SyncPlan(source: str, dest: str, timestamp: str, operations: list = ) ``` [Kaynak](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/_buckets.py#L302) Tam bir senkronizasyon planını temsil eder. ### CommitInfo[[huggingface_hub.CommitInfo]] #### huggingface_hub.CommitInfo[[huggingface_hub.CommitInfo]] ```python huggingface_hub.CommitInfo(commit_url: str, *args, **kwargs) ``` [Kaynak](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L362) **Parametreler:** commit_url (`str`) : Commit'in bulunacağı URL. commit_message (`str`) : Oluşturulan commit'in özeti (ilk satırı). commit_description (`str`) : Oluşturulan commit'in açıklaması. Boş olabilir. oid (`str`) : Commit hash kimliği. Örnek: `"91c54ad1727ee830252e457677f467be0bfd8a57"`. pr_url (`str`, *isteğe bağlı*) : Oluşturulmuşsa, oluşturulan PR'nin URL'si. `create_pr=True` parametresi iletildiğinde doldurulur. pr_revision (`str`, *isteğe bağlı*) : Oluşturulmuşsa, oluşturulan PR'nin revizyonu. `create_pr=True` parametresi iletildiğinde doldurulur. Örnek: `"refs/pr/1"`. pr_num (`int`, *isteğe bağlı*) : Oluşturulmuşsa, oluşturulan PR tartışmasının numarası. `create_pr=True` parametresi iletildiğinde doldurulur. [get_discussion_details()](/docs/huggingface_hub/v2.4.0/tr/package_reference/hf_api#huggingface_hub.HfApi.get_discussion_details) içinde `discussion_num` olarak iletilebilir. Örnek: `1`. repo_url (`RepoUrl`) : repo_id, repo_type gibi bilgileri içeren commit'in depo URL'si. Yeni oluşturulan bir commit hakkında bilgi içeren veri yapısı. Hub üzerinde bir commit oluşturan herhangi bir yöntem tarafından döndürülür: [create_commit()](/docs/huggingface_hub/v2.4.0/tr/package_reference/hf_api#huggingface_hub.HfApi.create_commit), [upload_file()](/docs/huggingface_hub/v2.4.0/tr/package_reference/hf_api#huggingface_hub.HfApi.upload_file), [upload_folder()](/docs/huggingface_hub/v2.4.0/tr/package_reference/hf_api#huggingface_hub.HfApi.upload_folder), [delete_file()](/docs/huggingface_hub/v2.4.0/tr/package_reference/hf_api#huggingface_hub.HfApi.delete_file), [delete_folder()](/docs/huggingface_hub/v2.4.0/tr/package_reference/hf_api#huggingface_hub.HfApi.delete_folder). Geriye dönük uyumluluk için `str` sınıfından devralır ancak `str`'e özgü yöntemlerin kullanımı artık önerilmez. ### DatasetInfo[[huggingface_hub.DatasetInfo]] #### huggingface_hub.DatasetInfo[[huggingface_hub.DatasetInfo]] ```python huggingface_hub.DatasetInfo(**kwargs) ``` [Kaynak](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L1013) **Parametreler:** id (`str`) : Veri setinin kimliği. author (`str`) : Veri setinin yazarı. card_data (`DatasetCardData`, *isteğe bağlı*) : [huggingface_hub.repocard_data.DatasetCardData](/docs/huggingface_hub/v2.4.0/tr/package_reference/cards#huggingface_hub.DatasetCardData) nesnesi olarak Veri Seti Kartı Meta verisi. citation (`str`, *isteğe bağlı*) : Veri seti için atıf bilgisi. created_at (`datetime`, *isteğe bağlı*) : Hub'daki repozitorinin oluşturulma tarihi. En düşük değerin `2022-03-02T23:29:04.000Z` olduğunu ve bu tarihin, oluşturma tarihlerini depolamaya başladığımız tarihe karşılık geldiğini unutmayın. description (`str`, *isteğe bağlı*) : Veri setinin açıklaması. disabled (`bool`, *isteğe bağlı*) : Deponun devre dışı bırakılıp bırakılmadığı. downloads (`int`) : Son 30 gün içinde veri setinin indirme sayısı. downloads_all_time (`int`) : Veri setinin oluşturulmasından bu yana kümülatif indirme sayısı. gated (`Literal["auto", "manual", False]`, *isteğe bağlı*) : Depo kapalı mı? Eğer öyleyse, onayın manuel mi yoksa otomatik mi olduğu. last_modified (`datetime`, *isteğe bağlı*) : Depoya son commit tarihi. likes (`int`) : Number of likes of the dataset. main_size (`int`, *isteğe bağlı*) : Veri setinin ana dalının bayt cinsinden boyutu. paperswithcode_id (`str`, *isteğe bağlı*) : Veri setinin Papers with code kimliği. private (`bool`) : Depo özel mi. resource_group (`dict`, *isteğe bağlı*) : Veri seti için kaynak grubu bilgisi. sha (`str`) : Bu özel revizyondaki depo SHA'sı. siblings (`list[RepoSibling]`) : Veri setini oluşturan [huggingface_hub.hf_api.RepoSibling](/docs/huggingface_hub/v2.4.0/tr/package_reference/hf_api#huggingface_hub.hf_api.RepoSibling) nesnelerinin listesi. tags (`list[str]`) : Veri setinin etiketlerinin listesi. trending_score (`int`, *isteğe bağlı*) : Veri setinin trend skoru. used_storage (`int`, *isteğe bağlı*) : Hub'daki veri setinin bayt cinsinden boyutu. Hub'daki bir veri seti hakkında bilgi içerir. Bu nesne [dataset_info()](/docs/huggingface_hub/v2.4.0/tr/package_reference/hf_api#huggingface_hub.HfApi.dataset_info) ve [list_datasets()](/docs/huggingface_hub/v2.4.0/tr/package_reference/hf_api#huggingface_hub.HfApi.list_datasets) tarafından döndürülür. > [!TIP] > Bu sınıfın çoğu özelliği isteğe bağlıdır. Bunun nedeni, Hub tarafından döndürülen verinin yapılan sorguya bağlı olmasıdır. Genel olarak, sorgu ne kadar spesifikse, o kadar çok bilgi döndürülür. Buna karşılık, [list_datasets()](/docs/huggingface_hub/v2.4.0/tr/package_reference/hf_api#huggingface_hub.HfApi.list_datasets) kullanılarak veri kümeleri listelendiğinde yalnızca özelliklerin bir alt kümesi döndürülür. ### DryRunFileInfo[[huggingface_hub.DryRunFileInfo]] #### huggingface_hub.DryRunFileInfo[[huggingface_hub.DryRunFileInfo]] ```python huggingface_hub.DryRunFileInfo(commit_hash: str, file_size: int | None, filename: str, local_path: str, is_cached: bool, will_download: bool) ``` [Kaynak](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/file_download.py#L182) **Parametreler:** commit_hash (`str`) : Dosyayla ilgili commit_hash. file_size (`int`, *isteğe bağlı*) : Biliniyorsa dosyanın boyutu. LFS dosyası durumunda, işaretçinin değil, gerçek LFS dosyasının boyutunu içerir. filename (`str`) : Depodaki dosyanın adı. is_cached (`bool`) : Dosyanın yerel olarak önbelleğe alınıp alınmadığı. will_download (`bool`) : `hf_hub_download` `dry_run=False` ile çağrıldığında dosyanın indirilip indirilmeyeceğini belirtir. Pratikte, dosya önbellekte değilse veya `force_download=True` ise will_download `True` olur. Bir dosya indirme işlemi için kuru çalıştırma (dry run) gerçekleştirildiğinde dönen bilgiler. `dry_run=True` olduğunda [hf_hub_download()](/docs/huggingface_hub/v2.4.0/tr/package_reference/file_download#huggingface_hub.hf_hub_download) tarafından döndürülür. ### DuplicatedRepoUrl[[huggingface_hub.DuplicatedRepoUrl]] #### huggingface_hub.DuplicatedRepoUrl[[huggingface_hub.DuplicatedRepoUrl]] ```python huggingface_hub.DuplicatedRepoUrl(url: Any, endpoint: str | None = None) ``` [Kaynak](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L594) **Parametreler:** files_copy_pending (`bool`) : `True` if the LFS/Xet files of the new repo are still being copied in the background. Until the copy is complete, downloading these files may fail. [duplicate_repo()](/docs/huggingface_hub/v2.4.0/tr/package_reference/hf_api#huggingface_hub.HfApi.duplicate_repo) tarafından döndürülen [RepoUrl](/docs/huggingface_hub/v2.4.0/tr/package_reference/hf_api#huggingface_hub.RepoUrl). ### GitRefInfo[[huggingface_hub.GitRefInfo]] #### huggingface_hub.GitRefInfo[[huggingface_hub.GitRefInfo]] ```python huggingface_hub.GitRefInfo(name: str, ref: str, target_commit: str) ``` [Kaynak](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L1444) **Parametreler:** name (`str`) : Referansın adı (ör. etiket adı veya dal adı). ref (`str`) : Hub'daki tam git ref'i (ör. `"refs/heads/main"` veya `"refs/tags/v1.0"`). target_commit (`str`) : ref için hedef commit'in OID'si (ör. `"e7da7f221d5bf496a48136c0cd264e630fe9fcc8"`) Hub'daki bir depoyu işaret eden bir git referansına ilişkin bilgileri içerir. ### GitCommitInfo[[huggingface_hub.GitCommitInfo]] #### huggingface_hub.GitCommitInfo[[huggingface_hub.GitCommitInfo]] ```python huggingface_hub.GitCommitInfo(commit_id: str, authors: list[str], created_at: datetime, title: str, message: str, formatted_title: str | None, formatted_message: str | None) ``` [Kaynak](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L1489) **Parametreler:** commit_id (`str`) : commit'in OID'si (ör. `"e7da7f221d5bf496a48136c0cd264e630fe9fcc8"`) authors (`list[str]`) : Commit'in yazarlarının listesi. created_at (`datetime`) : Commit'in oluşturulma zamanı. title (`str`) : Commit başlığı. Bu, yazarlar tarafından girilen serbest metin bir değerdir. message (`str`) : Commit açıklaması. Bu, yazarlar tarafından girilen serbest metin bir değerdir. formatted_title (`str`) : HTML olarak biçimlendirilmiş commit başlığı. Yalnızca `formatted=True` ayarlanırsa döndürülür. formatted_message (`str`) : HTML olarak biçimlendirilmiş commit açıklaması. Yalnızca `formatted=True` ayarlandığında döndürülür. Hub'daki bir depo için bir git commit hakkında bilgi içerir. Daha fazla ayrıntı için [list_repo_commits()](/docs/huggingface_hub/v2.4.0/tr/package_reference/hf_api#huggingface_hub.HfApi.list_repo_commits) işlevine göz atın. ### GitRefs[[huggingface_hub.GitRefs]] #### huggingface_hub.GitRefs[[huggingface_hub.GitRefs]] ```python huggingface_hub.GitRefs(branches: list[GitRefInfo], converts: list[GitRefInfo], tags: list[GitRefInfo], pull_requests: list[GitRefInfo] | None = None) ``` [Kaynak](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L1463) **Parametreler:** branches (`list[GitRefInfo]`) : Depodaki dallar hakkında bilgi içeren [GitRefInfo](/docs/huggingface_hub/v2.4.0/tr/package_reference/hf_api#huggingface_hub.GitRefInfo) öğelerinin listesi. converts (`list[GitRefInfo]`) : Depodaki "convert" ref'leri hakkında bilgi içeren [GitRefInfo](/docs/huggingface_hub/v2.4.0/tr/package_reference/hf_api#huggingface_hub.GitRefInfo) listesidir. Converts, Dataset depolarında ön işlenmiş verileri itmek için (içeriden) kullanılan ref'lerdir. tags (`list[GitRefInfo]`) : Depodaki etiketler hakkında bilgi içeren [GitRefInfo](/docs/huggingface_hub/v2.4.0/tr/package_reference/hf_api#huggingface_hub.GitRefInfo) öğelerinin listesi. pull_requests (`list[GitRefInfo]`, *isteğe bağlı*) : Depodaki pull request'ler hakkında bilgi içeren [GitRefInfo](/docs/huggingface_hub/v2.4.0/tr/package_reference/hf_api#huggingface_hub.GitRefInfo) öğelerinin listesi. Yalnızca `include_prs=True` ayarlandığında döndürülür. Hub'daki bir repoya ait tüm git referansları hakkında bilgi içerir. Nesne, [list_repo_refs()](/docs/huggingface_hub/v2.4.0/tr/package_reference/hf_api#huggingface_hub.HfApi.list_repo_refs) tarafından döndürülür. ### InferenceProviderMapping[[huggingface_hub.hf_api.InferenceProviderMapping]] #### huggingface_hub.hf_api.InferenceProviderMapping[[huggingface_hub.hf_api.InferenceProviderMapping]] ```python huggingface_hub.hf_api.InferenceProviderMapping(**kwargs) ``` [Kaynak](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L773) ### KernelInfo[[huggingface_hub.KernelInfo]] #### huggingface_hub.KernelInfo[[huggingface_hub.KernelInfo]] ```python huggingface_hub.KernelInfo(**kwargs) ``` [Kaynak](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L1285) **Parametreler:** id (`str`) : Çekirdek deposunun kimliği. author (`str`, *isteğe bağlı*) : Çekirdek deposunun yazarı. downloads (`int`, *isteğe bağlı*) : Son 30 gün içinde çekirdek deposunun indirme sayısı. gated (`Literal["auto", "manual", False]`, *isteğe bağlı*) : Depo kapalı mı? Eğer öyleyse, onayın manuel mi yoksa otomatik mi olduğu. last_modified (`datetime`, *isteğe bağlı*) : Depoya son commit tarihi. likes (`int`, *isteğe bağlı*) : Çekirdek deposunun beğeni sayısı. private (`bool`, *isteğe bağlı*) : Depo özel mi. sha (`str`, *isteğe bağlı*) : Bu özel revizyondaki depo SHA'sı. Hub'daki bir çekirdek deposu hakkında bilgi içerir. Bu nesne [kernel_info()](/docs/huggingface_hub/v2.4.0/tr/package_reference/hf_api#huggingface_hub.HfApi.kernel_info) tarafından döndürülür. ### LFSFileInfo[[huggingface_hub.hf_api.LFSFileInfo]] #### huggingface_hub.hf_api.LFSFileInfo[[huggingface_hub.hf_api.LFSFileInfo]] ```python huggingface_hub.hf_api.LFSFileInfo(**kwargs) ``` [Kaynak](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L1887) **Parametreler:** file_oid (`str`) : Dosyanın SHA-256 nesne kimliği. Bu, dosyanın kalıcı olarak silinmesi sırasında geçirilecek tanımlayıcıdır. filename (`str`) : LFS nesnesi için olası dosya adı. Daha fazla bilgi için yukarıdaki notu inceleyin. oid (`str`) : LFS nesnesinin OID'si. pushed_at (`datetime`) : LFS nesnesinin depoya gönderildiği tarih. ref (`str`, *isteğe bağlı*) : LFS nesnesinin itildiği referans (varsa). size (`int`) : LFS nesnesinin boyutu. Hub'daki bir depoda LFS olarak saklanan bir dosya hakkında bilgi içerir. Bir depodan LFS dosyalarını listelemek ve kalıcı olarak silmek suretiyle yer açma bağlamında kullanılır. Daha fazla ayrıntı için [list_lfs_files()](/docs/huggingface_hub/v2.4.0/tr/package_reference/hf_api#huggingface_hub.HfApi.list_lfs_files) ve [permanently_delete_lfs_files()](/docs/huggingface_hub/v2.4.0/tr/package_reference/hf_api#huggingface_hub.HfApi.permanently_delete_lfs_files) işlevlerine bakın. Git LFS dosyaları, performansın optimize edilmesi amacıyla dosya yolları yerine SHA-256 nesne kimlikleri kullanılarak izlenir. Bu yaklaşım gereklidir çünkü tek bir nesne, farklı commit'ler boyunca birden çok yol tarafından referans alınabilir ve bu bağlantıları aramak ve çözmek pratik değildir. Her SHA ile hangi dosya adlarının ilişkili olduğunu nasıl öğrenebileceğinizi öğrenmek için [belgelerimize](https://huggingface.co/docs/hub/storage-limits#advanced-track-lfs-file-references) göz atın. Örnek: ```py >>> from huggingface_hub import HfApi >>> api = HfApi() >>> lfs_files = api.list_lfs_files("username/my-cool-repo") # Filter files to delete based on a combination of `filename`, `pushed_at`, `ref` or `size`. # e.g. select only LFS files in the "checkpoints" folder >>> lfs_files_to_delete = (lfs_file for lfs_file in lfs_files if lfs_file.filename.startswith("checkpoints/")) # Permanently delete LFS files >>> api.permanently_delete_lfs_files("username/my-cool-repo", lfs_files_to_delete) ``` ### ModelInfo[[huggingface_hub.ModelInfo]] #### huggingface_hub.ModelInfo[[huggingface_hub.ModelInfo]] ```python huggingface_hub.ModelInfo(**kwargs) ``` [Kaynak](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L798) **Parametreler:** id (`str`) : Model kimliği. author (`str`, *isteğe bağlı*) : Modelin yazarı. base_models (`list[str]`, *isteğe bağlı*) : Bu modelin türetildiği temel modellerin listesi. card_data (`ModelCardData`, *isteğe bağlı*) : [huggingface_hub.repocard_data.ModelCardData](/docs/huggingface_hub/v2.4.0/tr/package_reference/cards#huggingface_hub.ModelCardData) nesnesi olarak Model Kartı Meta verisi. children_model_count (`int`, *isteğe bağlı*) : Bu modelden türetilen çocuk modellerin sayısı. config (`dict`, *isteğe bağlı*) : Model yapılandırması. created_at (`datetime`, *isteğe bağlı*) : Hub'daki repozitorinin oluşturulma tarihi. En düşük değerin `2022-03-02T23:29:04.000Z` olduğunu ve bu tarihin, oluşturma tarihlerini depolamaya başladığımız tarihe karşılık geldiğini unutmayın. disabled (`bool`, *isteğe bağlı*) : Deponun devre dışı bırakılıp bırakılmadığı. downloads (`int`) : Modelin son 30 gün içindeki indirme sayısı. downloads_all_time (`int`) : Modelin oluşturulmasından bu yana kümülatif indirme sayısı. eval_results (`list[EvalResultEntry]`, *isteğe bağlı*) : Modelin değerlendirme sonuçları. gated (`Literal["auto", "manual", False]`, *isteğe bağlı*) : Depo kapalı mı? Eğer öyleyse, onayın manuel mi yoksa otomatik mi olduğu. gguf (`dict`, *isteğe bağlı*) : Modelin GGUF bilgileri. inference (`Literal["warm"]`, *isteğe bağlı*) : Modelin Inference Providers'taki durumu. Model en az bir sağlayıcı tarafından sunuluyorsa sıcak (warm) olarak işaretlenir. inference_provider_mapping (`list[InferenceProviderMapping]`, *isteğe bağlı*) : Kullanıcının sağlayıcı sırasına göre sıralanmış bir `InferenceProviderMapping` listesi. last_modified (`datetime`, *isteğe bağlı*) : Depoya son commit tarihi. library_name (`str`, *isteğe bağlı*) : Modelle ilişkili kütüphane. likes (`int`) : Modelin beğeni sayısı. mask_token (`str`, *isteğe bağlı*) : Modelin kullandığı maske sembolü. model_index (`dict`, *isteğe bağlı*) : Değerlendirme için model indeksi. pipeline_tag (`str`, *isteğe bağlı*) : Modelle ilişkili pipeline etiketi. private (`bool`) : Depo özel mi. resource_group (`dict`, *isteğe bağlı*) : Model için kaynak grubu bilgisi. safetensors (`SafeTensorsInfo`, *isteğe bağlı*) : Modelin safetensors bilgileri. security_repo_status (`dict`, *isteğe bağlı*) : Modelin güvenlik tarama durumu. sha (`str`, *isteğe bağlı*) : Bu özel revizyondaki depo SHA'sı. siblings (`list[RepoSibling]`) : Modeli oluşturan [huggingface_hub.hf_api.RepoSibling](/docs/huggingface_hub/v2.4.0/tr/package_reference/hf_api#huggingface_hub.hf_api.RepoSibling) nesnelerinin listesi. spaces (`list[str]`, *isteğe bağlı*) : Modeli kullanan boşlukların listesi. tags (`list[str]`) : Modelin etiketlerinin listesi. `card_data.tags` ile karşılaştırıldığında, Hub tarafından hesaplanan ek etiketleri (ör. desteklenen kütüphaneler, modelin arXiv) içerir. transformers_info (`TransformersInfo`, *isteğe bağlı*) : Modelle ilişkili Transformers'a özgü bilgiler (auto sınıfı, işlemci vb.). trending_score (`int`, *isteğe bağlı*) : Modelin trend skoru. used_storage (`int`, *isteğe bağlı*) : Hub'daki modelin bayt cinsinden boyutu. widget_data (`Any`, *isteğe bağlı*) : Modelle ilişkili widget verisi. Hub'daki bir model hakkında bilgi içerir. Bu nesne [model_info()](/docs/huggingface_hub/v2.4.0/tr/package_reference/hf_api#huggingface_hub.HfApi.model_info) ve [list_models()](/docs/huggingface_hub/v2.4.0/tr/package_reference/hf_api#huggingface_hub.HfApi.list_models) tarafından döndürülür. > [!TIP] > Bu sınıfın çoğu özelliği isteğe bağlıdır. Bunun nedeni, Hub tarafından döndürülen verinin yapılan sorguya bağlı olmasıdır. Genel olarak, sorgu ne kadar spesifikse, o kadar çok bilgi döndürülür. Buna karşılık, [list_models()](/docs/huggingface_hub/v2.4.0/tr/package_reference/hf_api#huggingface_hub.HfApi.list_models) kullanılarak modeller listelendiğinde yalnızca özelliklerin bir alt kümesi döndürülür. ### RepoSibling[[huggingface_hub.hf_api.RepoSibling]] #### huggingface_hub.hf_api.RepoSibling[[huggingface_hub.hf_api.RepoSibling]] ```python huggingface_hub.hf_api.RepoSibling(rfilename: str, size: int | None = None, blob_id: str | None = None, lfs: BlobLfsInfo | None = None) ``` [Kaynak](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L648) **Parametreler:** rfilename (str) : depo köküne göre göreli dosya adı. size (`int`, *isteğe bağlı*) : Dosyanın bayt cinsinden boyutu. Bu öznitelik, [repo_info()](/docs/huggingface_hub/v2.4.0/tr/package_reference/hf_api#huggingface_hub.HfApi.repo_info) işlevinin `files_metadata` argümanı `True` olarak ayarlandığında tanımlanır. Aksi halde `None`'dir. blob_id (`str`, *isteğe bağlı*) : Dosyanın git OID'si. Bu öznitelik, [repo_info()](/docs/huggingface_hub/v2.4.0/tr/package_reference/hf_api#huggingface_hub.HfApi.repo_info) işlevinin `files_metadata` argümanı `True` olarak ayarlandığında tanımlanır. Aksi halde `None`'dir. lfs (`BlobLfsInfo`, *isteğe bağlı*) : Dosyanın LFS meta verileri. Bu öznitelik, [repo_info()](/docs/huggingface_hub/v2.4.0/tr/package_reference/hf_api#huggingface_hub.HfApi.repo_info) işlevinin `files_metadata` argümanı `True` olarak ayarlandığında ve dosya Git LFS ile depolandığında tanımlanır. Aksi halde `None` değerini alır. Hub'daki bir depodaki depo dosyası hakkında temel bilgiler içerir. > [!TIP] > Bu sınıfın `rfilename` dışında tüm özellikleri isteğe bağlıdır. Bunun nedeni, Hub'da depoları listelerken ( [list_models()](/docs/huggingface_hub/v2.4.0/tr/package_reference/hf_api#huggingface_hub.HfApi.list_models) , [list_datasets()](/docs/huggingface_hub/v2.4.0/tr/package_reference/hf_api#huggingface_hub.HfApi.list_datasets) veya [list_spaces()](/docs/huggingface_hub/v2.4.0/tr/package_reference/hf_api#huggingface_hub.HfApi.list_spaces) ile) yalnızca dosya adlarının döndürülmesidir. Dosya boyutu, blob kimliği veya lfs ayrıntıları gibi daha fazla bilgiye ihtiyacınız varsa, bunları arka uç sunucuya bu bilgileri getirmek için daha fazla kısıtlama eklediğinden, bunları tek tek her depo için özellikle talep etmeniz gerekir ( [model_info()](/docs/huggingface_hub/v2.4.0/tr/package_reference/hf_api#huggingface_hub.HfApi.model_info) , [dataset_info()](/docs/huggingface_hub/v2.4.0/tr/package_reference/hf_api#huggingface_hub.HfApi.dataset_info) veya [space_info()](/docs/huggingface_hub/v2.4.0/tr/package_reference/hf_api#huggingface_hub.HfApi.space_info) kullanarak). ### RepoFile[[huggingface_hub.RepoFile]] #### huggingface_hub.RepoFile[[huggingface_hub.RepoFile]] ```python huggingface_hub.RepoFile(**kwargs) ``` [Kaynak](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L680) **Parametreler:** path (str) : depo köküne göre göreli dosya yolu. size (`int`) : Dosyanın bayt cinsinden boyutu. blob_id (`str`) : Dosyanın git OID'si. lfs (`BlobLfsInfo`, *isteğe bağlı*) : Dosyanın LFS meta verileri. xet_hash (`str`, *isteğe bağlı*) : Dosyanın Xet özeti. last_commit (`LastCommitInfo`, *isteğe bağlı*) : Dosyanın son commit meta verileri. Yalnızca [list_repo_tree()](/docs/huggingface_hub/v2.4.0/tr/package_reference/hf_api#huggingface_hub.HfApi.list_repo_tree) ve [get_paths_info()](/docs/huggingface_hub/v2.4.0/tr/package_reference/hf_api#huggingface_hub.HfApi.get_paths_info) `expand=True` ile çağrıldığında tanımlıdır. security (`BlobSecurityInfo`, *isteğe bağlı*) : Dosyanın güvenlik tarama meta verileri. Yalnızca [list_repo_tree()](/docs/huggingface_hub/v2.4.0/tr/package_reference/hf_api#huggingface_hub.HfApi.list_repo_tree) ve [get_paths_info()](/docs/huggingface_hub/v2.4.0/tr/package_reference/hf_api#huggingface_hub.HfApi.get_paths_info) `expand=True` ile çağrıldığında tanımlıdır. Hub'daki bir dosya hakkında bilgi içerir. ### RepoUrl[[huggingface_hub.RepoUrl]] #### huggingface_hub.RepoUrl[[huggingface_hub.RepoUrl]] ```python huggingface_hub.RepoUrl(url: Any, endpoint: str | None = None) ``` [Kaynak](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L527) **Parametreler:** url (`Any`) : repo url'sinin String değeri. endpoint (`str`, *isteğe bağlı*) : Hub'un uç noktası. Varsayılan olarak . **Yükselen:** `HfUriError` - `HfUriError` -- URL çözümlenemezse (ör. kanonik tek segmentli depo veya bilinmeyen `repo_type`). Hub'daki bir depo URL'sini tanımlayan `str` alt sınıfı. `RepoUrl`, `HfApi.create_repo` tarafından döndürülür. Geriye dönük uyumluluk için `str`'den devralır. Başlatma sırasında URL, özellikleri doldurmak için ayrıştırılır: - endpoint (`str`) - namespace (`str`) - repo_name (`str`) - repo_id (`str`) - repo_type (`Literal["model", "dataset", "space"]`) - url (`str`) Örnek: ```py >>> RepoUrl('https://huggingface.co/openai-community/gpt2') RepoUrl('https://huggingface.co/openai-community/gpt2', endpoint='https://huggingface.co', repo_type='model', repo_id='openai-community/gpt2') >>> RepoUrl('https://hub-ci.huggingface.co/datasets/dummy_user/dummy_dataset', endpoint='https://hub-ci.huggingface.co') RepoUrl('https://hub-ci.huggingface.co/datasets/dummy_user/dummy_dataset', endpoint='https://hub-ci.huggingface.co', repo_type='dataset', repo_id='dummy_user/dummy_dataset') >>> RepoUrl('hf://datasets/my-user/my-dataset') RepoUrl('hf://datasets/my-user/my-dataset', endpoint='https://huggingface.co', repo_type='dataset', repo_id='user/dataset') >>> HfApi.create_repo("dummy_model") RepoUrl('https://huggingface.co/Wauplin/dummy_model', endpoint='https://huggingface.co', repo_type='model', repo_id='Wauplin/dummy_model') ``` ### SafetensorsRepoMetadata[[huggingface_hub.utils.SafetensorsRepoMetadata]] #### huggingface_hub.utils.SafetensorsRepoMetadata[[huggingface_hub.utils.SafetensorsRepoMetadata]] ```python huggingface_hub.utils.SafetensorsRepoMetadata(metadata: dict | None, sharded: bool, weight_map: dict, files_metadata: dict) ``` [Kaynak](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/utils/_safetensors.py#L74) **Parametreler:** metadata (`dict`, *isteğe bağlı*) : Var ise, 'model.safetensors.index.json' dosyasında bulunan meta veriler. Yalnızca parçalı modeller için doldurulur. sharded (`bool`) : Deponun parçalı bir model içerip içermediğini belirtir. weight_map (`dict[str, str]`) : Tüm ağırlıkların haritası. Anahtarlar tensör adları, değerler ise tensörleri içeren dosyaların dosya adlarıdır. files_metadata (`dict[str, SafetensorsFileMetadata]`) : Tüm dosyaların metadata haritası. Anahtarlar dosya adlarıdır ve değerler, ilgili dosyanın metadata'sıdır; bir `SafetensorsFileMetadata` nesnesi olarak. parameter_count (`dict[str, int]`) : Veri türüne göre parametre sayılarının haritası. Anahtarlar veri türlerini, değerler ise o veri türündeki parametre sayısını temsil eder. Safetensors deposu için meta veriler. Bir depo, kök dizininde 'model.safetensors' ağırlık dosyası (paylaşılmayan model) veya 'model.safetensors.index.json' dizin dosyası (parçalı model) içeriyorsa bir Safetensors deposu olarak kabul edilir. Bu sınıf, [get_safetensors_metadata()](/docs/huggingface_hub/v2.4.0/tr/package_reference/hf_api#huggingface_hub.HfApi.get_safetensors_metadata) tarafından döndürülür. safetensors formatı hakkında daha fazla ayrıntı için https://huggingface.co/docs/safetensors/index#format adresine göz atın. ### SafetensorsFileMetadata[[huggingface_hub.utils.SafetensorsFileMetadata]] #### huggingface_hub.utils.SafetensorsFileMetadata[[huggingface_hub.utils.SafetensorsFileMetadata]] ```python huggingface_hub.utils.SafetensorsFileMetadata(metadata: dict, tensors: dict) ``` [Kaynak](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/utils/_safetensors.py#L44) **Parametreler:** metadata (`dict`) : Dosyada bulunan meta veriler. tensors (`dict[str, TensorInfo]`) : Tüm tensörlerin haritası. Anahtarlar tensör adlarıdır ve değerler, ilgili tensörün bilgilerini bir `TensorInfo` nesnesi olarak içerir. parameter_count (`dict[str, int]`) : Veri türüne göre parametre sayılarının haritası. Anahtarlar veri türlerini, değerler ise o veri türündeki parametre sayısını temsil eder. Hub üzerinde barındırılan bir Safetensors dosyasının meta verileri. Bu sınıf, [parse_safetensors_file_metadata()](/docs/huggingface_hub/v2.4.0/tr/package_reference/hf_api#huggingface_hub.HfApi.parse_safetensors_file_metadata) tarafından döndürülür. safetensors formatı hakkında daha fazla ayrıntı için https://huggingface.co/docs/safetensors/index#format adresine göz atın. ### SpaceInfo[[huggingface_hub.SpaceInfo]] #### huggingface_hub.SpaceInfo[[huggingface_hub.SpaceInfo]] ```python huggingface_hub.SpaceInfo(**kwargs) ``` [Kaynak](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L1147) **Parametreler:** id (`str`) : Space'in kimliği. author (`str`, *isteğe bağlı*) : Space'in yazarı. card_data (`SpaceCardData`, *isteğe bağlı*) : [huggingface_hub.repocard_data.SpaceCardData](/docs/huggingface_hub/v2.4.0/tr/package_reference/cards#huggingface_hub.SpaceCardData) nesnesi olarak Space Card Meta verisi. created_at (`datetime`, *isteğe bağlı*) : Hub'daki repozitorinin oluşturulma tarihi. En düşük değerin `2022-03-02T23:29:04.000Z` olduğunu ve bu tarihin, oluşturma tarihlerini depolamaya başladığımız tarihe karşılık geldiğini unutmayın. datasets (`list[str]`, *isteğe bağlı*) : Space tarafından kullanılan veri kümelerinin listesi. disabled (`bool`, *isteğe bağlı*) : Space devre dışı mı? gated (`Literal["auto", "manual", False]`, *isteğe bağlı*) : Depo kapalı mı? Eğer öyleyse, onayın manuel mi yoksa otomatik mi olduğu. host (`str`, *isteğe bağlı*) : Space'in ana URL'si. last_modified (`datetime`, *isteğe bağlı*) : Depoya son commit tarihi. likes (`int`) : Number of likes of the Space. models (`list[str]`, *isteğe bağlı*) : Space tarafından kullanılan modellerin listesi. private (`bool`) : Depo özel mi. region (`Literal["us", "eu"]`, *isteğe bağlı*) : Space'in depolandığı bulut bölgesi. resource_group (`dict`, *isteğe bağlı*) : Space için kaynak grubu bilgisi. runtime (`SpaceRuntime`, *isteğe bağlı*) : [huggingface_hub.hf_api.SpaceRuntime](/docs/huggingface_hub/v2.4.0/tr/package_reference/space_runtime#huggingface_hub.SpaceRuntime) nesnesi olarak Space çalışma zamanı bilgisi. sdk (`str`, *isteğe bağlı*) : Space tarafından kullanılan SDK. sha (`str`, *isteğe bağlı*) : Bu özel revizyondaki depo SHA'sı. siblings (`list[RepoSibling]`) : Space'i oluşturan [huggingface_hub.hf_api.RepoSibling](/docs/huggingface_hub/v2.4.0/tr/package_reference/hf_api#huggingface_hub.hf_api.RepoSibling) nesnelerinin listesi. subdomain (`str`, *isteğe bağlı*) : Space'in alt alanı. tags (`list[str]`) : Space etiketlerinin listesi. trending_score (`int`, *isteğe bağlı*) : Space'in trend skoru. used_storage (`int`, *isteğe bağlı*) : Hub'daki Space'in bayt cinsinden boyutu. Hub'daki bir Space hakkında bilgi içerir. Bu nesne [space_info()](/docs/huggingface_hub/v2.4.0/tr/package_reference/hf_api#huggingface_hub.HfApi.space_info) ve [list_spaces()](/docs/huggingface_hub/v2.4.0/tr/package_reference/hf_api#huggingface_hub.HfApi.list_spaces) tarafından döndürülür. > [!TIP] > Bu sınıfın çoğu özelliği isteğe bağlıdır. Bunun nedeni, Hub tarafından döndürülen verinin yapılan sorguya bağlı olmasıdır. Genel olarak, sorgu ne kadar spesifikse, o kadar çok bilgi döndürülür. Buna karşılık, [list_spaces()](/docs/huggingface_hub/v2.4.0/tr/package_reference/hf_api#huggingface_hub.HfApi.list_spaces) kullanılarak uzaylar listelendiğinde yalnızca özelliklerin bir alt kümesi döndürülür. ### SpaceSearchResult[[huggingface_hub.SpaceSearchResult]] #### huggingface_hub.SpaceSearchResult[[huggingface_hub.SpaceSearchResult]] ```python huggingface_hub.SpaceSearchResult(data: dict) ``` [Kaynak](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/_space_api.py#L309) **Parametreler:** id (`str`) : Space'in kimliği (ör. `"username/repo-name"`). author (`str`) : Uzayın sahibi. title (`str`) : Space'in görüntüleme başlığı. emoji (`str` veya `None`) : Space'in emoji simgesi. sdk (`str` veya `None`) : Space'in kullandığı SDK (ör. `"gradio"`, `"docker"`, `"static"`). likes (`int`) : Beğeni sayısı. private (`bool`) : Space'in özel olup olmadığı. tags (`list[str]` veya `None`) : Etiket listesi. runtime ([SpaceRuntime](/docs/huggingface_hub/v2.4.0/tr/package_reference/space_runtime#huggingface_hub.SpaceRuntime) veya `None`) : Çalışma zamanı bilgileri (aşama, donanım vb.). ai_short_description (`str` veya `None`) : Yapay zeka tarafından oluşturulan kısa açıklama. ai_category (`str` veya `None`) : Yapay zeka tarafından oluşturulan kategori (ör. `"Image Generation"`). semantic_relevancy_score (`float` veya `None`) : Arama sorgusuna göre semantik ilgili puanı (0-1). trending_score (`int` veya `None`) : Trend skoru. Spaces anlamsal arama API'sinden tek bir sonuç. [HfApi.search_spaces()](/docs/huggingface_hub/v2.4.0/tr/package_reference/hf_api#huggingface_hub.HfApi.search_spaces) tarafından döndürülür. ### TensorInfo[[huggingface_hub.utils.TensorInfo]] #### huggingface_hub.utils.TensorInfo[[huggingface_hub.utils.TensorInfo]] ```python huggingface_hub.utils.TensorInfo(dtype: typing.Literal['F64', 'F32', 'F16', 'BF16', 'I64', 'I32', 'I16', 'I8', 'U8', 'U3', 'BOOL'], shape: list, data_offsets: tuple) ``` [Kaynak](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/utils/_safetensors.py#L14) **Parametreler:** dtype (`str`) : Tensörün veri türü ("F64", "F32", "F16", "BF16", "I64", "I32", "I16", "I8", "U8", "U3", "BOOL"). shape (`list[int]`) : Tensörün şekli. data_offsets (`tuple[int, int]`) : Dosyadaki verilerin ofsetleri, `[BEGIN, END]` biçiminde bir tuple olarak. parameter_count (`int`) : Tensördeki parametre sayısı. Bir tensör hakkında bilgi. safetensors formatı hakkında daha fazla ayrıntı için https://huggingface.co/docs/safetensors/index#format adresine göz atın. ### Kullanıcı[[huggingface_hub.User]] #### huggingface_hub.User[[huggingface_hub.User]] ```python huggingface_hub.User(**kwargs) ``` [Kaynak](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L1658) **Parametreler:** username (`str`) : Hub'daki kullanıcının adı (benzersiz). fullname (`str`) : Kullanıcının tam adı. avatar_url (`str`) : Kullanıcının avatarının URL'si. details (`str`, *isteğe bağlı*) : Kullanıcının ayrıntıları. is_following (`bool`, *isteğe bağlı*) : Kimliği doğrulanmış kullanıcının bu kullanıcıyı takip edip etmediğini belirtir. is_pro (`bool`, *isteğe bağlı*) : Kullanıcının pro kullanıcısı olup olmadığı. num_models (`int`, *isteğe bağlı*) : Kullanıcının oluşturduğu model sayısı. num_datasets (`int`, *isteğe bağlı*) : Kullanıcının oluşturduğu veri setlerinin sayısı. num_spaces (`int`, *isteğe bağlı*) : Kullanıcının oluşturduğu boşluk sayısı. num_discussions (`int`, *isteğe bağlı*) : Kullanıcının başlattığı tartışma sayısı. num_papers (`int`, *isteğe bağlı*) : Kullanıcının yazarı olduğu makale sayısı. num_upvotes (`int`, *isteğe bağlı*) : Kullanıcının aldığı olumlu oy sayısı. num_likes (`int`, *isteğe bağlı*) : Kullanıcının verdiği beğeni sayısı. num_following (`int`, *isteğe bağlı*) : Bu kullanıcının takip ettiği kullanıcı sayısı. num_followers (`int`, *isteğe bağlı*) : Bu kullanıcıyı takip eden kullanıcı sayısı. orgs (`Organization` listesi) : Kullanıcının üye olduğu kuruluşların listesi. Hub'daki bir kullanıcıyla ilgili bilgileri içerir. ### UserLikes[[huggingface_hub.UserLikes]] #### huggingface_hub.UserLikes[[huggingface_hub.UserLikes]] ```python huggingface_hub.UserLikes(user: str, total: int, datasets: list[str], kernels: list[str], models: list[str], spaces: list[str]) ``` [Kaynak](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L1522) **Parametreler:** user (`str`) : Beğenileri aldığımız kullanıcının adı. total (`int`) : Toplam beğeni sayısı. datasets (`list[str]`) : Kullanıcının beğendiği veri kümelerinin listesi (repo_ids olarak). kernels (`list[str]`) : Kullanıcının beğendiği çekirdeklerin listesi (repo_ids olarak). models (`list[str]`) : Kullanıcının beğendiği modellerin listesi (repo_ids olarak). spaces (`list[str]`) : Kullanıcının beğendiği boşlukların listesi (repo_ids olarak). Hub'daki bir kullanıcının beğenileri hakkında bilgi içerir. ### WebhookInfo[[huggingface_hub.WebhookInfo]] #### huggingface_hub.WebhookInfo[[huggingface_hub.WebhookInfo]] ```python huggingface_hub.WebhookInfo(id: str, url: str | None, job: JobSpec | None, watched: list[WebhookWatchedItem], domains: list[constants.WEBHOOK_DOMAIN_T], secret: str | None, disabled: bool) ``` [Kaynak](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L496) **Parametreler:** id (`str`) : Webhook kimliği. url (`str`, *isteğe bağlı*) : Webhook'un URL'si. job (`JobSpec`, *isteğe bağlı*) : Tetiklenecek Job'un spesifikasyonları. watched (`list[WebhookWatchedItem]`) : Webhook tarafından izlenen öğelerin listesi, bkz. [WebhookWatchedItem](/docs/huggingface_hub/v2.4.0/tr/package_reference/hf_api#huggingface_hub.WebhookWatchedItem). domains (`list[WEBHOOK_DOMAIN_T]`) : Webhook'ün izlediği alan adlarının listesi. `["repo", "discussion"]` değerlerinden biri olabilir. secret (`str`, *isteğe bağlı*) : Webhook'un gizli anahtarı. disabled (`bool`) : Webhook'ün devre dışı bırakılıp bırakılmadığını belirtir. Bir webhook hakkında bilgi içeren veri yapısı. `url` veya `job`'dan biri, ancak ikisi birden belirtilmemiştir. ### WebhookWatchedItem[[huggingface_hub.WebhookWatchedItem]] #### huggingface_hub.WebhookWatchedItem[[huggingface_hub.WebhookWatchedItem]] ```python huggingface_hub.WebhookWatchedItem(type: Literal['bucket', 'dataset', 'model', 'org', 'space', 'user'], name: str) ``` [Kaynak](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/hf_api.py#L480) **Parametreler:** type (`Literal["bucket", "dataset", "model", "org", "space", "user"]`) : İzlenecek öğenin türü. `["bucket", "dataset", "model", "org", "space", "user"]` değerlerinden biri olabilir. name (`str`) : İzlenecek öğenin adı. Kullanıcı adı, kuruluş adı, model adı, veri seti adı, space adı veya bucket adı olabilir. Bir webhook tarafından izlenen öğeler hakkında bilgi içeren veri yapısı. ## CommitOperation[[huggingface_hub.CommitOperationAdd]] Aşağıda `CommitOperation()` için desteklenen değerler yer almaktadır: #### huggingface_hub.CommitOperationAdd[[huggingface_hub.CommitOperationAdd]] ```python huggingface_hub.CommitOperationAdd(path_in_repo: str, path_or_fileobj: str | pathlib.Path | bytes | typing.BinaryIO) ``` [Kaynak](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/_commit_api.py#L141) **Parametreler:** path_in_repo (`str`) : Depodaki göreli dosya yolu, örneğin: `"checkpoints/1fec34a/weights.bin"` path_or_fileobj (`str`, `Path`, `bytes` veya `BinaryIO`) : Şunlardan biri: - Yüklemek için yerel bir dosyanın yolu (`str` veya `pathlib.Path` olarak) - Yüklenmek istenen dosyanın içeriğini içeren bir bayt tamponu (`bytes`) - Genellikle `open(path, "rb")` ile elde edilen bir "dosya nesnesi" (`io.BufferedIOBase` alt sınıfı). `seek()` ve `tell()` yöntemlerini desteklemelidir. **Yükselen:** ``ValueError`` - [`ValueError`](https://docs.python.org/3/library/exceptions.html#ValueError) -- `path_or_fileobj`, `str`, `Path`, `bytes` veya `io.BufferedIOBase` türlerinden biri değilse. - [`ValueError`](https://docs.python.org/3/library/exceptions.html#ValueError) -- `path_or_fileobj` bir `str` veya `Path` ise ancak mevcut bir dosyanın yoluna işaret etmiyorsa. - [`ValueError`](https://docs.python.org/3/library/exceptions.html#ValueError) -- `path_or_fileobj` bir `io.BufferedIOBase` ise ancak hem `seek()` hem de `tell()` desteklenmiyorsa. Hub'daki bir depoya dosya yüklemek için gerekli bilgileri tutan veri yapısı. #### as_file[[huggingface_hub.CommitOperationAdd.as_file]] ```python as_file(with_tqdm: bool = False) ``` [Kaynak](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/_commit_api.py#L223) **Parametreler:** with_tqdm (`bool`, *isteğe bağlı*, varsayılan `False`) : True ise, dosya nesnesi üzerinde gezinme işlemi bir ilerleme çubuğu görüntüler. Yalnızca dosya benzeri nesne bir dosya yoluysa çalışır. Saf baytlar ve tamponlar desteklenmez. `path_or_fileobj` altındaki verileri okumaya izin veren dosya benzeri bir nesne üreten bir bağlam yöneticisi. Örnek: ```python >>> operation = CommitOperationAdd( ... path_in_repo="remote/dir/weights.h5", ... path_or_fileobj="./local/weights.h5", ... ) CommitOperationAdd(path_in_repo='remote/dir/weights.h5', path_or_fileobj='./local/weights.h5') >>> with operation.as_file() as file: ... content = file.read() >>> with operation.as_file(with_tqdm=True) as file: ... while True: ... data = file.read(1024) ... if not data: ... break config.json: 100%|█████████████████████████| 8.19k/8.19k [00:02<00:00, 3.72kB/s] >>> with operation.as_file(with_tqdm=True) as file: ... httpx2.put(..., data=file) config.json: 100%|█████████████████████████| 8.19k/8.19k [00:02<00:00, 3.72kB/s] ``` #### b64content[[huggingface_hub.CommitOperationAdd.b64content]] ```python b64content() ``` [Kaynak](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/_commit_api.py#L275) `path_or_fileobj`'in base64 kodlanmış içeriği Dönüş: `bytes` #### huggingface_hub.CommitOperationDelete[[huggingface_hub.CommitOperationDelete]] ```python huggingface_hub.CommitOperationDelete(path_in_repo: str, is_folder: typing.Union[bool, typing.Literal['auto']] = 'auto') ``` [Kaynak](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/_commit_api.py#L56) **Parametreler:** path_in_repo (`str`) : Depodaki göreli dosya yolu, örneğin bir dosya için `"checkpoints/1fec34a/weights.bin"` veya bir klasör için `"checkpoints/1fec34a/"`. is_folder (`bool` veya `Literal["auto"]`, *isteğe bağlı*) : Silme İşleminin bir klasöre mi yoksa dosyaya mı uygulandığını belirtir. "auto" değeri verilirse, yolun "/" ile mi (klasör) yoksa başka bir karakterle mi (dosya) bittiğine bakılarak yol türü (dosya veya klasör) otomatik olarak tahmin edilir. Yol türünü açıkça belirtmek için `is_folder=True` veya `is_folder=False` değerlerini ayarlayabilirsiniz. Hub'daki bir depodan bir dosya veya klasörü silmek için gerekli bilgileri tutan veri yapısı. #### huggingface_hub.CommitOperationCopy[[huggingface_hub.CommitOperationCopy]] ```python huggingface_hub.CommitOperationCopy(src_path_in_repo: str, path_in_repo: str, src_revision: str | None = None, src_repo_id: str | None = None, src_repo_type: str | None = None, _src_oid: str | None = None, _dest_oid: str | None = None, _is_duplicated: bool = False) ``` [Kaynak](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/_commit_api.py#L87) **Parametreler:** src_path_in_repo (`str`) : Kopyalanacak dosyanın depodaki göreli dosya yolu, örn. `"checkpoints/1fec34a/weights.bin"`. path_in_repo (`str`) : Dosyanın kopyalanacağı depodaki göreli dosya yolu, örn. `"checkpoints/1fec34a/weights_copy.bin"`. src_revision (`str`, *isteğe bağlı*) : Kopyalanacak dosyanın git revizyonu. Geçerli herhangi bir git revizyonu olabilir. Varsayılan olarak hedef commit revizyonuna ayarlanır. src_repo_id (`str`, *isteğe bağlı*) : Kopyalanacak kaynak depo (ör. `"username/source-model"`). Varsayılan olarak hedef depodur (depo içi kopyalama). src_repo_type (`str`, *isteğe bağlı*) : Kaynak depoyun türü (`"model"`, `"dataset"` veya `"space"`). `src_repo_id` ayarlandığında zorunludur. Hub'daki bir depodaki dosyayı kopyalamak için gerekli bilgileri tutan veri yapısı. Hem LFS dosyaları hem de normal dosyalar desteklenir. LFS dosyaları sunucu tarafında kopyalanırken normal dosyalar, commit'in bir parçası olarak indirilir ve yeniden yüklenir. Depo arası kopyalamalar, `src_repo_id` ve `src_repo_type` ayarlanarak desteklenir. Depo arası LFS kopyalamalarında, commit oluşturulmadan önce LFS nesneleri hedef depoya kopyalanır. Bu işlem [create_commit()](/docs/huggingface_hub/v2.4.0/tr/package_reference/hf_api#huggingface_hub.HfApi.create_commit) tarafından otomatik olarak yönetilir. Depo arası kopyalamaların yalnızca aynı [depolama bölgesi](https://huggingface.co/docs/hub/storage-regions) içinde çalıştığını, bölgeler arası kopyalamanın desteklenmediğini unutmayın. Not: Hub'da bir LFS dosyasını yeniden adlandırmak için [CommitOperationCopy](/docs/huggingface_hub/v2.4.0/tr/package_reference/hf_api#huggingface_hub.CommitOperationCopy) ve [CommitOperationDelete](/docs/huggingface_hub/v2.4.0/tr/package_reference/hf_api#huggingface_hub.CommitOperationDelete) işlemlerini birleştirebilirsiniz. ## CommitScheduler[[huggingface_hub.CommitScheduler]] #### huggingface_hub.CommitScheduler[[huggingface_hub.CommitScheduler]] ```python huggingface_hub.CommitScheduler(repo_id: str, folder_path: str | pathlib.Path, every: int | float = 5, path_in_repo: str | None = None, repo_type: str | None = None, revision: str | None = None, private: bool | None = None, token: str | None = None, allow_patterns: list[str] | str | None = None, ignore_patterns: list[str] | str | None = None, squash_history: bool = False, hf_api: typing.Optional[ForwardRef('HfApi')] = None) ``` [Kaynak](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/_commit_scheduler.py#L30) **Parametreler:** repo_id (`str`) : Commit yapılacak repozituarın kimliği. folder_path (`str` veya `Path`) : Düzenli olarak yüklenmesi gereken yerel klasörün yolu. every (`int` veya `float`, *isteğe bağlı*) : Her commit arasındaki dakika sayısı. Varsayılan olarak 5 dakikadır. path_in_repo (`str`, *isteğe bağlı*) : Depodaki dizinin göreli yolu, örneğin: `"checkpoints/"`. Varsayılan olarak deponun kök klasörüdür. repo_type (`str`, *isteğe bağlı*) : Commit yapılacak repoyun türü. Varsayılan olarak `model`'dir. revision (`str`, *isteğe bağlı*) : Commit'in yapılacağı repo revizyonu. Varsayılan olarak `main`'dir. private (`bool`, *isteğe bağlı*) : Depoyu özel yapılıp yapılmayacağını belirtir. `None` (varsayılan) ise, organizasyonun varsayılanı özel değilse depo herkese açık olur. Depo zaten mevcutsa bu değer yok sayılır. token (`str`, *isteğe bağlı*) : Depoya taahhüt etmek için kullanılacak jeton. Varsayılan olarak makinede kayıtlı jeton kullanılır. allow_patterns (`list[str]` veya `str`, *isteğe bağlı*) : Verilirse, yalnızca en az bir desenle eşleşen dosyalar yüklenir. ignore_patterns (`list[str]` veya `str`, *isteğe bağlı*) : Verilirse, desenlerden herhangi biriyle eşleşen dosyalar yüklenmez. squash_history (`bool`, *isteğe bağlı*) : Her commit sonrasında repoyu geçmişinin sıkıştırılıp sıkıştırılmayacağını belirtir. Varsayılan değer `False`'dir. Commit'lerin sıkıştırılması, repo çok büyük hale geldiğinde performans düşüşlerini önlemek için faydalıdır. hf_api (`HfApi`, *isteğe bağlı*) : Hub'a commit yapmak için kullanılacak [HfApi](/docs/huggingface_hub/v2.4.0/tr/package_reference/hf_api#huggingface_hub.HfApi) istemcisi. Özel ayarlarla (user agent, token,...) ayarlanabilir. Hub'a düzenli aralıklarla (ör. her 5 dakikada bir) yerel bir klasör yüklemek için zamanlayıcı. Zamanlayıcının önerilen kullanım yöntemi, bir bağlam yöneticisi olarak kullanmaktır. Bu, betik sonlandığında zamanlayıcının düzgün şekilde durdurulmasını ve son commit'in tetiklenmesini sağlar. Zamanlayıcı ayrıca `stop` yöntemiyle manuel olarak da durdurulabilir. Kullanımı hakkında daha fazla bilgi edinmek için [yükleme kılavuzuna](https://huggingface.co/docs/huggingface_hub/guides/upload#scheduled-uploads) göz atın. Örnek: ```py >>> from pathlib import Path >>> from huggingface_hub import CommitScheduler # Scheduler uploads every 10 minutes >>> csv_path = Path("watched_folder/data.csv") >>> CommitScheduler(repo_id="test_scheduler", repo_type="dataset", folder_path=csv_path.parent, every=10) >>> with csv_path.open("a") as f: ... f.write("first line") # Some time later (...) >>> with csv_path.open("a") as f: ... f.write("second line") ``` Bağlam yöneticisi kullanan örnek: ```py >>> from pathlib import Path >>> from huggingface_hub import CommitScheduler >>> with CommitScheduler(repo_id="test_scheduler", repo_type="dataset", folder_path="watched_folder", every=10) as scheduler: ... csv_path = Path("watched_folder/data.csv") ... with csv_path.open("a") as f: ... f.write("first line") ... (...) ... with csv_path.open("a") as f: ... f.write("second line") # Scheduler is now stopped and last commit have been triggered ``` #### push_to_hub[[huggingface_hub.CommitScheduler.push_to_hub]] ```python push_to_hub() ``` [Kaynak](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/_commit_scheduler.py#L204) Klasörü Hub'a gönderin ve commit bilgilerini döndürün. > [!WARNING] > Bu yöntemin doğrudan çağrılması amaçlanmamıştır. Eşzamanlı commit'leri önlemek için kuyruk mekanizmasını dikkate alarak zamanlayıcı tarafından arka planda çalıştırılır. Yönteme doğrudan bir çağrı yapılması, eşzamanlılık sorunlarına yol açabilir. `push_to_hub` varsayılan davranışı, eklemeye özel bir klasör varsayar. Klasördeki tüm dosyaları listeler ve yalnızca değiştirilen dosyaları yükler. Değişiklik bulunamazsa, yöntem hiçbir şey taahhüt etmeden döner. Bu davranışı değiştirmek isterseniz, [CommitScheduler](/docs/huggingface_hub/v2.4.0/tr/package_reference/hf_api#huggingface_hub.CommitScheduler) sınıfından türetip bu yöntemi geçersiz kılabilirsiniz. Örneğin, taahhüt etmeden önce verileri tek bir dosyada sıkıştırmak için bu işe yarayabilir. Daha fazla ayrıntı ve örnekler için [entegrasyon kılavuzumuza](https://huggingface.co/docs/huggingface_hub/main/en/guides/upload#scheduled-uploads) göz atın. #### stop[[huggingface_hub.CommitScheduler.stop]] ```python stop() ``` [Kaynak](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/_commit_scheduler.py#L157) Zamanlayıcıyı durdurun. Durdurulmuş bir zamanlayıcı yeniden başlatılamaz. Ağırlıklı olarak test amaçlıdır. #### tetikleyici[[huggingface_hub.CommitScheduler.trigger]] ```python trigger() ``` [Kaynak](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/_commit_scheduler.py#L181) Bir `push_to_hub` tetikleyin ve bir gelecek (future) döndürün. Bu yöntem her `every` dakikada bir otomatik olarak çağrılır. Bir sonraki planlanan commit'i beklemeden hemen bir commit tetiklemek için bunu manuel olarak da çağırabilirsiniz.