Logos, scenes and stickers

Turn your mascot into a logo or app icon, an SVG, a scene or a sticker. Logos, SVGs and scenes return jobs to poll; a sticker can complete right away.

Logo#

Rudy, the mascot	Graphic app icon	Cut-paper mark	Soft-depth icon

Three logos from one mascot; more styles on the mascot logo page.

A logo costs 5 credits. The references supply the identity, logo_description the composition (such as a face portrait with asymmetrical ears) and logo_style_instruction the treatment (such as flat colors or bold outlines), so you can change one without the other.

For a filled icon, name the background color and ask it to fill the canvas; the master keeps it. The transparent version, used for resized PNGs and the favicon, can lose colored backing shapes, so use the master for a filled badge. Output is raster; for vector paths, generate an SVG.

curl https://api.masko.ai/v1/mascots/MASCOT_ID/generate \
  -H "Authorization: Bearer $MASKO_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{
    "type": "logo",
    "name": "App icon",
    "logo_description": "A face-only icon of the character",
    "logo_style_name": "Flat",
    "logo_style_instruction": "Solid colors, simple silhouette, no gradients"
  }'

Logo presets and ideas#

• GET /v1/logo-styles: Studio's nine logo treatments with previews and full instructions (not the mascot styles at /v1/styles).
• GET /v1/mascots/{id}/logos/suggestions: five free logo directions and three style suggestions, with optional variant_id and refresh=true. A direction's custom style has name and instruction, plus preset_id for an exact built-in match.

Send a preset as logo_style_id:

{
  "type": "logo",
  "name": "Playful portrait",
  "logo_description": "An oversized face portrait with a natural tilt",
  "logo_style_id": "graphic-app-icon"
}

The preset resolves to its full instructions; logo_style_name and logo_style_instruction override them. For several logos, use /generate-batch with one request each.

For safe retries, create the item first and send its item_id with a UUID request_id. The same ID and body return the existing job without a new charge; a new ID is a new paid attempt.

Generate an SVG from a logo#

Logo image	SVG

POST /v1/assets/{id}/svg with a UUID request_id turns a completed logo master, image, transparent image or sticker into an SVG on the same item, for 30 credits.

curl -X POST 'https://api.masko.ai/v1/assets/ASSET_ID/svg' \
  -H "Authorization: Bearer $MASKO_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{"request_id":"bba386b8-c756-4f7c-89a2-132862188bf4"}'

• The 202 response has data.job_id, data.asset_ids.svg, data.estimated_cost and data.poll_url; the job can take several minutes.
• Reuse the request_id after an interruption or a brief 409. A new ID is another paid generation; failures are refunded.
• Read it with GET /v1/assets/{svg_asset_id} (file_url or cdn_url). In cdn-export, hosted logo items show it as logos.svg and image items as svg.

The source PNG stays unchanged. Paths are editable and scale cleanly, but fine details can differ from the source.

Scene#

A scene costs 3 credits. Describe the place and the action separately:

curl https://api.masko.ai/v1/mascots/MASCOT_ID/generate \
  -H "Authorization: Bearer $MASKO_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{
    "type": "scene",
    "name": "Reading corner",
    "scene": "A cozy library in warm afternoon light",
    "action": "Reading a book in an armchair",
    "aspect_ratio": "4:3",
    "position": "center"
  }'

• aspect_ratio: 4:3, 1:1, 21:9, 4:5, 3:4 or 9:16.
• source_asset_id builds the scene from a specific character image. To edit a scene, send source_image_asset_id and edit_instructions instead.
• variant_id targets a named variant, for logos too. Otherwise a scene's reference image supplies its saved context, and a conflicting variant returns 409 before charging unless it lists that image as a reference.

Sticker#

Ko with a trophy	Ko asleep

POST /v1/assets/:id/sticker turns a completed mascot image into a transparent PNG sticker with a white border, for 1 credit, with no background-removal step. A completed result returns 201; check data.status.

From a completed animation with background removal, it makes an animated sticker in all four chat platform versions for 0 credits; poll GET /v1/assets/{sticker_id}/sticker. See animated sticker creation and the endpoint reference for source requirements.

Collect the result#

Save data.job_id, follow job progress, and use the returned URLs (hosting and file formats) rather than building paths.