volcengine-ata-subtitle

What This Skill Does

The volcengine-ata-subtitle skill is a powerful automation tool designed to generate time-aligned subtitles (SRT or ASS formats) by leveraging the Volcengine Automatic Time Alignment (ATA) API. This skill simplifies the tedious process of manual timing by synchronizing plain text transcripts with audio files, allowing for rapid deployment of subtitles for videos, social media content, or archives. By automating the alignment process, it ensures high precision and professional quality, saving content creators significant editing time.

Installation

To install this skill, run the following command in your terminal: clawhub install openclaw/skills/skills/blackeight4752/doubao-ata-subtitle. Once installed, you must configure your credentials to authenticate with the Volcengine API. You can either export the environment variables VOLC_ATA_APP_ID, VOLC_ATA_TOKEN, and VOLC_ATA_API_BASE, or create a configuration file at ~/.volcengine_ata.conf following the provided template. Ensure you have FFmpeg installed on your system to handle the mandatory audio conversion to 16kHz mono PCM format, as the API is strictly sensitive to these audio parameters.

Use Cases

1. Content Localization: Generate subtitles for translated transcripts to quickly localize international video content.
2. Accessible Media: Create accurate time-stamped subtitles for educational videos to improve accessibility and engagement.
3. Post-Production Automation: Integrate subtitle generation into a larger video editing pipeline where text is prepared in advance and needs to be perfectly aligned with spoken narration.

Example Prompts

1. "Use the volcengine-ata-subtitle skill to align my text file 'script.txt' with the audio from 'interview.wav' and save the output as 'subtitles.srt'."
2. "I need to convert my video audio to an ASS subtitle file. Please process 'lecture.wav' and 'content.txt' using the ATA skill and format it as ASS."
3. "The current subtitles aren't synced. Use the ATA skill to re-process my audio and text files so the timing matches the dialogue exactly."

Tips & Limitations

• Pre-processing is Critical: Always ensure your audio is 16kHz mono PCM using ffmpeg -i input.mp4 -vn -acodec pcm_s16le -ar 16000 -ac 1 audio.wav. The API will reject files that do not meet these specs.
• Input Formatting: Ensure your text file is clean, UTF-8 encoded, and contains no timestamps or punctuation. Each sentence should occupy a single line for best alignment results.
• Troubleshooting: If you encounter an 'Authorization failed' error, confirm that your VOLC_ATA_TOKEN is prefixed correctly with 'Bearer; ' as required by the API schema. Always check your connection if you receive API timeout errors during peak usage times.