Creative
Alphacreative_audio_detach
Extract the audio track from a saved video in the connected workspace when its Creative flag is enabled.
Operation Write.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
body | object | Yes | Video program. |
body.video_url | string | Yes | URL of a video saved in this workspace. Maximum 100 MB. |
body.format | string | No | Output format, wav or mp3. Default wav. |
body.range | object | No | Start and optional end in seconds. Omit for the full track. |
body.channels | string | No | Preserve the source layout or convert to mono. |
body.sample_rate | integer | No | Output sample rate in Hz, 16000, 44100, or 48000. |
body.mode | string | No | Use async to get a job ID immediately, sync or subscribe for a bounded wait, or webhook for terminal delivery. |
body.wait_timeout_seconds | integer | No | Wait from 0 to 30 seconds in sync or subscribe mode. |
body.webhook_url | string | No | Public HTTPS URL for terminal delivery. |
body.project_id | string | No | Destination project in the same workspace. |
body.metadata | object | No | Caller data to keep with the job. |
idempotency_key | string | Yes | Reuse this key to retry the same request. |
The source can be up to 1,800 seconds and the output up to 900 seconds. A video with no audio track fails the job.
Pass data.job.id to creative_jobs_wait, then read the saved output with creative_jobs_result.
Sample prompt
Extract a mono WAV from my uploaded video at 16000 Hz and return the audio URL.