Rechercher dans la doc...

Commencez à taper pour rechercher dans la documentation

Guide de la plateforme

Épinglage de groupes

Verrouillez un modèle sur des groupes de fournisseurs précis au lieu du routage le moins cher.

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 qu'il peut utiliser et l'ordre dans lequel ils sont essayés, et la facturation suit 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.

Tableau des prix par groupe sur une page de détail de modèle

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. Les modèles non touchés restent sur auto.

Sélecteur de groupes par modèle dans l'éditeur de clé

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.

Curseur de plage de prix sur un modèle, montrant les offres retenues

Une fourchette et des voies épinglées se combinent en union : la fourchette couvre les fournisseurs bon marché, et un épinglage garde un fournisseur coûteux précis comme repli même s'il se trouve hors de la fourchette. Avec Le moins cher d'abord, ce repli n'est atteint que lorsque tout ce qui est moins cher échoue ; avec Mon ordre, c'est vous qui décidez de sa place.

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.

Automatique activé, la plage enregistrée grisée mais conservée

Sous la liste des voies, Ordre de repli décide dans quel ordre les voies choisies sont essayées. Le moins cher d'abord est le réglage par défaut : les voies vont du tarif le plus bas au plus élevé, et la liste affiche cet ordre sans permettre de le modifier.

Ordre de repli sur Le moins cher d'abord, avec les voies choisies triées par tarif

Passez à Mon ordre pour faire glisser les voies choisies dans n'importe quel ordre. Les requêtes essaient d'abord la voie du haut et ne descendent que si elle échoue, ce qui permet de préférer un fournisseur de confiance à un fournisseur moins cher. Trier par prix remet la liste dans l'ordre du moins cher. Une voie indisponible garde sa place et est ignorée jusqu'à son retour.

Ordre de repli sur Mon ordre, avec les voies choisies dans une liste numérotée et des poignées de glissement

Si une fourchette de prix est définie, les voies ajoutées par la fourchette que vous n'avez pas choisies viennent après votre liste, la moins chère d'abord. Un fournisseur qui entre plus tard dans la fourchette se place aussi à cet endroit.

Un modèle épinglé passe uniquement par ses groupes épinglés et se replie en cas d'erreur, dans l'ordre défini sous Ordre de repli. Le groupe qui traite 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.

bash
curl https://api.test.wanmo.ai/v1/chat/completions \
  -H "Authorization: Bearer $UNOROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -H "X-Group: glm-new-relay-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 :

json
{
  "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.