Skip to navigation
Audio Trims API

Get Audio Trim

Retrieve an audio trim created by the same user or API key. While status is queued or processing, wait retryAfterMs before polling again. When status is completed, assetId is the trimmed WAV audio asset and durationSeconds is its measured length. A failed trim has errorCode audio_trim_failed; start a new trim with a new Idempotency-Key.

Authentication

x-api-keystring
API Key authentication via header

Path parameters

idstringRequired

The trim id returned by POST /v2/audio-trims.

Response

Trim retrieved successfully.
idstring
Unique identifier for the trim.
statusenum
Status of an audio trim. Terminal states are completed and failed.
Allowed values:
retryAfterMsinteger
Milliseconds to wait before polling again. 0 once the trim is completed or failed.
assetIdstringOptional
ID of the trimmed audio asset. Null until status is completed.
durationSecondsdoubleOptional
Measured duration of the trimmed audio in seconds. Null until status is completed.
errorCodestringOptional

audio_trim_failed when status is failed; otherwise null.

Errors

401
Unauthorized Error
404
Not Found Error
409
Conflict Error