Estimate cost

Computes cost estimates using one of two methods:

1. Historical API Price (historical_api_price):

Based on historical pricing per API call from past usage patterns
Takes call_quantity (number of API calls) per endpoint
Useful for estimating based on actual historical usage patterns
Example: “How much will 100 calls to flux/dev cost?”

2. Unit Price (unit_price):

Based on unit price × expected billing units from pricing service
Takes unit_quantity (number of billing units like images/videos) per endpoint
Useful when you know the expected output quantity
Example: “How much will 50 images from flux/dev cost?”

Authentication: Required. Users must provide a valid API key. Custom pricing or discounts may be applied based on account status.

Common Use Cases:

Pre-calculate costs for batch operations
Display cost estimates in user interfaces
Budget planning and cost optimization

See fal.ai pricing for more details.

POST

models

pricing

estimate

curl --request POST \
  --url https://api.fal.ai/v1/models/pricing/estimate \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "estimate_type": "historical_api_price",
  "endpoints": {
    "fal-ai/flux/dev": {
      "call_quantity": 100
    },
    "fal-ai/flux/schnell": {
      "call_quantity": 50
    }
  }
}
'

{
  "estimate_type": "historical_api_price",
  "total_cost": 3.75,
  "currency": "USD"
}

Authorizations

Authorization

string

header

required

API key must be prefixed with "Key ", e.g. Authorization: Key YOUR_API_KEY

Body

application/json

Option 1
Option 2

Historical API price estimate: Calculates cost based on historical pricing per API call. Useful for estimating costs based on actual usage patterns.

estimate_type

enum<string>

required

Estimate type: historical API pricing based on past usage patterns

Available options:

historical_api_price

endpoints

object

required

Map of endpoint IDs to call quantities

Show child attributes

Response

Cost estimates calculated successfully

Cost estimation response with total cost

estimate_type

enum<string>

required

The type of estimate that was performed

Available options:

historical_api_price,

unit_price

total_cost

number

required

Total estimated cost across all endpoints

Required range: x >= 0

currency

string

required

Three-letter currency code (ISO 4217, e.g., 'USD')

Required string length: 3

Usage Returns paginated usage records for your workspace with filters for endpoint, user, date range, and auth method. Each item includes the billed unit quantity, the pre-discount unit price and cost_subtotal, any percentage discount applied, and the final cost_total (cost_subtotal − cost_discount). **Key Features:** - Usage data for all endpoints or filtered by specific endpoint(s) - Flexible date range filtering - User-specific usage tracking - Detailed usage line items with unit quantity, price, and discount breakdown - Paginated results for large datasets **Common Use Cases:** - Generate usage reports for all endpoints or specific models - Track usage patterns - Monitor endpoint usage across different auth methods - Build usage dashboards and visualizations See [fal.ai docs](https://docs.fal.ai/model-apis/faq) for more details.

⌘I

curl --request POST \
  --url https://api.fal.ai/v1/models/pricing/estimate \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "estimate_type": "historical_api_price",
  "endpoints": {
    "fal-ai/flux/dev": {
      "call_quantity": 100
    },
    "fal-ai/flux/schnell": {
      "call_quantity": 50
    }
  }
}
'

{
  "estimate_type": "historical_api_price",
  "total_cost": 3.75,
  "currency": "USD"
}