specification: FinOps Framework
specificationVersion: '1.0'
schema: https://www.finops.org/framework/
provider: LangDB
providerId: langdb
created: '2026-06-20'
modified: '2026-06-20'
reconciled: false
tags:
- AI
- LLM
- AI Gateway
- Routing
- Governance
- MCP
- FinOps
- Cost Management
- FOCUS
description: >-
  FinOps view of LangDB AI Gateway spend. LangDB centralizes spend across many
  model providers behind one gateway and adds native cost-management surfaces:
  per-thread cost, total and per-model usage endpoints, time-series analytics,
  project budgets, and per-user / per-group spend limits. Model usage is billed
  at underlying provider rates; the managed service adds subscription and/or
  enterprise fees. Exact gateway fees and any markup are not fully published
  and are not reconciled in this artifact.
notes: >-
  Use the /usage/total, /usage/models, /analytics, and /threads/{id}/cost
  endpoints for cost visibility. Confirm subscription fees, any per-request
  gateway charge, and budget/cost-group configuration during reconciliation.
sources:
- https://docs.langdb.ai/features/usage
- https://docs.langdb.ai/features/cost-control
- https://langdb.ai/cost-control/
- https://focus.finops.org/focus-specification/v1-3/
alignedWith:
  framework: FinOps Foundation Framework
  frameworkUrl: https://www.finops.org/framework/
  dataSpec: FOCUS
  dataSpecVersion: '1.3'
  dataSpecUrl: https://focus.finops.org/focus-specification/v1-3/
publisherName: LangDB
serviceCategory: AI and Machine Learning
billingModel:
  pricingCategory: Usage-Based
  billingFrequency: Monthly
  billingCurrency: USD
  chargeCategories:
  - Usage
  - Purchase
  - Adjustment
focusColumns:
  ServiceName: LangDB AI Gateway
  ServiceCategory: AI and Machine Learning
  ProviderName: LangDB
  PublisherName: LangDB
  InvoiceIssuerName: LangDB
  BillingCurrency: USD
  ChargeCategory: Usage
  PricingCategory: Usage-Based
meters:
- name: input_tokens
  description: Prompt tokens sent through the gateway, billed at the routed model's input rate.
  unit: tokens
  aggregation: sum
  dimensions:
  - project
  - model
  - provider
- name: output_tokens
  description: Tokens generated by the routed model, billed at its output rate.
  unit: tokens
  aggregation: sum
  dimensions:
  - project
  - model
  - provider
- name: embedding_tokens
  description: Tokens embedded via the /embeddings endpoint.
  unit: tokens
  aggregation: sum
  dimensions:
  - project
  - model
- name: images_generated
  description: Images produced via the /images/generations endpoint.
  unit: images
  aggregation: sum
  dimensions:
  - project
  - model
- name: thread_cost
  description: Aggregated cost per conversation thread, available via /threads/{thread_id}/cost.
  unit: usd
  aggregation: sum
  dimensions:
  - project
  - thread
- name: subscription_fee
  description: Managed-service subscription fee for paid / enterprise tiers.
  unit: usd
  aggregation: sum
  dimensions:
  - account
  - plan
principles:
- name: Visibility
  description: Pull /usage/total, /usage/models, and /analytics to inspect token burn and cost per project and model.
- name: Allocation
  description: Tag requests with X-Project-Id, X-Thread-Id, X-Run-Id, and X-Label to map spend to teams, sessions, and workflows.
- name: Optimization
  description: Use routing to send work to cheaper models, enable fallbacks/load balancing, and set budgets to cap spend.
- name: Accountability
  description: Set per-user and per-group spend limits and project budgets; review per-model usage monthly against budget.
maintainers:
- FN: Kin Lane
  email: kin@apievangelist.com