# Podcastor

> Build audio and video podcasts with the Podcastor API and MCP.

- [Welcome to PodcastorAI](https://docs.podcastor.ai/home/welcome.md): Turn your ideas, articles, documents, and scripts into AI-powered audio and video podcasts.
- [Getting started](https://docs.podcastor.ai/api-reference/quickstart/getting-started.md): Make your first request, then compose the atomic Podcast workflow.
- [Authentication](https://docs.podcastor.ai/api-reference/quickstart/authentication.md): Use an API key tied to your Podcastor account and Space.
- [Pricing and credits](https://docs.podcastor.ai/api-reference/quickstart/pricing.md): Use your existing Podcastor subscription across Web, API and MCP.
- [Errors and retries](https://docs.podcastor.ai/api-reference/quickstart/error-handling.md): Handle business errors, uncertain requests and duplicate submissions.
- [Rate limits](https://docs.podcastor.ai/api-reference/quickstart/rate-limits.md): Control polling and generation concurrency without duplicating work.
- [Create a podcast](https://docs.podcastor.ai/api-reference/guides/create-a-podcast.md): Compose the script, audio, workspace and render stages.
- [Assets and hosts](https://docs.podcastor.ai/api-reference/guides/assets-and-hosts.md): Reuse the existing Podcastor libraries for voices, avatars, images and music.
- [Polling and outputs](https://docs.podcastor.ai/api-reference/guides/polling-and-outputs.md): Track native tasks and retrieve video, speech, audio and subtitles.
- [Webhook availability](https://docs.podcastor.ai/api-reference/guides/webhooks.md): Understand what existing Webhook subscriptions can notify you about.
- [Account](https://docs.podcastor.ai/api-reference/account/account.md): Get the current Web account and Space.
- [Subscription](https://docs.podcastor.ai/api-reference/account/subscription.md): Get the shared Web subscription and remaining credits.
- [Capabilities](https://docs.podcastor.ai/api-reference/account/capabilities.md): Discover the atomic Web workflow and shared project, billing and storage identity.
- [Catalog](https://docs.podcastor.ai/api-reference/account/catalog.md): Search voices, avatars or templates from the shared Web libraries.
- [Create project](https://docs.podcastor.ai/api-reference/projects/create-project.md): Create a Podcast script project from text, URLs, documents, a script, or audio. Poll get_project for script readiness.
- [Regenerate script](https://docs.podcastor.ai/api-reference/projects/regenerate-script.md): Update project input and regenerate its script using prj_id.
- [List projects](https://docs.podcastor.ai/api-reference/projects/list-projects.md): List Podcast projects in the current Space.
- [Get project](https://docs.podcastor.ai/api-reference/projects/get-project.md): Get project script, task status, assets and completed video URL.
- [Get settings](https://docs.podcastor.ai/api-reference/projects/get-settings.md): Get the saved Podcast project settings.
- [Save project](https://docs.podcastor.ai/api-reference/projects/save-project.md): Save script scenes, host voices, avatars, B-roll, subtitles, layout and audio enhancement settings.
- [Rename project](https://docs.podcastor.ai/api-reference/projects/rename-project.md): Rename a project in the current Space.
- [Copy project](https://docs.podcastor.ai/api-reference/projects/copy-project.md): Copy an existing project for further editing.
- [Delete project](https://docs.podcastor.ai/api-reference/projects/delete-project.md): Delete a project from the current Space.
- [Check source](https://docs.podcastor.ai/api-reference/projects/check-source.md): Validate a Podcast source URL.
- [Prepare audio](https://docs.podcastor.ai/api-reference/audio/prepare-audio.md): Submit asynchronous full-script TTS and workspace preparation after save_project. Uses the Web credit balance.
- [Get audio task](https://docs.podcastor.ai/api-reference/audio/get-audio-task.md): Poll the full-script TTS and workspace preparation task.
- [Redo speech](https://docs.podcastor.ai/api-reference/audio/redo-speech.md): Regenerate one Podcast scene's speech asynchronously with the shared Web billing and subtitles.
- [Get speech task](https://docs.podcastor.ai/api-reference/audio/get-speech-task.md): Poll a scene speech regeneration task.
- [Concat audio](https://docs.podcastor.ai/api-reference/audio/concat-audio.md): Concatenate the current workspace's speech tracks and save the resulting audio in the existing project storage.
- [Download audio](https://docs.podcastor.ai/api-reference/audio/download-audio.md): Get the generated audio download URL.
- [Export subtitles](https://docs.podcastor.ai/api-reference/audio/export-subtitles.md): Export the project's subtitles as SRT.
- [Get workspace](https://docs.podcastor.ai/api-reference/rendering/get-workspace.md): Read the project's editable workspace after audio preparation.
- [Save workspace](https://docs.podcastor.ai/api-reference/rendering/save-workspace.md): Save an edited project workspace draft.
- [Apply workspace](https://docs.podcastor.ai/api-reference/rendering/apply-workspace.md): Apply a saved workspace draft to the project.
- [Render credit check](https://docs.podcastor.ai/api-reference/rendering/render-credit-check.md): Check render credit requirements against the shared Web balance.
- [Render](https://docs.podcastor.ai/api-reference/rendering/render.md): Render prepared Podcast workspaces using the Web render pipeline. Poll get_project for completion and video URL.
- [Retry project](https://docs.podcastor.ai/api-reference/rendering/retry-project.md): Retry a failed project using the existing Web retry and compensation rules.
- [Set cover](https://docs.podcastor.ai/api-reference/rendering/set-cover.md): Set the project's cover.
- [Cover context](https://docs.podcastor.ai/api-reference/rendering/cover-context.md): Get project context for cover generation.
- [List voices](https://docs.podcastor.ai/api-reference/voices/list-voices.md): List available public voices.
- [List user voices](https://docs.podcastor.ai/api-reference/voices/list-user-voices.md): List user voices from the shared Web asset library.
- [Get voice](https://docs.podcastor.ai/api-reference/voices/get-voice.md): Get details and preview audio for an accessible voice.
- [Voice labels](https://docs.podcastor.ai/api-reference/voices/voice-labels.md): Get voice filter options.
- [List elevenlabs voices](https://docs.podcastor.ai/api-reference/voices/list-elevenlabs-voices.md): Search ElevenLabs voices available to the current Web account.
- [Elevenlabs labels](https://docs.podcastor.ai/api-reference/voices/elevenlabs-labels.md): Get ElevenLabs voice filter options.
- [Save elevenlabs voice](https://docs.podcastor.ai/api-reference/voices/save-elevenlabs-voice.md): Resolve and save an ElevenLabs voice for project use.
- [Clone voice](https://docs.podcastor.ai/api-reference/voices/clone-voice.md): Clone a voice into the shared Web voice library with existing Web charges.
- [Voice clone allowance](https://docs.podcastor.ai/api-reference/voices/voice-clone-allowance.md): Get the Web account's remaining free voice clones.
- [Design voice](https://docs.podcastor.ai/api-reference/voices/design-voice.md): Generate candidate voices from a description using the same Web allowance and provider.
- [Save designed voice](https://docs.podcastor.ai/api-reference/voices/save-designed-voice.md): Save a designed voice to the shared Web voice library.
- [List avatars](https://docs.podcastor.ai/api-reference/avatars/list-avatars.md): List public and user Podcast avatars by type.
- [Create avatar](https://docs.podcastor.ai/api-reference/avatars/create-avatar.md): Generate Podcast avatar photos using Web pricing and asset ownership.
- [Get avatar](https://docs.podcastor.ai/api-reference/avatars/get-avatar.md): Get Podcast avatar photo and motion task status.
- [Get avatar draft](https://docs.podcastor.ai/api-reference/avatars/get-avatar-draft.md): Get the current user's unfinished Podcast avatar draft.
- [Delete avatar draft](https://docs.podcastor.ai/api-reference/avatars/delete-avatar-draft.md): Delete the current user's unfinished Podcast avatar draft.
- [More avatar photos](https://docs.podcastor.ai/api-reference/avatars/more-avatar-photos.md): Generate additional photos for a Podcast avatar.
- [Generate avatar motion](https://docs.podcastor.ai/api-reference/avatars/generate-avatar-motion.md): Generate motion for a Podcast avatar using the shared Web pipeline.
- [Rename avatar](https://docs.podcastor.ai/api-reference/avatars/rename-avatar.md): Rename a user Podcast avatar.
- [Delete avatar](https://docs.podcastor.ai/api-reference/avatars/delete-avatar.md): Delete a user Podcast avatar.
- [Retry avatar](https://docs.podcastor.ai/api-reference/avatars/retry-avatar.md): Retry a failed Podcast avatar task.
- [Query avatar info](https://docs.podcastor.ai/api-reference/avatars/query-avatar-info.md): Resolve selected Podcast avatar information.
- [Upload sign](https://docs.podcastor.ai/api-reference/assets/upload-sign.md): Get the same OSS upload signature used by Web. Upload the bytes to the returned destination, then register the asset with its corresponding asset operation.
- [List music](https://docs.podcastor.ai/api-reference/assets/list-music.md): List background music.
- [List user music](https://docs.podcastor.ai/api-reference/assets/list-user-music.md): List user background music.
- [Add music](https://docs.podcastor.ai/api-reference/assets/add-music.md): Register uploaded music in the shared Web library.
- [List backgrounds](https://docs.podcastor.ai/api-reference/assets/list-backgrounds.md): List shared public and current-user Podcast backgrounds.
- [Add background](https://docs.podcastor.ai/api-reference/assets/add-background.md): Register an uploaded Podcast background in the shared Web library.
- [Delete background](https://docs.podcastor.ai/api-reference/assets/delete-background.md): Delete a user Podcast background.
- [Regenerate background](https://docs.podcastor.ai/api-reference/assets/regenerate-background.md): Regenerate a background with its original settings and Web charges.
- [List covers](https://docs.podcastor.ai/api-reference/assets/list-covers.md): List Podcast covers in the shared Space library.
- [Delete cover](https://docs.podcastor.ai/api-reference/assets/delete-cover.md): Delete a Podcast cover from the Space library.
- [Generate image](https://docs.podcastor.ai/api-reference/assets/generate-image.md): Generate Podcast images using Web pricing. Set source to podcast_background for a background or podcast_cover for covers; poll get_image_task.
- [Get image task](https://docs.podcastor.ai/api-reference/assets/get-image-task.md): Get image generation status and resulting background or cover assets.
- [List templates](https://docs.podcastor.ai/api-reference/templates/list-templates.md): List Podcast templates.
- [List image templates](https://docs.podcastor.ai/api-reference/templates/list-image-templates.md): List public and user image Podcast templates.
- [Create image template](https://docs.podcastor.ai/api-reference/templates/create-image-template.md): Create an image Podcast template in the shared Web library.
- [Update image template](https://docs.podcastor.ai/api-reference/templates/update-image-template.md): Edit an image Podcast template.
- [Delete image template](https://docs.podcastor.ai/api-reference/templates/delete-image-template.md): Delete a user image Podcast template.
- [Copy image template](https://docs.podcastor.ai/api-reference/templates/copy-image-template.md): Copy an accessible image Podcast template into the shared Web library.
- [List image backgrounds](https://docs.podcastor.ai/api-reference/templates/list-image-backgrounds.md): List image Podcast backgrounds.
- [Add image background](https://docs.podcastor.ai/api-reference/templates/add-image-background.md): Register an uploaded image Podcast background in the shared Web library.
- [Delete image background](https://docs.podcastor.ai/api-reference/templates/delete-image-background.md): Delete a user image Podcast background.
- [List images](https://docs.podcastor.ai/api-reference/templates/list-images.md): List image Podcast materials.
- [Add image](https://docs.podcastor.ai/api-reference/templates/add-image.md): Register an uploaded image in the shared Podcast library.
- [Delete image](https://docs.podcastor.ai/api-reference/templates/delete-image.md): Delete a user image material.
- [List waveforms](https://docs.podcastor.ai/api-reference/templates/list-waveforms.md): List image Podcast waveforms.
- [Add waveform](https://docs.podcastor.ai/api-reference/templates/add-waveform.md): Create a reusable waveform.
- [Update waveform](https://docs.podcastor.ai/api-reference/templates/update-waveform.md): Update a user waveform.
- [Delete waveform](https://docs.podcastor.ai/api-reference/templates/delete-waveform.md): Delete a user waveform.
- [List webhooks](https://docs.podcastor.ai/api-reference/webhooks/list-webhooks.md): List the account's shared Webhook subscriptions.
- [Create webhook](https://docs.podcastor.ai/api-reference/webhooks/create-webhook.md): Subscribe to the events supported by the existing Web Webhook service.
- [Update webhook](https://docs.podcastor.ai/api-reference/webhooks/update-webhook.md): Update an account Webhook subscription.
- [Delete webhook](https://docs.podcastor.ai/api-reference/webhooks/delete-webhook.md): Delete an account Webhook subscription.
- [Webhook events](https://docs.podcastor.ai/api-reference/webhooks/webhook-events.md): Discover supported Webhook events.

## OpenAPI Specs

- [openapi](/api-reference/openapi.json)