Inpaint Audio with Video

Create async job

Start an async video-guided audio inpainting job. Returns immediately with a job_id. Poll until status is succeeded or errored.

post/v2/inpaint-audio/with_video/v1.6/jobs

Request

  • Base URL: https://api.mirelo.ai
  • URL: https://api.mirelo.ai/v2/inpaint-audio/with_video/v1.6/jobs
  • Auth: HTTP bearer

Request body

promptstring

Optional text prompt to guide the replacement. If omitted, the model infers content from surrounding audio context and the video.

num_samplesinteger

Number of audio variants to generate

seedinteger nullable

Seed for reproducible generation. Integer, minimum -1. Omit, or send -1 or null, for a randomly chosen seed. It does not guarantee identical audio because generation is not bit-deterministic across inference workers.

output_format'wav' | 'mp3' | 'aac' | 'flac'

Container for the generated audio. One of "wav" (default), "mp3", "aac", "flac". Omit for WAV, which is what every request returned before this parameter existed. Requests that need server-side post-processing — a tiled loop, a windowed extend or inpaint, a long video clip — are generated losslessly and encoded into this container once, at the end.

Example request

{
  "audio": {
    "type": "url",
    "audio_url": "https://example.com/my-sfx.wav"
  },
  "segment": {
    "start_ms": 2000,
    "end_ms": 4000
  },
  "video": {
    "type": "url",
    "video_url": "https://example.com/clip.mp4"
  },
  "num_samples": 1
}

Response

Job accepted

job_idstring uuid required

Unique identifier for the async job

job_urlstring required

Relative URL to poll for job status, e.g. /v2/text-to-sfx/{version}/jobs/{job_id}. Append to your API base URL to form the full polling URL.

estimated_msinteger required

Estimated completion time in milliseconds

estimated_completion_atstring date-time required

ISO 8601 estimated completion timestamp

Changes

No recorded changes to this operation across all 1 revision of this API.