AuralWise CLI

中文文档

Command-line interface for AuralWise Speech Intelligence API.

One API call returns transcription, speaker diarization, speaker embeddings, word-level timestamps, and 521-class audio event detection — all at once.

Features

• Speech Transcription — 99 languages, with a dedicated Chinese engine (optimize_zh) for faster speed and higher accuracy
• Speaker Diarization — Automatic speaker count detection, per-segment speaker labels
• Speaker Embeddings — 192-dim voice print vectors for cross-recording speaker matching
• Timestamps — Word-level (~10ms) or segment-level (~100ms) precision
• Audio Event Detection — 521 AudioSet sound event classes (applause, cough, music, keyboard, etc.)
• VAD — Voice Activity Detection segments
• Batch Mode — Half-price processing using off-peak GPU capacity, delivered within 24h
• Local Transcoding + Vocal Enhancement — Automatically transcodes audio to mono 16kHz 32kbps MP3 and applies a vocal enhancement filter chain (denoise, highpass, EQ, loudness normalization) before upload, cutting upload size dramatically and improving ASR accuracy on noisy recordings

Installation

npm install -g auralwise_cli

Requires Node.js >= 18.

Quick Start

# Set your API key (get one at https://auralwise.cn)
export AURALWISE_API_KEY=asr_xxxxxxxxxxxxxxxxxxxx

# Transcribe from URL — waits for completion and prints results
auralwise transcribe https://example.com/meeting.mp3

# Transcribe a local file (auto base64 upload)
auralwise transcribe ./recording.wav

# Chinese optimization mode (faster, cheaper for Chinese audio)
auralwise transcribe ./meeting.mp3 --optimize-zh --language zh

# Submit without waiting
auralwise transcribe https://example.com/audio.mp3 --no-wait

# Get JSON output
auralwise transcribe ./audio.mp3 --json --output result.json

Commands

auralwise transcribe <source>

Submit an audio file for processing. <source> can be an HTTP(S) URL or a local file path.

Input modes:

• URL mode — Pass an https://... URL. By default the CLI downloads and transcodes the audio locally before upload; if ffmpeg is missing or transcoding is disabled, the URL is submitted directly to the API.
• File mode — Pass a local file path; the CLI reads, transcodes, and uploads as base64.

Local transcoding pipeline (default ON):

When ffmpeg is available on your PATH, the CLI first converts your audio to mono 16kHz 32kbps MP3 with a vocal enhancement filter chain (afftdn denoise → 80Hz highpass → two-band EQ → dynaudnorm loudness). This typically shrinks uploads by 10-20× and yields cleaner ASR on noisy recordings. Temp files are deleted immediately after the upload succeeds.

• If ffmpeg isn't installed, the CLI prints a one-time warning and submits the original file/URL unchanged.
• If the filter chain is incompatible with a particular source, it falls back to a plain transcode (same format, no filters).
• Upload size is capped at 150 MB. A local file exceeding the limit aborts with an error; a URL source that exceeds the limit after transcoding falls back to submitting the URL directly.
• Pass --no-transcode to skip transcoding entirely and upload the file as-is.

Upstream service limits (validated locally before upload):

Limit	Value	Notes
Minimum file size	1 KB	Anything smaller is rejected as not a valid audio file
Maximum file size	2 GB	Upstream hard cap
Maximum duration	5 hours	Probed via ffprobe when available; otherwise enforced server-side

Common options:

Option	Description
--language <lang>	ASR language code (zh, en, ja, ...) or auto-detect if omitted
--optimize-zh	Use dedicated Chinese engine (faster, cheaper, segment-level timestamps)
--no-asr	Disable transcription
--no-diarize	Disable speaker diarization
--no-events	Disable audio event detection
--no-transcode	Skip local transcoding; upload the original file as-is
--hotwords <words>	Boost recognition of specific words (comma-separated)
--num-speakers <n>	Set fixed number of speakers
--max-speakers <n>	Max speakers for auto-detection (default: 10)
--batch	Use batch mode (half-price, 24h delivery)
--no-wait	Return immediately after task creation
--json	Output result as JSON
--output <file>	Save result to file
--callback-url <url>	Webhook URL for completion notification

