Base URL
All API requests are made to:https://youthumb.ai/api
Getting Your API Key
To use the API, you need an API key. Here's how to get one:1
Navigate to API Keys
Go to Account → API Keys
2
Create New Key
Click the Create API Key button and give your key a descriptive name.
3
Copy Your Key
Copy your API key immediately. For security reasons, it will only be shown once.
Security Warning: Never expose your API key in client-side code, public repositories, or browser JavaScript. Always use environment variables and server-side requests.
Quick Start
Here's a minimal example to create and generate a thumbnail:# 1. Create a thumbnail project
curl -X POST https://youthumb.ai/api/thumbnails \
-H "x-api-key: your_api_key" \
-H "Content-Type: application/json" \
-d '{"prompt": "Excited creator with bright yellow background"}'
# Response: { "success": true, "data": { "projectId": "abc-123", ... } }
# 2. Start generation
curl -X POST https://youthumb.ai/api/thumbnails/abc-123/start \
-H "x-api-key: your_api_key"
# 3. Poll for completion
curl https://youthumb.ai/api/thumbnails/abc-123/status \
-H "x-api-key: your_api_key"Response Format
All API responses follow a consistent format: Success Response:{
"success": true,
"data": { ... }
}{
"success": false,
"error": "Error message",
"details": { ... } // Optional: validation errors
}Available APIs
| API | Description |
|---|---|
| Thumbnails | Create and generate AI thumbnails |
| Persons | Manage face profiles for personalization |
| Templates | Browse style reference templates |
| Presets | Access predefined style presets |
Rate Limits
API requests are rate-limited based on your subscription plan. If you exceed the limit, you'll receive a429 Too Many Requests response.
What's Next?
1
Authentication
Learn about authentication methods and best practices.
2
Thumbnails API
Explore the Thumbnails API to start generating thumbnails.
Need help? Contact our support team or check the error codes reference for troubleshooting.