Pricing

Returns unit pricing for requested endpoint IDs. Most models use output-based pricing (e.g., per image/video with proportional adjustments for resolution/length). Some models use GPU-based pricing depending on architecture. Values are expressed per model’s billing unit in a given currency.

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

Common Use Cases:

Display pricing in user interfaces
Compare pricing across different models
Build cost estimation tools
Check current billing rates

See fal.ai pricing for more details.

GET

models

pricing

Pricing

curl --request GET \
  --url https://api.fal.ai/v1/models/pricing \
  --header 'Authorization: <api-key>'

import requests

url = "https://api.fal.ai/v1/models/pricing"

headers = {"Authorization": "<api-key>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {Authorization: '<api-key>'}};

fetch('https://api.fal.ai/v1/models/pricing', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "prices": [
    {
      "endpoint_id": "fal-ai/flux/dev",
      "unit_price": 0.025,
      "unit": "image",
      "currency": "USD"
    }
  ],
  "next_cursor": null,
  "has_more": false
}

{
  "error": {
    "type": "validation_error",
    "message": "Invalid request parameters"
  }
}

{
  "error": {
    "type": "authorization_error",
    "message": "Authentication required"
  }
}

{
  "error": {
    "type": "not_found",
    "message": "Resource not found"
  }
}

{
  "error": {
    "type": "rate_limited",
    "message": "Rate limit exceeded"
  }
}

Authorizations

Authorization

string

header

required

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

Query Parameters

endpoint_id

required

Filter by specific endpoint ID(s). Accepts 1-50 endpoint IDs. Supports comma-separated values: ?endpoint_id=model1,model2 or array syntax: ?endpoint_id=model1&endpoint_id=model2

Example:

["fal-ai/flux/dev"]

Response

Pricing information retrieved successfully

Response containing pricing information for requested endpoints

next_cursor

string | null

required

Cursor for the next page of results, null if no more pages

has_more

boolean

required

Boolean indicating if more results are available (convenience field derived from next_cursor)

prices

object[]

required

Pricing information for requested endpoints

Show child attributes

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](https://fal.ai/pricing) for more details.

⌘I

Pricing

curl --request GET \
  --url https://api.fal.ai/v1/models/pricing \
  --header 'Authorization: <api-key>'

import requests

url = "https://api.fal.ai/v1/models/pricing"

headers = {"Authorization": "<api-key>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {Authorization: '<api-key>'}};

fetch('https://api.fal.ai/v1/models/pricing', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "prices": [
    {
      "endpoint_id": "fal-ai/flux/dev",
      "unit_price": 0.025,
      "unit": "image",
      "currency": "USD"
    }
  ],
  "next_cursor": null,
  "has_more": false
}

{
  "error": {
    "type": "validation_error",
    "message": "Invalid request parameters"
  }
}

{
  "error": {
    "type": "authorization_error",
    "message": "Authentication required"
  }
}

{
  "error": {
    "type": "not_found",
    "message": "Resource not found"
  }
}

{
  "error": {
    "type": "rate_limited",
    "message": "Rate limit exceeded"
  }
}