---
title: "Create Podcast"
method: POST
path: "/v1/studio/podcasts"
tags: ["studio"]
---

# Create Podcast

`POST /v1/studio/podcasts`

Create and auto-convert a podcast project. Currently, the LLM cost is covered by us but you will still be charged for the audio generation. In the future, you will be charged for both the LLM and audio generation costs.

## Headers

- `safety-identifier` string, nullable — Used for moderation. Your workspace must be allowlisted to use this feature.
- `xi-api-key` string, nullable — Your API key. This is required by most endpoints to access our API programmatically. You can view your xi-api-key using the 'Profile' tab on the website.

## Request body

- BodyCreatePodcastV1StudioPodcastsPost
  - `model_id` string, required — The ID of the model to be used for this Studio project, you can query GET /v1/models to list all available models.
  - `mode` union, required — The type of podcast to generate. Can be 'conversation', an interaction between two voices, or 'bulletin', a monologue.
    - PodcastConversationMode
      - `type` 'conversation', required — The type of podcast to create.
      - `conversation` PodcastConversationModeData, required
        - `host_voice_id` string, required — The ID of the host voice.
        - `guest_voice_id` string, required — The ID of the guest voice.
    - PodcastBulletinMode
      - `type` 'bulletin', required — The type of podcast to create.
      - `bulletin` PodcastBulletinModeData, required
        - `host_voice_id` string, required — The ID of the host voice.
  - `source` union, required — The source content for the Podcast.
    - PodcastTextSource
      - `type` 'text', required — The type of source to create.
      - `text` string, required — The text to create the podcast from.
    - PodcastURLSource
      - `type` 'url', required — The type of source to create.
      - `url` string, required — The URL to create the podcast from.
    - union[]
      - union
        - PodcastTextSource
          - `type` 'text', required — The type of source to create.
          - `text` string, required — The text to create the podcast from.
        - PodcastURLSource
          - `type` 'url', required — The type of source to create.
          - `url` string, required — The URL to create the podcast from.
  - `quality_preset` 'standard' | 'high' | 'ultra' | 'ultra_lossless'
  - `duration_scale` 'short' | 'default' | 'long' — Duration of the generated podcast. Must be one of: short - produces podcasts shorter than 3 minutes. default - produces podcasts roughly between 3-7 minutes. long - produces podcasts longer than 7 minutes.
  - `language` string, nullable — An optional language of the Studio project. Two-letter language code (ISO 639-1).
  - `intro` string, nullable — The intro text that will always be added to the beginning of the podcast.
  - `outro` string, nullable — The outro text that will always be added to the end of the podcast.
  - `instructions_prompt` string, nullable — Additional instructions prompt for the podcast generation used to adjust the podcast's style and tone.
  - `highlights` string[], nullable — A brief summary or highlights of the Studio project's content, providing key points or themes. This should be between 10 and 70 characters.
  - `callback_url` string, nullable — A url that will be called by our service when the Studio project is converted. Request will contain a json blob containing the status of the conversion Messages: 1. When project was converted successfully: { type: "project_conversion_status", event_timestamp: 1234567890, data: { request_id: "1234567890", project_id: "21m00Tcm4TlvDq8ikWAM", conversion_status: "success", project_snapshot_id: "22m00Tcm4TlvDq8ikMAT", error_details: None, } } 2. When project conversion failed: { type: "project_conversion_status", event_timestamp: 1234567890, data: { request_id: "1234567890", project_id: "21m00Tcm4TlvDq8ikWAM", conversion_status: "error", project_snapshot_id: None, error_details: "Error details if conversion failed" } } 3. When chapter was converted successfully: { type: "chapter_conversion_status", event_timestamp: 1234567890, data: { request_id: "1234567890", project_id: "21m00Tcm4TlvDq8ikWAM", chapter_id: "22m00Tcm4TlvDq8ikMAT", conversion_status: "success", chapter_snapshot_id: "23m00Tcm4TlvDq8ikMAV", error_details: None, } } 4. When chapter conversion failed: { type: "chapter_conversion_status", event_timestamp: 1234567890, data: { request_id: "1234567890", project_id: "21m00Tcm4TlvDq8ikWAM", chapter_id: "22m00Tcm4TlvDq8ikMAT", conversion_status: "error", chapter_snapshot_id: None, error_details: "Error details if conversion failed" } }
  - `apply_text_normalization` 'auto' | 'on' | 'off' | 'apply_english', nullable — This parameter controls text normalization with four modes: 'auto', 'on', 'apply_english' and 'off'. When set to 'auto', the system will automatically decide whether to apply text normalization (e.g., spelling out numbers). With 'on', text normalization will always be applied, while with 'off', it will be skipped. 'apply_english' is the same as 'on' but will assume that text is in English.

## Response `200`

Successful Response

