Épinglage de groupes

Chaque modèle est servi par un ou plusieurs groupes de fournisseurs, chacun avec son propre prix. Par défaut, une clé utilise auto : chaque requête part vers le groupe actif le moins cher.

L'épinglage remplace ce comportement par modèle. Vous choisissez les groupes utilisables, et la facturation est verrouillée sur leurs tarifs.

Chaque page de modèle liste tous les groupes avec prix d'entrée et de sortie sous Group Pricing. Le badge de remise dans la liste des modèles reflète le groupe le moins cher.

Ouvrez Clés API, créez ou modifiez une clé, et ouvrez le sélecteur de groupes. Cherchez un modèle, cliquez dessus et cochez un ou plusieurs groupes, triés du moins cher au plus cher. Les modèles non touchés restent sur auto.

Les modèles épinglés remontent en tête avec un badge indiquant leur nombre de groupes. Clear all remet la clé sur auto. La liste des clés affiche les clés épinglées comme auto +N.

Au lieu de cocher les offres une à une, faites glisser la plage de prix à deux poignées sur un modèle pour ne router que via les fournisseurs dont le tarif s'y trouve. Comme la sélection se fait par prix et non par nom, les nouveaux fournisseurs entrant dans la plage sont pris en compte automatiquement.

Une plage et des offres épinglées se combinent en une union : la plage couvre les fournisseurs bon marché, et un épinglage conserve un fournisseur coûteux précis en secours même s'il sort de la plage. Le routage essaie toujours le moins cher d'abord, le secours n'est donc atteint que si tout le reste échoue.

Automatique rend le modèle à la chaîne habituelle du moins cher au plus cher. Sa plage et ses épinglages restent enregistrés mais inactifs : les désactiver restaure exactement la configuration précédente.

Un modèle épinglé n'est routé que dans ses groupes épinglés, du moins cher au plus cher, avec basculement en cas d'erreur. Le groupe qui sert la requête fixe le tarif facturé.

Associez un épinglage à une surveillance pour savoir quand ses groupes changent de prix ou tombent, voir Notifications

Pour épingler une seule requête sans modifier la clé, envoyez un en-tête X-Group avec le nom exact du groupe. Il l'emporte sur l'épinglage de la clé et sur le routage auto. Copiez les noms depuis Group Pricing.

curl https://api.unorouter.com/v1/chat/completions \
  -H "Authorization: Bearer $UNOROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -H "X-Group: glm-new-pol-glm-5.2" \
  -d '{
    "model": "glm-5.2",
    "messages": [{ "role": "user", "content": "Hello" }]
  }'

L'en-tête doit nommer un groupe utilisable par la clé, sinon la requête est rejetée. Les modèles non épinglés restent sur le routage le moins cher.

Si tous les groupes épinglés sont hors service alors que d'autres fournisseurs servent encore le modèle, les requêtes échouent avec une erreur précise plutôt qu'un message générique de surcharge :

{
  "error": {
    "message": "Your pinned provider groups for model \"glm-5.2\" are currently unavailable, but the model is still served by other providers. Edit this key's group override, or try again later.",
    "type": "new_api_error",
    "code": "get_channel_failed"
  }
}

Élargissez ou retirez l'épinglage, ou réessayez plus tard. Le modèle lui-même est en service.