AI Video Effects API

What is an AI Video Effects API?

An AI video effects API applies a predefined visual effect to your media and returns a finished video. Instead of writing a prompt from scratch, you choose an effect by name — "Cakeify", "Car Explosion", "Dolly Zoom In" — and the platform supplies the tuned template behind it. The result is consistent, repeatable output that is easy to automate.

Muapi groups its effects into four endpoints that share one authentication scheme and the same submit-and-poll flow: AI Video Effects (64 transformations, characters, human moments and styles), Viral Video Effect Templates (41 social-style effects like kisses, hugs and morphs), VFX (9 cinematic effects such as explosions and disintegration) and Camera Motion Controls (47 shots such as crash zooms, whip pans and FPV drone moves). A separate AI Dance Effects endpoint transfers the motion of a reference video onto a character image.

Video Effects vs. General Image-to-Video

Effect presets are for repeatable, named looks: you choose Cakeify or a dolly zoom and get that effect every time, which suits templates, social apps and ad variants. A general image-to-video model takes a free-form prompt and gives you open-ended motion, with less predictability from run to run. Use the effects API when you want a specific, reusable effect; use image-to-video when you want to direct the motion yourself. Compare with the Image to Video API →

Key Capabilities

All Supported Video Effects

Every preset below can be passed as the name parameter on its endpoint. Names are case-sensitive — copy them exactly as shown.

Getting the Best Results

• Use a clear, well-lit source image. Effects work best on a single, sharply focused subject. Cluttered or low-resolution inputs reduce realism.
• Match the effect to the subject. Person-centred effects such as hugs, kisses or character transformations need a visible person; VFX like Car Explosion need the object in frame.
• Set the aspect ratio you will publish in. The AI Video Effects, VFX and Motion Controls endpoints accept 16:9 and 9:16, so generate vertical for Shorts, Reels and TikTok.
• Start at 480p, medium. Cost and speed scale with resolution, quality and duration, so preview an effect cheaply before generating a final 720p, high-quality render.

Privacy and Consent

Several effects place a recognisable person in a new scene, relationship or appearance. Only submit photos of people who have agreed to be used this way, and do not use effects to create misleading content about a real person. Muapi does not verify consent on your behalf; that responsibility sits with the API caller.

How to Call the Video Effects API

1. Host your image. Upload it via POST /api/v1/upload_file or use any publicly reachable URL.
2. Submit the request. Call POST /api/v1/ai-video-effects with image_url, name (the effect) and prompt. Other endpoints (video-effects, vfx, motion-controls) use the same pattern; video-effects needs only image_url and name.
3. Poll for completion. Check GET /api/v1/predictions/{request_id}/result until status is completed, then download the video, or set a webhook to be notified.

curl -X POST https://api.muapi.ai/api/v1/ai-video-effects \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{
    "image_url": "https://example.com/photo.jpg",
    "name": "Cakeify",
    "prompt": "a ceramic mug on a kitchen counter",
    "aspect_ratio": "9:16",
    "resolution": "480p",
    "quality": "medium",
    "duration": 5
  }'

import requests

response = requests.post(
    "https://api.muapi.ai/api/v1/ai-video-effects",
    headers={"x-api-key": "YOUR_API_KEY"},
    json={
        "image_url": "https://example.com/photo.jpg",
        "name": "Cakeify",
        "prompt": "a ceramic mug on a kitchen counter",
        "aspect_ratio": "9:16",
        "resolution": "480p",
        "quality": "medium",
        "duration": 5,
    },
)
request_id = response.json()["request_id"]

result = requests.get(
    f"https://api.muapi.ai/api/v1/predictions/{request_id}/result",
    headers={"x-api-key": "YOUR_API_KEY"},
)
print(result.json())

Frequently Asked Questions