A frame of a video plus words (tool render_thumbnail). Schema on GET /api/tools.

post/api/thumbnails

Request

  • Base URL: https://shapelessai.com
  • URL: https://shapelessai.com/api/thumbnails
  • Auth: one of:
    • HTTP bearer
    • OAuth 2 (authorization code, authorization URL https://shapelessai.com/api/auth/mcp/authorize, token URL https://shapelessai.com/api/auth/mcp/token, scopes: write)

Request body

video_keystring required

The finished video (mediaKey from edit_footage or videoKey from render_video_project).

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.

Response

OK

toolstring required
outputunknown required
chargedUsdnumber required

Changes

No recorded changes to this operation across all 2 revisions of this API.