É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.

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.