Skip to content
Braiv Docs

Quote a product bundle

POST
/videos/{videoId}/quote
 
curl --request POST \
  --url https://api.braiv.co/v1/videos/vid_01JZ8M6A/quote \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'Idempotency-Key: import-launch-demo-20260901' \
  --data '{ "dubs": [ { "product": "premium", "languages": [ "es" ] } ], "shorts": { "kind": "shorts", "numClips": 3, "includeWatermark": false }, "zeroPromptThumbnail": { "enabled": true, "characterCount": 1, "referenceProducts": [ "thumbnail-style-reference" ], "translateLanguageCodes": [ "es" ], "autoDetectContentMoments": true } }'

Calculates the exact credits required without debiting the account. Duration is resolved from the video unless supplied. Required scope: videos:read.

Authorizations

Section titled “Authorizations ”

Parameters

Section titled “ Parameters ”

Path Parameters

Section titled “Path Parameters ”
videoId
required
string
>= 1 characters

Braiv library video document ID.

Example 
vid_01JZ8M6A

Header Parameters

Section titled “Header Parameters ”
Idempotency-Key
string
>= 1 characters

Caller-generated key for safe POST retries. The API retains the first JSON response for 24 hours. Reusing a key with another path or body returns 409 IDEMPOTENCY_REPLAY.

Example 
import-launch-demo-20260901

Request Body

Section titled “Request Body ”

One or more billable actions. Empty bundles return a zero quote.

Media type application/json
object
durationSeconds

Settled billing duration; otherwise resolved from the source video.

number
> 0
dubs

Dubs included in the quote or reservation.

Array<object>
object
product

Dubbing product to price.

string
default: plus
Allowed values: plus premium
languages
required

Target languages priced separately.

Array<string>
>= 1 items unique items
captionLanguageCodes

Caption translation languages to price.

Array<string>
unique items
transcriptOnly

Reserve source transcription as a standalone action.

boolean
shorts

Shorts-family bundle to price.

object
kind
required

Shorts-family product to price: shorts prices short highlights, promo prices one promotional edit, and clips prices long-form excerpts.

string
Allowed values: shorts promo clips
numClips

Number of clips priced; defaults to one.

integer
default: 1 >= 1
includeWatermark

Affects clip pricing and subscriber rebates.

boolean
isSubscriber

Pricing hint consumed by the bundle pricer.

boolean
includeSoundtrack

Adds the promo soundtrack product.

boolean
includeGeneratedThumbnail

Adds generated thumbnail pricing to each long clip.

boolean
zeroPromptThumbnail

Zero-prompt thumbnail bundle to price.

object
enabled
required

Only true creates thumbnail line items.

boolean
referenceProducts

Additional catalog products used as references.

Array<string>
characterCount

Character reference slots added to pricing.

integer
0 <= 3
translateLanguageCodes

Thumbnail translation languages priced individually.

Array<string>
unique items
autoDetectContentMoments

Adds the content-moment-detect line item. Set this when the generation recipe uses Precision autoDetectContentReferences. Quote field name stays autoDetectContentMoments for pricing.

boolean
Example 
{
  "dubs": [
    {
      "product": "premium",
      "languages": [
        "es"
      ]
    }
  ],
  "shorts": {
    "kind": "shorts",
    "numClips": 3,
    "includeWatermark": false
  },
  "zeroPromptThumbnail": {
    "enabled": true,
    "characterCount": 1,
    "referenceProducts": [
      "thumbnail-style-reference"
    ],
    "translateLanguageCodes": [
      "es"
    ],
    "autoDetectContentMoments": true
  }
}

Responses

Section titled “ Responses ”

200

Section titled “200 ”

Current pricing, balance, shortfall, and per-action breakdown.

Media type application/json
object
total
required

Total credits required by all line items.

number
durationSeconds
required

Settled duration used for pricing.

number
pricingVersion
required

Pricing ruleset identifier.

string
balance
required

Current account credit balance.

number
usageBillingActive
required

If true, wallet shortfall does not block the operation.

boolean
shortfall
required

Additional wallet credits required; zero with usage billing.

number
sufficient
required

Whether billing can cover the quoted total.

boolean
breakdown
required

Per-action pricing lines.

Array<object>
object
actionKey
required

Billable action consumed by downstream work.

string
Allowed values: dub captions transcript zero-prompt-thumbnail thumbnail-translate content-moment-detect lipsync shorts-clip promo longclip
product
required

Internal catalog product used for pricing.

string
targetLanguageCode

Language charged by this line

string
>= 2 characters <= 16 characters /^[A-Za-z]{2,3}(?:-[A-Za-z]{2,4})?$/
credits
required

Exact credits quoted or reserved.

number
description

Human-readable line-item summary.

