Mirelo AI Sfx V1.5 Video To Video API Documentation

Mirelo AI Sfx V1.5 Video To Video API Documentation

Playground

Mirelo SFX V1.5 generates synchronized sound effects and audio for any video, producing synced SFX to enhance visuals. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.

Features

Mirelo SFX v1.5 turns your videos into synchronized sound effects using advanced multimodal AI. It listens, sees, and imagines — automatically generating realistic or cinematic sound layers that perfectly match the visual rhythm. Whether it’s footsteps, explosions, or ambient noise, this model brings motion to life.

Why it sounds great

• AI-driven sound synthesis – Generates sound effects that fit object motion, timing, and energy directly from video frames.
• Cinematic awareness – Detects on-screen actions (impacts, motion, intensity) and produces corresponding effects.
• Multiple variations – Create multiple versions of the same video for creative control and sound design diversity.
• High coherence – Outputs seamlessly loopable audio segments aligned to scene transitions.
• Plug-and-play – Just upload a video clip, set samples, and receive ready-to-use sound effects.

Limits and Performance

• Max duration per job: up to 10 seconds
• Processing speed: typically 6–12 seconds per generation
• Input: MP4, MOV, or URL video upload
• Output: AI-generated synchronized sound effects (WAV or MP3)

Pricing

How to Use

1. Upload a video (drag & drop or paste a URL).
2. (Optional) Write a prompt to describe sound context (e.g., “soft footsteps on wood,” “metal clangs,” “cinematic ambience”).
3. Set num_samples — the number of different sound versions to generate.
4. (Optional) Fix seed for reproducibility or randomize for variation.
5. Click Run — preview and download results.

Pro tips for best quality

• Use short, focused clips (≤10s) to maintain strong visual-sound alignment.
• For cinematic realism, include context in the prompt (e.g., “rainy street, distant thunder”).
• Generate multiple samples to audition variations before final mixdown.
• Adjust seed for subtle variations in timing and sound character.

Note

• Each sample is generated independently; total cost scales linearly with num_samples.
• Works best with clear, high-contrast motion — busy scenes may mix sound layers automatically.

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'
{
  "video": "https://interactive-examples.mdn.mozilla.net/media/cc0-videos/flower.mp4",
  "num_samples": 2
}
JSON
)

# 1. Submit the prediction.
SUBMIT_RESPONSE=$(curl --silent --show-error --fail-with-body \
  -X POST "https://api.wavespeed.ai/api/v3/mirelo-ai/sfx-v1.5/video-to-video" \
  -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