Lector API

Lector It

Lector can turn text, URLs, documents, and images into audio with a clean API built for developers, agents, and automation.

What Lector can turn into audio

  • Text and content - direct audio generation
  • URLs - public pages into audio
  • Documents and document URLs - readable content into audio
  • Images and image URLs - readable content into audio
  • Files and links - flexible workflows for apps and agents

Choose how audio is delivered

  • stream - direct audio response
  • url - signed audio file URL
  • async_url - background job for supported endpoints
  • auto - Lector chooses the delivery path

Auto is convenience. Explicit settings are control. Use auto when you want Lector to choose the best delivery path, or use url, stream, or async_url when you need exact behavior. URL responses include an audio URL; async jobs return a job and status flow. callback_url is available for async-capable API workflows.

Built for agents and automation

  • OpenAI tool use workflows
  • Claude-style reasoning workflows
  • Local and autonomous agents
  • Slack, Telegram, and automation workflows
  • Accessibility and assistive workflows

Quick examples

curl -X POST https://api.lectorai.app/v1/tts \
    -H "Authorization: Bearer YOUR_API_KEY" \
    -H "Content-Type: application/json" \
    -d '{
      "text": "Hello from Lector",
      "voice": "marin",
      "delivery": "url"
    }'
curl -X POST https://api.lectorai.app/v1/listen-url \
    -H "Authorization: Bearer YOUR_API_KEY" \
    -H "Content-Type: application/json" \
    -d '{
      "url": "https://example.com/article",
      "delivery": "url"
    }'

Core endpoints

  • /v1/tts
  • /v1/listen-content
  • /v1/listen-url
  • /v1/listen-document
  • /v1/listen-document-url
  • /v1/listen-image
  • /v1/listen-image-url
  • /v1/capabilities

Simple billing flow

Start with API access, generate audio, and scale usage as your application grows.

Start building with Lector API