Create from Website

Analyze a website to get AI-generated mascot suggestions based on the brand.

Analyze a URL

Send a website URL with type: "url" and the API will screenshot the page, extract brand colors, analyze the visual identity, and suggest mascot concepts that match the brand. This endpoint is free.

curl -X POST https://api.masko.ai/v1/analyze \
  -H "Authorization: Bearer masko_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "type": "url", "url": "https://example.com" }'

Tip

The same endpoint analyzes an image. Pass type: "image" and image_url to extract a character description and name from an existing mascot image.

Use Suggestions

Take a suggestion from the response and pass its prompt and style to create a collection. You can use the direct creation shortcut to do it in one call.

curl -X POST https://api.masko.ai/v1/collections \
  -H "Authorization: Bearer masko_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Codey",
    "project_id": "PROJECT_ID",
    "prompt": "A friendly blue robot with rounded features...",
    "style": "3d"
  }'

When to Use This

Choose the right creation method for your use case:

From website - You have a brand but no mascot idea yet. The AI analyzes the site and suggests characters that match the visual identity.
From text - You already know what you want. Describe the character, pick a style, and generate previews.
From image - You have existing artwork. Upload it and the API auto-detects the character for consistent new poses.