Routage transparent et ventilation du vol

GetVibe est un routeur transparent : vous sélectionnez explicitement une variante publique via le suffixe :alias, ou vous laissez le nom du modèle sans suffixe ; la passerelle sélectionne alors la route en fonction de la stratégie de votre compte et de votre clé et, en cas d’échec, bascule vers une autre variante disponible. Seuls les identifiants de route publics sont utilisés dans les réponses et l’historique.

"model": "claude-opus-4.8"          // auto — key strategy
"model": "claude-opus-4.8:yellow"   // pin — :yellow only, no switching to other channels
"model": "claude-opus-4.8:2"        // pin — catalog variant #2 (legacy :N syntax)

Chaque modèle est fourni par plusieurs canaux à des prix différents, comme une échelle. Ces deux paramètres du corps de la requête indiquent quels échelons de cette échelle peuvent vous servir. Tous deux sont exprimés en USD par million de tokens, avec la même unité et les mêmes chiffres que ceux affichés sur la page Models. Ils sont comparés à notre prix, c’est-à-dire ce qui vous est facturé, et jamais à un prix de gros que vous ne pouvez pas voir.

{
  "model": "deepseek-v4-flash-0731",
  "messages": [{"role": "user", "content": "hi"}],
  "max_price": 0.02,
  "min_price": {"input": 0.001}
}

Les deux volets doivent être respectés, entrée et sortie — jamais une moyenne des deux. Un canal peu coûteux en entrée et cher en sortie ne respecte pas une limite exprimée par un seul nombre.

Un plafond permanent, défini une seule fois dans le cabinet

Un plafond n’a pas besoin d’être répété à chaque appel. Le tableau de bord en enregistre un par clé API et par modèle, ainsi qu’une valeur par défaut qui couvre chaque modèle pour lequel vous n’avez rien défini explicitement, et l’API le lit à chaque requête. Une requête qui contient max_price utilise cette valeur pour cet appel uniquement ; une requête qui n’en contient pas utilise votre plafond enregistré. Priorité, de la plus spécifique à la plus générale :

Où consulter les prix que vous encadrez

GET /api/catalog publie un tableau channels pour chaque modèle : une entrée par canal sur lequel une requête peut aboutir, du moins cher au plus cher, chacune indiquant l’adresse avec laquelle vous pouvez le fixer, son prix inputUsd / outputUsd par million de tokens et s’il s’agit du canal par défaut. Ce sont les chiffres exacts auxquels max_price et min_price sont comparés, ainsi que les chiffres exacts qui vous sont facturés : une seule liste, et non trois.

curl -s https://getvibeapi.com/api/catalog   | jq '.[] | select(.apiModel=="z-ai/glm-5.3") | .channels'

Ce qui vous est facturé

Vous êtes facturé pour le canal qui a effectivement traité la requête, augmenté de notre majoration fixe — et non pour le plafond que vous avez défini, sans jamais le dépasser. Si vous fixez un plafond de prix et que la requête est exécutée sur un niveau moins cher, vous payez le moins cher. L’échelle de la page du modèle affiche une fourchette, et le montant « à partir de » correspond au niveau le moins cher existant : il s’agit d’un prix réel qui peut vous être facturé, et non d’une promesse que cette requête sera exécutée à ce niveau. Définissez max_price lorsque vous avez besoin d’une limite supérieure garantie.

Lorsque rien ne convient

La requête est refusée : HTTP 422 avec "type": "price_bound_no_lane", indiquant les prix les plus bas et les plus élevés des canaux pour ce modèle ainsi que la liste complète des channels, afin que vous puissiez choisir une limite à partir des valeurs au lieu de la deviner. lowest_passing_usd_per_million est la limite minimale qui permet d’admettre un canal à cet instant : la propre paire d’un canal ; son envoi réussit donc (les deux branches cheapest peuvent provenir de canaux différents). Le même champ apparaît lorsque l’échange lui-même a refusé votre limite : il s’agit alors du niveau de prix suivant disposant encore d’une offre, et il n’est jamais inférieur à la limite que vous avez envoyée. Lorsque votre limite n’était pas le facteur limitant, mais que le plafond d’achat appliqué par nos soins au canal l’était, et que les offres situées en dessous étaient occupées ou épuisées, la réponse est à la place HTTP 503 "type": "no_seller_available" avec Retry-After et sans prix suggéré : augmenter max_price ne servirait à rien, mais réessayer dans un court instant pourrait fonctionner. Le niveau le moins cher ne contient souvent qu’une seule offre, déjà occupée ; pour obtenir des résultats fiables, définissez donc la limite au niveau ou au-dessus du priceTypical du modèle, là où se trouve la majorité de l’offre. Nous ne fournissons jamais discrètement un canal plus cher et nous ne remplaçons jamais le modèle par un autre. Une valeur mal formée, comme une chaîne, zéro, une valeur négative ou un champ inconnu, est 400 invalid_request_error et n’est jamais ignorée silencieusement.

