Episodes

Generate a new episode (asynchronous)

post/v1/episodes/generate

Request

  • Base URL: https://api.jellypod.com
  • URL: https://api.jellypod.com/v1/episodes/generate
  • 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

host_idsstring[]

Hosts to use for generation. In script mode, every segment host_id must be included here, or omit host_ids to infer them from the script.

promptstring

Prompt used to write the episode script. Provide either prompt or script, not both.

source_idsstring[]

Source documents for prompt-based generation. Not supported when script is provided.

podcast_idstring uuid required

Podcast that will own the 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.

Example request

{
  "host_ids": [
    "2e6939fe",
    "a91c4d22"
  ],
  "prompt": "Create a friendly two-host episode about simple habits for a calmer workweek.",
  "script": {
    "chapters": [
      {
        "segments": [
          {
            "host_id": "2e6939fe",
            "text": "Welcome to the show. Today we are talking about one small habit that can make the week easier."
          },
          {
            "host_id": "a91c4d22",
            "text": "I like that. Let us start with something simple someone can try tomorrow morning."
          }
        ],
        "title": "Opening"
      }
    ]
  }
}

Response

Episode queued for generation

Changes

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