TTS, Batch & Prompts

Three utility command groups: omni tts for voice synthesis, omni batch for bulk media processing, and omni prompts for customizing LLM prompt templates.

TTS Commands

`omni tts voices`

List available text-to-speech voices.

omni tts voices

TTS is also available inline via omni send --tts "text" — see Messaging for details.

Batch Commands

The omni batch command group manages bulk media processing jobs — transcribing audio, describing images, and extracting document content at scale.

`omni batch create`

Create a batch processing job.

omni batch create [options]

Option	Description
`--instance <id>`	Instance ID
`--type <type>`	Job type: `targeted_chat_sync`, `time_based_batch`, or `media_redownload`
`--chat <id>`	Chat ID (required for `targeted_chat_sync`)
`--days <n>`	Days to look back (required for `time_based_batch` and `media_redownload`)
`--limit <n>`	Max items to process
`--content-types <types>`	Content types: `audio`, `image`, `video`, `document` (comma-separated)
`--force`	Re-process items that already have content
`--delay-min <ms>`	Min random delay between items in ms (default: 1000)
`--delay-max <ms>`	Max random delay between items in ms (default: 3000)
`--no-confirm`	Skip confirmation prompt

Job Types

Type	Description
`targeted_chat_sync`	Process media from a specific chat
`time_based_batch`	Process media from all chats within a time window
`media_redownload`	Re-download and reprocess media files

Examples

# Transcribe all audio from a chat
omni batch create \
  --instance <id> \
  --type targeted_chat_sync \
  --chat <chat-id> \
  --content-types audio

# Process last 7 days of images and documents
omni batch create \
  --instance <id> \
  --type time_based_batch \
  --days 7 \
  --content-types image,document

# Force reprocess with no confirmation
omni batch create \
  --instance <id> \
  --type time_based_batch \
  --days 30 \
  --force \
  --no-confirm

`omni batch list`

List batch jobs.

omni batch list [options]

Option	Description
`--instance <id>`	Filter by instance ID
`--status <status>`	Filter by status: `pending`, `running`, `completed`, `failed`, `cancelled` (comma-separated)
`--type <type>`	Filter by job type
`--limit <n>`	Max results

omni batch list
omni batch list --status running,pending
omni batch list --instance <id> --type time_based_batch

`omni batch status`

Get job status with optional live updates.

omni batch status <job-id> [options]

Option	Description
`--watch`	Watch for updates
`--interval <ms>`	Poll interval in ms (default: 2000)

omni batch status <job-id>
omni batch status <job-id> --watch

`omni batch cancel`

Cancel a running job.

omni batch cancel <job-id>

`omni batch estimate`

Estimate job scope and cost without creating the job. Accepts the same options as create.

omni batch estimate [options]

Option	Description
`--instance <id>`	Instance ID
`--type <type>`	Job type
`--chat <id>`	Chat ID (for `targeted_chat_sync`)
`--days <n>`	Days to look back
`--limit <n>`	Max items
`--content-types <types>`	Content types to include

# Check how many items before committing
omni batch estimate \
  --instance <id> \
  --type time_based_batch \
  --days 30 \
  --content-types audio,image

Prompt Commands

The omni prompts command group manages LLM prompt templates used for media description (images, videos, documents) and gating decisions. Override defaults to customize how Omni processes media.

`omni prompts list`

List all prompt settings with their override status.

omni prompts list

`omni prompts get`

Show the current prompt for a specific type.

omni prompts get <name>

Name	Description
`image`	Prompt for describing images
`video`	Prompt for describing videos
`document`	Prompt for extracting document content
`gate`	Prompt for gating decisions

omni prompts get image
omni prompts get gate

`omni prompts set`

Set a prompt override. Reads from stdin if no value is provided (for multiline prompts).

omni prompts set <name> [value] [options]

Option	Description
`--reason <reason>`	Reason for change

# Inline override
omni prompts set image "Describe this image in detail, including text and objects" --reason "More detailed descriptions"

# Multiline via stdin
cat <<'EOF' | omni prompts set document --reason "Custom extraction"
Extract all text from this document. Include:
- Headers and titles
- Body text
- Table contents as markdown
EOF

`omni prompts reset`

Clear a prompt override, reverting to the code default.

omni prompts reset <name>

omni prompts reset image

omni prompts set overrides the global default for every instance, agent, and incoming media of that type until reset. Test on a non-production instance first — a bad transcription prompt can silently corrupt downstream agent context for hours before anyone notices.

Use --reason on every prompts set so the next operator can tell why an override exists. The reason is surfaced in omni prompts list.

Messaging

Inline TTS via omni send --tts and the omni speak verb.

Media architecture

How media flows through transcription, description, and extraction.

Getting Started

Core Concepts

CLI Reference

Architecture

TTS, Batch & Prompts

TTS, Batch & Prompts

TTS Commands

`omni tts voices`

Batch Commands

`omni batch create`

Job Types

Examples

`omni batch list`

`omni batch status`

`omni batch cancel`

`omni batch estimate`

Prompt Commands

`omni prompts list`

`omni prompts get`

`omni prompts set`

`omni prompts reset`

See also

Messaging

Media architecture

​TTS, Batch & Prompts

​TTS Commands

​omni tts voices

​Batch Commands

​omni batch create

​Job Types

​Examples

​omni batch list

​omni batch status

​omni batch cancel

​omni batch estimate

​Prompt Commands

​omni prompts list

​omni prompts get

​omni prompts set

​omni prompts reset

​See also

Messaging

Media architecture

TTS, Batch & Prompts

TTS Commands

`omni tts voices`

Batch Commands

`omni batch create`

Job Types

Examples

`omni batch list`

`omni batch status`

`omni batch cancel`

`omni batch estimate`

Prompt Commands

`omni prompts list`

`omni prompts get`

`omni prompts set`

`omni prompts reset`

See also