Passer à la 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.

Authentification

x-api-keystring
Authentification par clé API via en-tête

Paramètres de chemin

idstringRequis

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

Réponse

Trim retrieved successfully.
idstring
Unique identifier for the trim.
statusenum
Status of an audio trim. Terminal states are completed and failed.
Valeurs autorisées:
retryAfterMsinteger
Milliseconds to wait before polling again. 0 once the trim is completed or failed.
assetIdstringOptionnel
ID of the trimmed audio asset. Null until status is completed.
durationSecondsdoubleOptionnel
Measured duration of the trimmed audio in seconds. Null until status is completed.
errorCodestringOptionnel

audio_trim_failed when status is failed; otherwise null.

Erreurs

401
Unauthorized Error
404
Not Found Error
409
Conflict Error