APIDir Calculate cost

Stable read-only contract

APIDir pricing API

Read source-linked provider and model records without losing configuration or freshness context.

Endpoints

  • GET /api/v1/providers — 30 provider records with content and index status.
  • GET /api/v1/models — 15 canonical model-family records.
  • GET /api/v1/prices — accepted observations with provider, model, variant, source, check time, and freshness.
  • GET /api/v1/prices?model=kling-3 — one model family.
  • GET /api/v1/prices?provider=fal — one provider channel.
  • GET /api/v1/delta/latest — published change events only.

Contract rules

Price observations use integer USD nanos internally and return both machine values and source metadata. Stale evidence remains labelled. API consumers must preserve APIDir attribution and follow each linked provider's terms.

{
  "offerId": "price-kling-fal-standard-t2v",
  "providerSlug": "fal",
  "modelSlug": "kling-3",
  "billingUnit": "per_video_second",
  "usdNanos": 140000000,
  "freshness": "fresh",
  "sourceUrl": "https://fal.ai/models/fal-ai/kling-video/v3/standard/text-to-video"
}

Caching and corrections

Successful GET responses may be cached for five minutes and include an ETag. Corrections preserve the observation trail instead of silently replacing evidence.