Référence des politiques des fournisseurs

Référencez les champs, valeurs par défaut, limites et erreurs des fournisseurs ShareAI pour choisir les fournisseurs d'exécution dans les requêtes d'inférence.

Voir en Markdown

Sur cette page

L'optionnel provider objet appartient au niveau supérieur de la requête d'inférence, aux côtés de model. Un objet vide utilise les valeurs par défaut. Il est distinct de l'accès à distance du fournisseur et de ses identifiants de gestion.

Champ	Type	Comportement
`only`	tableau de tags de fournisseurs	Restreindre l'exécution à ces fournisseurs.
`ignore`	tableau de tags de fournisseurs	Exclure ces fournisseurs, y compris des solutions de repli.
`order`	tableau de tags de fournisseurs	Classer ces fournisseurs en premier dans l'ordre fourni ; puis appliquer le tri.
`allow_fallbacks`	booléen ; valeur par défaut true	Autoriser d'autres fournisseurs éligibles. Avec false et une liste d'ordre non vide, seuls les fournisseurs listés restent ; sans ordre, seul le fournisseur classé en premier reste.
`networks`	tableau	Restreindre les types de fournisseurs à communauté, entreprise et/ou shareai.
`sort`	chaîne ou objet	Utilisez prix, latence ou débit, ou un objet avec by et direction.

JSON

{
  "provider": {
    "ignore": [
      "PROVIDER_TO_EXCLUDE"
    ],
    "networks": [
      "company",
      "shareai"
    ],
    "sort": {
      "by": "throughput",
      "direction": "desc"
    },
    "allow_fallbacks": true
  }
}

Remplacez le placeholder par un tag de fournisseur en minuscule réel, ou supprimez le champ ignore. Les types de réseau sélectionnent des catégories d'infrastructure ; ils n'identifient pas les créateurs de modèles.

Trier les valeurs par défaut#

Trier	Direction par défaut	Inversion explicite
`price`	`asc` — le plus bas en premier	`desc` — le plus élevé en premier
`latency`	`asc` — le temps écoulé le plus court en premier	`desc` — le plus long en premier
`throughput`	`desc` — le plus grand nombre de tokens de sortie par seconde en premier	`asc` — le plus petit en premier

Pour un objet, définissez by sur l'un de ces noms et direction vers asc ou desc. Voir comment fonctionnent les mesures et les solutions de repli.

Validation et erreurs#

Utilisez des booléens JSON et des tableaux de tags de fournisseurs en minuscule. Ne pas envoyer null pour provider ou sort.
Seuls les champs listés sont acceptés ; ce n'est pas une implémentation complète des paramètres OpenRouter.
La politique est limitée à 8 KiB. Les listes only, ignore et order acceptent chacune au maximum 100 tags.
Les politiques invalides renvoient HTTP 400. Les portées d'identifiants interdites renvoient HTTP 403. Aucun fournisseur éligible disponible renvoie HTTP 503.

Une politique minimale#

JSON

{
  "provider": {
    "sort": "price"
  }
}

Lorsqu'elle est entièrement omise, la sélection des fournisseurs par défaut utilise également un classement déterministe par prix croissant. Les contraintes s'appliquent toujours avant le classement.

Dernière mise à jour le 16 septembre 2026