Modelos

El campo model recibe el nombre exacto del modelo. La lista completa, con precios y compatibilidad con caché, está en la página del catálogo.

• Los ID usan vendor/model (estilo OpenRouter), por ejemplo, anthropic/claude-opus-5; claude-opus-5 se acepta como alias de entrada con una facturación idéntica.
• model:alias fija un canal, por ejemplo, openai/gpt-5.6-sol:yellow. GET /v1/models muestra un ID por modelo; ?variants=1 devuelve la lista completa.

La mayoría de los canales son libros de marketplace: muchos vendedores ofrecen el mismo modelo a precios diferentes. Tu solicitud se completa con la oferta más barata que la acepta y se te cobra el costo de esa ejecución más nuestra comisión. Por eso, la tarifa por token es un rango y no un número único: depende del nivel del libro que haya completado la solicitud.

GET /api/catalog y GET /v1/pricing publican ese rango por modelo (pricing) y por canal (channels[]), leído del mismo nivel GET /api/model-ladder?model=<model> que ofrece con sus recuentos de ofertas.

"pricing": {
  "basis": "fill",
  "unit": "USD per 1M tokens",
  "priceFrom":    { "input": 0.465, "output": 2.325 },
  "priceTypical": { "input": 0.5,   "output": 2.5 },
  "priceTo":      { "input": 1.5,   "output": 7.5 },
  "minChargePerRequest": 0.0000125,
  "ladder": "/api/model-ladder?model=claude-opus-5.5",
  "ladderUpdatedAt": "2026-09-25T08:45:01.522Z",
  "ladderStale": false
},
"channels": [
  { "address": "claude-opus-5.5:claude-code", "isDefault": true,
    "inputUsd": 0.465, "outputUsd": 2.325,
    "basis": "fill", "pool": "cc/claude-opus-5-5",
    "priceFrom": { "input": 0.465, "output": 2.325 },
    "priceTypical": { "input": 0.5, "output": 2.5 },
    "priceTo": { "input": 1.5, "output": 7.5 },
    "maxPriceCeiling": { "input": 0.6, "output": 3 },
    "minChargePerRequest": 0.0000125 }
]

La mayoría de los modelos tiene varias variantes públicas. La variante predeterminada se elige automáticamente (la prioridad sigue la configuración de tu cuenta o clave). Para fijar una variante específica en una solicitud, añade su alias después de dos puntos al nombre del modelo:

"model": "gpt-6.1-sol"           // default variant (auto)
"model": "gpt-6.1-sol:yellow"    // explicit public variant
"model": "claude-opus-5.5"     // use an id from the catalog

Solicitud de ejemplo con una variante explícita:

curl https://getvibeapi.com/v1/chat/completions \
  -H "Authorization: Bearer $GETVIBE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-opus-4.8:yellow",
    "messages": [{"role": "user", "content": "Hello!"}]
  }'
# :yellow — pin a public variant for this request

Usa solo alias del catálogo. Sufijos disponibles:

Puedes obtener mediante programación la lista completa de ids de modelos disponibles:

curl https://getvibeapi.com/v1/models \
  -H "Authorization: Bearer $GETVIBE_API_KEY"

Además de id/object/created/owned_by, cada entrada incluye type (chat, embedding, rerank, image, video, audio, music, 3d), architecture.input_modalities / output_modalities y endpoints — dónde enviar una solicitud para ese modelo.

• La lista predeterminada solo contiene modelos de chat, embedding y rerank, para que el selector de modelos del IDE nunca ofrezca un modelo que no pueda chatear.
• Los modelos multimedia (imagen, video, audio, música, 3D) se muestran bajo solicitud: ?type=image (o una lista: ?type=image,video), ?output_modalities=image; ?modality= y ?category= son sinónimos de type.
• Todo de una vez: ?all=true, ?type=all o GET /v1/models/all. El contenido multimedia se muestra junto con sus variantes (model:alias), exactamente el id que debes enviar.
• GET /v1/models/{id} devuelve un modelo; un ID desconocido devuelve un 404 con code: "model_not_found".

curl "https://getvibeapi.com/v1/models?type=image,video" \
  -H "Authorization: Bearer $GETVIBE_API_KEY"

Cada modelo que se añade al catálogo y nuestras publicaciones de novedades se publican en un feed abierto, sin necesidad de clave. Léelo desde un lector RSS o desde un agente, para que este pueda adaptar su enfoque a medida que cambian los modelos. El feed contiene todo el historial, página por página, y cada evento incluye lo que un agente necesita para llamar al modelo de inmediato.

• /rss.xml (alias /feed.xml) es RSS 2.0; /feed.json es JSON Feed 1.1 con un bloque _meta a nivel de feed y un bloque _catalog por evento.
• Páginas: 50 eventos por página, ?limit= hasta 100, del más reciente al más antiguo. La página siguiente (más antigua) es next_url en JSON Feed y <atom:link rel="next"> en RSS (RFC 5005, también con rel="first" y rel="previous"). Los enlaces incluyen un cursor, de modo que un modelo publicado mientras recorres las páginas nunca desplaza un evento que ya hayas leído. Usa los enlaces tal como se devuelven.
• Filtros: ?kind=text|image|video|audio|music|3d|news y ?since=YYYY-MM-DD — solo eventos a partir de ese día en UTC, inclusive. Los filtros funcionan junto con la paginación y se mantienen en los enlaces.
• Un evento model_added incluye el título, la fecha en que el modelo apareció en el catálogo, un enlace a la página del modelo, una descripción y, en _catalog: los ids públicos que debes enviar como model (sin variantes de ruta :alias ni nombres de proveedores), los endpoints, las modalidades de entrada y salida, la ventana de contexto y la salida máxima, las capacidades (herramientas, JSON / salida estructurada, visión, razonamiento y sus niveles, almacenamiento en caché), el precio público inicial en USD con su unidad, para medios, cada parámetro de la solicitud con sus valores permitidos, una solicitud lista para usar (curl y JSON) y un enlace a la documentación. Un evento news es una publicación de novedades.
• El guid de un evento nunca cambia. El feed no contiene resultados de generación registrados, solo una solicitud de ejemplo.
• Consulta como máximo una vez cada pocos minutos: cada página tiene sus propios ETag y Last-Modified; envía If-None-Match / If-Modified-Since y, si la página no ha cambiado, responderá 304 sin cuerpo. Para obtener solo las novedades, guarda la fecha del último evento que procesaste y solicita ?since= con esa fecha.

curl -sS "https://getvibeapi.com/feed.json?since=2026-10-01&limit=100"
curl -sS -i https://getvibeapi.com/feed.json -H 'If-None-Match: "<ETag from the previous response>"'   # -> 304