Thumbnail
Generate a platform-sized thumbnail from a title, with the brief LLM-refined first. An AI image by default, with no text on it. Send headline to have the words laid on it, variants (up to 4) for several images to choose from, each with a preview, or source to make it from a frame of your own video instead. Each image is priced as one thumbnail.
Authorizations
A workspace API key.
Headers
Stable retry key for this logical paid call. Reuse it after a timeout to receive the original result without duplicate work or spend.
1 - 255Send 1 to get the price, balance and budget verdict without running anything.
"1"The approved price; a call that would cost more is refused and nothing is charged.
^\d+$Body
Video or article title. This is the only required field.
1 - 200The existing project to file this work under. Create it with POST /v1/projects, then reuse its id across related calls. A project this workspace does not own answers not_found; the work is never silently filed somewhere else.
1 - 200Who or what should be visibly present; the strongest visual-quality input.
300Up to 3,000 characters from the content. Helps the image reflect the actual material instead of guessing from the title.
3000Id of an asset this workspace has already transcribed. Use it instead of pasting transcript; if both are sent, transcript wins. Asset ids come from GET /v1/assets.
1 - 200Additional visual direction that is not already in the title or subject.
500Emotional tone, e.g. urgent, calm, or hopeful.
80Preferred palette in plain language or hex colors.
100Where the main subject sits. Defaults to subject_left; accepted values are listed below.
subject_left, subject_right, centered Visual treatment. Defaults to viral; accepted values are listed below.
viral, cinematic, bold-text, dramatic, educational, minimal Target platform, which determines aspect ratio: 16:9 for youtube, 9:16 for the others. Defaults to youtube.
youtube, youtube_shorts, instagram_reels, tiktok Words to lay on the thumbnail, in heavy capitals on the side the composition leaves open. Omit it for a clean image with no text (the default).
1 - 120How many different images to make, 1 to 4. Each is priced as one thumbnail. Defaults to 1.
1 <= x <= 4Brand colours for the headline panel and accents. Used only with headline.
Brand heading font for the headline; one Sigmora cannot draw falls back to Anton.
60Make the thumbnail from a frame of your own video instead of generating an image. The headline (or the title) is laid on the frame. One image per call.
Response
Success.
- Option 1
- Option 2
What this call actually cost, which is not always what was quoted.
300
The existing project this work was filed under. It matches the projectId supplied by the caller after workspace ownership was verified.
"prj_9x2a4c"
Your balance after the charge. Absent when billing is disabled for the workspace.
3900
Present only when assetId was sent: the indexed transcript the image was written from.