Logos, scenes and stickers

Use the same character collection to generate assets for your product. These requests spend generation credits. Logo and scene generation return asynchronous jobs; sticker generation can return an already completed result.

Logo

A logo generation costs 5 credits. Choose the description and style for this request:

curl https://api.masko.ai/v1/collections/COLLECTION_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"
  }'

Scene

A scene costs 3 credits. Describe the environment and the character’s action separately:

curl https://api.masko.ai/v1/collections/COLLECTION_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"
  }'

Supported aspect ratios are 4:3, 1:1, 21:9, 4:5, 3:4, and 9:16. To edit a scene, use type: "scene" with source_image_asset_id and edit_instructions.

Sticker

POST /v1/assets/:id/sticker turns an existing image asset into a sticker. It costs 1 credit and requires a completed image attached to a collection. A completed response uses HTTP 201; inspect data.status and the returned asset. Read the endpoint reference for the sticker options and the accepted source asset requirements.

Collect the result

Save data.job_id, check job progress, and retrieve the completed assets. Prefer returned URLs over constructing paths. See hosting and formats for published URLs and signed links.