Felo API PlatformFelo API Platform

Guías

Modelos y precios

Entiende los ID de modelos, los proveedores, las tarifas publicadas, los descuentos, las unidades de facturación y cómo se calcula el precio de una solicitud.

Los precios de los modelos se publican en USD. Un modelo puede estar disponible a través de más de un proveedor upstream, y cada proveedor puede publicar un precio de cliente distinto. Esta guía explica de dónde proceden esos precios y cómo calcular una solicitud antes de enviarla.

Encontrar un ID de modelo

Usa el ID de modelo que devuelve la API. No construyas un ID a partir del nombre visible ni del slug de la página.

EndpointDevuelve
GET /api/v1/modelsTodas las categorías de modelos habilitadas
GET /api/v1/videos/modelsModelos de generación de video
GET /api/v1/decisions/modelsModelos de decisión

GET /api/v1/models también acepta exclude_video_and_decisions=true y un filtro provider opcional. El descubrimiento lee el catálogo y no cobra por una llamada a un modelo.

Los modelos de imagen no tienen un endpoint de lista dedicado. Filtra GET /api/v1/models por model_kind: "image_generation"; consulta Generación de imágenes.

Para ver una vista navegable, abre el catálogo de modelos o la página de precios. Las páginas de detalle de los modelos muestran los límites de contexto, los protocolos y todos los precios de proveedor publicados.

Proveedores y canales

Cada modelo incluye una lista de canales públicos. Un canal es una configuración concreta de proveedor upstream para ese modelo, como Anthropic, Azure, Google o un canal de Claude con descuento.

  • is_default marca el canal que se usa para el precio destacado y la ruta predeterminada.
  • runnable indica si el canal está disponible actualmente para solicitudes.
  • standard_pricing contiene las tarifas estándar del proveedor.
  • discount_multiplier es el multiplicador de venta, de 0 a 1.
  • pricing_mode es configured_rates o upstream_cost.

La página del modelo ordena los proveedores con el predeterminado primero y después por precio de entrada para el cliente, de menor a mayor. Para elegir un proveedor explícitamente, consulta Canales y enrutamiento de proveedores.

Cómo se calcula el precio de cliente

Para un canal configured_rates:

customer price = standard rate × discount multiplier

Por ejemplo, un canal con una tarifa estándar de entrada de $1.00 por 1 M de tokens y un multiplicador de 0.8 cobra $0.80 por 1 M de tokens.

Para un canal upstream_cost, standard_pricing es null, no cero. La facturación se basa en el coste de generación notificado multiplicado por el descuento congelado. La página del modelo muestra la regla real de ese canal.

Las tarifas por token se muestran por 1 millón de tokens para facilitar la lectura. La facturación usa la precisión por token de la instantánea de precios actual.

Unidades de facturación

UnidadUso típicoCómo se mide
TokensChat, razonamiento, embeddings, generación de textoTokens de entrada y de salida por separado; las lecturas y escrituras de caché pueden tener sus propias tarifas
Tokens de imagenGeneración y edición de imágenesTokens de imagen de entrada y de salida por separado; el número de tokens de salida por imagen depende de la resolución
SolicitudesAlgunos endpoints de imagen y utilidadesUn cargo fijo por llamada
Segundos o nivelesGeneración de videoDuración, resolución, entradas de referencia u otra condición publicada

Si coinciden varias condiciones de precio, se aplica la primera condición coincidente que figure en los detalles de precios del modelo. Consulta los niveles en la página de detalle del modelo antes de calcular un trabajo grande.

Tarifas de caché

Cuando un modelo publica input_cache_read o input_cache_write, esas tarifas aparecen en el catálogo y en la página del modelo. El uso de caché lo notifica la respuesta del protocolo; no se garantiza un acierto de caché y depende del proveedor upstream y de la solicitud. Felo no añade un interruptor de caché independiente.

Dónde consultar los precios

  • Página de precios: compara modelos y proveedores.
  • Página de detalle del modelo: tabla completa de tarifas, niveles y condiciones.
  • API del catálogo de modelos: los mismos datos en JSON, actualizados en un plazo de 60 segundos.

No codifiques los precios directamente en tu aplicación. Lee el catálogo o muestra un enlace a la página de precios para que un cambio de precio no rompa silenciosamente tu cálculo de costes.

Calcular una solicitud

  1. Encuentra el ID de modelo y el canal que piensas usar.
  2. Lee las tarifas de entrada, salida y caché de ese canal.
  3. Multiplica por los recuentos de tokens que esperas, o usa la tarifa por solicitud o por duración en los modelos que no facturan por token.
  4. Añade cualquier nivel condicional que corresponda.
  5. Deja margen para reintentos y variación de la salida.

Relacionado