Inspiration Tools

Save and manage style inspirations from YouTube videos or images. Inspirations guide the AI's visual style.

create_inspiration

Create an inspiration from a YouTube video or image. Guide: https://thumbfa.st/docs/inspiration-guide

Endpoint: POST /api/v1/tools/create_inspiration

Cost: 0.1 thumbnails

This tool takes no parameters.

Example

curl -X POST https://thumbfa.st/api/v1/tools/create_inspiration \
  -H "Authorization: Bearer tf_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{}'

list_inspirations

List inspirations to find style references for generations. Use this to find inspiration IDs before calling generate_thumbnail with inspirationIds. Filter by 'mine' for your own inspirations or 'all' for the public library. Search by name or category to find specific styles (e.g., "tech", "gaming", "minimalist").

Endpoint: POST /api/v1/tools/list_inspirations

Parameters

Example

curl -X POST https://thumbfa.st/api/v1/tools/list_inspirations \
  -H "Authorization: Bearer tf_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "limit": 20
  }'

get_inspiration

Get details of a specific inspiration.

Endpoint: POST /api/v1/tools/get_inspiration

Parameters

Example

curl -X POST https://thumbfa.st/api/v1/tools/get_inspiration \
  -H "Authorization: Bearer tf_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "inspirationId": "example_inspirationId"
  }'

delete_inspiration

Delete an inspiration from your organization.

Endpoint: POST /api/v1/tools/delete_inspiration

Parameters

Example

curl -X POST https://thumbfa.st/api/v1/tools/delete_inspiration \
  -H "Authorization: Bearer tf_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "inspirationId": "example_inspirationId"
  }'