List switch (multicam) candidates + recommendation for a synced-angle group
Required permission: media:read
API key auth. Prefix cf_live_ for production orgs, cf_test_ for sandbox.
In: header
Path Parameters
Response Body
application/json
application/json
application/json
application/json
application/json
application/json
application/json
application/json
curl -X GET "https://example.com/v1/projects/string/selector/candidates"{ "projectId": "string", "groupId": "string", "selectorVersion": "string", "signalVersions": { "property1": "string", "property2": "string" }, "moments": [ { "startSec": 0, "endSec": 0, "chosen": "string", "pacingNote": "string", "candidates": [ { "candidateId": "string", "role": "string", "score": 0, "contributions": { "property1": 0, "property2": 0 }, "reasons": [ "string" ] } ] } ], "recommendation": { "cutSchedule": [ { "startSec": 0, "endSec": 0, "candidateId": "string", "sourceInSec": 0, "sourceOutSec": 0, "reasons": [ "string" ] } ], "audioBed": [ { "startSec": 0, "endSec": 0, "candidateId": "string", "reasons": [ "string" ] } ], "suppressedSwitches": [ { "atSec": 0, "wouldHaveBeenCandidateId": "string", "byScore": 0, "blockedBy": "string", "releaseAtSec": 0 } ] }, "divergesFromComposition": true}{ "error": { "code": "string", "message": "string", "details": { "property1": null, "property2": null } }}{ "error": { "code": "string", "message": "string", "details": { "property1": null, "property2": null } }}{ "x402Version": 2, "accepts": [ {} ], "error": "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 } }}Search stock media (Pexels / Pixabay / Freesound / Klipy) POST
Search licensed stock media by keyword. Pass `query` for one search, or `queries[]` (β€10) to run a batch in ONE call β the batch returns `results[]`, one entry per query in order, each with its own `candidates` (and an `error` string if that single query failed; one bad query never discards the rest). `kind` selects the corpus (video/photo β Pexels+Pixabay, sfx β Freesound CC0-only, gif β Klipy); defaults to video. Returns ranked candidates each carrying an opaque `candidateId` β pass it to import_resource to bring the asset into a project. Free + rate-limited; results are cached for 7 days, after which a candidateId must be refreshed by searching again. For sfx, bound the result by clip length with `durationSec` β impacts/ticks β 0β2s, risers/whooshes β 2β8s, ambients unbounded.
Re-resolve a switch advisory under a hand-supplied policy (A/B taste; not persisted) POST
Required permission: media:read