Episodes

Import script text and generate a new episode (asynchronous)

post/v1/episodes/import

Request

  • Base URL: https://api.jellypod.com
  • URL: https://api.jellypod.com/v1/episodes/import
  • Auth: HTTP bearer

Headers

idempotency-keystring

Optional key for one logical generation command. Reuse the same key and input after a lost or uncertain response. After a proven rejection before work starts, follow recovery.idempotency_key. Omit it to start a new generation on every request.

Request body

podcast_idstring uuid required

Podcast that will own the imported generated episode.

renderboolean

Render audio and video after generation only when explicitly requested. Defaults to false, leaving an editable draft. Generation uses credits; rendering is free.

scriptstring required

Script or transcript text. Bracketed speaker labels match saved Characters unless speaker_characters explicitly assigns their Character IDs.

Example request

{
  "script": "[Host One]\nWelcome to the show. Today we are talking about one small habit that can make the week easier.\n\n[Host Two]\nI like that. Let us start with something simple someone can try tomorrow morning."
}

Response

Imported episode queued for generation

Changes

No recorded changes to this operation across all 1 revision of this API.