Leonardoai Motion 2.0 API Documentation

Leonardoai Motion 2.0 API Documentation

Playground

Leonardo Motion 2.0 delivers upgraded image-to-video generation, producing more realistic, detailed videos than its predecessor. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.

Features

Generate smooth, cinematic video from a single prompt (and optional reference image). Motion 2.0 focuses on stable subjects, clean transitions, and faster turnaround—ideal for story beats, product shots, title cards, and social posts.

Why it looks great

• Enhanced motion coherence — Sharper continuity between subject and background with far less flicker, wobble, or geometric distortion.
• Stable subject integrity — Characters and objects keep their identity under complex moves; no “melting” during fast action.
• Higher aesthetic quality — Cinematic lighting, richer textures, and finer detail for a more filmic look and stronger sense of depth.
• Improved motion control — Prompts like “slow dolly-zoom” or “rapid orbit” map more faithfully to the final camera behavior.
• Faster generation — Quicker inference so you can iterate rapidly and lock creative decisions sooner.

Pricing

$0.30 per run! Clear, simple pricing for predictable budgeting.

How to use

1. Write your prompt. Describe scene, subject, motion, lighting, and mood.
2. (Optional) Add a reference image.
3. Pick aspect_ratio. 16:9 for landscape, 9:16 for vertical.
4. Generate. Review the result, then refine phrasing (or reuse the same seed if available) for controlled iterations.

Prompt starters

• “A lone hiker at golden hour; slow dolly-in, gentle wind in grass, soft rim light, shallow depth of field, cinematic grade.”
• “Minimal product hero on pedestal; 360° orbit at medium speed, studio key light + soft fill, glossy reflections.”
• “Noir alley at night; handheld micro-jitter and push-in, neon bounce light, light rain, fog rolling through.”

Pro tips

• Be explicit about camera verbs (dolly, pan, tilt, orbit) and speed (slow/medium/fast).
• Specify lighting and materials (backlight, rim light, volumetrics, glossy/rough) to guide mood and texture.
• Keep prompts focused; remove conflicting style words to improve motion coherence.
• When using an image, describe which parts should stay consistent versus change.

Common use cases

• Storyboards and previz with believable camera language
• Logo/title motion with controlled cinematic moves
• Product promos that preserve brand color and surfaces
• Social shorts where vertical 9:16 is a must

Authentication

For authentication details, please refer to the Authentication Guide.

API Endpoints

Submit Task & Query Result

set -euo pipefail

export WAVESPEED_API_KEY="your-api-key"

REQUEST_BODY=$(cat <<'JSON'
{
  "prompt": "A cinematic ocean wave at sunrise, highly detailed",
  "aspect_ratio": "16:9"
}
JSON
)

# 1. Submit the prediction.
SUBMIT_RESPONSE=$(curl --silent --show-error --fail-with-body \
  -X POST "https://api.wavespeed.ai/api/v3/leonardoai/motion-2.0" \
  -H "Authorization: Bearer ${WAVESPEED_API_KEY}" \
  -H "Content-Type: application/json" \
  -d "${REQUEST_BODY}")

TASK=$(printf '%s' "${SUBMIT_RESPONSE}" | jq 'if type == "object" and has("data") then .data else . end')
PREDICTION_ID=$(printf '%s' "${TASK}" | jq -r '.id // empty')
if [ -z "${PREDICTION_ID}" ]; then
  printf 'Submission response did not contain a prediction id
' >&2
  exit 1
fi
RESULT_URL="https://api.wavespeed.ai/api/v3/predictions/${PREDICTION_ID}/result"

# 2. Poll until the prediction finishes.
while true; do
  RESPONSE=$(curl --silent --show-error --fail-with-body \
    "${RESULT_URL}" \
    -H "Authorization: Bearer ${WAVESPEED_API_KEY}")
  RESULT=$(printf '%s' "${RESPONSE}" | jq 'if type == "object" and has("data") then .data else . end')
  STATUS=$(printf '%s' "${RESULT}" | jq -r '.status // empty')

  case "${STATUS}" in
    completed) printf '%s\n' "${RESULT}" | jq '.outputs'; break ;;
    failed|cancelled|timeout|deleted) printf '%s\n' "${RESULT}" | jq . >&2; exit 1 ;;
    *) sleep 2 ;;
  esac
done

Parameters

Task Submission Parameters

Request Parameters

Response Parameters

Result Request Parameters

Result Response Parameters