{ "openapi": "3.1.1", "info": { "title": "Audio Cutter & Merger API", "version": "1.0.0", "summary": "Trim audio, keep or remove ranges, fade in/out, or join up to 10 clips with crossfades.", "description": "Every endpoint performs the same calculation as the human page and returns inputs, result, units, assumptions, sources, warnings and computedAt. MCP endpoint: /mcp." }, "servers": [ { "url": "https://audiocuttermerger.usefulweb.site" } ], "paths": { "/api/v1/calculate": { "post": { "operationId": "calculate", "summary": "Trim audio, keep or remove ranges, fade in/out, or join up to 10 clips with crossfades.", "description": "Cuts an audio file to a start and end time, keeps or removes a list of time ranges, and adds fade-in/fade-out. In merge mode it joins up to 10 clips in order, optionally with a crossfade between them. Output as MP3, M4A, Ogg, Opus, FLAC or WAV.\n\nMethodology:\n- Times are parsed strictly (seconds, mm:ss or hh:mm:ss.mmm); only the resulting numbers are written into the ffmpeg filtergraph, never your text.\n- Cut mode: ranges to keep are sorted, clipped to the file length and merged where they overlap; \"remove\" ranges are inverted into the parts to keep. Each part is cut sample-accurately with atrim and the parts are joined with the concat filter.\n- Merge mode: every clip is converted to a common sample rate (the highest of the clips, max 48 kHz) and channel layout (stereo if any clip is stereo), then joined with concat, or chained with acrossfade (triangular curves) when a crossfade is set. Each crossfade shortens the total by its length.\n- Fade in/out (afade) is applied to the final result. The result is encoded once in the chosen format.", "tags": [ "media" ], "x-mcp-tool": "audio_cutter_merger", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AudioCutterMergerInput" }, "examples": { "example1": { "summary": "Cut 0.1–0.4 s with a short fade out", "value": { "mode": "cut", "file": { "filename": "tone.mp3", "contentType": "audio/mpeg", "contentBase64": "SUQzAwAAAAAANFRJVDIAAAALAAAAVGVzdCB0b25lAFRQRTEAAAALAAAAdXNlZnVsd2ViAAAAAAAAAAAAAAD/4zjAAAAAAAAAAAAASW5mbwAAAA8AAAAJAAADYABVVVVVVVVVVVVVVWpqampqampqampqgICAgICAgICAgICVlZWVlZWVlZWVlaqqqqqqqqqqqqqqwMDAwMDAwMDAwMDV1dXV1dXV1dXV1erq6urq6urq6urq//////////////8AAAAATGF2ZiBsYW1lAAAAAAAAAAAAAAAAJAJgAAAAAAAAA2DhWsr/AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAD/4xjEAAyokqh5SAAAD22/4d3d3v/RESv5d3f5SSwbgLgLgLg3PlAxw/yhz9/R7+j38HAxkAffWBDmgH+Ud39CgQkKRFiBEz//4xjECA3w6qDBlDgA5MkBJoc7/EBhyQNsGAOBS4BzxgokpgaxKNMIQcg9HhsNv/x0ajU4GhL/hIGhKdBq////////////////4xjECw8QpjgB3gAA+GhGAAYBYAxfoGgIGBqDgYSYPhhOi9GJrekZAAshh+g1GCWCYAgOwqAOYCAAJbFkl+rfoA//b7/L5fX/4xjECQqwjo5YCbRi/n3qiICUpOT5DnL9WR4Ms63+X06P/v9H/+//+nJf+t9GXtsQBtdfrcl5/f+V1eIwQL/nESYRBr0i8sr/4xjEGQtIloJYCnZigON9/lP9n9b/T9v37q/9P2//1fRV///5O3qXQOATAhMCmwMhwSPQYQHRBgcjAEgOoWAuAIB4YAGRACL/4xjEJgpYpjQABvxEbLUb6v///jGAGAADfQMAIBwMCwEgEAvAxGjLAx9m1A6uxbA3pD+AwbAgAwDAJACBeAkAoj4ZgQohCDD/4xjENw04pkABVgAAAR/itBmDQVp/WLIJwRwGKJAwM/DsNjcZwDM5yDpBHgAgGAy0hSC/v8A3wDWMsT8L2PP//zMe5udL5uv/4xjEPRaRlozJlWgAL///+brMwdB8Bn//oB8BmiY1//9BMaaJuNf//3IVBd2AA//aqqp/9VVVOdqOJAwVLAwCARKyIBJV/QX/4xjEHQ1AmqR5xggBBn/0FCv8FBn/FBQp/xQYK/oKFHfiSf/9TEFNRTQuMSAoYWxwaGEgMClVVVVVVVVVVVVVVVVVVVVVVVU=" }, "start": "0.1", "end": "0.4", "fadeOut": 0.1, "format": "mp3", "bitrate": "64" } }, "example2": { "summary": "Merge two tones with a 0.1 s crossfade", "value": { "mode": "merge", "file": { "filename": "tone.mp3", "contentType": "audio/mpeg", "contentBase64": "SUQzAwAAAAAANFRJVDIAAAALAAAAVGVzdCB0b25lAFRQRTEAAAALAAAAdXNlZnVsd2ViAAAAAAAAAAAAAAD/4zjAAAAAAAAAAAAASW5mbwAAAA8AAAAJAAADYABVVVVVVVVVVVVVVWpqampqampqampqgICAgICAgICAgICVlZWVlZWVlZWVlaqqqqqqqqqqqqqqwMDAwMDAwMDAwMDV1dXV1dXV1dXV1erq6urq6urq6urq//////////////8AAAAATGF2ZiBsYW1lAAAAAAAAAAAAAAAAJAJgAAAAAAAAA2DhWsr/AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAD/4xjEAAyokqh5SAAAD22/4d3d3v/RESv5d3f5SSwbgLgLgLg3PlAxw/yhz9/R7+j38HAxkAffWBDmgH+Ud39CgQkKRFiBEz//4xjECA3w6qDBlDgA5MkBJoc7/EBhyQNsGAOBS4BzxgokpgaxKNMIQcg9HhsNv/x0ajU4GhL/hIGhKdBq////////////////4xjECw8QpjgB3gAA+GhGAAYBYAxfoGgIGBqDgYSYPhhOi9GJrekZAAshh+g1GCWCYAgOwqAOYCAAJbFkl+rfoA//b7/L5fX/4xjECQqwjo5YCbRi/n3qiICUpOT5DnL9WR4Ms63+X06P/v9H/+//+nJf+t9GXtsQBtdfrcl5/f+V1eIwQL/nESYRBr0i8sr/4xjEGQtIloJYCnZigON9/lP9n9b/T9v37q/9P2//1fRV///5O3qXQOATAhMCmwMhwSPQYQHRBgcjAEgOoWAuAIB4YAGRACL/4xjEJgpYpjQABvxEbLUb6v///jGAGAADfQMAIBwMCwEgEAvAxGjLAx9m1A6uxbA3pD+AwbAgAwDAJACBeAkAoj4ZgQohCDD/4xjENw04pkABVgAAAR/itBmDQVp/WLIJwRwGKJAwM/DsNjcZwDM5yDpBHgAgGAy0hSC/v8A3wDWMsT8L2PP//zMe5udL5uv/4xjEPRaRlozJlWgAL///+brMwdB8Bn//oB8BmiY1//9BMaaJuNf//3IVBd2AA//aqqp/9VVVOdqOJAwVLAwCARKyIBJV/QX/4xjEHQ1AmqR5xggBBn/0FCv8FBn/FBQp/xQYK/oKFHfiSf/9TEFNRTQuMSAoYWxwaGEgMClVVVVVVVVVVVVVVVVVVVVVVVU=" }, "file2": { "filename": "tone2.mp3", "contentType": "audio/mpeg", "contentBase64": "SUQzBAAAAAAACgAAAAAAAAAAAAD/4zjAAAAAAAAAAAAASW5mbwAAAA8AAAAJAAADYABVVVVVVVVVVVVVVWpqampqampqampqgICAgICAgICAgICVlZWVlZWVlZWVlaqqqqqqqqqqqqqqwMDAwMDAwMDAwMDV1dXV1dXV1dXV1erq6urq6urq6urq//////////////8AAAAATGF2ZiBsYW1lAAAAAAAAAAAAAAAAJAJgAAAAAAAAA2CfAwBHAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAD/4xjEAAxI0phRSwAAArwHve973v9jGMYz+Xve9/8MYxlfy977QJAeAEwAwAwAwCwRyef3fv6P8CO4f5T39Co4bDYd/xqIo8P/4xjECQ6I9qABh9AAb/B8Og9Ab/xJ3i4QISh05d3yWWGCOD0Ki/F8hFQXddlMZjNampsTv8qIgqCoiPf+CtX/////9ZiTrBr/4xjECQ4w5kAB1kgAkBgLAcBgRE4Bg3DkBh3BEBhTHYBllKwB/bhaBnMKyBieA6IEAwFgWCgBw+UAwHiVdoWGABh/d9L+WXz/4xjECwxw1lcYDTyg/96/6iyBCGOqUu6gsaCAnw8CE0GRXujP/q+qz7v/9Wv/If9P/9Wt+upZwlQ4QGAbwCAEl7gMALGAlAD/4xjEFA0A5igABX6EeaMmFWhAOaNAJRMACrieyL09zfV/f///7v/9dv///+rMAAuAv/y//63caqKh7oFMhRFHgUzvgEvJhJz/4xjEGwsw4jWQCDxIrAOUZcyRyypv//7d3R//2/+t/////+tBZfcagAABADA3AYFAoAYZAfAYcRigZBRrgeE0lAZXB1AoKwL/4xjEKQzw5kgBVjAA4cDAOAsOeQcmLC0AAICBECgMBgQCf5hkz/FhhUFj/GgLgBQGiskgktEfoSVJ4DBGQWtkQIYMwIAAOQD/4xjEMBgJoq5ZiqAAFn5E///E3hicZMlRZZEyiOf///m6JfN0TMPA//+Aw8D4DNE//8aHiY00l3//5pLkKg3EQFdwAP/2Zl//4xjECg0wzrZZwxAB4zMyl7MzMv/GZv+MGAgImAgIUcUGG/iCnb6Cgw3+goUd8UGO/wUKG/5IKkxBTUU0LjEgKGFscGhhIDA=" }, "crossfade": 0.1, "format": "wav" } } } } } }, "responses": { "200": { "description": "Calculation result envelope.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AudioCutterMergerResult" } } } }, "400": { "description": "Malformed JSON body.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "422": { "description": "Invalid input (see errors[]).", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "429": { "description": "Rate limit exceeded (see Retry-After).", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } } } } }, "/api/v1/tool": { "get": { "operationId": "getToolDefinition", "summary": "Inputs, output schema and examples for this tool", "responses": { "200": { "description": "Tool definition.", "content": { "application/json": { "schema": { "type": "object" } } } } } } } }, "components": { "schemas": { "Problem": { "type": "object", "description": "RFC 9457 problem details. 422 responses include per-field `errors`.", "required": [ "type", "title", "status", "detail" ], "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer" }, "detail": { "type": "string" }, "code": { "type": "string" }, "errors": { "type": "array", "items": { "type": "object", "required": [ "field", "message" ], "properties": { "field": { "type": "string" }, "message": { "type": "string" } } } } } }, "AudioCutterMergerInput": { "type": "object", "additionalProperties": false, "properties": { "mode": { "title": "What to do", "type": "string", "enum": [ "cut", "merge" ], "default": "cut" }, "file": { "title": "Audio file (clip 1)", "description": "MP3, WAV, FLAC, Ogg/Opus, M4A, AIFF; max 100 MB in total. Processed on our server in a private temporary folder that is deleted afterwards; the result can be downloaded for about 2 hours. Upload as {filename, contentType?, contentBase64}. Max 102400 KiB. Accepts .mp3,.wav,.flac,.ogg,.oga,.opus,.m4a,.aac,.aif,.aiff,.wma,.mp4,.mov,.webm,.mkv,audio/*.", "type": "object", "additionalProperties": false, "required": [ "filename", "contentBase64" ], "properties": { "filename": { "type": "string" }, "contentType": { "type": "string" }, "contentBase64": { "type": "string" } } }, "file2": { "title": "Clip 2 (merge mode)", "type": "object", "description": "Upload as {filename, contentType?, contentBase64}. Max 102400 KiB. Accepts .mp3,.wav,.flac,.ogg,.oga,.opus,.m4a,.aac,.aif,.aiff,.wma,.mp4,.mov,.webm,.mkv,audio/*.", "additionalProperties": false, "required": [ "filename", "contentBase64" ], "properties": { "filename": { "type": "string" }, "contentType": { "type": "string" }, "contentBase64": { "type": "string" } } }, "file3": { "title": "Clip 3 (merge mode)", "type": "object", "description": "Upload as {filename, contentType?, contentBase64}. Max 102400 KiB. Accepts .mp3,.wav,.flac,.ogg,.oga,.opus,.m4a,.aac,.aif,.aiff,.wma,.mp4,.mov,.webm,.mkv,audio/*.", "additionalProperties": false, "required": [ "filename", "contentBase64" ], "properties": { "filename": { "type": "string" }, "contentType": { "type": "string" }, "contentBase64": { "type": "string" } } }, "file4": { "title": "Clip 4 (merge mode)", "type": "object", "description": "Upload as {filename, contentType?, contentBase64}. Max 102400 KiB. Accepts .mp3,.wav,.flac,.ogg,.oga,.opus,.m4a,.aac,.aif,.aiff,.wma,.mp4,.mov,.webm,.mkv,audio/*.", "additionalProperties": false, "required": [ "filename", "contentBase64" ], "properties": { "filename": { "type": "string" }, "contentType": { "type": "string" }, "contentBase64": { "type": "string" } } }, "file5": { "title": "Clip 5 (merge mode)", "type": "object", "description": "Upload as {filename, contentType?, contentBase64}. Max 102400 KiB. Accepts .mp3,.wav,.flac,.ogg,.oga,.opus,.m4a,.aac,.aif,.aiff,.wma,.mp4,.mov,.webm,.mkv,audio/*.", "additionalProperties": false, "required": [ "filename", "contentBase64" ], "properties": { "filename": { "type": "string" }, "contentType": { "type": "string" }, "contentBase64": { "type": "string" } } }, "file6": { "title": "Clip 6 (merge mode)", "type": "object", "description": "Upload as {filename, contentType?, contentBase64}. Max 102400 KiB. Accepts .mp3,.wav,.flac,.ogg,.oga,.opus,.m4a,.aac,.aif,.aiff,.wma,.mp4,.mov,.webm,.mkv,audio/*.", "additionalProperties": false, "required": [ "filename", "contentBase64" ], "properties": { "filename": { "type": "string" }, "contentType": { "type": "string" }, "contentBase64": { "type": "string" } } }, "file7": { "title": "Clip 7 (merge mode)", "type": "object", "description": "Upload as {filename, contentType?, contentBase64}. Max 102400 KiB. Accepts .mp3,.wav,.flac,.ogg,.oga,.opus,.m4a,.aac,.aif,.aiff,.wma,.mp4,.mov,.webm,.mkv,audio/*.", "additionalProperties": false, "required": [ "filename", "contentBase64" ], "properties": { "filename": { "type": "string" }, "contentType": { "type": "string" }, "contentBase64": { "type": "string" } } }, "file8": { "title": "Clip 8 (merge mode)", "type": "object", "description": "Upload as {filename, contentType?, contentBase64}. Max 102400 KiB. Accepts .mp3,.wav,.flac,.ogg,.oga,.opus,.m4a,.aac,.aif,.aiff,.wma,.mp4,.mov,.webm,.mkv,audio/*.", "additionalProperties": false, "required": [ "filename", "contentBase64" ], "properties": { "filename": { "type": "string" }, "contentType": { "type": "string" }, "contentBase64": { "type": "string" } } }, "file9": { "title": "Clip 9 (merge mode)", "type": "object", "description": "Upload as {filename, contentType?, contentBase64}. Max 102400 KiB. Accepts .mp3,.wav,.flac,.ogg,.oga,.opus,.m4a,.aac,.aif,.aiff,.wma,.mp4,.mov,.webm,.mkv,audio/*.", "additionalProperties": false, "required": [ "filename", "contentBase64" ], "properties": { "filename": { "type": "string" }, "contentType": { "type": "string" }, "contentBase64": { "type": "string" } } }, "file10": { "title": "Clip 10 (merge mode)", "type": "object", "description": "Upload as {filename, contentType?, contentBase64}. Max 102400 KiB. Accepts .mp3,.wav,.flac,.ogg,.oga,.opus,.m4a,.aac,.aif,.aiff,.wma,.mp4,.mov,.webm,.mkv,audio/*.", "additionalProperties": false, "required": [ "filename", "contentBase64" ], "properties": { "filename": { "type": "string" }, "contentType": { "type": "string" }, "contentBase64": { "type": "string" } } }, "start": { "title": "Start time (cut mode)", "description": "Seconds (5.5), mm:ss (1:30) or hh:mm:ss.mmm. Empty = from the beginning.", "type": "string", "maxLength": 20 }, "end": { "title": "End time (cut mode)", "description": "Empty = to the end.", "type": "string", "maxLength": 20 }, "ranges": { "title": "Time ranges (cut mode, optional)", "description": "One range per line, start-end. Overrides start/end.", "type": "array", "items": { "type": "string" }, "maxItems": 50 }, "rangeAction": { "title": "Ranges are", "type": "string", "enum": [ "keep", "remove" ], "default": "keep" }, "fadeIn": { "title": "Fade in", "type": "number", "minimum": 0, "maximum": 30, "default": 0, "x-unit": "s" }, "fadeOut": { "title": "Fade out", "type": "number", "minimum": 0, "maximum": 30, "default": 0, "x-unit": "s" }, "crossfade": { "title": "Crossfade between clips (merge mode)", "type": "number", "minimum": 0, "maximum": 10, "default": 0, "x-unit": "s" }, "format": { "title": "Output format", "type": "string", "enum": [ "mp3", "m4a", "ogg", "opus", "flac", "wav" ], "default": "mp3" }, "bitrate": { "title": "Bitrate (lossy formats)", "type": "string", "enum": [ "32", "48", "64", "96", "128", "160", "192", "224", "256", "320" ], "default": "192" } }, "required": [ "file" ] }, "AudioCutterMergerResult": { "type": "object", "additionalProperties": false, "required": [ "schemaVersion", "tool", "computedAt", "inputs", "summary", "result", "units", "assumptions", "sources", "warnings", "presentation", "links" ], "properties": { "schemaVersion": { "type": "string", "const": "1.0" }, "tool": { "type": "object", "additionalProperties": false, "required": [ "id", "name", "version" ], "properties": { "id": { "type": "string" }, "name": { "type": "string" }, "version": { "type": "string" } } }, "computedAt": { "type": "string", "format": "date-time" }, "inputs": { "type": "object", "description": "Normalised inputs actually used, including applied defaults." }, "summary": { "type": "string" }, "result": { "type": "object", "additionalProperties": false, "required": [ "mode", "segments", "clips", "outputFormat", "expectedSeconds", "durationSeconds", "outputBytes", "artifact" ], "properties": { "mode": { "type": "string", "enum": [ "cut", "merge" ] }, "segments": { "type": "array", "items": { "type": "object", "additionalProperties": false, "required": [ "start", "end" ], "properties": { "start": { "type": "number" }, "end": { "type": "number" } } }, "description": "Kept parts of the source (cut mode)." }, "clips": { "type": "array", "items": { "type": "object", "additionalProperties": false, "required": [ "clip", "durationSeconds", "codec" ], "properties": { "clip": { "type": "integer" }, "durationSeconds": { "type": "number" }, "codec": { "type": "string" } } } }, "crossfadeSeconds": { "type": "number" }, "outputFormat": { "type": "string" }, "expectedSeconds": { "type": "number" }, "durationSeconds": { "type": "number" }, "outputBytes": { "type": "integer" }, "artifact": { "type": "object", "additionalProperties": false, "required": [ "artifactId", "filename", "mime", "bytes", "sha256", "path" ], "properties": { "artifactId": { "type": "string" }, "filename": { "type": "string" }, "mime": { "type": "string" }, "bytes": { "type": "integer" }, "sha256": { "type": "string" }, "path": { "type": "string", "description": "Download path on the same site (valid for about 2 hours)." } } } } }, "units": { "type": "object", "additionalProperties": { "type": "string" } }, "assumptions": { "type": "array", "items": { "type": "string" } }, "sources": { "type": "array", "items": { "type": "object", "additionalProperties": false, "required": [ "title" ], "properties": { "title": { "type": "string" }, "url": { "type": "string" }, "publisher": { "type": "string" }, "retrievedAt": { "type": "string" }, "note": { "type": "string" } } } }, "warnings": { "type": "array", "items": { "type": "string" } }, "presentation": { "type": "array", "items": { "type": "object" }, "description": "Display blocks used by the human page (same data)." }, "links": { "type": "object", "additionalProperties": false, "required": [ "human", "api", "openapi", "methodology" ], "properties": { "human": { "type": "string", "format": "uri" }, "api": { "type": "string", "format": "uri" }, "openapi": { "type": "string", "format": "uri" }, "methodology": { "type": "string", "format": "uri" } } } } } } } }