Skip to main content

​
Overview

The Podcast API turns your topic and source material into a finished, multi-speaker episode. A project moves through a simple lifecycle: create the project and its speakers, add sources, generate an outline, generate the transcript, then render the narrated audio. Finished episodes can be published to a public RSS feed for Apple Podcasts and Spotify.

​
Authentication

  • API Key (Recommended): X-API-Key: your_api_key header
  • JWT Token: Authorization: Bearer your_jwt_token

​
Lifecycle at a glance

StepEndpoint
1. Create a project (+ speakers)POST /api/v1/podcast/projects
2. Add source materialPOST /api/v1/podcast/projects/{id}/sources
3. Generate the outlinePOST /api/v1/podcast/projects/{id}/outline/generate
4. Generate the transcriptPOST /api/v1/podcast/projects/{id}/transcript/generate
5. Estimate + render audioGET /api/v1/podcast/projects/{id}/audio/estimate · POST /api/v1/podcast/projects/{id}/audio/generate
6. Track progressGET /api/v1/podcast/projects/{id}/progress
7. Publish an RSS feedPOST /api/v1/podcast/feed

​
Create a Project

POST /api/v1/podcast/projects
X-API-Key: {api_key}
Content-Type: application/json

{
  "title": "The Future of Audio AI",
  "topic": "How on-device audio models change creator workflows",
  "briefing": "Keep it upbeat and accessible for a general audience.",
  "language": "en",
  "target_duration_minutes": 15,
  "speakers": [
    { "name": "Host", "voice": "aura" },
    { "name": "Guest", "voice": "sage" }
  ]
}
Key fields:
  • title (required): Episode title (1–200 characters)
  • topic (required): Main topic (1–500 characters)
  • briefing (optional): Extra context / tone guidance
  • key_points (optional): List of points to cover
  • language (optional): Primary language code (default en)
  • target_duration_minutes (optional): Target length, 5–60
  • speakers (required): 1–4 initial speakers

​
Manage Projects

ActionRequest
List projectsGET /api/v1/podcast/projects
Get oneGET /api/v1/podcast/projects/{id}
UpdatePUT /api/v1/podcast/projects/{id}
DeleteDELETE /api/v1/podcast/projects/{id}

​
Update a Speaker

Change a speaker’s name or assigned voice on a project. 
PUT /api/v1/podcast/projects/{project_id}/speakers/{speaker_id}
X-API-Key: {api_key}
Content-Type: application/json

{
  "name": "Co-Host",
  "voice": "willow"
}

​
Generate Audio

Preview the cost, then render. Audio generation follows the prepaid model — credits are reserved up front and refunded automatically on failure. 
# Estimate
curl -s "https://api.audiopod.ai/api/v1/podcast/projects/$PROJECT_ID/audio/estimate" \
  -H "X-API-Key: $AUDIOPOD_API_KEY"

# Render
curl -X POST "https://api.audiopod.ai/api/v1/podcast/projects/$PROJECT_ID/audio/generate" \
  -H "X-API-Key: $AUDIOPOD_API_KEY"
Poll GET /api/v1/podcast/projects/{id}/progress until generation completes.

​
Publish an RSS Feed

Turn your completed episodes into a public podcast feed you can submit to directories. The feed URL carries a signed, feed-scoped token. 
POST /api/v1/podcast/feed
X-API-Key: {api_key}
The feed itself is fetched anonymously by podcast players: 
GET /api/v1/podcast/feed/{token}.xml

​
Next Steps

Audio Reader

Narrate a single article or block of text.

Voice Management

Browse voices or design a custom one for your hosts.