accept_dataset_agreement
Accept Dataset Agreement
Accept the Dataset License Agreement for a quoted order on the buyer's behalf. Call ONLY after the buyer explicitly approves the tier, clip count, price, and the full agreement text. Paid tiers move to awaiting_payment; the free evaluation sample goes straight to Stockfilm's manual review.
Parametersconfirmedrequiredlegal_namerequiredorder_tokenrequiredsigner_namerequiredagreement_sha256required
build_rough_cut
Build Rough Cut Timeline
Auto-assemble a timed sequence of vintage clips into a video timeline based on a description. Returns an ordered list of clips with durations. Great for creating edit lists or storyboards.
Parameterspacequeryrequiredyear_toyear_fromtarget_seconds
check_clip_rights
Check Clip Rights
Verify a clip is eligible for a given intended use (commercial, editorial, broadcast, etc.) before licensing.
Parametersclip_idrequiredintended_use
create_4k_checkout
Create 4K License Checkout
Create or resume Stripe hosted checkout for a quoted 4K license. Call ONLY after the user explicitly approves the quoted clip, total price, resolution, license scope, territory, term, and terms. Returns a checkout URL and private order token. The user pays securely in Stripe; never collect card details in chat. Repeating the same quote reuses its order. Creating checkout is not proof of purchase.
Parametersconfirmedrequiredquote_tokenrequired
create_dataset_checkout
Create Dataset Checkout
Start payment for an accepted dataset order. Card orders (proxy media, up to $10,000) return a Stripe checkout_url the buyer pays in a browser; never collect card details in chat. 4K, research, and larger orders return a bank-wire invoice (number, amount, due date, reference) that is also emailed to the buyer; the buyer's finance team pays it. Repeating the call reuses the open checkout or invoice. Payment is not delivery: every order is reviewed by a person at Stockfilm after the funds clear.
Parametersorder_tokenrequired
describe_training_dataset
Describe Training Dataset
Describe Stockfilm's AI-training dataset product: eligible catalog counts, the three fixed-price tiers (free evaluation sample; $25,000 research for academic institutions; commercial at $3.00/clip proxies or $10.00/clip 4K masters, $10,000 minimum), payment rails (card for small proxy orders, bank wire for 4K and larger orders), available filters, the agreement version and sha256, and the purchase workflow. AI-training rights are sold only this way, never per clip and never exclusively.
Takes no parameters.
get_4k_order
Get 4K License and Download
Verify a 4K order's payment with Stripe and retrieve the license, receipt, and private master download after payment. Requires the private order token from create_4k_checkout. May activate an already-paid license. Never claim purchase completed until purchase_completed is true. If delivery_status is preparing, retry later. Poll no faster than once every 10 seconds. Keep the token and download URL private.
Parametersorder_tokenrequired
get_clip_details
Get Clip Details
Get full details for a specific Stockfilm clip including description, year shot, location, price, resolution, thumbnail URL, and preview URL.
Parametersclip_idrequired
get_dataset_agreement
Get Dataset Agreement
Fetch the full text of the Stockfilm Dataset License Agreement with its version and sha256. Show the text to the buyer before accept_dataset_agreement; the sha256 must be sent back on acceptance.
Takes no parameters.
get_dataset_order
Get Dataset Order
Check a dataset order: payment state, Stockfilm's approval decision, and, once delivered, download.manifest_url for the metadata files, signed license, and per-clip media URLs. Poll no more than every 10 minutes while awaiting approval. Never report delivery until status is delivered.
Parametersorder_tokenrequired
license_clip
Get Clip Licensing Options
Get licensing options for a clip without charging the user. The website offers 4K masters for eligible clips; the separate x402 product is 144p. Review availability, exact price, and terms on the clip page before purchase. This tool does not issue a license or process payment.
Parametersclip_idrequired
quote_4k_license
Quote a 4K License
Quote an eligible, unwatermarked 4K master using the website's direct license pricing. Verifies actual resolution and licensing availability. Ask for the buyer email and desired use, territory, and term. Does not charge the user. Show the complete quote and terms before requesting checkout approval. AI training is excluded.
Parameterstermrequiredclip_idrequiredterritoryrequiredusage_scoperequiredcustomer_emailrequired
quote_training_dataset
Quote Training Dataset
Create a fixed-price dataset quote for a filtered subset and get a private order_token. Freezes the exact clip list. Ask the buyer for their email, organization, and intended use first. Does not charge anyone. Show the buyer the tier, clip count, hours, price, payment method (card or bank wire), and the agreement before asking them to accept.
Parameterstierrequiredfilterscustomer_orgintended_userequiredcustomer_emailrequiredmedia_resolution
scope_training_dataset
Scope Training Dataset
Count how many clips and hours match a filter set for a dataset tier, with the fixed price. Free, reserves nothing, needs no buyer details. Use it to iterate on filters before quoting.
Parameterstierfiltersmedia_resolution