Make a shot candidate
create_candidateGenerate a shot candidate picture or clip for a specific shot in a faceless video run, to keep or discard later. Call quote_candidate first to see the price.
Instructions
Make a shot candidate of a run made by make_faceless (paid): a NEW run of skill edit_shot that generates one picture or clip for one shot, to keep or discard in a later revision. Call quote_candidate first and show the user the price. A delivered candidate is charged its one unit whether it is kept or discarded; one that fails is charged nothing, even when its paid work was already done. An identical request returns the same run it started before, so a call repeated after a lost answer starts nothing new; to make another candidate with the same request on purpose, pass take 2. An original has a limit on candidates running at once and on candidates failed or unfinished, apart from its revisions; a refusal names which. While shot candidates are closed it answers editing_disabled and charges nothing. The result is a new run: poll it with get_run; once it succeeded, its candidate.preview_url shows what was made.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| take | No | Take number, 1 by default: the same request and take return the same run; take 2 makes another candidate. | |
| run_id | Yes | The faceless run whose shot the candidate is for: a succeeded original or revision. | |
| shot_id | Yes | The shot to make a candidate for, as get_run_shots names it. | |
| operation | Yes | What to generate: one of the operations get_run_shots lists for the shot. |