Skip to main content
To generate audio or video, submit a content item via Create and generate content. That endpoint queues TTS and media processing — it is the main entry point for integrations. Most workflows follow three steps:
  1. Create — POST article HTML, manual segments, or an audio upload. See Processing types.
  2. Wait for completion — Use webhooks to be notified when status is processed (or handle error / skipped). See the Webhooks guide.
  3. Retrieve — Call Get content with ?segments=full when you need segment data for the player.

Create and generate content

Submit content and start audio or video generation.

Processing types

Choose auto_segment, manual_segment, or audio_upload.

Content object

Properties returned on every content item.

Regenerate content

Re-run generation after updating an existing item.

​
Endpoints

The other API reference sections — Extraction, Pronunciation settings, Script settings, Video settings, and Background music settings — configure project defaults. They do not generate content on their own. Use the Items endpoints below the developer guide for that.

​
Identifiers

​
Processing status

  • Content items — dashboard concepts and metadata
  • Webhooks — get notified when processing completes
  • Replace audio — swap AI-generated audio for an uploaded file via the API
  • Upload audio — dashboard workflow for audio_upload