Generation Tools

Generate, modify, and manage AI-generated YouTube thumbnails. These tools handle the core thumbnail creation workflow.

generate_thumbnail

Generate YouTube thumbnails from a text prompt.

Endpoint: POST /api/v1/tools/generate_thumbnail

Cost: 1 thumbnail | Rate Limit: 10 requests/min

Parameters

Parameter	Type	Required	Description
`prompt`	string	No	Text description of the thumbnail (default: 1)
`imageIds`	string[]	No	IDs of uploaded images
`model`	string	No	AI model to use (default: gemini)

Example

curl -X POST https://thumbfa.st/api/v1/tools/generate_thumbnail \
  -H "Authorization: Bearer tf_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A YouTuber looking shocked at their laptop",
    "model": "gemini"
  }'

get_generation_status

Get the status of a generation including pending and completed thumbnails.

Endpoint: POST /api/v1/tools/get_generation_status

Parameters

Parameter	Type	Required	Description
`generationId`	string	Yes	ID of the generation to check

Example

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

generate_variation

Create new variations of an existing prompt with optional modifications.

Endpoint: POST /api/v1/tools/generate_variation

Cost: 1 thumbnail | Rate Limit: 10 requests/min

Parameters

Parameter	Type	Required	Description
`promptId`	string	No	ID of the existing prompt (default: 1)
`newPrompt`	string	No	Modified prompt text
`model`	string	No	AI model to use (default: gemini)

Example

curl -X POST https://thumbfa.st/api/v1/tools/generate_variation \
  -H "Authorization: Bearer tf_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "promptId": "example_promptId",
    "model": "gemini"
  }'

list_generations

List your generated thumbnails with optional search and pagination.

Endpoint: POST /api/v1/tools/list_generations

Parameters

Parameter	Type	Required	Description
`cursor`	string	No	Pagination cursor
`search`	string	No	Search in prompt text

Example

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

cancel_generation

Cancel pending generations and get thumbnails refunded.

Endpoint: POST /api/v1/tools/cancel_generation

Parameters

Parameter	Type	Required	Description
`generationId`	string	Yes	ID of the generation to cancel

Example

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

trigger_generation

Trigger the actual image generation for a pending generation. Called internally by the generation loop.

Endpoint: POST /api/v1/tools/trigger_generation

This tool takes no parameters.

Example

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

REST API Person Tools