Export an audio clip

Extracts and encodes an audio-only clip from a TVU MediaMind media object and uploads
the result to cloud storage. The source is identified by sourceObjectId (the internal
TVU MediaMind object ID) rather than a raw file path; the service resolves the underlying
storage location automatically.

This is a long-polling endpoint — keep re-submitting the same body until
errorCode is 1005 (terminal success, status: 2) or a non-1001 error code.

Output format is inferred from the fileName extension. The mediaType field is
used to select the source media record returned by metadata lookup: use "mma" for
high-resolution media; omit it or use another value for preview media.

Optional AI transcription (reTranscribe.switch: true): after the audio file is
exported, it is uploaded to an AI transcription service. The transcription group and
language are set via reTranscribe.groupId and reTranscribe.language. If this upload
fails, the job returns 1029 rather than 1005.

Webhook: set callbackUrl to receive an HTTP POST notification when the job
completes instead of (or in addition to) polling.

Idempotency: supply uuid to prevent duplicate jobs — re-submitting the same uuid
returns the existing job's state.

Error Codes

Code	Message	Cause
`1000`	task created successfully	Task registered; begin polling (`timeWait` > 0)
`1001`	work not finish.	Still processing — wait `timeWait` ms and poll again
`1005`	Work Finish	Audio export completed successfully (terminal, `timeWait` = 0, `status` = 2)
`1017`	add user task fail.	Task creation failed; retry
`1018`	the request param abnormal.	Required field missing (sourceObjectId, etc.)
`1020`	tvu264 some error.	Audio encoding failed
`1021`	upload file fail	Failed to upload output audio to cloud storage
`1029`	failed to upload audio to AI	AI transcription upload failed (only when `reTranscribe.switch=true`)
`1031`	video export time exceeds limit.	System export quota reached
`1032`	the number of user max export task exceeds limit.	User export limit reached
`1033`	The bucket of the media is wrong.	Source media bucket is misconfigured
`1081`	get storage fail.	Failed to retrieve storage configuration
`1084`	from redis get user task fail.	Cache lookup error; retry
`1099`	Media processing encountered an exception. Please retry...	Unexpected processing error

curl --location 'https://api.tvunetworks.com/exportaudio' \ --header 'SID: 92575d36dcb631ac94745e6b157de17a5a13d65b31e44869f06854ab928dd80235d4daae8696b4a92a7be5f802c45a219648701fc9ca59f44e9c0f022d5d38a7' \ --header 'Content-Type: application/json' \ --data '{ "startTime": 1700000000000, "duration": 60000, "sourceObjectId": "123456789012345678", "fileName": "audio_extract.flac", "sampleRate": 48000, "mediaType": "mma" }'

Error Codes

Request

Responses

Export an audio clip

Error Codes#

Request

Responses

Error Codes