A picture of the project's reference at any time, width and crop
Same as GET /video-analyses/{analysisId}/frames, resolved through the project's reference (404 when it has none).
Times are on the SOURCE clock.
Authorization
bearerAuth Typecut API key. Generate one in app.typecut.ai → Settings → API keys. Send as Authorization: Bearer tc_live_….
In: header
Path Parameters
uuidQuery Parameters
Seconds on the SOURCE clock: one number or a comma list, up to 12 (e.g. "47.3" or "1,2.5,40").
Output width in px (default 480). Height keeps the aspect.
64 <= value <= 1920x,y,w,h as fractions of the frame, e.g. "0,0.6667,1,0.3333" is the lower third.
Response Body
application/json
application/json
application/json
application/json
curl -X GET "https://example.com/projects/497f6eca-6276-4993-bfeb-53cbbbba6f08/reference/frames?t=string"{
"data": {
"analysis_id": "string",
"duration_sec": 0,
"notes": [
"string"
],
"frames": [
{
"t": 0,
"width": 0,
"crop": {
"x": 0,
"y": 0,
"w": 0,
"h": 0
},
"url": "string",
"cached": true
}
]
}
}{
"error": {
"type": "string",
"code": "string",
"message": "string"
}
}{
"error": {
"type": "string",
"code": "string",
"message": "string"
}
}{
"error": {
"type": "string",
"code": "string",
"message": "string"
}
}Record the source a project is meant to match PUT
Points the project at a video analysis (analysis_id, analyze_video first) and/or an audio analysis (audio_analysis_id, analyze_audio first), with an optional alignment of replica scenes to spans of th
What the project's reference says in a window GET
The reference's shots (kind, framing, on-screen text, motion, palette, keyframe url), its transcript and any sound events inside a window, as rows.