Skip to main content
POST
Estimate the price of a video description
Estimate the cost of a video description job before submitting it.

Authorizations

Authorization
string
header
required

Sanctum personal access token, sent as Authorization: Bearer <token>. The token is opaque — it carries no claims and no embedded expiry, so do not attempt to decode it. Issue and revoke tokens from your account dashboard.

Headers

Accept
enum<string>
default:application/json
required
Available options:
application/json

Body

multipart/form-data

Provide exactly one of video_url, video_file or duration_seconds.

Exactly ONE input source per request — video_url, video_file or duration_seconds — hence the three variants below. They are mutually exclusive, not a menu of optional fields: sending two of them is a 422. platform belongs to the duration_seconds variant alone. model and preset apply to all three, and are validated exactly as on POST /api/v2/videos/descriptions, so a quote is never returned for a request the job endpoint would reject.

video_url
string
required

URL of the video to quote. Mutually exclusive with video_file and duration_seconds; platform must NOT be sent with it, as it is derived from the URL. Quotes from a TikTok URL are refused (the lookup itself costs money) — quote TikTok by duration_seconds + platform: tiktok instead.

Example:

"https://www.youtube.com/watch?v=jNQXAC9IVRw"

model
string
required

The model to use.

Example:

"Marlin_2B"

preset
enum<string> | null

The preset you will submit. It sets how much machine time the description takes (detail is roughly 7× fast per hour of material), which is what the price follows; on a TikTok, where the price is a fixed card, it multiplies the card ×0.75 / ×1 / ×1.5 for fast / balanced / detail. Omitted quotes at the model default (balanced). Ignored on a model without info.features.supports_presets.

Available options:
fast,
balanced,
detail,
null
Example:

"balanced"

include_metadata
boolean | null
default:false

Whether the job will ask for source metadata. Carries a flat surcharge on URL sources (an upload always returns null metadata and is never charged), so pass it exactly as you will pass it to POST /api/v2/videos/descriptions.

Example:

false

Response

Calculated price for the video description.

data
object