Zur Navigation springen

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.

Authentifizierung

x-api-keystring
API-Key-Authentifizierung via Header

Pfadparameter

idstringErforderlich

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

Antwort

Trim retrieved successfully.
idstring
Unique identifier for the trim.
statusenum
Status of an audio trim. Terminal states are completed and failed.
Erlaubte Werte:
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.

Fehler

401
Unauthorized Error
404
Not Found Error
409
Conflict Error