Pose-to-animation walkthrough

Create a mascot with references, generate a pose, check it, then animate that exact pose, so you see the pose before paying for the video. Each step feeds IDs into the next.

Step 1: Create a project and mascot

Create the project, then a mascot seeded with reference_image_urls, so its style card is extracted on the first generation.

curl -X POST https://api.masko.ai/v1/projects \
  -H "Authorization: Bearer masko_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "My SaaS"
  }'

curl -X POST https://api.masko.ai/v1/mascots \
  -H "Authorization: Bearer masko_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "project_id": "75270a54-f2f9-58e5-83c0-8575c720ca86",
    "name": "Felix the Fox",
    "context": "Friendly brand mascot for our SaaS",
    "reference_image_urls": [
      "https://example.com/fox-front.png",
      "https://example.com/fox-side.png"
    ]
  }'

Step 2: Add additional references (optional)

A mascot can have up to 6 references. Adding or removing one clears the style card, which the next generation extracts again.

curl -X POST https://api.masko.ai/v1/mascots/8bf14263-eabc-58a4-80f6-be9e4f7bceeb/references \
  -H "Authorization: Bearer masko_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://example.com/fox-back.png"
  }'

Step 3: Generate a pose image

Generate the pose you want to animate, and keep asset_ids.image for step 4.

curl -X POST https://api.masko.ai/v1/mascots/8bf14263-eabc-58a4-80f6-be9e4f7bceeb/generate \
  -H "Authorization: Bearer masko_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "image",
    "name": "Waving hello",
    "image_prompt": "waving hello with a friendly smile, one arm raised"
  }'

Poll /v1/jobs/0818df65-d092-5901-a506-3b2e64fb88ef?wait=true&api_version=2026-09-26 until the job is completed, then check the pose.

Step 4: Animate that pose

Send type: "animation" with source_image_asset_id set to the image from step 3. animation_model: "standard" costs 2 credits/sec (2–15s) and "premium" 6 credits/sec (4–30s), both 5s by default; this example costs 10 credits.

curl -X POST https://api.masko.ai/v1/mascots/8bf14263-eabc-58a4-80f6-be9e4f7bceeb/generate \
  -H "Authorization: Bearer masko_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "animation",
    "item_id": "b3bbee96-0599-5ca2-ab23-e7b157f50091",
    "source_image_asset_id": "3c8ce568-35ce-59c2-b3f8-9fb7e4a16e52",
    "animation_prompt": "waving arm back and forth in a friendly greeting",
    "animation_model": "standard",
    "duration": 5
  }'

Next steps

Animations guide covers transitions between poses, auto-reverse looping, and size variants
Reference images and style consistency explains the three kinds of reference images and when to use each

Pose-to-animation walkthrough

Step 1: Create a project and mascot#

Step 2: Add additional references (optional)#

Step 3: Generate a pose image#

Step 4: Animate that pose#

Next steps#

Step 1: Create a project and mascot

Step 2: Add additional references (optional)

Step 3: Generate a pose image

Step 4: Animate that pose

Next steps