For Agents
Convert text or article URLs into speech audio with selectable voices, optional word-level timestamps, and async job submission for long-form content.
Install Jentic One Beta
Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the Listnr Text-to-Speech API, or any other public or private API you need. You set the rules, the agent never sees your credentials, and every call is logged.
Two steps, two machines. Install the instance in a safe environment, then register your agent from wherever it runs.
Step 1: Jentic One Host machine
# On the machine that will host your Jentic One instance:
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | shStep 2: Agent machine
# On the machine where your agent runs (keep this separate from the instance):
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh
jentic register # connects your agent to your Jentic One instanceJentic One is in public beta. The setup above keeps your agent separate from the instance, which is what you want before using real credentials: an agent running as the same OS user as Jentic One can read its stored keys directly. Just evaluating? A single local install is fine to start. See the secure deployment guide for the tiers.
What an agent can do with Listnr Text-to-Speech API.
Convert text to speech synchronously via POST /convert-text with a chosen voice
Submit long-form text-to-speech as an async job via POST /convert-text-async and poll via GET /job-status
Generate speech with word-level timestamps for caption alignment via POST /convert-text-with-timestamps
GET STARTED
Use for: I need to convert a blog post into audio narration, I want to generate a TTS file with word-level timestamps for captions, Submit a long article for async TTS conversion, List available Listnr voices in English
Not supported: Does not handle speech-to-text, voice cloning, or audio editing — use for text-to-speech and article-to-audio conversion only.
Listnr is a text-to-speech API that converts written text or article URLs into natural-sounding speech across a multi-voice library. It supports synchronous and asynchronous text-to-speech jobs, word-level timestamp output for caption alignment, URL-based article conversion, and a job status endpoint for polling long-running async conversions. Useful for podcasting workflows, accessibility features, and content-to-audio pipelines that need flexible voice selection.
Convert any article URL into audio via POST /convert-url and POST /convert-url-async
List available voices and languages via GET /available-voices
Authenticate every request with an x-listnr-token header scoped to the account
Patterns agents use Listnr Text-to-Speech API for, with concrete tasks.
★ Article-to-Audio Conversion
Turn published articles into audio versions for readers who prefer to listen. POST /convert-url accepts a target article URL and returns an audio file in a chosen voice without requiring the caller to scrape or pre-process the page. Larger articles can be submitted via POST /convert-url-async for non-blocking processing, with status polling via GET /job-status.
POST /convert-url with url=https://blog.example.com/post-1 and voiceId=en-US-female-1, then download the returned audio.
Long-Form TTS via Async Jobs
Submit long scripts (chapters, podcast episodes, training content) for TTS without blocking on a single HTTP request. POST /convert-text-async returns a job id immediately, and GET /job-status returns progress and the final audio URL when complete. Best for content teams generating dozens of minutes of audio per submission.
POST /convert-text-async with the chapter text and voiceId, then poll GET /job-status until the job reports completed.
Captioned Audio with Timestamps
Generate audio with synchronised word-level timestamps so a downstream player can render captions or karaoke-style highlighting. POST /convert-text-with-timestamps returns both the audio asset and a timestamp track aligned to each word in the source text. Useful for accessibility-driven media products and language-learning apps.
POST /convert-text-with-timestamps with the script text and a voiceId, then merge the returned timestamps with the audio for a captioned player.
AI Agent Voice Generation
Let an AI agent narrate generated content (summaries, briefings, replies) on demand. Through Jentic, the agent searches by intent, gets the right /convert-text or /convert-url endpoint with its schema, and executes while the x-listnr-token stays in the MAXsystem vault. Audio can be returned inline in chat or attached to a generated document.
Search Jentic for 'convert text to speech', load the schema, and execute POST /convert-text with the agent's generated summary text.
7 endpoints — listnr is a text-to-speech api that converts written text or article urls into natural-sounding speech across a multi-voice library.
METHOD
PATH
DESCRIPTION
/convert-text
Synchronous text-to-speech conversion
/convert-text-async
Async text-to-speech submission
/convert-text-with-timestamps
TTS with word-level timestamps
/convert-url
Convert article URL to audio
/convert-url-async
Async article URL to audio
/available-voices
List available TTS voices
/job-status
Check async job status
/convert-text
Synchronous text-to-speech conversion
/convert-text-async
Async text-to-speech submission
/convert-text-with-timestamps
TTS with word-level timestamps
/convert-url
Convert article URL to audio
/convert-url-async
Async article URL to audio
Three things that make agents converge on Jentic-routed access.
Credential isolation
Listnr x-listnr-token values are stored encrypted in the Jentic MAXsystem vault and injected as the request header at execution time — agents receive scoped tokens and never hold the raw value.
Intent-based discovery
Agents search by intent (e.g., 'convert article URL to audio') and Jentic returns the matching /convert-* endpoint with its input schema, no manual navigation of the Listnr docs required.
Time to first call
Direct Listnr integration: 4-6 hours for auth, sync vs async handling, and voice selection. Through Jentic: under 20 minutes — search, load schema, execute.
Alternatives and complements available in the Jentic catalogue.
Specific to using Listnr Text-to-Speech API through Jentic.
What authentication does the Listnr TTS API use?
The Listnr API uses an x-listnr-token header on every request. Through Jentic, the token is stored in the MAXsystem vault and injected at execution time, so agents never see the raw token.
Can I convert article URLs into audio with the Listnr API?
Yes. POST /convert-url accepts a target article URL and a voiceId, returning audio without needing a manual scrape. POST /convert-url-async runs the same conversion as a job for longer articles, returning a job id you can poll via GET /job-status.
What are the rate limits for the Listnr TTS API?
Rate limits are enforced per token and vary by plan, with stricter limits on synchronous /convert-text calls than on async submissions. For long-form jobs, prefer /convert-text-async or /convert-url-async to avoid blocking on a single request.
How do I generate speech with word-level timestamps through Jentic?
Run pip install jentic, then search for 'convert text to speech with timestamps'. Jentic returns POST /convert-text-with-timestamps. Load the schema, supply text and voiceId, and execute. The response includes the audio asset and a per-word timestamp track.
How do I find available voices for the Listnr API?
Call GET /available-voices to retrieve the current voice library with languages and voiceId values. Cache the response and pass the chosen voiceId into /convert-text or /convert-url to control the voice on every conversion.
/available-voices
List available TTS voices
/job-status
Check async job status