Enrutamiento transparente y desglose de la ejecución

GetVibe es un enrutador transparente: puedes elegir explícitamente una variante pública mediante el sufijo :alias, o dejar el nombre del modelo sin sufijo; en ese caso, la puerta de enlace elige la ruta según la estrategia de tu cuenta o clave y, cuando se producen errores, cambia a otra variante disponible. En las respuestas y el historial solo se utilizan identificadores de ruta públicos.

"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)

Cada modelo se ofrece a través de varios canales con distintos precios: una escalera. Estos dos parámetros del cuerpo de la solicitud indican qué peldaños de esa escalera pueden atenderte. Ambos están expresados en USD por 1M de tokens, la misma unidad y los mismos números que muestra la página Models. Se comparan con el precio de nuestro servicio, es decir, lo que se te cobra, nunca con un precio mayorista que no puedes ver.

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

Ambas partes deben cumplir, entrada y salida, nunca un promedio de las dos. Un canal barato en entrada y caro en salida no cumple un límite de un solo número.

Un límite máximo permanente, establecido una sola vez en el gabinete

No es necesario repetir un límite en cada llamada. El panel almacena uno por clave de API y por modelo, además de un valor predeterminado que cubre todos los modelos que no hayas configurado explícitamente, y la API lo lee en cada solicitud. Una solicitud que incluya max_price usa ese valor en su lugar para esa única llamada; una solicitud que no incluya ninguno usa tu límite almacenado. Prioridad, de la más específica a la menos específica:

Dónde consultar los precios que estás delimitando

GET /api/catalog publica un arreglo channels para cada modelo: una entrada por cada canal en el que puede terminar una solicitud, ordenados del más barato al más caro, cada uno con la dirección mediante la que puedes fijarlo, su precio inputUsd / outputUsd por 1M de tokens y si es el predeterminado. Esos son los números exactos contra los que se comparan max_price y min_price, y los números exactos que se te cobran: una lista, no tres.

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

Qué se te cobra

Se te cobra por el canal que realmente atendió la solicitud, más nuestro margen fijo, no por el límite máximo que estableciste, y nunca más que eso. Si estableces un límite de precio y la solicitud se completa en un nivel más barato, pagas el más barato. La escala de la página del modelo muestra un rango, y la cifra “desde” es el nivel más barato existente: es un precio real que se te podría cobrar, no una promesa de que esta solicitud llegará a ese nivel. Establece max_price cuando necesites un límite superior garantizado.

Cuando nada encaja

La solicitud es rechazada: HTTP 422 con "type": "price_bound_no_lane", indicando los precios más bajo y más alto de los canales para ese modelo y la lista completa de channels, para que puedas elegir un límite a partir de los números en lugar de adivinarlo. lowest_passing_usd_per_million es el límite mínimo que admite un canal en este momento: el par propio de un canal, por lo que enviarlo funciona (los dos tramos de cheapest pueden provenir de canales diferentes). El mismo campo aparece cuando el propio intercambio rechazó tu límite: en ese caso, es el siguiente nivel de precio que aún tiene disponibilidad y nunca es inferior al límite que enviaste. Cuando tu límite no era el motivo: el techo de compra propio del canal sí lo era, y las ofertas por debajo estaban ocupadas o agotadas, la respuesta es HTTP 503 "type": "no_seller_available" con Retry-After y sin un precio sugerido: aumentar max_price no ayudaría; volver a intentarlo en breve podría funcionar. El escalón más barato suele contener una sola oferta que está ocupada, así que, para obtener resultados de forma fiable, establece el límite en el priceTypical del modelo o por encima, donde se concentra la mayor parte de la oferta. Nunca servimos silenciosamente un canal más caro ni sustituimos otro modelo. Un valor mal formado, como una cadena, un cero, un número negativo o un campo desconocido, es 400 invalid_request_error y nunca se ignora silenciosamente.

{
  "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}
    ]
  }
}

Los canales servidos desde un grupo de suscripción de un proveedor se pueden direccionar por nombre. Escribe el nombre después de dos puntos, exactamente como cualquier otro alias:

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

El sufijo después de los dos puntos es un identificador de ruta público, no un nombre del proveedor ascendente. La lista completa para un modelo específico está en el catálogo (Models, la columna «In API»). Alias principales:

Para las solicitudes auto (modelo sin sufijo), se configura lo siguiente en cada clave de API (panel → Claves de API):

Agrega un alias de proveedor después de dos puntos: se respeta independientemente de la estrategia de enrutamiento. La lista completa de alias y ejemplos está en la sección 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

Para cada clave de API puedes configurar en el panel:

Con un modelo sin especificar, la pasarela puede cambiar a otra variante pública del mismo modelo si la actual devolvió 429, 5xx o un 200 vacío sin contenido. Restricciones:

• Las solicitudes con imágenes/PDF no se cambian a otro proveedor (compatibilidad con visión).
• La conmutación por error no cambia a una variante significativamente más cara (excepto con strategy=price).
• Existe un límite superior para el número de intentos por solicitud del cliente.
• Con pin (:alias), la conmutación por error entre proveedores está desactivada: recibes el error de la ruta elegida.

El reintento con retroceso exponencial en 429 se describe en Errores y límites.

Para clientes de confianza de revelación/depuración, después de que se completa la solicitud (incluido auto), los encabezados están disponibles y muestran qué variante pública se ejecutó realmente. Los clientes normales no reciben estos datos.

Encabezados de respuesta para clientes de depuración/revelación confiables (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

Historial de uso

En GET /v1/generations, GET /v1/usage y el panel, cada registro tiene los campos:

GetVibe no proporciona una lista «raw» en cascada de los proveedores ascendentes en el cuerpo de la solicitud. El control se realiza mediante :alias público, la estrategia de claves y el auto-failover dentro del catálogo de modelos. No existe una API independiente de «ignorar proveedores» ni indicadores ZDR de enrutamiento.