string
Example 
{
  "total": 126,
  "durationSeconds": 184,
  "pricingVersion": "2026-09-10-captions-paid",
  "balance": 300,
  "usageBillingActive": false,
  "shortfall": 0,
  "sufficient": true,
  "breakdown": [
    {
      "actionKey": "dub",
      "product": "cloning-dubbing",
      "targetLanguageCode": "es",
      "credits": 46,
      "description": "Dub to es"
    },
    {
      "actionKey": "shorts-clip",
      "product": "shorts-clip",
      "credits": 60,
      "description": "Generate 3 short clip(s)"
    },
    {
      "actionKey": "zero-prompt-thumbnail",
      "product": "thumbnail-create",
      "credits": 20,
      "description": "Generate thumbnail"
    },
    {
      "actionKey": "content-moment-detect",
      "product": "content-moment-detect",
      "credits": 20,
      "description": "Detect key moments"
    }
  ]
}

400

Section titled “400 ”

Request fields are missing, malformed, out of bounds, or mutually inconsistent.

Media type application/json
object
error
required

Structured public API error envelope.

object
code
required

Stable machine-readable error code.

string
Allowed values: UNAUTHENTICATED INVALID_API_KEY INSUFFICIENT_SCOPE PERMISSION_DENIED ROLE_CANNOT_PRODUCE NOT_FOUND INVALID_ARGUMENT UNSUPPORTED_SOURCE DURATION_UNKNOWN INSUFFICIENT_CREDITS CONFLICT ALREADY_EXISTS IDEMPOTENCY_REPLAY RATE_LIMITED PREVIEW_NOT_DOWNLOADABLE DOWNLOAD_TIER_NONE FAILED_PRECONDITION GONE METHOD_NOT_ALLOWED INTERNAL
message
required

Human-readable error summary.

string
details
required

Machine-readable operation-specific context; empty when unavailable.

object
key
additional properties
any
Example 
{
  "error": {
    "code": "INVALID_ARGUMENT",
    "message": "The request contains invalid or missing fields.",
    "details": {}
  }
}

401

Section titled “401 ”

A supported authentication header is missing or contains an invalid Public API key.

Media type application/json
object
error
required

Structured public API error envelope.

object
code
required

Stable machine-readable error code.

string
Allowed values: UNAUTHENTICATED INVALID_API_KEY INSUFFICIENT_SCOPE PERMISSION_DENIED ROLE_CANNOT_PRODUCE NOT_FOUND INVALID_ARGUMENT UNSUPPORTED_SOURCE DURATION_UNKNOWN INSUFFICIENT_CREDITS CONFLICT ALREADY_EXISTS IDEMPOTENCY_REPLAY RATE_LIMITED PREVIEW_NOT_DOWNLOADABLE DOWNLOAD_TIER_NONE FAILED_PRECONDITION GONE METHOD_NOT_ALLOWED INTERNAL
message
required

Human-readable error summary.

string
details
required

Machine-readable operation-specific context; empty when unavailable.

object
key
additional properties
any
Examples

Authentication header missing

{
  "error": {
    "code": "UNAUTHENTICATED",
    "message": "Missing API key.",
    "details": {}
  }
}

403

Section titled “403 ”

Authentication succeeded, but the required scope, workspace role, or resource permission is missing.

Media type application/json
object
error
required

Structured public API error envelope.

object
code
required

Stable machine-readable error code.

string
Allowed values: UNAUTHENTICATED INVALID_API_KEY INSUFFICIENT_SCOPE PERMISSION_DENIED ROLE_CANNOT_PRODUCE NOT_FOUND INVALID_ARGUMENT UNSUPPORTED_SOURCE DURATION_UNKNOWN INSUFFICIENT_CREDITS CONFLICT ALREADY_EXISTS IDEMPOTENCY_REPLAY RATE_LIMITED PREVIEW_NOT_DOWNLOADABLE DOWNLOAD_TIER_NONE FAILED_PRECONDITION GONE METHOD_NOT_ALLOWED INTERNAL
message
required

Human-readable error summary.

string
details
required

Machine-readable operation-specific context; empty when unavailable.

object
key
additional properties
any
Examples
Example scope 
{
  "error": {
    "code": "INSUFFICIENT_SCOPE",
    "message": "The API key lacks the required scope.",
    "details": {}
  }
}

404

Section titled “404 ”

The resource does not exist or is not accessible to the caller.

Media type application/json
object
error
required

Structured public API error envelope.

object
code
required

Stable machine-readable error code.

string
Allowed values: UNAUTHENTICATED INVALID_API_KEY INSUFFICIENT_SCOPE PERMISSION_DENIED ROLE_CANNOT_PRODUCE NOT_FOUND INVALID_ARGUMENT UNSUPPORTED_SOURCE DURATION_UNKNOWN INSUFFICIENT_CREDITS CONFLICT ALREADY_EXISTS IDEMPOTENCY_REPLAY RATE_LIMITED PREVIEW_NOT_DOWNLOADABLE DOWNLOAD_TIER_NONE FAILED_PRECONDITION GONE METHOD_NOT_ALLOWED INTERNAL
message
required

