Render a thumbnail
Package a finished video with its cover: one frame of it, three to five words, at most one picture, sized for the platform.
It is filed beside the video as <video>-thumbnail.jpg, so a post that carries only the video key gets the cover on YouTube, LinkedIn, Facebook and Reels without another step.
Ask in plain words
- "make a YouTube thumbnail for this video"
- "thumbnail generator API"
- "put a three word cover on my Reel"
From an agent host (MCP)
Server: https://shapelessai.com/mcp (add it to your host).
render_thumbnail: Package a finished video with its cover: one frame of it (frame_at, in seconds), three to five words, at most one picture. Filed beside the video as <video>-thumbnail.jpg, so a post that carries the video key gets the cover. Free: nothing is charged. Needs the write scope.
From code (REST)
Bearer API key with the scope each call names (auth, OpenAPI).
POST /api/thumbnails(write scope): A frame of a video plus words (tool render_thumbnail). Schema on GET /api/tools.
The body
video_keystring, required: The finished video (mediaKey from edit_footage or videoKey from a video job (jobs_create)).frame_atnumber, required: Seconds into the video (or into frame_key) to take the face from.frame_keystring: A clip to take the frame from instead, at its own resolution: the take behind the cut. frame_at then counts on it.headlinestring, required: Three to five words, not the title. Stars mark the accent words: "I hired an AI".picture_keystring: One picture at most (an image media key): the product, the post, the number, the company's mark or the face of the person the video is about.accentstring: Hex colour of the starred words. Defaults to the cut's accent.foregroundstring: Hex colour of the words. Default white.outlinestring: Hex colour of the contour and the scrim behind the words. Default near-black.budgetUsdnumber: The most this call may spend, in USD (default 2, max 10). Held while the tool runs, released after.
From a terminal (CLI)
shapeless tools run render_thumbnail --input '<json>'(tools show render_thumbnailprints the schema)
Example
Refusals
| Status | Meaning |
|---|---|
| 400 | The input does not match the tool's schema; the message names the field. |
| 402 | Not enough credit to hold budgetUsd, or the call costs more than budgetUsd. |
| 404 | No such tool on this deployment. |
| 422 | The tool refused this input; nothing was charged. |
| 502 | The tool failed; nothing was charged. |
Where else
More in Media
Generate an image · Generate AI video · Edit a video · Record a product demo · Render a carousel · Turn text into speech · Make subtitle files · Call any agent tool
