get_clip_details
Get Clip Details
Get full details for one footage.cool clip: description, tags, location, shot year, duration, people and release notice, collection, thumbnail, watermarked preview, clip page, the master's verified resolution and codec when known, and licensing options with prices.
输入参数clip_id必填
build_rough_cut
Build Rough Cut Timeline
Plan a timed edit from a description: picks and orders clips across different shoots and locations, sets a cut length for each at the chosen pace, and totals the license cost. Returns an edit decision list with preview URLs for a storyboard or rough cut. It does not render video or license anything.
输入参数pacequery必填peopleyear_tocategorylocationyear_fromtarget_seconds
check_clip_rights
Check Clip Rights
Screen whether a license covers an intended use for a clip and which tier fits: commercial, editorial, documentary, internal_corporate, digital (web and social), broadcast, theatrical, or ai_training. Reports chain of title, people and property flags, and the release policy. Catalog screening, not legal advice.
输入参数clip_id必填intended_useexpected_distribution
license_clip
Get Clip Licensing Options
Get licensing options and prices for a clip without charging anything: Royalty-Free Standard (from $79), Extended for broadcast (from $199), and Exclusive Buyout (quoted by email). This tool never issues a license or takes payment; quote_4k_license starts a purchase.
输入参数clip_id必填
quote_4k_license
Quote a 4K License
Quote a license for a clip's clean, unwatermarked master. Verifies the master file in storage and reports its exact resolution and codec: nearly every master is 4K UHD, and when one is lower (HD 1080p or 2.7K) the quote includes a resolution_notice that you must pass on to the user. Prices the chosen license from the site's direct pricing and returns a private quote token valid for 30 minutes. Ask the user for the buyer email and the license type first; never invent an email. Does not charge anything. Show the full quote, including the resolution, and the terms link to the user before asking to check out. AI training is excluded.
输入参数clip_id必填usage_scopelicense_type必填customer_email必填expected_distribution
create_4k_checkout
Create 4K License Checkout
Create or resume Stripe hosted checkout for a quote. Call ONLY after the user explicitly approves the quoted clip, the master resolution, license type, total price, and terms. Returns a checkout URL for the user and a private order token. The user pays securely on Stripe; never collect card details in chat. Calling again with the same quote returns the same checkout. Creating checkout is not proof of purchase.
输入参数confirmed必填quote_token必填
get_4k_order
Get 4K License and Download
Check an order after checkout. Verifies the payment directly with Stripe, then returns the active license, receipt, license certificate link, and a private download link for the clean master. Requires the private order token from create_4k_checkout. Never report the purchase as complete unless purchase_completed is true. Poll no faster than once every 10 seconds. Keep the token and links private.
输入参数order_token必填
get_catalog_overview
Get Catalog Overview
Overview of what footage.cool's library covers: clip counts by shot year, scene category, subject, and location (grouped by region), people versus no-people counts, and pricing. Use it to see what exists and to find valid category values for search_footage and build_rough_cut.
无需输入参数。