dasheng-audio-tag
Audio tagging service that identifies environmental sounds in audio files.
Quick Start
Tag an audio file:
python3 scripts/audiotag.py <audio_file>
# 服务地址: https://llmplus.ai.xiaomi.com/dasheng/audio/tag
Check queue status:
python3 scripts/audiotag.py --queue
API Details
Tagging Endpoint: POST https://llmplus.ai.xiaomi.com/dasheng/audio/tag
- Method: POST, multipart form-data with file upload
Queue Metrics Endpoint: POST https://llmplus.ai.xiaomi.com/metrics?path=/dasheng/audio/tag
- Returns:
active（当前活跃请求数）、avg_latency_ms（平均耗时） - 预估等待时长 = active × avg_latency_ms
Usage Patterns
Basic tagging
python3 scripts/audiotag.py audio.mp3
Check queue / waiting status
python3 scripts/audiotag.py --queue
Programmatic usage
from scripts.audiotag import tag_audio, check_queue, format_queue_status
# Tag audio
result = tag_audio("sample-0.mp3")
# Check queue
queue_info = check_queue()
print(format_queue_status(queue_info))
Queue Status（排队情况）
何时调用
- IM 即将超时但 tag 服务还未返回结果时：调用
--queue查排队情况，告知用户当前排队状态并请用户稍后来问任务是否完成。 - 用户稍后询问任务进度但 tag 服务仍未返回时：调用
--queue返回最新排队情况给用户。
返回字段说明
| 字段 | 说明 |
|---|---|
active |
当前活跃请求数（排队中） |
avg_latency_ms |
平均处理耗时（毫秒） |
estimated_wait_sec |
预估等待时长（秒）= active × avg_latency_ms |
total_processed |
累计已处理请求数 |
状态分级
- 🟢 active=0 或预估等待 <5s → 服务空闲/很快完成
- 🟡 预估等待 5-30s → 轻微排队
- 🔴 预估等待 >30s → 排队较长，建议稍后重试
Supported Audio Formats
Common audio formats: mp3, wav, m4a, ogg, flac
Troubleshooting
- File not found: Check the audio file path
- API request failed: Verify network connectivity and API endpoint availability
- Unsupported format: Try converting to mp3 or wav format
- Long wait: Use
--queueto check current queue status