Error
A valid request URL is required to generate request examples{
"success": true,
"generations": [
{
"id": "<string>",
"status": "<string>"
}
],
"creditsDeducted": 123,
"creditsRemaining": 123
}{
"error": "<string>",
"success": true,
"code": "<string>",
"message": "<string>"
}{
"error": "<string>",
"success": true,
"code": "<string>",
"message": "<string>"
}Thumbnail generator
Create thumbnail
Generate click-worthy YouTube thumbnails from a title, script, or reference image — returns a job you can poll until the images are ready.
POST
/
thumbnails
/
create
Error
A valid request URL is required to generate request examples{
"success": true,
"generations": [
{
"id": "<string>",
"status": "<string>"
}
],
"creditsDeducted": 123,
"creditsRemaining": 123
}{
"error": "<string>",
"success": true,
"code": "<string>",
"message": "<string>"
}{
"error": "<string>",
"success": true,
"code": "<string>",
"message": "<string>"
}Pass YouTube URL in
context for YouTube thumbnail mode:
{
"prompt": "Bold title, shocked face",
"context": [{ "type": "youtube", "content": "https://youtube.com/watch?v=..." }],
"variations": 3
}
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Body
application/json
Title or idea for the thumbnail.
One source for the thumbnail: a YouTube video (youtube, reads its title and transcript) or a PDF (document, public URL).
Maximum array length:
1Show child attributes
Show child attributes
Reference images, such as the creator's face. Up to 16 including the template.
One layout template image to follow.
Maximum array length:
1Facial expression for the person in the thumbnail.
Available options:
auto, neutral, soft-smile, big-smile, surprised, confused, worried, angry, sad, disgusted, determined Required range:
1 <= x <= 20