Score moments
Score a transcript and return the moments worth cutting — chosen on meaning, not clock position.
Authorizations
A workspace API key.
Headers
Stable retry key for this logical paid call. Reuse it after a timeout to receive the original result without duplicate work or spend.
1 - 255Send 1 to get the price, balance and budget verdict without running anything.
"1"The approved price; a call that would cost more is refused and nothing is charged.
^\d+$Body
- Option 1
- Option 2
Send exactly one source: either transcript or assetId, not both and not neither.
The segments to score. Send exactly one of transcript or assetId.
1 - 20000 elementsThe existing project to file this work under. Create it with POST /v1/projects, then reuse its id across related calls. A project this workspace does not own answers not_found; the work is never silently filed somewhere else.
1 - 200Score a transcript this workspace has already had transcribed instead of sending one. Send exactly one of transcript or assetId. Asset ids come from GET /v1/assets (an asset is usable once transcriptReady is true). An asset you may not edit, one in another workspace and one not yet transcribed are all reported as not found.
1 - 200Plain-language channel voice or audience context.
1 - 120Subject area used when judging relevance.
1 - 200Optional score cutoffs. Omitted fields use the service defaults.
Target short-form surfaces. The strictest requested duration ceiling is enforced before any render is planned.
1 - 5 elementsyoutube, tiktok, instagram, facebook, snapchat Maximum reviewed moments to return after deterministic refinement.
1 <= x <= 20Maximum overlap fraction of the shorter clip before the lower-ranked candidate is removed.
0 <= x <= 1Response
Success.
- Option 1
- Option 2
What this call actually cost, which is not always what was quoted.
300
The spans worth cutting, scored. Each carries its start, end and why it scored.
Lower-ranked candidates removed after deterministic range refinement.
0 <= x <= 9007199254740991Versioned selection evidence, including duration profile, fallback state, and review requirement.
What was billed: minutes of transcript scored.
The existing project this work was filed under. It matches the projectId supplied by the caller after workspace ownership was verified.
"prj_9x2a4c"
Your balance after the charge. Absent when billing is disabled for the workspace.
3900
Present only when assetId was sent: the indexed transcript this call scored, how many cues, and when it was captured.