- PodcastProjectResponseModel
  - `project` ProjectResponseModel, required
    - `project_id` string, required — The ID of the project.
    - `name` string, required — The name of the project.
    - `create_date_unix` integer, required — The creation date of the project.
    - `created_by_user_id` string, nullable, required — The user ID who created the project.
    - `default_title_voice_ref_id` string, required — The default title project voice reference ID.
    - `default_paragraph_voice_ref_id` string, required — The default paragraph project voice reference ID.
    - `default_model_id` string, required — The default model ID.
    - `last_conversion_date_unix` integer, nullable — The last conversion date of the project.
    - `can_be_downloaded` boolean, required — Whether the project can be downloaded.
    - `title` string, nullable — The title of the project.
    - `author` string, nullable — The author of the project.
    - `description` string, nullable — The description of the project.
    - `genres` string[], nullable — List of genres of the project.
    - `cover_image_url` string, nullable — The cover image URL of the project.
    - `target_audience` 'children' | 'young adult' | 'adult' | 'all ages', nullable — The target audience of the project.
    - `language` string, nullable — Two-letter language code (ISO 639-1) of the language of the project.
    - `content_type` string, nullable — The content type of the project, e.g. 'Novel' or 'Short Story'
    - `original_publication_date` string, nullable — The original publication date of the project.
    - `mature_content` boolean, nullable — Whether the project contains mature content.
    - `isbn_number` string, nullable — The ISBN number of the project.
    - `volume_normalization` boolean, required — Whether the project uses volume normalization.
    - `state` 'creating' | 'default' | 'converting' | 'in_queue', required — The state of the project.
    - `access_level` 'admin' | 'editor' | 'commenter' | 'viewer', required — The access level of the project.
    - `fiction` 'fiction' | 'non-fiction', nullable — Whether the project is fiction.
    - `quality_check_on` boolean, required — Whether quality check is enabled for this project.
    - `quality_check_on_when_bulk_convert` boolean, required — Whether quality check is enabled on the project when bulk converting.
    - `creation_meta` ProjectCreationMetaResponseModel
      - `creation_progress` number, required — The progress of the project creation.
      - `status` 'draft' | 'pending' | 'creating' | 'finished' | 'failed', required — The status of the project creation action.
      - `type` 'blank' | 'generate_podcast' | 'auto_assign_voices' | 'dub_video' | 'import_speech', required
    - `source_type` 'blank' | 'book' | 'article' | 'genfm' | 'video' | 'screenplay', nullable — The source type of the project.
    - `chapters_enabled` boolean, nullable — Whether chapters are enabled for the project.
    - `captions_enabled` boolean, nullable — Whether captions are enabled for the project.
    - `caption_style` CaptionStyleModel
      - `template` CaptionStyleTemplateModel
        - `key` string, required
        - `label` string, required
        - `requires_high_fps` boolean
      - `text_font` string, nullable
      - `text_scale` number, nullable
      - `text_color` string, nullable
      - `text_align` 'start' | 'center' | 'end', nullable
      - `text_style` 'normal' | 'italic', nullable
      - `text_weight` 'normal' | 'bold' | '900', nullable
      - `text_transform` 'none' | 'uppercase', nullable
      - `text_blend_mode` 'normal' | 'difference' | 'multiply', nullable
      - `text_shadow` StudioTextStyleShadowModel
        - `enabled` boolean, required
        - `color` string, required
        - `opacity` number, required
        - `blur` number, required
        - `offset_x` number, required
        - `offset_y` number, required
      - `text_outline` StudioTextStyleOutlineModel
        - `enabled` boolean, required
        - `color` string, required
        - `opacity` number, required
        - `width` number, required
      - `background_enabled` boolean, nullable
      - `background_color` string, nullable
      - `background_opacity` number, nullable
      - `background_blur` number, nullable
      - `background_border_radius` number, nullable
      - `word_highlights_enabled` boolean, nullable
      - `word_highlights_color` string, nullable
      - `word_highlights_background_color` string, nullable
      - `word_highlights_opacity` number, nullable
      - `word_highlights_border_radius` number, nullable
      - `word_highlights_blur` number, nullable
      - `section_animation` CaptionStyleSectionAnimationModel
        - `enter_type` 'none' | 'fade' | 'scale' | 'pop' | 'slide_up' | 'slide_down' | 'slam' | 'scale_down' | 'slide_in', required
        - `exit_type` 'none' | 'fade' | 'scale' | 'pop' | 'slide_up' | 'slide_down' | 'slam' | 'scale_down' | 'slide_in', required
      - `word_animation` CaptionStyleWordAnimationModel
        - `enter_type` 'none' | 'fade' | 'scale' | 'pop' | 'slide_up' | 'slide_down' | 'slam' | 'scale_down' | 'slide_in', required
        - `exit_type` 'none' | 'fade' | 'scale' | 'pop' | 'slide_up' | 'slide_down' | 'slam' | 'scale_down' | 'slide_in', required
      - `character_animation` CaptionStyleCharacterAnimationModel
        - `enter_type` 'none' | 'fade' | 'typewriter', required
        - `exit_type` 'none' | 'fade', required
      - `cursor_enabled` boolean, nullable
      - `width_pct` number, nullable
      - `horizontal_placement` CaptionStyleHorizontalPlacementModel
        - `align` 'left' | 'center' | 'right', required
        - `translate_pct` number, required
      - `vertical_placement` CaptionStyleVerticalPlacementModel
        - `align` 'top' | 'center' | 'bottom', required
        - `translate_pct` number, required
      - `auto_break_enabled` boolean, nullable
      - `max_lines_per_section` integer, nullable
      - `max_words_per_line` integer, nullable
    - `caption_style_template_overrides` object, nullable — Styling changes that have been made to the provided templates
    - `public_share_id` string, nullable — The public share ID of the project.
    - `aspect_ratio` '16:9' | '9:16' | '4:5' | '1:1', nullable — The aspect ratio of the project.
    - `agent_settings` StudioAgentSettingsModel
      - `tool_settings` object
    - `default_title_voice_id` string, required — The default title voice ID.
    - `default_paragraph_voice_id` string, required — The default paragraph voice ID.

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/elevenlabs/apis/elevenlabs-api-documentation.md) · [All operations](https://skmtc.net/elevenlabs/apis/elevenlabs-api-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/elevenlabs/elevenlabs-api-documentation/revisions/6c2d6eb4a7e6/schema)