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.
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. |
JSON Schema
{
"$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.
Call it yourself
curl for this page
curl "https://apis.io/api/v1/json-schemas/jellypod-com-generate-episode-input"
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.