Make Me Santa

Overview

Make Me Santa is a fun and easy-to-use AI tool that transforms your photos into festive Santa Claus-style images. Simply upload your photo, and our AI will add Santa-like features such as the iconic red hat and jolly appearance while maintaining your facial features. Perfect for creating social media posts, or just adding some Christmas cheer to your photos. The tool works with any clear face photo and processes your image within seconds.

API Reference

URL: https://api.maxstudio.ai/make-me-santa
Method: POST

API Parameters

Name	Type	Required	Description
`image`	string	yes	Base64 encoded image

Note: The input image must contain a clearly visible human face for the AI to process successfully.

⚠️ Important: When sending the base64 image, do not include the prefix (e.g., 'data:image/jpeg;base64,'). Send only the raw base64 string.

Headers

Name	Type	Required	Description
`x-api-key`	string	yes	Your API key obtained from the MaxStudio APIs Dashboard (opens in a new tab). Generate this key by logging into your account and navigating to the API Keys section.

Code Examples


// TypeScript implementation
interface Params {
    image: string;
    isSantaFilter: boolean;
}
async function MakeMeSanta(params: Params): Promise<any> {
    try {
        const response = await fetch('https://api.maxstudio.ai/make-me-santa', {
            method: 'POST',
            headers: {
                'Content-Type': 'application/json'
            },
            body: JSON.stringify({
                image: params.image,
                isSantaFilter: params.isSantaFilter
            })
        });
        const jobId = await response.json();
        return jobId;
    } catch (error) {
        console.error('Error:', error);
        throw error;
    }
}

Success Response

{

"jobId": "<job_id>"
}

Error Response Examples

// Rate Limit Error

{
"status": 429,
"error": "Rate limit exceeded. Please try again later."
}

// Insufficient Credits

{
"status": 402,
"error": "Insufficient credits. Please Buy credits."
}

// Invalid Input

{
"status": 400,
"error": "Image size must be less than 5MB"
}

Get Job Status

Headers

Name	Type	Required	Description
`x-api-key`	string	yes	Your API key obtained from the MaxStudio APIs Dashboard (opens in a new tab). Generate this key by logging into your account and navigating to the API Keys section.

To check the status of your job, use the following examples:


// TypeScript implementation
async function getJobStatus(jobId: string): Promise<void> {
    const url = `https://api.maxstudio.ai/make-me-santa/${jobId}`;
    try {
        const response = await axios.get(url);
        const jobId = response.data;
        return jobId;
    } catch (error) {
        console.error('Error:', error);
    }
}

Job Status Reference

Status	Description
creating	Job is being initialized
pending	Job is in processing queue
running	Job is actively processing
completed	Processing finished successfully
failed	Processing encountered an error
not-found	Invalid or expired job ID

Output

{

"status": "<status>", // One of the status values from the table above
"result": "<result>" // Base64 encoded image data when status is 'completed'
}

Video Face Swap Image Style Transfer