Get authoring context for a media item (faces + transcript)
The read-only context an agent needs to author a composition over this source: the detected face/subject roster (face-0 = primary speaker, with normalized bbox + active-speaker share) and the transcript. Call this before authoring crop intents (reframe) and overlay/caption timing. Faces are lazily detected — `faces.status` is `not_detected` until a compose/detect pass has run over the source, never a faked empty roster.
AuthorizationBearer <token>
API key auth. Prefix cf_live_ for production orgs, cf_test_ for sandbox.
In: header
Path Parameters
id*string
Response Body
application/json
application/json
application/json
application/json
application/json
application/json
application/json
curl -X GET "https://example.com/v1/media/string/context"{ "mediaId": "string", "durationSec": 0, "width": 0, "height": 0, "faces": { "status": "ready", "windows": [ { "window": { "startSec": 0, "endSec": 0 }, "faces": [ { "faceId": "string", "bbox": { "x": 0, "y": 0, "width": 0, "height": 0 }, "speakingShare": 0 } ] } ] }, "transcript": { "status": "ready", "data": { "mediaItemId": "string", "language": "string", "model": "string", "fullText": "string", "utterances": [ { "property1": null, "property2": null } ], "data": [ { "property1": null, "property2": null } ], "pagination": { "hasMore": true, "nextCursor": "string", "prevCursor": "string" } } }}{ "error": { "code": "string", "message": "string", "details": { "property1": null, "property2": null } }}{ "error": { "code": "string", "message": "string", "details": { "property1": null, "property2": null } }}{ "error": { "code": "string", "message": "string", "details": { "property1": null, "property2": null } }}{ "error": { "code": "string", "message": "string", "details": { "property1": null, "property2": null } }}{ "error": { "code": "string", "message": "string", "details": { "property1": null, "property2": null } }}{ "error": { "code": "string", "message": "string", "details": { "property1": null, "property2": null } }}