Person Tools

Manage reference persons that can be included in thumbnail generations. Persons provide consistent face references.

create_person

Create a reference person for thumbnail generations. Guide: https://thumbfa.st/docs/person-best-practices

Endpoint: POST /api/v1/tools/create_person

Parameters

Example

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

list_persons

List all reference persons in your organization. Use this to find person IDs before calling generate_thumbnail with personIds. Persons automatically replace faces in thumbnails - no need to mention them in the prompt.

Endpoint: POST /api/v1/tools/list_persons

This tool takes no parameters.

Example

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

get_person

Get details of a specific reference person.

Endpoint: POST /api/v1/tools/get_person

Parameters

Example

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

delete_person

Delete a reference person.

Endpoint: POST /api/v1/tools/delete_person

Parameters

Example

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