remix_find
Make it mine, for a long-form opening or a package: write up to n (1 to 5, default
3) new ones for your niche that keep one real find's structure. From a long find,
written holds openings: hook (what the creator says first), then (what the next half
minute has to deliver) and kept_structure, built on the find's template and its order
of beats. From a packaging find it holds packages: title, thumbnail (what to show and
how to frame it), thumbnail_text (the words to print, or null) and kept_structure,
built on its title template and its thumbnail's composition.
Write my intro: with mode "intro" and video_brief (your own video in a few sentences,
10 to 600 characters; a long find only, a packaging find is 422; niche and n are not
used) it writes YOUR intro in the real opening's structure. `written` then holds one
object with a beat for each beat of the real opening, in order: beat, does, from_s,
to_s, seconds and words_budget (the real opening's own timing, never the model's), say
(the words to say, with {placeholders} for what only you know), words, placeholders,
suggested_on_screen and suggested_broll (suggestions, never part of what is said); and
seconds, timing (measured or estimated), kept_structure, placeholders and
numbers_to_placeholders. The answer carries mode "intro" and video_brief, and niche is
null. A number you did not write in video_brief becomes {number}. One that copies the
real opening or runs over a word budget is 422 remix_not_possible.
Returns {"find_id", "kind", "niche", "n", "written", "label", "credits_charged": 1,
"credits"}. label says they were written by Hook Detector from a real opening's (or
package's) structure: show it with them, never present one as a real video's. One that
is the real find's own words is dropped. They are never added to a run, a keep or an
export. Costs 1 credit per call, taken before the model is asked and refunded when it
does not answer (503 model_unavailable) or when nothing it wrote keeps the rules or it
declines the content (422 remix_not_possible, the reason in the message; another try
or another niche may work). 402 insufficient_credits at a balance of 0;
404 find_not_found; limited per account per hour (429 rate_limited). Needs the
research permission. The answer carries remix_id: list_remixes and get_remix read it
back, free. Same as POST /v1/finds/{find_id}/remix.Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| n | No | how many to write, 1 to 5 (default 3) | |
| mode | No | optional: "openings" (the default) writes openings or packages for a niche; "intro" is Write my intro: your own timed intro for the video you describe in video_brief, in this long-form opening's structure. Only a long find has an intro (a packaging find is 422); niche and n are not used in intro mode | |
| niche | No | your niche, product or audience, as you would say it (1 to 120 characters) | |
| api_key | No | ||
| find_id | No | one of your finds (from get_run, get_find, list_finds or list_kept_finds) | |
| video_brief | No | required for mode "intro", 10 to 600 characters: what your video is about, in a few sentences, in your own words and language. The intro uses only the facts and numbers you write here; anything else becomes a {placeholder} | |
| idempotency_key | No | 1 to 255 visible ASCII characters; the same key and request within 24 hours answer the saved remix and charge nothing; the same key with another request is 422 idempotency_key_reused |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |