ShapelessAIAll capabilities
Media

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.

View as Markdown

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).

  • tools_run with { "name": "render_thumbnail", "input": { ... } }: the input is the REST body below; tools_list prints its JSON Schema.

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.

From a terminal (CLI)

  • shapeless tools run render_thumbnail --input '<json>' (tools show render_thumbnail prints the schema)

Example

curl -s https://shapelessai.com/api/thumbnails -H "Authorization: Bearer $SHAPELESS_API_KEY" -H "Content-Type: application/json" -d '{"video_key":"<mediaKey>","frame_at":3.2,"headline":"We cut *the price*"}'

Refusals

StatusMeaning
400The input does not match the tool's schema; the message names the field.
402Not enough credit to hold budgetUsd, or the call costs more than budgetUsd.
404No such tool on this deployment.
422The tool refused this input; nothing was charged.
502The tool failed; nothing was charged.

Where else

Every capability · Docs · /llms.txt