💡 Need a SaaS built? I can help! Hire me

Menu

ZenMic API Documentation

Transform your text into natural-sounding podcasts with our simple, powerful API.

Status: Stable

Authentication

All API requests require an API key in the headers:

Authorization: Bearer YOUR_API_KEY

Security Best Practices

  • Never expose your API key in client-side code
  • Use environment variables for key storage

API Endpoints

ZenMic API offers two simple endpoints:

  1. Script Generation: Convert topics or documents into podcast scripts
  2. Audio Generation: Transform scripts into natural-sounding podcasts

1. Script Generation Endpoint

Generate conversational podcast scripts from topics, documents, or both.

POST /api/upload.php
Content-Type: multipart/form-data
Authorization: Bearer your-api-key

Parameters:
- topic: Text topic to create a podcast about (optional if document is provided)
- document: Document file to extract content from (optional if topic is provided)
- title: Custom title for the podcast (optional)
- langCode: Language code (defaults to 'en')

Response:

{
    "success": true,
    "title": "Generated Podcast Title",
    "langCode": "en",
    "dialogue": [
        {"male": "Hello and welcome to our podcast."},
        {"female": "Today we're discussing an interesting topic..."},
        // More dialogue entries
    ],
    "input_method": "document" // or "topic"
}

For document uploads: Supported formats include PDF, Word, Text, Images (JPEG, PNG, TIFF, BMP). Maximum file size is 50MB.

2. Audio Generation Endpoint

Convert dialogue scripts into high-quality podcast audio.

POST /api
Content-Type: application/json
Authorization: Bearer your-api-key

{
    "title": "Podcast title",
    "langCode": "en",
    "dialogue": [
        {"male": "Hello and welcome to our podcast."},
        {"female": "Today we're discussing an interesting topic..."},
        {"guest": "And I'm here as a special guest!"}
    ]
}

Response:

{
    "success": true,
    "id": "abcd",
    "status_url": "/api/?id=abcd"
}

Check the status by making a GET request to the status_url. When ready, the response will include an audio_url field with the MP3 download link.

Try Script Generation

Try Audio Generation

Ready to Get Started?

Get an API key and start transforming your text into natural speech.

Get Your API Key

Ready to Transform Your Content?

Join hundreds of content creators who are already using ZenMic to create amazing podcasts.

Start Generating