audiopod-ai · Schema
PodcastProjectCreate
Project creation request.
Artificial IntelligenceAudioPodcastsAudiobookSoftware-as-a-ServiceCompany
Properties
| Name | Type | Description |
|---|---|---|
| title | string | Podcast title |
| topic | string | Main topic |
| briefing | string | Additional context/briefing |
| key_points | array | Key points to cover |
| language | string | Primary language code |
| quality_preset | object | Quality preset |
| target_duration_minutes | object | Target episode length in minutes (5-60). Drives segment count + dialogue density. |
| speakers | array | Initial speakers |
| episode_profile_id | object | Apply a saved episode profile |
| briefing_suffix | object | Appended to the profile's default briefing |
JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://artifacts.apis.io/audiopod-ai/json-schema/audiopod-ai-podcast-project-create-schema.json",
"title": "PodcastProjectCreate",
"description": "Project creation request.",
"x-generated": "2026-11-10",
"x-method": "derived",
"x-generator": "derive-json-schema.py",
"x-source": "openapi/audiopod-ai-podcast-api-openapi.yml#/components/schemas/PodcastProjectCreate",
"properties": {
"title": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"title": "Title",
"description": "Podcast title"
},
"topic": {
"type": "string",
"maxLength": 500,
"minLength": 1,
"title": "Topic",
"description": "Main topic"
},
"briefing": {
"type": "string",
"maxLength": 2000,
"title": "Briefing",
"description": "Additional context/briefing",
"default": ""
},
"key_points": {
"items": {
"type": "string"
},
"type": "array",
"title": "Key Points",
"description": "Key points to cover"
},
"language": {
"type": "string",
"title": "Language",
"description": "Primary language code",
"default": "en"
},
"quality_preset": {
"$ref": "#/$defs/QualityPreset",
"description": "Quality preset",
"default": "standard"
},
"target_duration_minutes": {
"anyOf": [
{
"type": "integer",
"maximum": 60.0,
"minimum": 5.0
},
{
"type": "null"
}
],
"title": "Target Duration Minutes",
"description": "Target episode length in minutes (5-60). Drives segment count + dialogue density."
},
"speakers": {
"items": {
"$ref": "#/$defs/SpeakerCreate"
},
"type": "array",
"maxItems": 4,
"minItems": 1,
"title": "Speakers",
"description": "Initial speakers"
},
"episode_profile_id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Episode Profile Id",
"description": "Apply a saved episode profile"
},
"briefing_suffix": {
"anyOf": [
{
"type": "string",
"maxLength": 2000
},
{
"type": "null"
}
],
"title": "Briefing Suffix",
"description": "Appended to the profile's default briefing"
}
},
"type": "object",
"required": [
"title",
"topic",
"speakers"
],
"$defs": {
"QualityPreset": {
"type": "string",
"enum": [
"quick",
"standard",
"premium"
],
"title": "QualityPreset",
"description": "Quality preset for podcast generation."
},
"SpeakerCreate": {
"properties": {
"name": {
"type": "string",
"maxLength": 50,
"minLength": 1,
"title": "Name",
"description": "Display name for the speaker"
},
"role": {
"$ref": "#/$defs/SpeakerRole",
"description": "Speaker role: Host, Expert, Guest, or Narrator"
},
"voice_type": {
"$ref": "#/$defs/app__schemas__podcast__VoiceType",
"description": "Voice type: preset, cloned, or standard",
"default": "preset"
},
"voice_id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Voice Id",
"description": "Legacy voice identifier (preset name or reference URL)"
},
"voice_ref_id": {
"anyOf": [
{
"type": "integer",
"maximum": 2147483647.0,
"minimum": 1.0
},
{
"type": "null"
}
],
"title": "Voice Ref Id",
"description": "In-house Voice catalog id for the audiobook TTS path"
},
"language": {
"type": "string",
"title": "Language",
"description": "Language code (e.g., en, zh, ja)",
"default": "en"
},
"use_turbo": {
"type": "boolean",
"title": "Use Turbo",
"description": "Use our fast English voice engine (faster, supports paralinguistic tags like [laugh], [cough])",
"default": false
},
"backstory": {
"anyOf": [
{
"type": "string",
"maxLength": 2000
},
{
"type": "null"
}
],
"title": "Backstory",
"description": "Speaker backstory/expertise"
},
"personality": {
"anyOf": [
{
"type": "string",
"maxLength": 2000
},
{
"type": "null"
}
],
"title": "Personality",
"description": "Speaker personality/voice"
}
},
"type": "object",
"required": [
"name",
"role"
],
"title": "SpeakerCreate",
"description": "Speaker creation request."
},
"SpeakerRole": {
"type": "string",
"enum": [
"Host",
"Expert",
"Guest",
"Narrator"
],
"title": "SpeakerRole",
"description": "Role of a speaker in the podcast."
},
"app__schemas__podcast__VoiceType": {
"type": "string",
"enum": [
"preset",
"cloned",
"standard"
],
"title": "VoiceType",
"description": "Type of voice for TTS."
}
}
}
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
This JSON Schema
curl "https://apis.io/api/v1/json-schemas/audiopod-ai-podcast-project-create"
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.