Sign in

Generate voiceover

Turn text into spoken audio using a natural-sounding TTS voice. Async — returns 202 with a pending job; poll GET /tool_jobs/{uid} until status is completed or failed.

post/tools/generate_voiceover

Request body

textstring required

What the voice should say — up to 2000 characters

voice'rachel' | 'adam' | 'antoni' | 'bella' | 'domi' | 'elli' | 'josh' | 'arnold' | 'charlie' | 'freya' required

Pre-made ElevenLabs voice. Rachel and Adam are safe defaults

metadatastring

Arbitrary metadata string stored with the tool run

Response

Tool run accepted

uidstring
tool'generate_voiceover'
status'pending' | 'running' | 'completed' | 'failed'

pending → running → completed / failed

progressinteger

0-100 job progress, 100 once completed

inputsobject

Inputs the job was created with

metadatastring nullable

Arbitrary metadata string round-tripped from the create request

selfstring uri
created_atstring date-time
completed_atstring date-time nullable
error_messagestring nullable

Human-readable failure reason (only present on failed jobs)

Changes

No recorded changes to this endpoint across all 1 revision of this API.