Human-readable error summary.

string
details
required

Machine-readable operation-specific context; empty when unavailable.

object
key
additional properties
any
Example 
{
  "error": {
    "code": "NOT_FOUND",
    "message": "Resource not found.",
    "details": {}
  }
}

409

Section titled “409 ”

The Idempotency-Key was reused with a different path or request body.

Media type application/json
object
error
required

Structured public API error envelope.

object
code
required

Stable machine-readable error code.

string
Allowed values: UNAUTHENTICATED INVALID_API_KEY INSUFFICIENT_SCOPE PERMISSION_DENIED ROLE_CANNOT_PRODUCE NOT_FOUND INVALID_ARGUMENT UNSUPPORTED_SOURCE DURATION_UNKNOWN INSUFFICIENT_CREDITS CONFLICT ALREADY_EXISTS IDEMPOTENCY_REPLAY RATE_LIMITED PREVIEW_NOT_DOWNLOADABLE DOWNLOAD_TIER_NONE FAILED_PRECONDITION GONE METHOD_NOT_ALLOWED INTERNAL
message
required

Human-readable error summary.

string
details
required

Machine-readable operation-specific context; empty when unavailable.

object
key
additional properties
any
Example 
{
  "error": {
    "code": "IDEMPOTENCY_REPLAY",
    "message": "Idempotency-Key was reused with a different request.",
    "details": {
      "pathMatch": true,
      "hashMatch": false
    }
  }
}

422

Section titled “422 ”

Duration-priced work cannot be quoted because media duration is unknown.

Media type application/json
object
error
required

Structured public API error envelope.

object
code
required

Stable machine-readable error code.

string
Allowed values: UNAUTHENTICATED INVALID_API_KEY INSUFFICIENT_SCOPE PERMISSION_DENIED ROLE_CANNOT_PRODUCE NOT_FOUND INVALID_ARGUMENT UNSUPPORTED_SOURCE DURATION_UNKNOWN INSUFFICIENT_CREDITS CONFLICT ALREADY_EXISTS IDEMPOTENCY_REPLAY RATE_LIMITED PREVIEW_NOT_DOWNLOADABLE DOWNLOAD_TIER_NONE FAILED_PRECONDITION GONE METHOD_NOT_ALLOWED INTERNAL
message
required

Human-readable error summary.

string
details
required

Machine-readable operation-specific context; empty when unavailable.

object
key
additional properties
any
Example 
{
  "error": {
    "code": "UNAUTHENTICATED"
  }
}

429

Section titled “429 ”

The API key exceeded its allowed concurrency or request rate. Retry after in-flight work completes or the limit resets.

Media type application/json
object
error
required

Structured public API error envelope.

object
code
required

Stable machine-readable error code.

string
Allowed values: UNAUTHENTICATED INVALID_API_KEY INSUFFICIENT_SCOPE PERMISSION_DENIED ROLE_CANNOT_PRODUCE NOT_FOUND INVALID_ARGUMENT UNSUPPORTED_SOURCE DURATION_UNKNOWN INSUFFICIENT_CREDITS CONFLICT ALREADY_EXISTS IDEMPOTENCY_REPLAY RATE_LIMITED PREVIEW_NOT_DOWNLOADABLE DOWNLOAD_TIER_NONE FAILED_PRECONDITION GONE METHOD_NOT_ALLOWED INTERNAL
message
required

Human-readable error summary.

string
details
required

Machine-readable operation-specific context; empty when unavailable.

object
key
additional properties
any
Example 
{
  "error": {
    "code": "RATE_LIMITED",
    "message": "API key concurrency limit reached",
    "details": {}
  }
}

500

Section titled “500 ”

An unexpected server error occurred.

Media type application/json
object
error
required

Structured public API error envelope.

object
code
required

Stable machine-readable error code.

string
Allowed values: UNAUTHENTICATED INVALID_API_KEY INSUFFICIENT_SCOPE PERMISSION_DENIED ROLE_CANNOT_PRODUCE NOT_FOUND INVALID_ARGUMENT UNSUPPORTED_SOURCE DURATION_UNKNOWN INSUFFICIENT_CREDITS CONFLICT ALREADY_EXISTS IDEMPOTENCY_REPLAY RATE_LIMITED PREVIEW_NOT_DOWNLOADABLE DOWNLOAD_TIER_NONE FAILED_PRECONDITION GONE METHOD_NOT_ALLOWED INTERNAL
message
required

Human-readable error summary.

string
details
required

Machine-readable operation-specific context; empty when unavailable.

object
key
additional properties
any
Example 
{
  "error": {
    "code": "INTERNAL",
    "message": "An unexpected error occurred.",
    "details": {}
  }
}