Welcome to MMAI

Authorization: Bearer your_api_key_here

curl -X GET https://www.magicmotion.ai/api/test-api-key \
  -H "Authorization: Bearer your_api_key_here"

curl -X POST https://www.magicmotion.ai/api/generate-motion \
  -H "Authorization: Bearer your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "dancing with excitement",
    "length": 8,
    "guidance_scale": 12
  }'

const generateAnimation = async (prompt, options = {}) => {
  const response = await fetch('https://www.magicmotion.ai/api/generate-motion', {
    method: 'POST',
    headers: {
      'Authorization': `Bearer ${process.env.MAGIC_MOTION_API_KEY}`,
      'Content-Type': 'application/json',
    },
    body: JSON.stringify({
      prompt,
      length: options.length ?? 5,
      guidance_scale: options.guidance_scale ?? 4,
      ...options,
    }),
  });

  if (!response.ok) {
    const error = await response.json();
    throw new Error(`MMAI API Error: ${error.message}`);
  }

  return response.json();
};

const result = await generateAnimation('jumping with joy', {
  length: 6,
  guidance_scale: 10,
});

console.log('Animation URL:', result.animation_url);
console.log('Credits remaining:', result.metadata.credits_remaining);

import requests
import os

def generate_animation(prompt, length=5, guidance_scale=4, seed=None):
    headers = {
        'Authorization': f'Bearer {os.getenv("MAGIC_MOTION_API_KEY")}',
        'Content-Type': 'application/json',
    }
    data = {'prompt': prompt, 'length': length, 'guidance_scale': guidance_scale}
    if seed:
        data['seed'] = seed

    response = requests.post(
        'https://www.magicmotion.ai/api/generate-motion',
        headers=headers,
        json=data,
    )
    response.raise_for_status()
    return response.json()

result = generate_animation('running in place', length=7, guidance_scale=8)
print(f"Animation URL: {result['animation_url']}")
print(f"Credits remaining: {result['metadata']['credits_remaining']}")

{
  "success": true,
  "job_id": "run_abc123def456",
  "animation_url": "https://storage.supabase.co/...",
  "metadata": {
    "prompt": "A Person dancing with excitement",
    "original_prompt": "dancing with excitement",
    "length": 8,
    "guidance_scale": 12,
    "seed": "1234567",
    "credits_used": 8,
    "credits_remaining": 492
  }
}

curl -X POST https://www.magicmotion.ai/api/generate-motion \
  -H "Authorization: Bearer your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A person walks forward confidently",
    "length": 5,
    "async_mode": true,
    "constraints": [{
      "type": "root2d",
      "frame_indices": [0, 60],
      "smooth_root_2d": [[0, 0], [1.5, 0]],
      "global_root_heading": [[1, 0], [1, 0]]
    }]
  }'

curl -X POST https://www.magicmotion.ai/api/kimodo/validate-constraints \
  -H "Authorization: Bearer your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{"constraints":[{"type":"root2d","frame_indices":[0],"smooth_root_2d":[[0,0]]}]}'

# Start generation — returns immediately
curl -X POST https://www.magicmotion.ai/api/generate-motion \
  -H "Authorization: Bearer your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "dancing with excitement",
    "length": 8,
    "guidance_scale": 12,
    "async_mode": true
  }'

# Response (202 Accepted)
# {
#   "success": true,
#   "job_id": "e8f184eb-c082-43de-8963-2ae33eb6006c-u2",
#   "status": "IN_PROGRESS",
#   "message": "Generation started. Poll /api/job-status/{job_id} for updates.",
#   "metadata": { ..., "estimated_time_seconds": 48 }
# }

async function waitForAnimation(jobId, apiKey) {
  const POLL_MS = 3000;
  const MAX_MS  = 10 * 60 * 1000; // 10 minutes
  const start   = Date.now();

  while (Date.now() - start < MAX_MS) {
    await new Promise((r) => setTimeout(r, POLL_MS));

    const res  = await fetch(
      `https://www.magicmotion.ai/api/job-status/${jobId}`,
      { headers: { Authorization: `Bearer ${apiKey}` } }
    );
    const data = await res.json();

    if (data.status === 'COMPLETED') return data.animation_url;
    if (data.status === 'FAILED')
      throw new Error(`Generation failed: ${data.message}`);

    // IN_QUEUE or IN_PROGRESS — keep polling
  }

  throw new Error('Timed out waiting for animation');
}