{
  "error": {
    "message": "No channel of model "deepseek-v4-flash-0731" is priced within your max_price $0.0001 in / $0.0001 out...",
    "type": "price_bound_no_lane",
    "code": 422,
    "param": "max_price",
    "cheapest_usd_per_million": {"input": 0.0065, "output": 0.013},
    "dearest_usd_per_million": {"input": 0.0528, "output": 0.1584},
    "lowest_passing_usd_per_million": {"input": 0.0205, "output": 0.0613},
    "channels": [
      {"address": "deepseek/deepseek-v4-flash-0731:codebuddy-cn", "label": "codebuddy-cn", "inputUsd": 0.0205, "outputUsd": 0.0613, "isDefault": true},
      {"address": "deepseek/deepseek-v4-flash-0731:qwencloud", "label": "qwencloud", "inputUsd": 0.0378, "outputUsd": 0.1132, "isDefault": false}
    ]
  }
}

Les canaux desservis par un pool d’abonnement fournisseur peuvent être adressés par leur nom. Écrivez le nom après deux-points, exactement comme pour tout autre alias :

"model": "gpt-6.1-sol:codex"         // pin a subscription pool
"model": "claude-opus-5.5:claude-code"  // pin the Claude Code pool

Le suffixe après les deux-points est un identifiant de route public, et non un nom fourni en amont. La liste complète pour un modèle spécifique se trouve dans le catalogue (Models, colonne « In API »). Principaux alias :

Pour les requêtes auto (modèle nu), les éléments suivants sont définis pour chaque clé API (tableau de bord → clés API) :

Ajoutez un alias de fournisseur après deux-points : il est respecté quelle que soit la stratégie de routage. La liste complète des alias et des exemples se trouve dans la section Models → Providers.

"model": "claude-opus-4.8"        // auto — key strategy
"model": "claude-opus-4.8:yellow"     // explicitly pin the :yellow channel
"model": "claude-opus-4.8:kiro-pool"  // explicitly pin the :kiro-pool channel

Pour chaque clé API, vous pouvez définir les éléments suivants dans le tableau de bord :

Avec un modèle nu, la passerelle peut basculer vers une autre variante publique du même modèle si la variante actuelle a renvoyé 429, 5xx ou un 200 vide sans contenu. Contraintes :

• Les requêtes contenant des images/PDF ne sont pas basculées vers un autre fournisseur (compatibilité vision).
• Le basculement de secours ne passe pas à une variante nettement plus chère (sauf strategy=price).
• Le nombre de tentatives par requête client est plafonné.
• Avec pin (:alias), le basculement entre fournisseurs est désactivé — vous obtenez l’erreur de la route choisie.

La nouvelle tentative avec temporisation exponentielle sur 429 est décrite dans Erreurs et limites.

Pour les clients de confiance destinés à la révélation et au débogage, une fois la requête terminée (y compris en mode automatique), des en-têtes indiquent quelle variante publique a réellement été exécutée. Ces données ne sont pas transmises aux clients ordinaires.

En-têtes de réponse pour les clients de confiance chargés de la révélation et du débogage (chat / messages / responses)

curl -sD - https://getvibeapi.com/v1/chat/completions \
  -H "Authorization: Bearer $GETVIBE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"gpt-6.1-sol","messages":[{"role":"user","content":"ping"}],"max_tokens":8}' \
  -o /dev/null | grep -i getvibe

# x-getvibe-route: yellow
# x-getvibe-model: gpt-6.1-sol:yellow

Historique de l’utilisation

Dans GET /v1/generations, GET /v1/usage et le tableau de bord, chaque enregistrement comporte les champs suivants :

GetVibe ne fournit pas de liste « raw » des fournisseurs en amont dans le corps de la requête. Le contrôle s’effectue via :alias public, la stratégie de clé et l’auto-basculement au sein du catalogue de modèles. Il n’existe pas d’API distincte « ignore providers » ni d’indicateurs ZDR de routage.