Volcengine TOS Audio Process

Convert audio files stored in Volcengine TOS into PCM-oriented WAV output through the TOS gateway's media_jobs API.

Setup (once per environment)

Install dependencies on first use:

cd {baseDir}
pip install -r {baseDir}/requirements.txt

Then run scripts with Python 3.7+:

python3 {baseDir}/scripts/<script>.py <args>

Environment Variables

This skill relies on the TOS identity declared in the metadata block. Common runtime variables are:

Environment Variable	Required	Description
`TOS_ACCESS_KEY`	Yes	TOS access key ID
`TOS_SECRET_KEY`	Yes	TOS secret access key
`TOS_ENDPOINT`	Yes	TOS endpoint URL
`TOS_REGION`	Yes	TOS region
`TOS_BUCKET`	Yes	Source bucket that stores the audio object
`TOS_OBJECT_KEY`	No	Source object key of the audio file. Can be overridden with `--key`
`TOS_SECURITY_TOKEN`	No	STS session token when using temporary credentials

Quick start

# Convert an audio object to 16k mono s16 WAV and wait for completion
python3 {baseDir}/scripts/audio_to_pcm.py \
  --key test.wav \
  --sample-rate 16000 \
  --channels 1 \
  --sample-format s16 \
  --output-object skill-test/audio/test_pcm.wav \
  --wait

Available scripts

Script	Purpose
`scripts/audio_to_pcm.py`	Submit an async `AudioConvert` job via the TOS gateway's `media_jobs` API that converts TOS audio into PCM-oriented WAV output. Supports `--wait` to poll until completion.
`scripts/tos_jobs_client.py`	Shared client for TOS gateway `doc_jobs`/`media_jobs` APIs using pre-signed URL auth.

Rules

TOS gateway API: This skill uses the TOS gateway's media_jobs API with job_type=AudioConvert. Authentication is handled via pre_signed_url from the TOS Python SDK and the TOS identity declared in the metadata block above.
Current output format: The output is a WAV file (PCM container), not raw headerless .pcm bytes.
Async job model: The script creates async jobs and optionally waits for completion with the --wait flag.
Language: Reply in the user's preferred language.

byted-tos-audio-process