Jellypod, Inc. · Schema

GenerateEpisodeInput

Fields for generating a new episode asynchronously. Prompt mode always writes a new script from the supplied material. Use POST /v1/episodes/import to preserve script text, or script mode here for a validated structured script.

Podcast creationContent AutomationEnterprise content platform

Properties

Name Type Description
host_ids array 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.
language string
options object Prompt-mode generation options. These are not used when `script` is provided.
prompt string Prompt used to write the episode script. Omit it to write the episode from `source_ids` alone. Provide `prompt`, `source_ids`, or both, or `script` instead.
script object
source_ids array Source documents for prompt-based generation. Not supported when `script` is provided.
podcast_id string Podcast that will own the generated episode.
outputs array Files to produce: audio (MP3), video (MP4 with sound), both, or [] for an editable draft. Each requested file becomes downloadable independently. Do not combine with render. Omission preserves legacy
render boolean Deprecated: use outputs. True produces audio and video; false or omission leaves an editable draft. Do not combine with outputs.
View JSON Schema on GitHub

JSON Schema

jellypod-com-generate-episode-input-schema.json Raw ↑
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/jellypod-com/json-schema/jellypod-com-generate-episode-input-schema.json",
  "title": "GenerateEpisodeInput",
  "description": "Fields for generating a new episode asynchronously. Prompt mode always writes a new script from the supplied material. Use POST /v1/episodes/import to preserve script text, or script mode here for a validated structured script.",
  "x-generated": "2026-11-13",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/_original/jellypod-com-api-openapi.json#/components/schemas/GenerateEpisodeInput",
  "type": "object",
  "properties": {
    "host_ids": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "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."
    },
    "language": {
      "type": "string",
      "enum": [
        "en",
        "es",
        "fr",
        "hi",
        "pt",
        "zh",
        "de",
        "ja",
        "ar",
        "ru",
        "ko",
        "id",
        "it",
        "nl",
        "tr",
        "pl",
        "sv",
        "fil",
        "ms",
        "ro",
        "uk",
        "el",
        "cs",
        "da",
        "fi",
        "no",
        "bg",
        "hr",
        "sk",
        "ta",
        "ace",
        "af",
        "ak",
        "sq",
        "am",
        "hy",
        "as",
        "awa",
        "az",
        "ban",
        "bjn",
        "ba",
        "eu",
        "be",
        "bem",
        "bn",
        "bho",
        "bs",
        "bug",
        "my",
        "yue",
        "ca",
        "ckb",
        "hne",
        "ny",
        "crh",
        "dyu",
        "dz",
        "et",
        "gl",
        "lg",
        "ka",
        "gn",
        "gu",
        "ht",
        "ha",
        "he",
        "hu",
        "is",
        "ig",
        "ga",
        "jv",
        "kab",
        "kam",
        "kn",
        "ks",
        "kk",
        "km",
        "ki",
        "rw",
        "kg",
        "ky",
        "lo",
        "ltg",
        "lv",
        "lt",
        "lb",
        "mk",
        "mag",
        "mai",
        "ml",
        "mt",
        "mni",
        "mr",
        "min",
        "lus",
        "mn",
        "ne",
        "nso",
        "or",
        "pag",
        "ps",
        "fa",
        "pa",
        "sat",
        "sr",
        "sd",
        "si",
        "sl",
        "so",
        "sw",
        "ss",
        "tg",
        "te",
        "th",
        "ti",
        "ur",
        "ug",
        "uz",
        "vi",
        "cy"
      ]
    },
    "options": {
      "type": "object",
      "properties": {
        "episode_length": {
          "type": "string"
        },
        "episode_length_minutes": {
          "type": "integer",
          "minimum": 1,
          "maximum": 75
        },
        "web_search": {
          "type": "boolean"
        }
      },
      "default": {},
      "description": "Prompt-mode generation options. These are not used when `script` is provided."
    },
    "prompt": {
      "type": "string",
      "minLength": 10,
      "maxLength": 10000,
      "description": "Prompt used to write the episode script. Omit it to write the episode from `source_ids` alone. Provide `prompt`, `source_ids`, or both, or `script` instead."
    },
    "script": {
      "$ref": "#/$defs/ImportedEpisodeScript"
    },
    "source_ids": {
      "type": "array",
      "items": {
        "type": "string",
        "format": "uuid"
      },
      "description": "Source documents for prompt-based generation. Not supported when `script` is provided."
    },
    "podcast_id": {
      "type": "string",
      "format": "uuid",
      "description": "Podcast that will own the generated episode."
    },
    "outputs": {
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "audio",
          "video"
        ]
      },
      "maxItems": 2,
      "description": "Files to produce: audio (MP3), video (MP4 with sound), both, or [] for an editable draft. Each requested file becomes downloadable independently. Do not combine with render. Omission preserves legacy render behavior."
    },
    "render": {
      "type": "boolean",
      "description": "Deprecated: use outputs. True produces audio and video; false or omission leaves an editable draft. Do not combine with outputs.",
      "deprecated": true
    }
  },
  "required": [
    "podcast_id"
  ],
  "additionalProperties": false,
  "$defs": {
    "ImportedEpisodeScript": {
      "type": "object",
      "properties": {
        "chapters": {
          "type": "array",
          "items": {
            "$ref": "#/$defs/ImportedScriptChapter"
          },
          "minItems": 1,
          "maxItems": 50,
          "description": "Ordered script chapters. Maximum 50 chapters."
        }
      },
      "required": [
        "chapters"
      ],
      "additionalProperties": false,
      "description": "Structured script input for episode generation. Script mode skips prompt-based script writing. Limits: 75000 total text characters, 50 chapters, 200 segments per chapter, 600 total segments, and 5000 characters per segment."
    },
    "ImportedScriptChapter": {
      "type": "object",
      "properties": {
        "segments": {
          "type": "array",
          "items": {
            "$ref": "#/$defs/ImportedScriptSegment"
          },
          "minItems": 1,
          "maxItems": 200,
          "description": "Spoken turns in this chapter. Maximum 200 segments."
        },
        "title": {
          "type": "string",
          "minLength": 1,
          "maxLength": 200,
          "description": "Optional chapter title."
        }
      },
      "required": [
        "segments"
      ],
      "additionalProperties": false,
      "description": "A group of imported script segments. Each chapter can contain up to 200 segments."
    },
    "ImportedScriptSegment": {
      "type": "object",
      "properties": {
        "host_id": {
          "type": "string",
          "minLength": 1,
          "description": "Host ID for the speaker of this segment."
        },
        "text": {
          "type": "string",
          "minLength": 1,
          "maxLength": 5000,
          "description": "Text to synthesize for this segment. Maximum 5000 characters."
        }
      },
      "required": [
        "host_id",
        "text"
      ],
      "additionalProperties": false,
      "description": "One spoken turn in an imported script. The host must belong to your organization."
    }
  }
}

Work with this as data

Every JSON Schema here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for schemas

4 MCP tools reach this
  • find_json_schemasBrowse and filter every JSON Schema in the catalog.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This JSON Schema
curl "https://apis.io/api/v1/json-schemas/jellypod-com-generate-episode-input"
All schemas
curl "https://apis.io/api/v1/json-schemas?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.