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

Each sound-effect variation costs $0.10, billed as 10 seconds at $0.01 per second.

Billing Rules

• Each sample is billed as 10 seconds, including for shorter input videos.
• Total price is $0.10 × num_samples.
• Input videos longer than 10 seconds are truncated to 10 seconds.
• prompt and seed do not add separate charges.

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 once. Never retry this request automatically:
# a retry after an unclear failure can create a second, billed task.
CHECK='The task may already exist. Check History or the predictions list before submitting again.'
if ! SUBMIT_RESPONSE=$(curl --silent --show-error --fail-with-body \
  --connect-timeout 10 --max-time 60 \
  -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}"); then
  printf 'Submit failed. %s\n' "${CHECK}" >&2
  exit 1
fi

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. %s\n' "${CHECK}" >&2
  exit 1
fi
RESULT_URL="https://api.wavespeed.ai/api/v3/predictions/${PREDICTION_ID}/result"

# 2. Poll until the prediction reaches a final status.
BODY_FILE=$(mktemp)
trap 'rm -f "${BODY_FILE}"' EXIT
while true; do
  # Transient errors (429, 5xx) are retried, honoring Retry-After.
  HTTP_CODE=$(curl --silent --show-error --fail-with-body \
    --connect-timeout 10 --max-time 60 --retry 5 --retry-delay 2 \
    --output "${BODY_FILE}" --write-out '%{http_code}' \
    "${RESULT_URL}" \
    -H "Authorization: Bearer ${WAVESPEED_API_KEY}" || true)
  case "${HTTP_CODE}" in
    2??) ;;
    000|429|5??)  # dropped connection or temporary error: keep polling
      printf 'Task %s: HTTP %s, polling again in 10s\n' "${PREDICTION_ID}" "${HTTP_CODE}" >&2
      sleep 10; continue ;;
    *) printf 'Task %s: HTTP %s\n' "${PREDICTION_ID}" "${HTTP_CODE}" >&2
      cat "${BODY_FILE}" >&2; exit 1 ;;
  esac
  RESULT=$(jq 'if type == "object" and has("data") then .data else . end' "${BODY_FILE}")
  STATUS=$(printf '%s' "${RESULT}" | jq -r '.status // empty')

  case "${STATUS}" in
    completed) printf '%s\n' "${RESULT}" | jq '.outputs'; break ;;
    failed|cancelled|timeout|deleted)
      printf 'Task %s ended with status %s\n' "${PREDICTION_ID}" "${STATUS}" >&2
      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