Recoup

Get started with Recoup.

Try Our Platform

Use Recoup’s AI tools for your artists, releases, and catalog.

Build Your Platform

Our team builds custom AI software for your business.

API REFERENCE

Estimate cost

On this page
GET/api/content/estimate

Estimate the cost of running the content creation pipeline. Calculates per-step and per-video costs based on current pricing. Supports comparing multiple workflow profiles (e.g., premium vs. budget) and projecting batch costs. This endpoint is informational only — it does not trigger any pipeline execution or spend credits.

Authentication

x-api-key in header

bearerAuth bearer

Request

cURL
curl --request GET \
  --url 'https://api.recoupable.dev/api/content/estimate' \
  --header 'x-api-key: YOUR_API_KEY'

Replace the YOUR_ placeholders with your values. Required query parameters are included; optional parameters are listed below.

Try it

Fill in the fields, send the request from your browser, and read the live response. The curl below updates as you type.

Kept in this browser tab only and cleared when it closes.

cURL for this request
curl --request GET \
  --url 'https://api.recoupable.dev/api/content/estimate'

Parameters

Query parameters

lipsyncboolean

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

batchinteger

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

Default: 1

compareboolean

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

Default: false

Responses

200Cost estimate calculated successfully

application/json

workflowsarray<ContentWorkflowEstimate>required

One or more workflow cost breakdowns

Item properties for workflows
namestringrequired

Workflow profile name

Example: "Current (image-to-video)"

perVideonumberrequired

Total estimated cost per video in USD

Example: 0.82

format: float

stepsarray<ContentStepEstimate>required

Per-step cost breakdown showing where the money goes

Item properties for steps
namestringrequired

Pipeline step name

Example: "Generate Image"

modelstringrequired

The AI model or service used for this step

Example: "fal-ai/nano-banana-pro/edit"

costnumberrequired

Estimated cost for this step in USD

Example: 0.04

format: float

unitstring

Billing unit type (e.g., images, seconds, megapixels). Not present for free steps.

Example: "images"

unitPricenumber

Price per billing unit in USD. Not present for free steps.

Example: 0.04

format: float

notestringrequired

Human-readable calculation detail

Example: "1 call"

costBreakdownobject

Summary of the biggest cost driver

Properties for costBreakdown
mostExpensiveStepstring

Name of the step that costs the most

Example: "Generate Video"

mostExpensivePercentinteger

Percentage of total cost from the most expensive step

Example: 68

comparisonobject

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

Properties for comparison
cheapeststringrequired

Name of the cheapest workflow profile

Example: "Budget (no upscale, LTX video)"

cheapestPerVideonumberrequired

Cost per video for the cheapest workflow

Example: 0.18

format: float

mostExpensivestringrequired

Name of the most expensive workflow profile

Example: "Current (audio-to-video)"

mostExpensivePerVideonumberrequired

Cost per video for the most expensive workflow

Example: 0.95

format: float

savingsPercentintegerrequired

Percentage savings between the cheapest and most expensive workflows

Example: 81

batchobject

Batch cost projection. Only present when batch > 1.

Properties for batch
countinteger

Number of videos in the batch

Example: 30

cheapestTotalnumber

Total cost for the batch using the cheapest workflow

Example: 5.4

format: float

mostExpensiveTotalnumber

Total cost for the batch using the most expensive workflow

Example: 28.5

format: float

401Unauthorized — invalid or missing API key

application/json

errorstringrequired

Error message describing what went wrong

Example: "Unauthorized"

Full specification

Download the OpenAPI file for complete schemas, constraints, and examples.

Download content.json
View operation source
json
{
  "operationId": "getContentEstimate",
  "description": "Estimate the cost of running the content creation pipeline. Calculates per-step and per-video costs based on current pricing. Supports comparing multiple workflow profiles (e.g., premium vs. budget) and projecting batch costs. This endpoint is informational only — it does not trigger any pipeline execution or spend credits.",
  "security": [
    {
      "apiKeyAuth": []
    },
    {
      "bearerAuth": []
    }
  ],
  "parameters": [
    {
      "name": "lipsync",
      "in": "query",
      "description": "Which workflow to estimate. `false` for image-to-video, `true` for audio-to-video. If omitted, estimates the default image-to-video workflow.",
      "required": false,
      "schema": {
        "type": "boolean",
        "example": false
      }
    },
    {
      "name": "batch",
      "in": "query",
      "description": "Number of videos to project costs for. Use this to answer questions like \"how much would 30 videos cost?\"",
      "required": false,
      "schema": {
        "type": "integer",
        "minimum": 1,
        "default": 1,
        "example": 1
      }
    },
    {
      "name": "compare",
      "in": "query",
      "description": "When `true`, returns estimates for all available workflow profiles (premium, budget, mid) for side-by-side comparison.",
      "required": false,
      "schema": {
        "type": "boolean",
        "default": false,
        "example": false
      }
    }
  ],
  "responses": {
    "200": {
      "description": "Cost estimate calculated successfully",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ContentEstimateResponse"
          }
        }
      }
    },
    "401": {
      "description": "Unauthorized — invalid or missing API key",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ContentErrorResponse"
          }
        }
      }
    }
  }
}