Recherchez les modèles publics via l'API Hugging Face (huggingface.co/api/models). Envoyez un mot-clé comme bert ou llama, une URL de page modèles, ou l'URL complète pagination.next. La réponse est { results, pagination }.
Les identifiants ont la forme google-bert/bert-base-uncased. Passez results[].id à /v2/huggingface/model.
GET https://api.piloterr.com/v2/huggingface/search?query=bert
GET et POST prennent le même query. La première carte pour bert est google-bert/bert-base-uncased, tâche fill-mask, bibliothèque transformers. Les likes et téléchargements correspondent à /v2/huggingface/model pour cet id. pagination.next est une URL curseur. Renvoyez-la telle quelle dans query pour la page suivante.
| Paramètre |
Obligatoire |
Exemple |
query |
oui |
bert |
query est obligatoire. Un mot-clé devient search avec 20 modèles par page. Une URL https://huggingface.co/models est acceptée avec search, q ou cursor. Une URL https://huggingface.co/api/models, y compris pagination.next, est transmise. Un autre hôte renvoie 400.
Une recherche par mot-clé met pagination.page à 1, per_page au nombre de modèles (20 quand la page est pleine), total_results et total_pages à null. pagination.next est le lien rel="next", ou null s'il est absent.
La page 2 de bert est l'URL pagination.next de la page 1. Sur cet appel, pagination.page vaut null : une URL curseur n'a pas de numéro de page. Les ids diffèrent de la page 1, et next est un autre curseur tant qu'il reste des pages. next vaut null seulement quand l'API n'envoie plus de lien. Ne fabriquez pas une URL page=2. Réutilisez le curseur reçu.
Les ids sont uniques sur une page, sous la forme propriétaire/nom.
| Champ |
Type |
Sens |
results[].id |
string |
Identifiant propriétaire/nom |
results[].url |
string |
Page du modèle |
results[].pipeline_tag |
string ou null |
Tâche, par exemple fill-mask |
results[].library_name |
string ou null |
Bibliothèque, par exemple transformers |
results[].likes |
number ou null |
J'aime |
results[].downloads |
number ou null |
Téléchargements |
results[].trending_score |
number ou null |
Score de tendance |
results[].private |
boolean ou null |
Indicateur privé |
results[].tags |
array |
Tags de l'API |
results[].created_at |
string ou null |
Date de création |
pagination.page |
integer ou null |
1 sur un mot-clé, null sur une URL curseur |
pagination.per_page |
integer ou null |
Modèles de la page |
pagination.total_results |
null |
Non fourni |
pagination.total_pages |
null |
Non fourni |
pagination.next |
string ou null |
URL curseur, ou null en dernière page |
- Trouver
google-bert/bert-base-uncased avec le mot-clé bert et garder l'id pour la fiche modèle.
- Suivre
pagination.next une fois pour les 20 modèles bert suivants, et s'arrêter quand next vaut null.
- Trier la première page par
downloads avant d'ouvrir un modèle fill-mask.
| Code |
Sens |
400 |
Requête vide, ou URL hors de huggingface.co |
401 |
Clé API absente |
404 |
La charge n'est pas une liste de modèles |
500 |
Échec de la récupération |
Hugging Face Model
