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.

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

namestringrequired

Workflow profile name

perVideonumberrequired

Total estimated cost per video in USD

format: float

stepsarray<ContentStepEstimate>required

Per-step cost breakdown showing where the money goes

Item properties

namestringrequired

Pipeline step name

modelstringrequired

The AI model or service used for this step

costnumberrequired

Estimated cost for this step in USD

format: float

unitstring

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

unitPricenumber

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

format: float

notestringrequired

Human-readable calculation detail

costBreakdownobject

Summary of the biggest cost driver

Properties

mostExpensiveStepstring

Name of the step that costs the most

mostExpensivePercentinteger

Percentage of total cost from the most expensive step

comparisonobject

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

Properties

cheapeststringrequired

Name of the cheapest workflow profile

cheapestPerVideonumberrequired

Cost per video for the cheapest workflow

format: float

mostExpensivestringrequired

Name of the most expensive workflow profile

mostExpensivePerVideonumberrequired

Cost per video for the most expensive workflow

format: float

savingsPercentintegerrequired

Percentage savings between the cheapest and most expensive workflows

batchobject

Batch cost projection. Only present when batch > 1.

Properties

countinteger

Number of videos in the batch

cheapestTotalnumber

Total cost for the batch using the cheapest workflow

format: float

mostExpensiveTotalnumber

Total cost for the batch using the most expensive workflow

format: float

401Unauthorized — invalid or missing API key

application/json

errorstringrequired

Error message describing what went wrong

Full specification

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

Download content.json

View operation source

json

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