ZenMic API Documentation

Introduction

The v4 API is the latest version of the ZenMic API. It's a streamlined, unified API that powers both the v4 Studio frontend and external integrations. Every endpoint uses Bearer token authentication with a single /api/v4/ base path.

Base URL: https://zenmic.com/api/v4/
All responses are JSON. Success: {"success":true,"data":{...}}. Errors include an "error" field.

Authentication

Include your API key in the Authorization header. Find your API key in the sidebar under Get Your API Key.

http

Authorization: Bearer YOUR_API_KEY

Keep it secret. Never expose your API key in client-side code.

POST Generate Script

Convert a topic, uploaded files, or both into a structured podcast script with scene, speaker profiles, and dialogue.

POST/api/v4/script

Request Body

json

{
  "topic": "The future of AI in healthcare, 3 minutes, in English",
  "show_name": "My Podcast",
  "files": [
    {
      "name": "report.pdf",
      "mimeType": "application/pdf",
      "data": "base64_encoded_content..."
    }
  ]
}

200 Response

{ "success": true, "data": { "title": "AI in Healthcare", "transcript": "s1: Welcome to the show...\n\ns2: Thanks for having me...", "scene": "A bright modern studio...", "notes": "Style:\n* Warm, intimate pacing\n* Natural pauses", "voice1": "Charon", "voice2": "Zephyr", "full_script": "## \"AI in Healthcare\"\n\n..." } }

POST Generate Audio

Convert a dialogue script into high-fidelity TTS audio. Returns a 202 with a polling URL. Audio is generated asynchronously in the background.

POST/api/v4/audio

Request Body

json

{
  "script": "s1: Welcome to the show...\n\ns2: Thanks for having me, let's dive in...",
  "voice1": "Charon",
  "voice2": "Zephyr",
  "title": "AI in Healthcare",
  "scene": "A bright modern studio",
  "director_notes": "Warm, conversational pacing"
}

202 Accepted

{ "success": true, "data": { "id": "a1b2", "status": "queued", "poll_url": "/api/v4/status?id=a1b2" } }

GET Poll Status

Poll the status of an audio generation job. No authentication required (episode IDs are public).

GET/api/v4/status?id=EPISODE_ID

200 Response (succeeded)

{ "success": true, "data": { "id": "a1b2", "status": "succeeded", "title": "AI in Healthcare", "duration": 187, "created_at": "2026-06-06 12:00:00", "audio_url": "https://zenmic.com/audio/a1b2" } }

POST Generate Idea

Get a random podcast episode idea based on your show's context and past episodes.

POST/api/v4/ideas

Request Body

json

{
  "show_name": "Tech Talks"
}

200 Response

{ "success": true, "data": { "idea": "In English language, 3 minutes long, discussion about how AI is transforming medical diagnosis." } }

POST Episodes (Manage)

List, delete, retry, or toggle publish status for episodes. Requires authentication.

POST/api/v4/episodes

List episodes

http

GET /api/v4/episodes?show_id=My%20Podcast
Authorization: Bearer YOUR_API_KEY

Delete episode

http

POST /api/v4/episodes
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

{"action": "delete", "episode_id": "a1b2"}

Retry failed episode

http

POST /api/v4/episodes
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

{"action": "retry", "episode_id": "a1b2"}

Toggle publish

http

POST /api/v4/episodes
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

{"action": "toggle_publish", "episode_id": "a1b2"}

You can also fetch full episode details (including transcript) via GET:

http

GET /api/v4/episodes?id=a1b2
Authorization: Bearer YOUR_API_KEY

POST Shows (Manage)

Create, switch, or update podcast shows. Requires authentication.

POST/api/v4/shows

Create show

http

POST /api/v4/shows
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

{"action": "create", "name": "My New Show"}

List shows

http

GET /api/v4/shows
Authorization: Bearer YOUR_API_KEY

POST Login

Used by the v4 frontend for Google and email magic link sign-in. This endpoint is not intended for external API use. It creates a PHP session and returns the user's API key for subsequent Bearer auth.

POST/api/v4/login

This endpoint is designed for the v4 frontend. External users should use their API key directly with the other endpoints.

ZenMic API Documentation

Introduction

Authentication

POST Generate Script

Request Body

POST Generate Audio

Request Body

GET Poll Status

POST Generate Idea

Request Body

POST Episodes (Manage)

List episodes

Delete episode

Retry failed episode

Toggle publish

POST Shows (Manage)

Create show

List shows

POST Login

Ready to Transform Your Content?