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.

Required permissions: none. Any authenticated caller can use this API.

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

Key on the API preset, or any key whose permissions include the ones this API lists. APIs with no required permission accept any key. Prefix it 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

Hide child attributes

endpoints.{key}

object

Hide child attributes

endpoints.{key}.call_quantity

integer

required

Number of API calls to estimate (regardless of units per call)

Required range: x >= 1

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

⌘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"
}