Skip to main content
GET
/
api
/
content
/
estimate
cURL
curl --request GET \
  --url https://recoup-api.vercel.app/api/content/estimate \
  --header 'x-api-key: <api-key>'
{
  "workflows": [
    {
      "name": "Current (image-to-video)",
      "perVideo": 0.82,
      "steps": [
        {
          "name": "Generate Image",
          "model": "fal-ai/nano-banana-pro/edit",
          "cost": 0.04,
          "note": "1 call",
          "unit": "images",
          "unitPrice": 0.04
        }
      ],
      "costBreakdown": {
        "mostExpensiveStep": "Generate Video",
        "mostExpensivePercent": 68
      }
    }
  ],
  "comparison": {
    "cheapest": "Budget (no upscale, LTX video)",
    "cheapestPerVideo": 0.18,
    "mostExpensive": "Current (audio-to-video)",
    "mostExpensivePerVideo": 0.95,
    "savingsPercent": 81
  },
  "batch": {
    "count": 30,
    "cheapestTotal": 5.4,
    "mostExpensiveTotal": 28.5
  }
}

Authorizations

​
x-api-key
string
header
required

Your Recoup API key. Learn more.

Query Parameters

​
lipsync
boolean

Which workflow to estimate. false for image-to-video, true for audio-to-video. If omitted, estimates the default image-to-video workflow.

Example:

false

​
batch
integer
default:1

Number of videos to project costs for. Use this to answer questions like "how much would 30 videos cost?"

Required range: x >= 1
Example:

1

​
compare
boolean
default:false

When true, returns estimates for all available workflow profiles (premium, budget, mid) for side-by-side comparison.

Example:

false

Response

Cost estimate calculated successfully

Cost estimates based on live fal.ai pricing. When compare is false, the workflows array contains a single entry. When true, it contains all available profiles.

​
workflows
object[]
required

One or more workflow cost breakdowns

​
comparison
object

Side-by-side summary. Only present when compare is true and multiple workflows are returned.

​
batch
object

Batch cost projection. Only present when batch > 1.