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 and unit price used to compute cost. **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 and price - 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"
}