skills/thumbnail-set/SKILL.md

---
name: thumbnail-set
description: "Three to five thumbnail concepts for a video: a face or product, a short title treatment, high contrast, delivered at upload size."
---

Needs: the video's title; a face photo or the product photos; the platform (YouTube 16:9, Instagram 1:1 or 4:5)
Credits: about 110–180 (3–5 images at ~36 each, the default model's 4K tier)
Time: 10 minutes

## When

After the video exists: a set to A/B. Not for the video itself.

## Ask first

1. **Title** — the 2–4 words that go on the image.
2. **Subject** — a face (`show_upload` for files on the user's device, `import_media_url` for a web link; images attached to the chat do not reach Frameo, and `create_upload_url` is for clients that send the file themselves) or the product photos.
3. **Platform** — sets the frame: YouTube 16:9, Instagram 1:1; for Instagram 4:5 generate at
   3:4 (the nearest supported ratio) and crop at the end.

## Steps

**Before any paid step.** The project: `list_projects` (or `create_project`) gives the `project_id`
and, when the project has several modules, the `module_id`; every call below that takes a project —
`estimate_cost` included — gets that same pair; without it those tools answer `project_needed`. The
quote: one `estimate_cost(items=[…])` prices a stage in one call, with the same project, model,
size and number of `image_urls` or `reference_image_urls` (`reference_count`) as each generate call, and returns a `quote_id` per item plus the total. Each generate call
then passes its own item's `quote_id` and `confirmed_by_user=true`. A quote is single-use and lasts
15 minutes, so a long plan is priced stage by stage, right before each stage runs; a stage that
comes to more than the user approved is asked about again first. Generate calls return
`generation_ids`; `wait_task` returns the links, and `show_generations` shows each stage's running
and finished work in one card where the chat app displays Frameo cards: all the stage's ids at
once, before its first `wait_task`, and the finished result with `final: true`.

**The plan first.** Before the first paid call, the plan goes to the user in the chat as plain
text: what will be made, in order, one line per generation (for a script, the shot list; for a
set, each shot), with each line's credits and the total. The credits come from
`estimate_cost(items=[…])`, up to 10 items a call, so a long plan takes several calls; those
quotes may expire unused, since each stage is quoted again right before it runs. Nothing is
generated until the user says yes. The user can drop or change lines; a changed line is priced
again.

**1. Concepts.** Propose 3–5 in one line each (big face + reaction, product + number, before/
after, a question, a bold object on colour); the user picks or edits.

**2. Images (~36 each at 4K).** `generate_image` per concept, each with its own quote,
`image_urls=[face or product]`,
prompt = the concept plus "high contrast, one focal point, space on the left third for
text, no small details", `aspect_ratio` from Ask first (1:1, 16:9, 9:16 or 3:4) and
`image_resolution` at the highest tier the model offers (`list_models(kind="image")`
names them, e.g. 4K on the default; the quote is exact for that model and tier). Leave the title off the image: the exact title is burned in at step 3, not generated.
`wait_task`, then show the set.

**3. Title and exact size (free).** One `run_ffmpeg` per pick: `scale` + `crop` to the
platform's pixel size (1280×720, 1080×1080, 1080×1350), and the title burned in from an `.ass`
sidecar with the `ass` filter (Noto Sans, large and bold, thick outline, in the free space) unless the
user prefers their own editor; ask which. `wait_task` for each
output link.

**4. Deliver.** Links and `open_in_frameo`.

## Done

The set on the canvas in one row.
`open_in_frameo` on the result opens the project in the Frameo app, where every take sits on
the canvas, ready for retakes and edits.

## Files

None.