adapt.auto_cut_down
Submit an auto-cut request.
Returns immediately with status: processing. Use the matching GET to
poll for completion, or supply a callback_url to receive a webhook.
Auto-cut trims a longer audio source to a target duration, choosing
musically natural cut points. The output duration may be slightly shorter
or longer than target_duration to land on a natural boundary.
target_duration is a target, not an exact length. Its absolute bounds — at
least 5 seconds and at most 5 minutes — are checked up front (422). It must
also be at most twice the source duration; since the source duration is only
known after ingestion, exceeding that surfaces asynchronously as a failed
operation with target_duration_too_long. The source must be fetchable,
decodable audio within the supported format/size limits and at least 2.5
seconds long (half the minimum target), else a source_* error — validated
once the source is fetched and decoded (see errors).
Credits cost: 1 per request. Insufficient credits returns 402 — see
errors.
Body
A unique UUID you choose. Send the same key to retry safely; we'll return the original response without doing the work again.
The audio source to operate on.
The desired output duration in seconds. This is a target, not an exact length — the result may be slightly shorter or longer to land on a natural cut point. Must be between 5 seconds and 5 minutes (enforced up front; out of range is a 422), and at most twice the source duration. Because the source duration is only known after the source is fetched and decoded, exceeding twice the source surfaces asynchronously as a failed operation with target_duration_too_long. See errors.
5 <= x <= 300Optional HTTPS URL we'll POST the final response to when the operation reaches ready or failed. Polling remains the canonical source of truth; webhooks are a best-effort latency optimisation.
1 - 2048Response
Successful Response