Advanced ASR options:

Option	Description
--beam-size <n>	Beam search width (default: 5)
--temperature <n>	Decoding temperature (default: 0.0)
--initial-prompt <text>	Guide transcription style
--vad-threshold <n>	VAD sensitivity 0-1 (default: 0.35)
--events-threshold <n>	Audio event confidence threshold (default: 0.3)
--events-classes <list>	Only detect specific event classes

auralwise tasks

List your tasks with optional filtering.

auralwise tasks                          # List all tasks
auralwise tasks --status done            # Only completed tasks
auralwise tasks --page 2 --page-size 50  # Pagination
auralwise tasks --json                   # JSON output

auralwise task <id>

Get details of a specific task.

auralwise task 550e8400-e29b-41d4-a716-446655440000
auralwise task 550e8400-e29b-41d4-a716-446655440000 --json

auralwise result <id>

Retrieve the full result of a completed task.

auralwise result <task-id>                     # Pretty-printed output
auralwise result <task-id> --json              # JSON output
auralwise result <task-id> --output result.json  # Save to file

auralwise delete <id>

Delete a task and its associated files.

auralwise delete <task-id>           # With confirmation prompt
auralwise delete <task-id> --force   # Skip confirmation

auralwise events

Browse the 521 AudioSet sound event classes.

auralwise events                       # List all 521 classes
auralwise events --search Cough        # Search by name
auralwise events --category Music      # Filter by category
auralwise events --json                # JSON output

Configuration

API Key

Set your API key via --api-key flag or environment variable:

# Environment variable (recommended)
export AURALWISE_API_KEY=asr_xxxxxxxxxxxxxxxxxxxx

# Or pass directly
auralwise --api-key asr_xxxx transcribe ./audio.mp3

Base URL

Override the API endpoint (default: https://api.auralwise.cn/v1):

auralwise --base-url https://your-private-instance.com/v1 transcribe ./audio.mp3

Language

The CLI supports English and Chinese interfaces:

auralwise --locale zh --help           # Chinese interface
auralwise --locale en transcribe --help  # English interface (default)

Examples

Meeting transcription with speaker diarization

auralwise transcribe ./meeting.mp3 \
  --optimize-zh \
  --language zh \
  --max-speakers 5 \
  --output meeting_result.json

Batch processing (half-price)

# Submit in batch mode — processed during off-peak hours, 50% discount
auralwise transcribe https://storage.example.com/archive.mp3 \
  --batch \
  --no-wait \
  --callback-url https://your-server.com/webhook

Audio event detection only

auralwise transcribe ./audio.mp3 \
  --no-asr \
  --no-diarize \
  --events-classes "Cough,Music,Applause" \
  --json

Transcription only (no diarization, no events)

auralwise transcribe ./podcast.mp3 \
  --no-diarize \
  --no-events \
  --hotwords "AuralWise,PGPU" \
  --output transcript.json

Output Format

Pretty-printed (default)

Audio Duration: 5.3min
Language: zh (99%)
Speakers: 2

Transcription

[0:00.5 - 0:02.3] SPEAKER_0: This is the first sentence
[0:02.5 - 0:04.1] SPEAKER_1: And this is the reply

Audio Events

[0:45.0 - 0:45.9] Cough (87%)
[1:20.0 - 1:25.0] Music (92%)

Speaker Embeddings

  SPEAKER_0: 25 segments, 192-dim vector
  SPEAKER_1: 18 segments, 192-dim vector

JSON (--json)

Returns the full API response. See API documentation for the complete schema.

Pricing

Capability	Standard	Batch (50% off)
Chinese transcription	¥0.27/hr	¥0.14/hr
General transcription (with word timestamps)	¥1.20/hr	¥0.60/hr
Speaker diarization (labels + embeddings)	+¥0.40/hr	+¥0.20/hr
Audio event detection (521 classes)	+¥0.10/hr	+¥0.05/hr

Example: 100 hours of Chinese meetings (full features) = ¥39 in batch mode.

API Documentation

Full API reference: https://auralwise.cn/api-docs

License

MIT